bashref.es.po 506 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056120571205812059120601206112062120631206412065120661206712068120691207012071120721207312074120751207612077120781207912080120811208212083120841208512086120871208812089120901209112092120931209412095120961209712098120991210012101121021210312104121051210612107121081210912110121111211212113121141211512116121171211812119121201212112122121231212412125121261212712128121291213012131121321213312134121351213612137121381213912140121411214212143121441214512146121471214812149121501215112152121531215412155121561215712158121591216012161121621216312164121651216612167121681216912170121711217212173121741217512176121771217812179121801218112182121831218412185121861218712188121891219012191121921219312194121951219612197121981219912200122011220212203122041220512206122071220812209122101221112212122131221412215122161221712218122191222012221122221222312224122251222612227122281222912230122311223212233122341223512236122371223812239122401224112242122431224412245122461224712248122491225012251122521225312254122551225612257122581225912260122611226212263122641226512266122671226812269122701227112272122731227412275122761227712278122791228012281122821228312284122851228612287122881228912290122911229212293122941229512296122971229812299123001230112302123031230412305123061230712308123091231012311123121231312314123151231612317123181231912320123211232212323123241232512326123271232812329123301233112332123331233412335123361233712338123391234012341123421234312344123451234612347123481234912350123511235212353123541235512356123571235812359123601236112362123631236412365123661236712368123691237012371123721237312374123751237612377123781237912380123811238212383123841238512386123871238812389123901239112392123931239412395123961239712398123991240012401124021240312404124051240612407124081240912410124111241212413124141241512416124171241812419124201242112422124231242412425124261242712428124291243012431124321243312434124351243612437124381243912440124411244212443124441244512446124471244812449124501245112452124531245412455124561245712458124591246012461124621246312464124651246612467124681246912470124711247212473124741247512476124771247812479124801248112482124831248412485124861248712488124891249012491124921249312494124951249612497124981249912500125011250212503125041250512506125071250812509125101251112512125131251412515125161251712518125191252012521125221252312524125251252612527125281252912530125311253212533125341253512536125371253812539125401254112542125431254412545125461254712548125491255012551125521255312554125551255612557125581255912560125611256212563125641256512566125671256812569125701257112572125731257412575125761257712578125791258012581125821258312584125851258612587125881258912590125911259212593125941259512596125971259812599126001260112602126031260412605126061260712608126091261012611126121261312614126151261612617126181261912620126211262212623126241262512626126271262812629126301263112632126331263412635126361263712638126391264012641126421264312644126451264612647126481264912650126511265212653126541265512656126571265812659126601266112662126631266412665126661266712668126691267012671126721267312674126751267612677126781267912680126811268212683126841268512686126871268812689126901269112692126931269412695126961269712698126991270012701127021270312704127051270612707127081270912710127111271212713127141271512716127171271812719127201272112722127231272412725127261272712728127291273012731127321273312734127351273612737127381273912740127411274212743127441274512746127471274812749127501275112752127531275412755127561275712758127591276012761127621276312764127651276612767127681276912770127711277212773127741277512776127771277812779127801278112782127831278412785127861278712788127891279012791127921279312794127951279612797127981279912800128011280212803128041280512806128071280812809128101281112812128131281412815128161281712818128191282012821128221282312824128251282612827128281282912830128311283212833128341283512836128371283812839128401284112842128431284412845128461284712848128491285012851128521285312854128551285612857128581285912860128611286212863128641286512866128671286812869128701287112872128731287412875128761287712878128791288012881128821288312884128851288612887128881288912890128911289212893128941289512896128971289812899129001290112902129031290412905129061290712908129091291012911129121291312914129151291612917129181291912920129211292212923129241292512926129271292812929129301293112932129331293412935129361293712938129391294012941129421294312944129451294612947129481294912950129511295212953129541295512956129571295812959129601296112962129631296412965129661296712968129691297012971129721297312974129751297612977129781297912980129811298212983129841298512986129871298812989129901299112992129931299412995129961299712998129991300013001130021300313004130051300613007130081300913010130111301213013130141301513016130171301813019130201302113022130231302413025130261302713028130291303013031130321303313034130351303613037130381303913040130411304213043130441304513046130471304813049130501305113052130531305413055130561305713058130591306013061130621306313064130651306613067130681306913070130711307213073130741307513076130771307813079130801308113082130831308413085130861308713088130891309013091130921309313094130951309613097130981309913100131011310213103131041310513106131071310813109131101311113112131131311413115131161311713118131191312013121131221312313124131251312613127131281312913130131311313213133131341313513136131371313813139131401314113142131431314413145131461314713148131491315013151131521315313154131551315613157131581315913160131611316213163131641316513166131671316813169131701317113172131731317413175131761317713178131791318013181131821318313184131851318613187131881318913190131911319213193131941319513196131971319813199132001320113202132031320413205132061320713208132091321013211132121321313214132151321613217132181321913220132211322213223132241322513226132271322813229132301323113232132331323413235132361323713238132391324013241132421324313244132451324613247132481324913250132511325213253132541325513256132571325813259132601326113262132631326413265132661326713268132691327013271132721327313274132751327613277132781327913280132811328213283132841328513286132871328813289132901329113292132931329413295132961329713298132991330013301133021330313304133051330613307133081330913310133111331213313133141331513316133171331813319133201332113322133231332413325133261332713328133291333013331133321333313334133351333613337133381333913340133411334213343133441334513346133471334813349133501335113352133531335413355133561335713358133591336013361133621336313364133651336613367133681336913370133711337213373133741337513376133771337813379133801338113382133831338413385133861338713388133891339013391133921339313394133951339613397133981339913400134011340213403134041340513406134071340813409134101341113412134131341413415134161341713418134191342013421134221342313424134251342613427134281342913430134311343213433134341343513436134371343813439134401344113442134431344413445134461344713448134491345013451134521345313454134551345613457134581345913460134611346213463134641346513466134671346813469134701347113472134731347413475134761347713478134791348013481134821348313484134851348613487134881348913490134911349213493134941349513496134971349813499135001350113502135031350413505135061350713508135091351013511135121351313514135151351613517135181351913520135211352213523135241352513526135271352813529135301353113532135331353413535135361353713538135391354013541135421354313544135451354613547135481354913550135511355213553135541355513556135571355813559135601356113562135631356413565135661356713568135691357013571135721357313574135751357613577135781357913580135811358213583135841358513586135871358813589135901359113592135931359413595135961359713598135991360013601136021360313604136051360613607136081360913610136111361213613136141361513616136171361813619136201362113622136231362413625136261362713628136291363013631136321363313634136351363613637136381363913640136411364213643136441364513646136471364813649136501365113652136531365413655136561365713658136591366013661136621366313664136651366613667136681366913670136711367213673136741367513676136771367813679136801368113682136831368413685136861368713688136891369013691136921369313694136951369613697136981369913700137011370213703137041370513706137071370813709137101371113712137131371413715137161371713718137191372013721137221372313724137251372613727137281372913730137311373213733137341373513736137371373813739137401374113742137431374413745137461374713748137491375013751137521375313754137551375613757137581375913760137611376213763137641376513766137671376813769137701377113772137731377413775137761377713778137791378013781137821378313784137851378613787137881378913790137911379213793137941379513796137971379813799138001380113802138031380413805138061380713808138091381013811138121381313814138151381613817138181381913820138211382213823138241382513826138271382813829138301383113832138331383413835138361383713838138391384013841138421384313844138451384613847138481384913850138511385213853138541385513856138571385813859138601386113862138631386413865138661386713868138691387013871138721387313874138751387613877138781387913880138811388213883138841388513886138871388813889138901389113892138931389413895138961389713898138991390013901139021390313904139051390613907139081390913910139111391213913139141391513916139171391813919139201392113922139231392413925139261392713928139291393013931139321393313934139351393613937139381393913940139411394213943139441394513946139471394813949139501395113952139531395413955139561395713958139591396013961139621396313964139651396613967139681396913970139711397213973139741397513976139771397813979139801398113982139831398413985139861398713988139891399013991139921399313994139951399613997139981399914000140011400214003140041400514006140071400814009140101401114012140131401414015140161401714018140191402014021140221402314024140251402614027140281402914030140311403214033140341403514036140371403814039140401404114042140431404414045140461404714048140491405014051140521405314054140551405614057140581405914060140611406214063140641406514066140671406814069140701407114072140731407414075140761407714078140791408014081140821408314084140851408614087140881408914090140911409214093140941409514096140971409814099141001410114102141031410414105141061410714108141091411014111141121411314114141151411614117141181411914120141211412214123141241412514126141271412814129141301413114132141331413414135141361413714138141391414014141141421414314144141451414614147141481414914150141511415214153141541415514156141571415814159141601416114162141631416414165141661416714168141691417014171141721417314174141751417614177141781417914180141811418214183141841418514186141871418814189141901419114192141931419414195141961419714198141991420014201142021420314204142051420614207142081420914210142111421214213142141421514216142171421814219142201422114222142231422414225142261422714228142291423014231142321423314234142351423614237142381423914240142411424214243142441424514246142471424814249142501425114252142531425414255142561425714258142591426014261142621426314264142651426614267142681426914270142711427214273142741427514276142771427814279142801428114282142831428414285142861428714288142891429014291142921429314294142951429614297142981429914300143011430214303143041430514306143071430814309143101431114312143131431414315143161431714318143191432014321143221432314324143251432614327143281432914330143311433214333143341433514336143371433814339143401434114342143431434414345143461434714348143491435014351143521435314354143551435614357143581435914360143611436214363143641436514366143671436814369143701437114372143731437414375143761437714378143791438014381143821438314384143851438614387143881438914390143911439214393143941439514396143971439814399144001440114402144031440414405144061440714408144091441014411144121441314414144151441614417144181441914420144211442214423144241442514426144271442814429144301443114432144331443414435144361443714438144391444014441144421444314444144451444614447144481444914450144511445214453144541445514456144571445814459144601446114462144631446414465144661446714468144691447014471144721447314474144751447614477144781447914480144811448214483144841448514486144871448814489144901449114492144931449414495144961449714498144991450014501145021450314504145051450614507145081450914510145111451214513145141451514516145171451814519145201452114522145231452414525145261452714528145291453014531145321453314534145351453614537145381453914540145411454214543145441454514546145471454814549145501455114552145531455414555145561455714558145591456014561145621456314564145651456614567145681456914570145711457214573145741457514576145771457814579145801458114582145831458414585145861458714588145891459014591145921459314594145951459614597145981459914600146011460214603146041460514606146071460814609146101461114612146131461414615146161461714618146191462014621146221462314624146251462614627146281462914630146311463214633146341463514636146371463814639146401464114642146431464414645146461464714648146491465014651146521465314654146551465614657146581465914660146611466214663146641466514666146671466814669146701467114672146731467414675146761467714678146791468014681146821468314684146851468614687146881468914690146911469214693146941469514696146971469814699147001470114702147031470414705147061470714708147091471014711147121471314714147151471614717147181471914720147211472214723147241472514726147271472814729147301473114732147331473414735147361473714738147391474014741147421474314744147451474614747147481474914750147511475214753147541475514756147571475814759147601476114762147631476414765147661476714768147691477014771147721477314774147751477614777147781477914780147811478214783147841478514786147871478814789147901479114792147931479414795147961479714798147991480014801148021480314804148051480614807148081480914810148111481214813148141481514816148171481814819148201482114822148231482414825148261482714828148291483014831148321483314834148351483614837148381483914840148411484214843148441484514846148471484814849148501485114852148531485414855148561485714858148591486014861148621486314864148651486614867148681486914870148711487214873148741487514876148771487814879148801488114882148831488414885148861488714888148891489014891148921489314894148951489614897148981489914900149011490214903149041490514906149071490814909149101491114912149131491414915149161491714918149191492014921149221492314924149251492614927149281492914930149311493214933149341493514936149371493814939149401494114942149431494414945149461494714948149491495014951149521495314954149551495614957149581495914960149611496214963149641496514966149671496814969149701497114972149731497414975149761497714978149791498014981149821498314984149851498614987149881498914990149911499214993149941499514996149971499814999150001500115002150031500415005150061500715008150091501015011150121501315014150151501615017150181501915020150211502215023150241502515026150271502815029150301503115032150331503415035150361503715038150391504015041150421504315044150451504615047150481504915050150511505215053150541505515056150571505815059150601506115062150631506415065150661506715068150691507015071150721507315074150751507615077150781507915080150811508215083150841508515086150871508815089150901509115092150931509415095150961509715098150991510015101151021510315104151051510615107151081510915110151111511215113151141511515116151171511815119151201512115122151231512415125151261512715128151291513015131151321513315134151351513615137151381513915140151411514215143151441514515146151471514815149151501515115152151531515415155151561515715158151591516015161151621516315164151651516615167151681516915170151711517215173151741517515176151771517815179151801518115182151831518415185151861518715188151891519015191151921519315194151951519615197151981519915200152011520215203152041520515206152071520815209152101521115212152131521415215152161521715218152191522015221152221522315224152251522615227152281522915230152311523215233152341523515236152371523815239152401524115242152431524415245152461524715248152491525015251152521525315254152551525615257152581525915260152611526215263152641526515266152671526815269152701527115272152731527415275152761527715278152791528015281152821528315284152851528615287152881528915290152911529215293152941529515296152971529815299153001530115302153031530415305153061530715308153091531015311153121531315314153151531615317153181531915320153211532215323153241532515326153271532815329153301533115332153331533415335153361533715338153391534015341153421534315344153451534615347153481534915350153511535215353153541535515356153571535815359153601536115362153631536415365153661536715368153691537015371153721537315374153751537615377153781537915380153811538215383153841538515386153871538815389153901539115392153931539415395153961539715398153991540015401154021540315404154051540615407154081540915410154111541215413154141541515416154171541815419154201542115422154231542415425154261542715428154291543015431154321543315434154351543615437154381543915440154411544215443154441544515446154471544815449154501545115452154531545415455154561545715458154591546015461154621546315464154651546615467154681546915470154711547215473154741547515476154771547815479154801548115482154831548415485154861548715488154891549015491154921549315494154951549615497154981549915500155011550215503155041550515506155071550815509155101551115512155131551415515155161551715518155191552015521155221552315524155251552615527155281552915530155311553215533155341553515536155371553815539155401554115542155431554415545155461554715548155491555015551155521555315554155551555615557155581555915560155611556215563155641556515566155671556815569155701557115572155731557415575155761557715578155791558015581155821558315584155851558615587155881558915590155911559215593155941559515596155971559815599156001560115602156031560415605156061560715608156091561015611156121561315614156151561615617156181561915620156211562215623156241562515626156271562815629156301563115632156331563415635156361563715638156391564015641156421564315644156451564615647156481564915650156511565215653156541565515656156571565815659156601566115662156631566415665156661566715668156691567015671156721567315674156751567615677156781567915680156811568215683156841568515686156871568815689156901569115692156931569415695156961569715698156991570015701157021570315704157051570615707157081570915710157111571215713157141571515716157171571815719157201572115722157231572415725157261572715728157291573015731157321573315734157351573615737157381573915740157411574215743157441574515746157471574815749157501575115752157531575415755157561575715758157591576015761157621576315764157651576615767157681576915770157711577215773157741577515776157771577815779157801578115782157831578415785157861578715788157891579015791157921579315794157951579615797157981579915800158011580215803158041580515806158071580815809158101581115812158131581415815158161581715818158191582015821158221582315824158251582615827158281582915830158311583215833158341583515836158371583815839158401584115842158431584415845158461584715848158491585015851158521585315854158551585615857158581585915860158611586215863158641586515866158671586815869158701587115872158731587415875158761587715878158791588015881158821588315884158851588615887158881588915890158911589215893158941589515896158971589815899159001590115902159031590415905159061590715908159091591015911159121591315914159151591615917159181591915920159211592215923159241592515926159271592815929159301593115932159331593415935159361593715938159391594015941159421594315944159451594615947159481594915950159511595215953159541595515956159571595815959159601596115962159631596415965159661596715968159691597015971159721597315974159751597615977159781597915980159811598215983159841598515986159871598815989159901599115992159931599415995159961599715998159991600016001160021600316004160051600616007160081600916010160111601216013160141601516016160171601816019160201602116022160231602416025160261602716028160291603016031160321603316034160351603616037160381603916040160411604216043160441604516046160471604816049160501605116052160531605416055160561605716058160591606016061160621606316064160651606616067160681606916070160711607216073160741607516076160771607816079160801608116082160831608416085160861608716088160891609016091160921609316094160951609616097160981609916100161011610216103161041610516106161071610816109161101611116112161131611416115161161611716118161191612016121161221612316124161251612616127161281612916130161311613216133161341613516136161371613816139161401614116142161431614416145161461614716148161491615016151161521615316154161551615616157161581615916160161611616216163161641616516166161671616816169161701617116172161731617416175161761617716178161791618016181161821618316184161851618616187161881618916190161911619216193161941619516196161971619816199162001620116202162031620416205162061620716208162091621016211162121621316214162151621616217162181621916220162211622216223162241622516226162271622816229162301623116232162331623416235162361623716238162391624016241162421624316244162451624616247162481624916250162511625216253162541625516256162571625816259162601626116262162631626416265162661626716268162691627016271162721627316274162751627616277162781627916280162811628216283162841628516286162871628816289162901629116292162931629416295162961629716298162991630016301163021630316304163051630616307163081630916310163111631216313163141631516316163171631816319163201632116322163231632416325163261632716328163291633016331163321633316334163351633616337163381633916340163411634216343163441634516346163471634816349163501635116352163531635416355163561635716358163591636016361163621636316364163651636616367163681636916370163711637216373163741637516376163771637816379163801638116382163831638416385163861638716388163891639016391163921639316394163951639616397163981639916400164011640216403164041640516406164071640816409164101641116412164131641416415164161641716418164191642016421164221642316424164251642616427164281642916430164311643216433164341643516436164371643816439164401644116442164431644416445164461644716448164491645016451164521645316454164551645616457164581645916460164611646216463164641646516466164671646816469164701647116472164731647416475164761647716478164791648016481164821648316484164851648616487164881648916490164911649216493164941649516496164971649816499165001650116502165031650416505165061650716508165091651016511165121651316514165151651616517165181651916520165211652216523165241652516526165271652816529165301653116532165331653416535165361653716538165391654016541165421654316544165451654616547165481654916550165511655216553165541655516556165571655816559165601656116562165631656416565165661656716568165691657016571165721657316574165751657616577165781657916580165811658216583165841658516586165871658816589165901659116592165931659416595165961659716598165991660016601166021660316604166051660616607166081660916610166111661216613166141661516616166171661816619166201662116622166231662416625166261662716628166291663016631166321663316634166351663616637166381663916640166411664216643166441664516646166471664816649166501665116652166531665416655166561665716658166591666016661166621666316664166651666616667166681666916670166711667216673166741667516676166771667816679166801668116682166831668416685166861668716688166891669016691166921669316694166951669616697166981669916700167011670216703167041670516706167071670816709167101671116712167131671416715167161671716718167191672016721167221672316724167251672616727167281672916730167311673216733167341673516736167371673816739167401674116742167431674416745167461674716748167491675016751167521675316754167551675616757167581675916760167611676216763167641676516766167671676816769167701677116772167731677416775167761677716778167791678016781167821678316784167851678616787167881678916790167911679216793167941679516796167971679816799168001680116802168031680416805168061680716808168091681016811168121681316814168151681616817168181681916820168211682216823168241682516826168271682816829168301683116832168331683416835168361683716838168391684016841168421684316844168451684616847168481684916850168511685216853168541685516856168571685816859168601686116862168631686416865168661686716868168691687016871168721687316874168751687616877168781687916880168811688216883168841688516886168871688816889168901689116892168931689416895168961689716898168991690016901169021690316904169051690616907169081690916910169111691216913169141691516916169171691816919169201692116922169231692416925169261692716928169291693016931169321693316934169351693616937169381693916940169411694216943169441694516946169471694816949169501695116952169531695416955169561695716958169591696016961169621696316964169651696616967169681696916970169711697216973169741697516976169771697816979169801698116982169831698416985169861698716988169891699016991169921699316994169951699616997169981699917000170011700217003170041700517006170071700817009170101701117012170131701417015170161701717018170191702017021170221702317024170251702617027170281702917030170311703217033170341703517036170371703817039170401704117042170431704417045170461704717048170491705017051170521705317054170551705617057170581705917060170611706217063170641706517066170671706817069170701707117072170731707417075170761707717078170791708017081170821708317084170851708617087170881708917090170911709217093170941709517096170971709817099171001710117102171031710417105171061710717108171091711017111171121711317114171151711617117171181711917120171211712217123171241712517126171271712817129171301713117132171331713417135171361713717138171391714017141171421714317144171451714617147171481714917150171511715217153171541715517156171571715817159171601716117162171631716417165171661716717168171691717017171171721717317174171751717617177171781717917180171811718217183171841718517186171871718817189171901719117192171931719417195171961719717198171991720017201172021720317204172051720617207172081720917210172111721217213172141721517216172171721817219172201722117222172231722417225172261722717228172291723017231172321723317234172351723617237172381723917240172411724217243172441724517246172471724817249172501725117252172531725417255172561725717258172591726017261172621726317264172651726617267172681726917270172711727217273172741727517276172771727817279172801728117282172831728417285172861728717288172891729017291172921729317294172951729617297172981729917300173011730217303173041730517306173071730817309173101731117312173131731417315173161731717318173191732017321173221732317324173251732617327173281732917330173311733217333173341733517336173371733817339173401734117342173431734417345173461734717348173491735017351173521735317354173551735617357173581735917360173611736217363173641736517366173671736817369173701737117372173731737417375173761737717378173791738017381173821738317384173851738617387173881738917390173911739217393173941739517396173971739817399
  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. msgid ""
  7. msgstr ""
  8. "Project-Id-Version: \n"
  9. "POT-Creation-Date: 2017-12-23 20:30+0100\n"
  10. "PO-Revision-Date: 2018-03-28 01:10-0600\n"
  11. "Language-Team: \n"
  12. "MIME-Version: 1.0\n"
  13. "Content-Type: text/plain; charset=UTF-8\n"
  14. "Content-Transfer-Encoding: 8bit\n"
  15. "X-Generator: Poedit 1.5.4\n"
  16. "Last-Translator: \n"
  17. "Plural-Forms: nplurals=2; plural=(n != 1);\n"
  18. "Language: es\n"
  19. #. type: title
  20. #: bashref.texi:4 bashref.texi:41
  21. #, no-wrap
  22. msgid "Bash Reference Manual"
  23. msgstr "Manual de Referencia de Bash"
  24. #. type: include
  25. #: bashref.texi:6
  26. #, no-wrap
  27. msgid "version.texi"
  28. msgstr "version.texi"
  29. #. type: copying
  30. #: bashref.texi:12
  31. msgid ""
  32. "This text is a brief description of the features that are present in the "
  33. "Bash shell (version @value{VERSION}, @value{UPDATED})."
  34. msgstr ""
  35. "Este texto es una breve descripción de las características presentes en el "
  36. "intérprete de órdenes de Bash (version @value{VERSION}, @value{UPDATED})."
  37. #. type: ifnottex
  38. #: bashref.texi:16 bashref.texi:67
  39. msgid ""
  40. "This is Edition @value{EDITION}, last updated @value{UPDATED}, of @cite{The "
  41. "GNU Bash Reference Manual}, for @code{Bash}, Version @value{VERSION}."
  42. msgstr ""
  43. "Esta es la Edición @value{EDITION}, actualizada por última vez "
  44. "@value{UPDATED}, de @cite{El Manual de Referencia de Bash}, para "
  45. "@code{Bash}, Version @value{VERSION}."
  46. #. type: copying
  47. #: bashref.texi:18
  48. msgid "Copyright @copyright{} 1988--2016 Free Software Foundation, Inc."
  49. msgstr "Copyright @copyright{} 1988--2016 Free Software Foundation, Inc."
  50. #. type: quotation
  51. #: bashref.texi:26
  52. msgid ""
  53. "Permission is granted to copy, distribute and/or modify this document under "
  54. "the terms of the GNU Free Documentation License, Version 1.3 or any later "
  55. "version published by the Free Software Foundation; with no Invariant "
  56. "Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the "
  57. "license is included in the section entitled ``GNU Free Documentation "
  58. "License''."
  59. msgstr ""
  60. "Se otorga permiso para copiar, distribuir y/o modificar este documento bajo "
  61. "los términos de la GNU Free Documentation License, Version 1.3 [Licencia de "
  62. "Documentación Libre de GNU, Version 1.3 o posterior] publicada por la Free "
  63. "Software Foundation; sin Invariant Sections [secciones invariables], sin "
  64. "Front-Cover Texts [textos en la cubierta frontal] y sin Back-Cover Texts "
  65. "[textos en la cubierta trasera]. Se incluye una copia de está licencia en "
  66. "la sección titulada ``GNU Free Documentation License''."
  67. #. type: dircategory
  68. #: bashref.texi:33
  69. #, no-wrap
  70. msgid "Basics"
  71. msgstr "Básicos"
  72. #. type: menuentry
  73. #: bashref.texi:36
  74. msgid "Bash: (bash)"
  75. msgstr "Bash: (bash)"
  76. #. type: menuentry
  77. #: bashref.texi:36
  78. msgid "The GNU Bourne-Again SHell."
  79. msgstr "La GNU Bourne-Again SHell."
  80. #. type: subtitle
  81. #: bashref.texi:42
  82. #, no-wrap
  83. msgid "Reference Documentation for Bash"
  84. msgstr "Documentación de Referencia para Bash"
  85. #. type: subtitle
  86. #: bashref.texi:43
  87. #, no-wrap
  88. msgid "Edition @value{EDITION}, for @code{Bash} Version @value{VERSION}."
  89. msgstr "Edición @value{EDITION}, para @code{Bash} Versión @value{VERSION}."
  90. #. type: subtitle
  91. #: bashref.texi:44
  92. #, no-wrap
  93. msgid "@value{UPDATED-MONTH}"
  94. msgstr "@value{UPDATED-MONTH}"
  95. #. type: author
  96. #: bashref.texi:45
  97. #, no-wrap
  98. msgid "Chet Ramey, Case Western Reserve University"
  99. msgstr "Chet Ramey, Case Western Reserve University"
  100. #. type: author
  101. #: bashref.texi:46
  102. #, no-wrap
  103. msgid "Brian Fox, Free Software Foundation"
  104. msgstr "Brian Fox, Free Software Foundation"
  105. #. type: node
  106. #: bashref.texi:57
  107. #, no-wrap
  108. msgid "Top"
  109. msgstr "Superior"
  110. #. type: chapter
  111. #: bashref.texi:57 bashref.texi:100 bashref.texi:103 bashref.texi:104
  112. #, no-wrap
  113. msgid "Introduction"
  114. msgstr "Introducción"
  115. #. type: node
  116. #: bashref.texi:57
  117. #, no-wrap
  118. msgid "(dir)"
  119. msgstr "(dir)"
  120. #. type: chapter
  121. #: bashref.texi:58 bashref.texi:100 bashref.texi:6157 bashref.texi:6158
  122. #, no-wrap
  123. msgid "Bash Features"
  124. msgstr "Características de Bash"
  125. #. type: ifnottex
  126. #: bashref.texi:63
  127. msgid ""
  128. "This text is a brief description of the features that are present in the "
  129. "Bash shell (version @value{VERSION}, @value{UPDATED}). The Bash home page "
  130. "is @url{http://www.gnu.org/software/bash/}."
  131. msgstr ""
  132. "Este texto es una descripción breve de las características presentes en el "
  133. "intérprete de órdenes Bash (versión @value{VERSION}, @value{UPDATED}). El "
  134. "sitio web la Bash es @url{http://www.gnu.org/software/bash/}."
  135. #. type: ifnottex
  136. #: bashref.texi:75
  137. msgid ""
  138. "Bash contains features that appear in other popular shells, and some "
  139. "features that only appear in Bash. Some of the shells that Bash has "
  140. "borrowed concepts from are the Bourne Shell (@file{sh}), the Korn Shell "
  141. "(@file{ksh}), and the C-shell (@file{csh} and its successor, @file{tcsh}). "
  142. "The following menu breaks the features up into categories, noting which "
  143. "features were inspired by other shells and which are specific to Bash."
  144. msgstr ""
  145. "Bash contiene características que aparecen en otros intérpretes de "
  146. "instrucciones populares, y algunas características que solo aparecen en "
  147. "Bash. Algunos de los intérpretes de los que Bash ha tomado conceptos son el "
  148. "Bourne Shell (@file{sh}), el Korn Shell (@file{ksh}) y el C-shell "
  149. "(@file{csh} y su sucesor, @file{tcsh}). El siguiente menú divide las "
  150. "características en categorías, mencionando qué características fueron "
  151. "inspiradas por otros intérpretes y cuáles son propias de Bash."
  152. #. type: ifnottex
  153. #: bashref.texi:79
  154. msgid ""
  155. "This manual is meant as a brief introduction to features found in Bash. The "
  156. "Bash manual page should be used as the definitive reference on shell "
  157. "behavior."
  158. msgstr ""
  159. "Este manual está pensado como una breve introducción a las características "
  160. "que se encuentran en Bash. La página de manual de Bash debería usarse como "
  161. "la referencia definitiva sobre el compartamiento del intérprete de órdenes."
  162. #. type: menuentry
  163. #: bashref.texi:100
  164. msgid "An introduction to the shell."
  165. msgstr "Una introducción al intérprete de órdenes."
  166. #. type: chapter
  167. #: bashref.texi:100 bashref.texi:191 bashref.texi:192
  168. #, no-wrap
  169. msgid "Definitions"
  170. msgstr "Definiciones"
  171. #. type: menuentry
  172. #: bashref.texi:100
  173. msgid "Some definitions used in the rest of this manual."
  174. msgstr "Algunas definiciones usadas en el resto de este manual"
  175. #. type: chapter
  176. #: bashref.texi:100 bashref.texi:305 bashref.texi:306
  177. #, no-wrap
  178. msgid "Basic Shell Features"
  179. msgstr "Características Básicas de Shell"
  180. #. type: menuentry
  181. #: bashref.texi:100
  182. msgid "The shell \"building blocks\"."
  183. msgstr "Los \"bloques constructores\" del intérprete"
  184. #. type: chapter
  185. #: bashref.texi:100 bashref.texi:3229 bashref.texi:3230
  186. #, no-wrap
  187. msgid "Shell Builtin Commands"
  188. msgstr "Instrucciones Integradas de la Shell"
  189. #. type: menuentry
  190. #: bashref.texi:100
  191. msgid "Commands that are a part of the shell."
  192. msgstr "Instrucciones que son parte del intérprete"
  193. #. type: chapter
  194. #: bashref.texi:100 bashref.texi:5377 bashref.texi:5378
  195. #, no-wrap
  196. msgid "Shell Variables"
  197. msgstr "Variables de la Shell"
  198. #. type: menuentry
  199. #: bashref.texi:100
  200. msgid "Variables used or set by Bash."
  201. msgstr "Variables usadas o establecidas por Bash"
  202. #. type: menuentry
  203. #: bashref.texi:100
  204. msgid "Features found only in Bash."
  205. msgstr "Características únicas de Bash"
  206. #. type: chapter
  207. #: bashref.texi:100 bashref.texi:7622 bashref.texi:7623
  208. #, no-wrap
  209. msgid "Job Control"
  210. msgstr "Control de Tareas"
  211. #. type: menuentry
  212. #: bashref.texi:100
  213. msgid "What job control is and how Bash allows you to use it."
  214. msgstr "Qué es el control de tareas y cómo te permite Bash usarlo."
  215. #. type: menuentry
  216. #: bashref.texi:100
  217. msgid "Command Line Editing"
  218. msgstr "Edición en Línea de Órdenes"
  219. #. type: menuentry
  220. #: bashref.texi:100
  221. msgid "Chapter describing the command line editing features."
  222. msgstr ""
  223. "Capítulo que describe las características de la edición en línea de órdenes."
  224. #. type: menuentry
  225. #: bashref.texi:100
  226. msgid "Using History Interactively"
  227. msgstr "Usando el Historial Interactivamente"
  228. #. type: menuentry
  229. #: bashref.texi:100
  230. msgid "Command History Expansion"
  231. msgstr "Expansión del Historial de Órdenes"
  232. #. type: chapter
  233. #: bashref.texi:100 bashref.texi:7918 bashref.texi:7919
  234. #, no-wrap
  235. msgid "Installing Bash"
  236. msgstr "Instalación de Bash"
  237. #. type: menuentry
  238. #: bashref.texi:100
  239. msgid "How to build and install Bash on your system."
  240. msgstr "Cómo construir e instalar Bash en tu sistema."
  241. #. type: appendix
  242. #: bashref.texi:100 bashref.texi:8427 bashref.texi:8428
  243. #, no-wrap
  244. msgid "Reporting Bugs"
  245. msgstr "Reportar Errores"
  246. #. type: menuentry
  247. #: bashref.texi:100
  248. msgid "How to report bugs in Bash."
  249. msgstr "Cómo reportar errores en Bash"
  250. #. type: appendix
  251. #: bashref.texi:100 bashref.texi:8466 bashref.texi:8467
  252. #, no-wrap
  253. msgid "Major Differences From The Bourne Shell"
  254. msgstr "Diferencias Principales Respecto a The Bourne Shell"
  255. #. type: menuentry
  256. #: bashref.texi:100
  257. msgid ""
  258. "A terse list of the differences between Bash and historical versions of /bin/"
  259. "sh."
  260. msgstr ""
  261. "Una lista de las diferencias entre Bash y versiones históricas de /bin/sh"
  262. #. type: appendix
  263. #: bashref.texi:100 bashref.texi:8934 bashref.texi:8935
  264. #, no-wrap
  265. msgid "GNU Free Documentation License"
  266. msgstr "GNU Free Documentation License"
  267. #. type: menuentry
  268. #: bashref.texi:100
  269. msgid "Copying and sharing this documentation."
  270. msgstr "Copiar y compartir esta documentación."
  271. #. type: appendix
  272. #: bashref.texi:100 bashref.texi:8939 bashref.texi:8940
  273. #, no-wrap
  274. msgid "Indexes"
  275. msgstr "Glosarios"
  276. #. type: menuentry
  277. #: bashref.texi:100
  278. msgid "Various indexes for this manual."
  279. msgstr "Varios glosarios para este manual."
  280. #. type: section
  281. #: bashref.texi:108 bashref.texi:110 bashref.texi:111
  282. #, no-wrap
  283. msgid "What is Bash?"
  284. msgstr "¿Qué es Bash?"
  285. #. type: menuentry
  286. #: bashref.texi:108
  287. msgid "A short description of Bash."
  288. msgstr "Una breve descripción de Bash."
  289. #. type: section
  290. #: bashref.texi:108 bashref.texi:136 bashref.texi:137
  291. #, no-wrap
  292. msgid "What is a shell?"
  293. msgstr "¿Qué es un intérprete?"
  294. #. type: menuentry
  295. #: bashref.texi:108
  296. msgid "A brief introduction to shells."
  297. msgstr "Una breve introducción a los intérpretes de instrucciones."
  298. #. type: Plain text
  299. #: bashref.texi:120
  300. msgid ""
  301. "Bash is the shell, or command language interpreter, for the @sc{gnu} "
  302. "operating system. The name is an acronym for the @samp{Bourne-Again SHell}, "
  303. "a pun on Stephen Bourne, the author of the direct ancestor of the current "
  304. "Unix shell @code{sh}, which appeared in the Seventh Edition Bell Labs "
  305. "Research version of Unix."
  306. msgstr ""
  307. "Bash es el intérprete, o el lenguaje intérprete de órdenes, para el sistema "
  308. "operativo @sc{gnu}. El nombre es un acrónimo de @samp{Bourne-Again SHell}, "
  309. "un juego de palabras con Stephen Bourne, el autor del ancestro directo del "
  310. "actual intérprete @code{sh}, que apareció en la versión Seventh Edition Bell "
  311. "Labs Research de Unix."
  312. #. type: Plain text
  313. #: bashref.texi:128
  314. msgid ""
  315. "Bash is largely compatible with @code{sh} and incorporates useful features "
  316. "from the Korn shell @code{ksh} and the C shell @code{csh}. It is intended "
  317. "to be a conformant implementation of the @sc{ieee} @sc{posix} Shell and "
  318. "Tools portion of the @sc{ieee} @sc{posix} specification (@sc{ieee} Standard "
  319. "1003.1). It offers functional improvements over @code{sh} for both "
  320. "interactive and programming use."
  321. msgstr ""
  322. "Bash es en gran parte compatible con @code{sh} e incorpora características "
  323. "útiles del intérprete Korn @code{ksh} y el intérprete C @code{csh}. Esta "
  324. "concebido para ser una implementación que se ajusta a la parte @sc{ieee} "
  325. "@sc{posix} Shell and Tools de la especificación @sc{ieee} @sc{posix} "
  326. "(@sc{ieee} Standard 1003.1). Ofrece mejoras funcionales sobre @code{sh} "
  327. "tanto para uso interactivo como para programar."
  328. #. type: Plain text
  329. #: bashref.texi:135
  330. msgid ""
  331. "While the @sc{gnu} operating system provides other shells, including a "
  332. "version of @code{csh}, Bash is the default shell. Like other @sc{gnu} "
  333. "software, Bash is quite portable. It currently runs on nearly every version "
  334. "of Unix and a few other operating systems @minus{} independently-supported "
  335. "ports exist for @sc{ms-dos}, @sc{os/2}, and Windows platforms."
  336. msgstr ""
  337. "Aunque el sistema operativo @sc{gnu} proporciona otros intérpretes de "
  338. "órdenes, incluyendo una versión de @code{csh}, Bash es el intérprete "
  339. "predeterminado. Al igual que otro software de @sc{gnu}, Bash es bastante "
  340. "portable. Actualmente se ejecuta en casi cualquier versión de Unix y "
  341. "algunos otros sistemas operativos ---existen versiones portadas mantenidas "
  342. "de forma independiente para @sc{ms-dos}, @sc{os/2} y plataformas Windows---."
  343. #. type: Plain text
  344. #: bashref.texi:142
  345. msgid ""
  346. "At its base, a shell is simply a macro processor that executes commands. "
  347. "The term macro processor means functionality where text and symbols are "
  348. "expanded to create larger expressions."
  349. msgstr ""
  350. "Básicamente, un intérprete es simplemente un procesador de macros que "
  351. "ejecuta instrucciones. El término procesador de macros significa "
  352. "funcionalidad donde texto y símbolos son expandidos para crear expresiones "
  353. "más grandes."
  354. #. type: Plain text
  355. #: bashref.texi:152
  356. msgid ""
  357. "A Unix shell is both a command interpreter and a programming language. As a "
  358. "command interpreter, the shell provides the user interface to the rich set "
  359. "of @sc{gnu} utilities. The programming language features allow these "
  360. "utilities to be combined. Files containing commands can be created, and "
  361. "become commands themselves. These new commands have the same status as "
  362. "system commands in directories such as @file{/bin}, allowing users or groups "
  363. "to establish custom environments to automate their common tasks."
  364. msgstr ""
  365. "Un intérprete de Unix es tanto un intérprete de órdenes como un lenguaje de "
  366. "programación. Como un intérprete de instrucciones, el intérprete "
  367. "proporciona la interfaz de usuario a un variado conjunto de utilidades de "
  368. "@sc{gnu}. Las funcionalidades del lenguaje de programación permiten que "
  369. "estás utilidades se combinen. Se pueden crear archivos que contienen "
  370. "instrucciones, y convertirse ellos mismos en instrucciones. Estas nuevas "
  371. "órdenes tienen la misma naturaleza que instrucciones del sistema en "
  372. "directorios como @file{/bin}, permitiendo que usuarios o grupos puedan "
  373. "establecer entornos personalizados para automatizar sus tareas comunes."
  374. #. type: Plain text
  375. #: bashref.texi:157
  376. msgid ""
  377. "Shells may be used interactively or non-interactively. In interactive mode, "
  378. "they accept input typed from the keyboard. When executing non-"
  379. "interactively, shells execute commands read from a file."
  380. msgstr ""
  381. "Los intérpretes pueden ser usados de forma interactiva o de forma no "
  382. "interactiva. En el modo interactivo, aceptan la entrada escrita desde el "
  383. "teclado. Cuando se ejecutan de forma no interactiva, los intérpretes "
  384. "ejecutan instrucciones leídas de un archivo."
  385. #. type: Plain text
  386. #: bashref.texi:167
  387. msgid ""
  388. "A shell allows execution of @sc{gnu} commands, both synchronously and "
  389. "asynchronously. The shell waits for synchronous commands to complete before "
  390. "accepting more input; asynchronous commands continue to execute in parallel "
  391. "with the shell while it reads and executes additional commands. The "
  392. "@dfn{redirection} constructs permit fine-grained control of the input and "
  393. "output of those commands. Moreover, the shell allows control over the "
  394. "contents of commands' environments."
  395. msgstr ""
  396. "Un intérprete permite la ejecución de instrucciones @sc{gnu}, tanto síncrona "
  397. "como asíncronamente. El intérprete espera a que las instrucciones síncronas "
  398. "se completen antes de aceptar más entradas; las instrucciones asíncronas "
  399. "continúan ejecutándose en paralelo con el intérprete mientras que lee y "
  400. "ejecuta instrucciones adicionales. Las construcciones de @dfn{redirección} "
  401. "permiten un control preciso de la entrada y la salida de esas "
  402. "instrucciones. Asimismo, el intérprete proporciona control sobre los "
  403. "contenidos de los entornos de instrucciones."
  404. #. type: Plain text
  405. #: bashref.texi:179
  406. msgid ""
  407. "Shells also provide a small set of built-in commands (@dfn{builtins}) "
  408. "implementing functionality impossible or inconvenient to obtain via separate "
  409. "utilities. For example, @code{cd}, @code{break}, @code{continue}, and "
  410. "@code{exec} cannot be implemented outside of the shell because they directly "
  411. "manipulate the shell itself. The @code{history}, @code{getopts}, "
  412. "@code{kill}, or @code{pwd} builtins, among others, could be implemented in "
  413. "separate utilities, but they are more convenient to use as builtin "
  414. "commands. All of the shell builtins are described in subsequent sections."
  415. msgstr ""
  416. "Los intérpretes también proporcionan un pequeño conjunto de instrucciones "
  417. "integradas (@dfn{builtins}) que implementan funcionalidad imposible o "
  418. "inconveniente de obtener mediante utilidades separadas. Por ejemplo, "
  419. "@code{cd}, @code{break}, @code{continue} y @code{exec} no pueden ser "
  420. "implementados fuera del intérprete porque manipulan directamente el "
  421. "intérprete en sí mismo. Las instrucciones integradas @code{history}, "
  422. "@code{getopts}, @code{kill} o @code{pwd}, entre otras, podrían ser "
  423. "implementadas en utilidades separadas, pero son más convenientes de usar "
  424. "como instrucciones integradas. Todas las funciones integradas del "
  425. "intérprete son descritas en las secciones posteriores."
  426. #. type: Plain text
  427. #: bashref.texi:184
  428. msgid ""
  429. "While executing commands is essential, most of the power (and complexity) of "
  430. "shells is due to their embedded programming languages. Like any high-level "
  431. "language, the shell provides variables, flow control constructs, quoting, "
  432. "and functions."
  433. msgstr ""
  434. "Mientras que la ejecución de instrucciones es esencial, la mayoría del poder "
  435. "(y de la complejidad) de los intérpretes es debido a sus lenguajes de "
  436. "programación integrados. Como cualquier otro lenguaje de alto nivel, el "
  437. "intérprete proporciona variables, estructuras de control de flujo, "
  438. "entrecomillado y funciones."
  439. #. type: Plain text
  440. #: bashref.texi:190
  441. msgid ""
  442. "Shells offer features geared specifically for interactive use rather than to "
  443. "augment the programming language. These interactive features include job "
  444. "control, command line editing, command history and aliases. Each of these "
  445. "features is described in this manual."
  446. msgstr ""
  447. "Los intérpretes ofrecen características enfocadas específicamente para uso "
  448. "interactivo en vez de para aumentar el lenguaje de programación. Estas "
  449. "características interactivas incluyen control de tareas, edición de línea de "
  450. "órdenes, historial de instrucciones y aliases. En este manual se describe "
  451. "cada una de estas características."
  452. #. type: Plain text
  453. #: bashref.texi:194
  454. msgid "These definitions are used throughout the remainder of this manual."
  455. msgstr ""
  456. #. type: cindex
  457. #: bashref.texi:197 bashref.texi:198
  458. #, no-wrap
  459. msgid "POSIX"
  460. msgstr ""
  461. #. type: table
  462. #: bashref.texi:202
  463. msgid ""
  464. "A family of open system standards based on Unix. Bash is primarily "
  465. "concerned with the Shell and Utilities portion of the @sc{posix} 1003.1 "
  466. "standard."
  467. msgstr ""
  468. #. type: item
  469. #: bashref.texi:203
  470. #, no-wrap
  471. msgid "blank"
  472. msgstr ""
  473. #. type: table
  474. #: bashref.texi:205
  475. msgid "A space or tab character."
  476. msgstr ""
  477. #. type: btindex
  478. #: bashref.texi:206 bashref.texi:207 bashref.texi:3943 bashref.texi:3944
  479. #, no-wrap
  480. msgid "builtin"
  481. msgstr ""
  482. #. type: table
  483. #: bashref.texi:210
  484. msgid ""
  485. "A command that is implemented internally by the shell itself, rather than by "
  486. "an executable program somewhere in the file system."
  487. msgstr ""
  488. #. type: cindex
  489. #: bashref.texi:211 bashref.texi:212
  490. #, no-wrap
  491. msgid "control operator"
  492. msgstr ""
  493. #. type: table
  494. #: bashref.texi:217
  495. msgid ""
  496. "A @code{token} that performs a control function. It is a @code{newline} or "
  497. "one of the following: @samp{||}, @samp{&&}, @samp{&}, @samp{;}, @samp{;;}, "
  498. "@samp{;&}, @samp{;;&}, @samp{|}, @samp{|&}, @samp{(}, or @samp{)}."
  499. msgstr ""
  500. #. type: cindex
  501. #: bashref.texi:218 bashref.texi:219 bashref.texi:3086
  502. #, no-wrap
  503. msgid "exit status"
  504. msgstr ""
  505. #. type: table
  506. #: bashref.texi:222
  507. msgid ""
  508. "The value returned by a command to its caller. The value is restricted to "
  509. "eight bits, so the maximum value is 255."
  510. msgstr ""
  511. #. type: cindex
  512. #: bashref.texi:223 bashref.texi:224
  513. #, no-wrap
  514. msgid "field"
  515. msgstr ""
  516. #. type: table
  517. #: bashref.texi:228
  518. msgid ""
  519. "A unit of text that is the result of one of the shell expansions. After "
  520. "expansion, when executing a command, the resulting fields are used as the "
  521. "command name and arguments."
  522. msgstr ""
  523. #. type: cindex
  524. #: bashref.texi:229 bashref.texi:230
  525. #, no-wrap
  526. msgid "filename"
  527. msgstr ""
  528. #. type: table
  529. #: bashref.texi:232
  530. msgid "A string of characters used to identify a file."
  531. msgstr ""
  532. #. type: cindex
  533. #: bashref.texi:233 bashref.texi:234
  534. #, no-wrap
  535. msgid "job"
  536. msgstr ""
  537. #. type: table
  538. #: bashref.texi:237
  539. msgid ""
  540. "A set of processes comprising a pipeline, and any processes descended from "
  541. "it, that are all in the same process group."
  542. msgstr ""
  543. #. type: cindex
  544. #: bashref.texi:238 bashref.texi:239 bashref.texi:7638
  545. #, no-wrap
  546. msgid "job control"
  547. msgstr ""
  548. #. type: table
  549. #: bashref.texi:242
  550. msgid ""
  551. "A mechanism by which users can selectively stop (suspend) and restart "
  552. "(resume) execution of processes."
  553. msgstr ""
  554. #. type: cindex
  555. #: bashref.texi:243 bashref.texi:244
  556. #, no-wrap
  557. msgid "metacharacter"
  558. msgstr ""
  559. #. type: table
  560. #: bashref.texi:249
  561. msgid ""
  562. "A character that, when unquoted, separates words. A metacharacter is a "
  563. "@code{space}, @code{tab}, @code{newline}, or one of the following "
  564. "characters: @samp{|}, @samp{&}, @samp{;}, @samp{(}, @samp{)}, @samp{<}, or "
  565. "@samp{>}."
  566. msgstr ""
  567. #. type: cindex
  568. #: bashref.texi:250 bashref.texi:251
  569. #, no-wrap
  570. msgid "name"
  571. msgstr ""
  572. #. type: cindex
  573. #: bashref.texi:252
  574. #, no-wrap
  575. msgid "identifier"
  576. msgstr ""
  577. #. type: table
  578. #: bashref.texi:257
  579. msgid ""
  580. "A @code{word} consisting solely of letters, numbers, and underscores, and "
  581. "beginning with a letter or underscore. @code{Name}s are used as shell "
  582. "variable and function names. Also referred to as an @code{identifier}."
  583. msgstr ""
  584. #. type: item
  585. #: bashref.texi:258
  586. #, no-wrap
  587. msgid "operator"
  588. msgstr ""
  589. #. type: cindex
  590. #: bashref.texi:259
  591. #, no-wrap
  592. msgid "operator, shell"
  593. msgstr ""
  594. #. type: table
  595. #: bashref.texi:263
  596. msgid ""
  597. "A @code{control operator} or a @code{redirection operator}. "
  598. "@xref{Redirections}, for a list of redirection operators. Operators contain "
  599. "at least one unquoted @code{metacharacter}."
  600. msgstr ""
  601. #. type: cindex
  602. #: bashref.texi:264 bashref.texi:265
  603. #, no-wrap
  604. msgid "process group"
  605. msgstr ""
  606. #. type: table
  607. #: bashref.texi:268
  608. msgid ""
  609. "A collection of related processes each having the same process group @sc{id}."
  610. msgstr ""
  611. #. type: cindex
  612. #: bashref.texi:269 bashref.texi:270
  613. #, no-wrap
  614. msgid "process group ID"
  615. msgstr ""
  616. #. type: table
  617. #: bashref.texi:273
  618. msgid ""
  619. "A unique identifier that represents a @code{process group} during its "
  620. "lifetime."
  621. msgstr ""
  622. #. type: cindex
  623. #: bashref.texi:274 bashref.texi:275
  624. #, no-wrap
  625. msgid "reserved word"
  626. msgstr ""
  627. #. type: table
  628. #: bashref.texi:279
  629. msgid ""
  630. "A @code{word} that has a special meaning to the shell. Most reserved words "
  631. "introduce shell flow control constructs, such as @code{for} and @code{while}."
  632. msgstr ""
  633. #. type: cindex
  634. #: bashref.texi:280 bashref.texi:281
  635. #, no-wrap
  636. msgid "return status"
  637. msgstr ""
  638. #. type: table
  639. #: bashref.texi:283
  640. msgid "A synonym for @code{exit status}."
  641. msgstr ""
  642. #. type: cindex
  643. #: bashref.texi:284 bashref.texi:285
  644. #, no-wrap
  645. msgid "signal"
  646. msgstr ""
  647. #. type: table
  648. #: bashref.texi:288
  649. msgid ""
  650. "A mechanism by which a process may be notified by the kernel of an event "
  651. "occurring in the system."
  652. msgstr ""
  653. #. type: cindex
  654. #: bashref.texi:289 bashref.texi:290 bashref.texi:5348
  655. #, no-wrap
  656. msgid "special builtin"
  657. msgstr ""
  658. #. type: table
  659. #: bashref.texi:293
  660. msgid ""
  661. "A shell builtin command that has been classified as special by the "
  662. "@sc{posix} standard."
  663. msgstr ""
  664. #. type: cindex
  665. #: bashref.texi:294 bashref.texi:295
  666. #, no-wrap
  667. msgid "token"
  668. msgstr ""
  669. #. type: table
  670. #: bashref.texi:298
  671. msgid ""
  672. "A sequence of characters considered a single unit by the shell. It is "
  673. "either a @code{word} or an @code{operator}."
  674. msgstr ""
  675. #. type: cindex
  676. #: bashref.texi:299 bashref.texi:300
  677. #, no-wrap
  678. msgid "word"
  679. msgstr ""
  680. #. type: table
  681. #: bashref.texi:303
  682. msgid ""
  683. "A sequence of characters treated as a unit by the shell. Words may not "
  684. "include unquoted @code{metacharacters}."
  685. msgstr ""
  686. #. type: cindex
  687. #: bashref.texi:307
  688. #, no-wrap
  689. msgid "Bourne shell"
  690. msgstr ""
  691. #. type: Plain text
  692. #: bashref.texi:315
  693. msgid ""
  694. "Bash is an acronym for @samp{Bourne-Again SHell}. The Bourne shell is the "
  695. "traditional Unix shell originally written by Stephen Bourne. All of the "
  696. "Bourne shell builtin commands are available in Bash, The rules for "
  697. "evaluation and quoting are taken from the @sc{posix} specification for the "
  698. "`standard' Unix shell."
  699. msgstr ""
  700. #. type: Plain text
  701. #: bashref.texi:321
  702. msgid ""
  703. "This chapter briefly summarizes the shell's `building blocks': commands, "
  704. "control structures, shell functions, shell @i{parameters}, shell expansions, "
  705. "@i{redirections}, which are a way to direct input and output from and to "
  706. "named files, and how the shell executes commands."
  707. msgstr ""
  708. #. type: section
  709. #: bashref.texi:332 bashref.texi:334 bashref.texi:335
  710. #, no-wrap
  711. msgid "Shell Syntax"
  712. msgstr ""
  713. #. type: menuentry
  714. #: bashref.texi:332
  715. msgid "What your input means to the shell."
  716. msgstr ""
  717. #. type: section
  718. #: bashref.texi:332 bashref.texi:570 bashref.texi:571
  719. #, no-wrap
  720. msgid "Shell Commands"
  721. msgstr ""
  722. #. type: menuentry
  723. #: bashref.texi:332
  724. msgid "The types of commands you can use."
  725. msgstr ""
  726. #. type: section
  727. #: bashref.texi:332 bashref.texi:1323 bashref.texi:1324
  728. #, no-wrap
  729. msgid "Shell Functions"
  730. msgstr ""
  731. #. type: menuentry
  732. #: bashref.texi:332
  733. msgid "Grouping commands by name."
  734. msgstr ""
  735. #. type: section
  736. #: bashref.texi:332 bashref.texi:1450 bashref.texi:1451
  737. #, no-wrap
  738. msgid "Shell Parameters"
  739. msgstr ""
  740. #. type: menuentry
  741. #: bashref.texi:332
  742. msgid "How the shell stores values."
  743. msgstr ""
  744. #. type: section
  745. #: bashref.texi:332 bashref.texi:1661 bashref.texi:1662
  746. #, no-wrap
  747. msgid "Shell Expansions"
  748. msgstr ""
  749. #. type: menuentry
  750. #: bashref.texi:332
  751. msgid "How Bash expands parameters and the various expansions available."
  752. msgstr ""
  753. #. type: section
  754. #: bashref.texi:332 bashref.texi:2543 bashref.texi:2544
  755. #, no-wrap
  756. msgid "Redirections"
  757. msgstr ""
  758. #. type: menuentry
  759. #: bashref.texi:332
  760. msgid "A way to control where input and output go."
  761. msgstr ""
  762. #. type: section
  763. #: bashref.texi:332 bashref.texi:2832 bashref.texi:2833
  764. #, no-wrap
  765. msgid "Executing Commands"
  766. msgstr ""
  767. #. type: menuentry
  768. #: bashref.texi:332
  769. msgid "What happens when you run a command."
  770. msgstr ""
  771. #. type: section
  772. #: bashref.texi:332 bashref.texi:3168 bashref.texi:3169
  773. #, no-wrap
  774. msgid "Shell Scripts"
  775. msgstr ""
  776. #. type: menuentry
  777. #: bashref.texi:332
  778. msgid "Executing files of shell commands."
  779. msgstr ""
  780. #. type: subsection
  781. #: bashref.texi:340 bashref.texi:357 bashref.texi:358
  782. #, no-wrap
  783. msgid "Shell Operation"
  784. msgstr ""
  785. #. type: menuentry
  786. #: bashref.texi:340
  787. msgid "The basic operation of the shell."
  788. msgstr ""
  789. #. type: subsection
  790. #: bashref.texi:340 bashref.texi:398 bashref.texi:399
  791. #, no-wrap
  792. msgid "Quoting"
  793. msgstr ""
  794. #. type: menuentry
  795. #: bashref.texi:340
  796. msgid "How to remove the special meaning from characters."
  797. msgstr ""
  798. #. type: subsection
  799. #: bashref.texi:340 bashref.texi:555 bashref.texi:556
  800. #, no-wrap
  801. msgid "Comments"
  802. msgstr ""
  803. #. type: menuentry
  804. #: bashref.texi:340
  805. msgid "How to specify comments."
  806. msgstr ""
  807. #. type: Plain text
  808. #: bashref.texi:346
  809. msgid ""
  810. "When the shell reads input, it proceeds through a sequence of operations. "
  811. "If the input indicates the beginning of a comment, the shell ignores the "
  812. "comment symbol (@samp{#}), and the rest of that line."
  813. msgstr ""
  814. #. type: Plain text
  815. #: bashref.texi:350
  816. msgid ""
  817. "Otherwise, roughly speaking, the shell reads its input and divides the input "
  818. "into words and operators, employing the quoting rules to select which "
  819. "meanings to assign various words and characters."
  820. msgstr ""
  821. #. type: Plain text
  822. #: bashref.texi:356
  823. msgid ""
  824. "The shell then parses these tokens into commands and other constructs, "
  825. "removes the special meaning of certain words or characters, expands others, "
  826. "redirects input and output as needed, executes the specified command, waits "
  827. "for the command's exit status, and makes that exit status available for "
  828. "further inspection or processing."
  829. msgstr ""
  830. #. type: Plain text
  831. #: bashref.texi:363
  832. msgid ""
  833. "The following is a brief description of the shell's operation when it reads "
  834. "and executes a command. Basically, the shell does the following:"
  835. msgstr ""
  836. #. type: enumerate
  837. #: bashref.texi:369
  838. msgid ""
  839. "Reads its input from a file (@pxref{Shell Scripts}), from a string supplied "
  840. "as an argument to the @option{-c} invocation option (@pxref{Invoking Bash}), "
  841. "or from the user's terminal."
  842. msgstr ""
  843. #. type: enumerate
  844. #: bashref.texi:375
  845. msgid ""
  846. "Breaks the input into words and operators, obeying the quoting rules "
  847. "described in @ref{Quoting}. These tokens are separated by "
  848. "@code{metacharacters}. Alias expansion is performed by this step "
  849. "(@pxref{Aliases})."
  850. msgstr ""
  851. #. type: enumerate
  852. #: bashref.texi:379
  853. msgid ""
  854. "Parses the tokens into simple and compound commands (@pxref{Shell Commands})."
  855. msgstr ""
  856. #. type: enumerate
  857. #: bashref.texi:384
  858. msgid ""
  859. "Performs the various shell expansions (@pxref{Shell Expansions}), breaking "
  860. "the expanded tokens into lists of filenames (@pxref{Filename Expansion}) "
  861. "and commands and arguments."
  862. msgstr ""
  863. #. type: enumerate
  864. #: bashref.texi:388
  865. msgid ""
  866. "Performs any necessary redirections (@pxref{Redirections}) and removes the "
  867. "redirection operators and their operands from the argument list."
  868. msgstr ""
  869. #. type: enumerate
  870. #: bashref.texi:391
  871. msgid "Executes the command (@pxref{Executing Commands})."
  872. msgstr ""
  873. #. type: enumerate
  874. #: bashref.texi:395
  875. msgid ""
  876. "Optionally waits for the command to complete and collects its exit status "
  877. "(@pxref{Exit Status})."
  878. msgstr ""
  879. #. type: cindex
  880. #: bashref.texi:400
  881. #, no-wrap
  882. msgid "quoting"
  883. msgstr ""
  884. #. type: subsubsection
  885. #: bashref.texi:410 bashref.texi:430 bashref.texi:431
  886. #, no-wrap
  887. msgid "Escape Character"
  888. msgstr ""
  889. #. type: menuentry
  890. #: bashref.texi:410
  891. msgid "How to remove the special meaning from a single character."
  892. msgstr ""
  893. #. type: subsubsection
  894. #: bashref.texi:410 bashref.texi:439 bashref.texi:440
  895. #, no-wrap
  896. msgid "Single Quotes"
  897. msgstr ""
  898. #. type: menuentry
  899. #: bashref.texi:410
  900. msgid "How to inhibit all interpretation of a sequence of characters."
  901. msgstr ""
  902. #. type: subsubsection
  903. #: bashref.texi:410 bashref.texi:446 bashref.texi:447
  904. #, no-wrap
  905. msgid "Double Quotes"
  906. msgstr ""
  907. #. type: menuentry
  908. #: bashref.texi:410
  909. msgid "How to suppress most of the interpretation of a sequence of characters."
  910. msgstr ""
  911. #. type: subsubsection
  912. #: bashref.texi:410 bashref.texi:474 bashref.texi:475
  913. #, no-wrap
  914. msgid "ANSI-C Quoting"
  915. msgstr ""
  916. #. type: menuentry
  917. #: bashref.texi:410
  918. msgid "How to expand ANSI-C sequences in quoted strings."
  919. msgstr ""
  920. #. type: node
  921. #: bashref.texi:410 bashref.texi:529
  922. #, no-wrap
  923. msgid "Locale Translation"
  924. msgstr ""
  925. #. type: menuentry
  926. #: bashref.texi:410
  927. msgid "How to translate strings into different languages."
  928. msgstr ""
  929. #. type: Plain text
  930. #: bashref.texi:417
  931. msgid ""
  932. "Quoting is used to remove the special meaning of certain characters or words "
  933. "to the shell. Quoting can be used to disable special treatment for special "
  934. "characters, to prevent reserved words from being recognized as such, and to "
  935. "prevent parameter expansion."
  936. msgstr ""
  937. #. type: Plain text
  938. #: bashref.texi:426
  939. msgid ""
  940. "Each of the shell metacharacters (@pxref{Definitions}) has special meaning "
  941. "to the shell and must be quoted if it is to represent itself. When the "
  942. "command history expansion facilities are being used (@pxref{History "
  943. "Interaction}), the @var{history expansion} character, usually @samp{!}, must "
  944. "be quoted to prevent history expansion. @xref{Bash History Facilities}, for "
  945. "more details concerning history expansion."
  946. msgstr ""
  947. #. type: Plain text
  948. #: bashref.texi:429
  949. msgid ""
  950. "There are three quoting mechanisms: the @var{escape character}, single "
  951. "quotes, and double quotes."
  952. msgstr ""
  953. #. type: Plain text
  954. #: bashref.texi:438
  955. msgid ""
  956. "A non-quoted backslash @samp{\\} is the Bash escape character. It preserves "
  957. "the literal value of the next character that follows, with the exception of "
  958. "@code{newline}. If a @code{\\newline} pair appears, and the backslash "
  959. "itself is not quoted, the @code{\\newline} is treated as a line continuation "
  960. "(that is, it is removed from the input stream and effectively ignored)."
  961. msgstr ""
  962. #. type: Plain text
  963. #: bashref.texi:445
  964. msgid ""
  965. "Enclosing characters in single quotes (@samp{'}) preserves the literal value "
  966. "of each character within the quotes. A single quote may not occur between "
  967. "single quotes, even when preceded by a backslash."
  968. msgstr ""
  969. #. type: Plain text
  970. #: bashref.texi:470
  971. msgid ""
  972. "Enclosing characters in double quotes (@samp{\"}) preserves the literal "
  973. "value of all characters within the quotes, with the exception of @samp{$}, "
  974. "@samp{`}, @samp{\\}, and, when history expansion is enabled, @samp{!}. When "
  975. "the shell is in @sc{posix} mode (@pxref{Bash POSIX Mode}), the @samp{!} has "
  976. "no special meaning within double quotes, even when history expansion is "
  977. "enabled. The characters @samp{$} and @samp{`} retain their special meaning "
  978. "within double quotes (@pxref{Shell Expansions}). The backslash retains its "
  979. "special meaning only when followed by one of the following characters: "
  980. "@samp{$}, @samp{`}, @samp{\"}, @samp{\\}, or @code{newline}. Within double "
  981. "quotes, backslashes that are followed by one of these characters are "
  982. "removed. Backslashes preceding characters without a special meaning are "
  983. "left unmodified. A double quote may be quoted within double quotes by "
  984. "preceding it with a backslash. If enabled, history expansion will be "
  985. "performed unless an @samp{!} appearing in double quotes is escaped using a "
  986. "backslash. The backslash preceding the @samp{!} is not removed."
  987. msgstr ""
  988. #. type: Plain text
  989. #: bashref.texi:473
  990. msgid ""
  991. "The special parameters @samp{*} and @samp{@@} have special meaning when in "
  992. "double quotes (@pxref{Shell Parameter Expansion})."
  993. msgstr ""
  994. #. type: cindex
  995. #: bashref.texi:476
  996. #, no-wrap
  997. msgid "quoting, ANSI"
  998. msgstr ""
  999. #. type: Plain text
  1000. #: bashref.texi:482
  1001. msgid ""
  1002. "Words of the form @code{$'@var{string}'} are treated specially. The word "
  1003. "expands to @var{string}, with backslash-escaped characters replaced as "
  1004. "specified by the ANSI C standard. Backslash escape sequences, if present, "
  1005. "are decoded as follows:"
  1006. msgstr ""
  1007. #. type: item
  1008. #: bashref.texi:484 bashref.texi:4132 bashref.texi:7192
  1009. #, no-wrap
  1010. msgid "\\a"
  1011. msgstr ""
  1012. #. type: table
  1013. #: bashref.texi:486 bashref.texi:4134
  1014. msgid "alert (bell)"
  1015. msgstr ""
  1016. #. type: item
  1017. #: bashref.texi:486 bashref.texi:4134
  1018. #, no-wrap
  1019. msgid "\\b"
  1020. msgstr ""
  1021. #. type: table
  1022. #: bashref.texi:488 bashref.texi:4136
  1023. msgid "backspace"
  1024. msgstr ""
  1025. #. type: item
  1026. #: bashref.texi:488 bashref.texi:4138 bashref.texi:7200
  1027. #, no-wrap
  1028. msgid "\\e"
  1029. msgstr ""
  1030. #. type: itemx
  1031. #: bashref.texi:489 bashref.texi:4139
  1032. #, no-wrap
  1033. msgid "\\E"
  1034. msgstr ""
  1035. #. type: table
  1036. #: bashref.texi:491
  1037. msgid "an escape character (not ANSI C)"
  1038. msgstr ""
  1039. #. type: item
  1040. #: bashref.texi:491 bashref.texi:4141
  1041. #, no-wrap
  1042. msgid "\\f"
  1043. msgstr ""
  1044. #. type: table
  1045. #: bashref.texi:493 bashref.texi:4143
  1046. msgid "form feed"
  1047. msgstr ""
  1048. #. type: item
  1049. #: bashref.texi:493 bashref.texi:4143 bashref.texi:7210
  1050. #, no-wrap
  1051. msgid "\\n"
  1052. msgstr ""
  1053. #. type: table
  1054. #: bashref.texi:495
  1055. msgid "newline"
  1056. msgstr ""
  1057. #. type: item
  1058. #: bashref.texi:495 bashref.texi:4145 bashref.texi:7212
  1059. #, no-wrap
  1060. msgid "\\r"
  1061. msgstr ""
  1062. #. type: table
  1063. #: bashref.texi:497 bashref.texi:4147
  1064. msgid "carriage return"
  1065. msgstr ""
  1066. #. type: item
  1067. #: bashref.texi:497 bashref.texi:4147 bashref.texi:7217
  1068. #, no-wrap
  1069. msgid "\\t"
  1070. msgstr ""
  1071. #. type: table
  1072. #: bashref.texi:499 bashref.texi:4149
  1073. msgid "horizontal tab"
  1074. msgstr ""
  1075. #. type: item
  1076. #: bashref.texi:499 bashref.texi:4149 bashref.texi:7227
  1077. #, no-wrap
  1078. msgid "\\v"
  1079. msgstr ""
  1080. #. type: table
  1081. #: bashref.texi:501 bashref.texi:4151
  1082. msgid "vertical tab"
  1083. msgstr ""
  1084. #. type: item
  1085. #: bashref.texi:501 bashref.texi:4151 bashref.texi:7244
  1086. #, no-wrap
  1087. msgid "\\\\"
  1088. msgstr ""
  1089. #. type: table
  1090. #: bashref.texi:503 bashref.texi:4153
  1091. msgid "backslash"
  1092. msgstr ""
  1093. #. type: item
  1094. #: bashref.texi:503
  1095. #, no-wrap
  1096. msgid "\\'"
  1097. msgstr ""
  1098. #. type: table
  1099. #: bashref.texi:505
  1100. msgid "single quote"
  1101. msgstr ""
  1102. #. type: item
  1103. #: bashref.texi:505
  1104. #, no-wrap
  1105. msgid "\\\""
  1106. msgstr ""
  1107. #. type: table
  1108. #: bashref.texi:507
  1109. msgid "double quote"
  1110. msgstr ""
  1111. #. type: item
  1112. #: bashref.texi:507
  1113. #, no-wrap
  1114. msgid "\\?"
  1115. msgstr ""
  1116. #. type: table
  1117. #: bashref.texi:509
  1118. msgid "question mark"
  1119. msgstr ""
  1120. #. type: item
  1121. #: bashref.texi:509 bashref.texi:7242
  1122. #, no-wrap
  1123. msgid "\\@var{nnn}"
  1124. msgstr ""
  1125. #. type: table
  1126. #: bashref.texi:512
  1127. msgid ""
  1128. "the eight-bit character whose value is the octal value @var{nnn} (one to "
  1129. "three digits)"
  1130. msgstr ""
  1131. #. type: item
  1132. #: bashref.texi:512 bashref.texi:4156
  1133. #, no-wrap
  1134. msgid "\\x@var{HH}"
  1135. msgstr ""
  1136. #. type: table
  1137. #: bashref.texi:515 bashref.texi:4159
  1138. msgid ""
  1139. "the eight-bit character whose value is the hexadecimal value @var{HH} (one "
  1140. "or two hex digits)"
  1141. msgstr ""
  1142. #. type: item
  1143. #: bashref.texi:515 bashref.texi:4159
  1144. #, no-wrap
  1145. msgid "\\u@var{HHHH}"
  1146. msgstr ""
  1147. #. type: table
  1148. #: bashref.texi:518 bashref.texi:4162
  1149. msgid ""
  1150. "the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value "
  1151. "@var{HHHH} (one to four hex digits)"
  1152. msgstr ""
  1153. #. type: item
  1154. #: bashref.texi:518 bashref.texi:4162
  1155. #, no-wrap
  1156. msgid "\\U@var{HHHHHHHH}"
  1157. msgstr ""
  1158. #. type: table
  1159. #: bashref.texi:521 bashref.texi:4165
  1160. msgid ""
  1161. "the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value "
  1162. "@var{HHHHHHHH} (one to eight hex digits)"
  1163. msgstr ""
  1164. #. type: item
  1165. #: bashref.texi:521
  1166. #, no-wrap
  1167. msgid "\\c@var{x}"
  1168. msgstr ""
  1169. #. type: table
  1170. #: bashref.texi:523
  1171. msgid "a control-@var{x} character"
  1172. msgstr ""
  1173. #. type: Plain text
  1174. #: bashref.texi:528
  1175. msgid ""
  1176. "The expanded result is single-quoted, as if the dollar sign had not been "
  1177. "present."
  1178. msgstr ""
  1179. #. type: subsubsection
  1180. #: bashref.texi:530
  1181. #, no-wrap
  1182. msgid "Locale-Specific Translation"
  1183. msgstr ""
  1184. #. type: cindex
  1185. #: bashref.texi:531
  1186. #, no-wrap
  1187. msgid "localization"
  1188. msgstr ""
  1189. #. type: cindex
  1190. #: bashref.texi:532
  1191. #, no-wrap
  1192. msgid "internationalization"
  1193. msgstr ""
  1194. #. type: cindex
  1195. #: bashref.texi:533
  1196. #, no-wrap
  1197. msgid "native languages"
  1198. msgstr ""
  1199. #. type: cindex
  1200. #: bashref.texi:534
  1201. #, no-wrap
  1202. msgid "translation, native languages"
  1203. msgstr ""
  1204. #. type: Plain text
  1205. #: bashref.texi:542
  1206. msgid ""
  1207. "A double-quoted string preceded by a dollar sign (@samp{$}) will cause the "
  1208. "string to be translated according to the current locale. If the current "
  1209. "locale is @code{C} or @code{POSIX}, the dollar sign is ignored. If the "
  1210. "string is translated and replaced, the replacement is double-quoted."
  1211. msgstr ""
  1212. #. type: item
  1213. #: bashref.texi:543 bashref.texi:5947
  1214. #, no-wrap
  1215. msgid "LC_MESSAGES"
  1216. msgstr ""
  1217. #. type: vindex
  1218. #: bashref.texi:544
  1219. #, no-wrap
  1220. msgid "TEXTDOMAIN"
  1221. msgstr ""
  1222. #. type: vindex
  1223. #: bashref.texi:545
  1224. #, no-wrap
  1225. msgid "TEXTDOMAINDIR"
  1226. msgstr ""
  1227. #. type: Plain text
  1228. #: bashref.texi:554
  1229. msgid ""
  1230. "Some systems use the message catalog selected by the @env{LC_MESSAGES} shell "
  1231. "variable. Others create the name of the message catalog from the value of "
  1232. "the @env{TEXTDOMAIN} shell variable, possibly adding a suffix of @samp{."
  1233. "mo}. If you use the @env{TEXTDOMAIN} variable, you may need to set the "
  1234. "@env{TEXTDOMAINDIR} variable to the location of the message catalog files. "
  1235. "Still others use both variables in this fashion: @env{TEXTDOMAINDIR}/"
  1236. "@env{LC_MESSAGES}/LC_MESSAGES/@env{TEXTDOMAIN}.mo."
  1237. msgstr ""
  1238. #. type: cindex
  1239. #: bashref.texi:557
  1240. #, no-wrap
  1241. msgid "comments, shell"
  1242. msgstr ""
  1243. #. type: Plain text
  1244. #: bashref.texi:569
  1245. msgid ""
  1246. "In a non-interactive shell, or an interactive shell in which the "
  1247. "@code{interactive_comments} option to the @code{shopt} builtin is enabled "
  1248. "(@pxref{The Shopt Builtin}), a word beginning with @samp{#} causes that word "
  1249. "and all remaining characters on that line to be ignored. An interactive "
  1250. "shell without the @code{interactive_comments} option enabled does not allow "
  1251. "comments. The @code{interactive_comments} option is on by default in "
  1252. "interactive shells. @xref{Interactive Shells}, for a description of what "
  1253. "makes a shell interactive."
  1254. msgstr ""
  1255. #. type: cindex
  1256. #: bashref.texi:572
  1257. #, no-wrap
  1258. msgid "commands, shell"
  1259. msgstr ""
  1260. #. type: Plain text
  1261. #: bashref.texi:576
  1262. msgid ""
  1263. "A simple shell command such as @code{echo a b c} consists of the command "
  1264. "itself followed by arguments, separated by spaces."
  1265. msgstr ""
  1266. #. type: Plain text
  1267. #: bashref.texi:581
  1268. msgid ""
  1269. "More complex shell commands are composed of simple commands arranged "
  1270. "together in a variety of ways: in a pipeline in which the output of one "
  1271. "command becomes the input of a second, in a loop or conditional construct, "
  1272. "or in some other grouping."
  1273. msgstr ""
  1274. #. type: subsection
  1275. #: bashref.texi:590 bashref.texi:592 bashref.texi:593
  1276. #, no-wrap
  1277. msgid "Simple Commands"
  1278. msgstr ""
  1279. #. type: menuentry
  1280. #: bashref.texi:590
  1281. msgid "The most common type of command."
  1282. msgstr ""
  1283. #. type: subsection
  1284. #: bashref.texi:590 bashref.texi:607 bashref.texi:608
  1285. #, no-wrap
  1286. msgid "Pipelines"
  1287. msgstr ""
  1288. #. type: menuentry
  1289. #: bashref.texi:590
  1290. msgid "Connecting the input and output of several commands."
  1291. msgstr ""
  1292. #. type: node
  1293. #: bashref.texi:590 bashref.texi:676
  1294. #, no-wrap
  1295. msgid "Lists"
  1296. msgstr ""
  1297. #. type: menuentry
  1298. #: bashref.texi:590
  1299. msgid "How to execute commands sequentially."
  1300. msgstr ""
  1301. #. type: subsection
  1302. #: bashref.texi:590 bashref.texi:732 bashref.texi:733
  1303. #, no-wrap
  1304. msgid "Compound Commands"
  1305. msgstr ""
  1306. #. type: menuentry
  1307. #: bashref.texi:590
  1308. msgid "Shell commands for control flow."
  1309. msgstr ""
  1310. #. type: subsection
  1311. #: bashref.texi:590 bashref.texi:1165 bashref.texi:1166
  1312. #, no-wrap
  1313. msgid "Coprocesses"
  1314. msgstr ""
  1315. #. type: menuentry
  1316. #: bashref.texi:590
  1317. msgid "Two-way communication between commands."
  1318. msgstr ""
  1319. #. type: subsection
  1320. #: bashref.texi:590 bashref.texi:1211 bashref.texi:1212
  1321. #, no-wrap
  1322. msgid "GNU Parallel"
  1323. msgstr ""
  1324. #. type: menuentry
  1325. #: bashref.texi:590
  1326. msgid "Running commands in parallel."
  1327. msgstr ""
  1328. #. type: cindex
  1329. #: bashref.texi:594
  1330. #, no-wrap
  1331. msgid "commands, simple"
  1332. msgstr ""
  1333. #. type: Plain text
  1334. #: bashref.texi:601
  1335. msgid ""
  1336. "A simple command is the kind of command encountered most often. It's just a "
  1337. "sequence of words separated by @code{blank}s, terminated by one of the "
  1338. "shell's control operators (@pxref{Definitions}). The first word generally "
  1339. "specifies a command to be executed, with the rest of the words being that "
  1340. "command's arguments."
  1341. msgstr ""
  1342. #. type: Plain text
  1343. #: bashref.texi:606
  1344. msgid ""
  1345. "The return status (@pxref{Exit Status}) of a simple command is its exit "
  1346. "status as provided by the @sc{posix} 1003.1 @code{waitpid} function, or "
  1347. "128+@var{n} if the command was terminated by signal @var{n}."
  1348. msgstr ""
  1349. #. type: cindex
  1350. #: bashref.texi:609
  1351. #, no-wrap
  1352. msgid "pipeline"
  1353. msgstr ""
  1354. #. type: cindex
  1355. #: bashref.texi:610
  1356. #, no-wrap
  1357. msgid "commands, pipelines"
  1358. msgstr ""
  1359. #. type: Plain text
  1360. #: bashref.texi:614
  1361. msgid ""
  1362. "A @code{pipeline} is a sequence of one or more commands separated by one of "
  1363. "the control operators @samp{|} or @samp{|&}."
  1364. msgstr ""
  1365. #. type: rwindex
  1366. #: bashref.texi:615
  1367. #, no-wrap
  1368. msgid "time"
  1369. msgstr ""
  1370. #. type: item
  1371. #: bashref.texi:616 bashref.texi:1632
  1372. #, no-wrap
  1373. msgid "!"
  1374. msgstr ""
  1375. #. type: cindex
  1376. #: bashref.texi:617
  1377. #, no-wrap
  1378. msgid "command timing"
  1379. msgstr ""
  1380. #. type: Plain text
  1381. #: bashref.texi:619
  1382. msgid "The format for a pipeline is"
  1383. msgstr ""
  1384. #. type: example
  1385. #: bashref.texi:621
  1386. #, no-wrap
  1387. msgid "[time [-p]] [!] @var{command1} [ | or |& @var{command2} ] @dots{}\n"
  1388. msgstr ""
  1389. #. type: Plain text
  1390. #: bashref.texi:629
  1391. msgid ""
  1392. "The output of each command in the pipeline is connected via a pipe to the "
  1393. "input of the next command. That is, each command reads the previous "
  1394. "command's output. This connection is performed before any redirections "
  1395. "specified by the command."
  1396. msgstr ""
  1397. #. type: Plain text
  1398. #: bashref.texi:636
  1399. msgid ""
  1400. "If @samp{|&} is used, @var{command1}'s standard error, in addition to its "
  1401. "standard output, is connected to @var{command2}'s standard input through the "
  1402. "pipe; it is shorthand for @code{2>&1 |}. This implicit redirection of the "
  1403. "standard error to the standard output is performed after any redirections "
  1404. "specified by the command."
  1405. msgstr ""
  1406. #. type: Plain text
  1407. #: bashref.texi:652
  1408. msgid ""
  1409. "The reserved word @code{time} causes timing statistics to be printed for the "
  1410. "pipeline once it finishes. The statistics currently consist of elapsed "
  1411. "(wall-clock) time and user and system time consumed by the command's "
  1412. "execution. The @option{-p} option changes the output format to that "
  1413. "specified by @sc{posix}. When the shell is in @sc{posix} mode (@pxref{Bash "
  1414. "POSIX Mode}), it does not recognize @code{time} as a reserved word if the "
  1415. "next token begins with a @samp{-}. The @env{TIMEFORMAT} variable may be set "
  1416. "to a format string that specifies how the timing information should be "
  1417. "displayed. @xref{Bash Variables}, for a description of the available "
  1418. "formats. The use of @code{time} as a reserved word permits the timing of "
  1419. "shell builtins, shell functions, and pipelines. An external @code{time} "
  1420. "command cannot time these easily."
  1421. msgstr ""
  1422. #. type: Plain text
  1423. #: bashref.texi:658
  1424. msgid ""
  1425. "When the shell is in @sc{posix} mode (@pxref{Bash POSIX Mode}), @code{time} "
  1426. "may be followed by a newline. In this case, the shell displays the total "
  1427. "user and system time consumed by the shell and its children. The "
  1428. "@env{TIMEFORMAT} variable may be used to specify the format of the time "
  1429. "information."
  1430. msgstr ""
  1431. #. type: Plain text
  1432. #: bashref.texi:661
  1433. msgid ""
  1434. "If the pipeline is not executed asynchronously (@pxref{Lists}), the shell "
  1435. "waits for all commands in the pipeline to complete."
  1436. msgstr ""
  1437. #. type: Plain text
  1438. #: bashref.texi:675
  1439. msgid ""
  1440. "Each command in a pipeline is executed in its own subshell (@pxref{Command "
  1441. "Execution Environment}). The exit status of a pipeline is the exit status "
  1442. "of the last command in the pipeline, unless the @code{pipefail} option is "
  1443. "enabled (@pxref{The Set Builtin}). If @code{pipefail} is enabled, the "
  1444. "pipeline's return status is the value of the last (rightmost) command to "
  1445. "exit with a non-zero status, or zero if all commands exit successfully. If "
  1446. "the reserved word @samp{!} precedes the pipeline, the exit status is the "
  1447. "logical negation of the exit status as described above. The shell waits for "
  1448. "all commands in the pipeline to terminate before returning a value."
  1449. msgstr ""
  1450. #. type: subsection
  1451. #: bashref.texi:677
  1452. #, no-wrap
  1453. msgid "Lists of Commands"
  1454. msgstr ""
  1455. #. type: cindex
  1456. #: bashref.texi:678
  1457. #, no-wrap
  1458. msgid "commands, lists"
  1459. msgstr ""
  1460. #. type: Plain text
  1461. #: bashref.texi:684
  1462. msgid ""
  1463. "A @code{list} is a sequence of one or more pipelines separated by one of the "
  1464. "operators @samp{;}, @samp{&}, @samp{&&}, or @samp{||}, and optionally "
  1465. "terminated by one of @samp{;}, @samp{&}, or a @code{newline}."
  1466. msgstr ""
  1467. #. type: Plain text
  1468. #: bashref.texi:688
  1469. msgid ""
  1470. "Of these list operators, @samp{&&} and @samp{||} have equal precedence, "
  1471. "followed by @samp{;} and @samp{&}, which have equal precedence."
  1472. msgstr ""
  1473. #. type: Plain text
  1474. #: bashref.texi:691
  1475. msgid ""
  1476. "A sequence of one or more newlines may appear in a @code{list} to delimit "
  1477. "commands, equivalent to a semicolon."
  1478. msgstr ""
  1479. #. type: Plain text
  1480. #: bashref.texi:700
  1481. msgid ""
  1482. "If a command is terminated by the control operator @samp{&}, the shell "
  1483. "executes the command asynchronously in a subshell. This is known as "
  1484. "executing the command in the @var{background}. The shell does not wait for "
  1485. "the command to finish, and the return status is 0 (true). When job control "
  1486. "is not active (@pxref{Job Control}), the standard input for asynchronous "
  1487. "commands, in the absence of any explicit redirections, is redirected from "
  1488. "@code{/dev/null}."
  1489. msgstr ""
  1490. #. type: Plain text
  1491. #: bashref.texi:704
  1492. msgid ""
  1493. "Commands separated by a @samp{;} are executed sequentially; the shell waits "
  1494. "for each command to terminate in turn. The return status is the exit status "
  1495. "of the last command executed."
  1496. msgstr ""
  1497. #. type: Plain text
  1498. #: bashref.texi:709
  1499. msgid ""
  1500. "@sc{and} and @sc{or} lists are sequences of one or more pipelines separated "
  1501. "by the control operators @samp{&&} and @samp{||}, respectively. @sc{and} "
  1502. "and @sc{or} lists are executed with left associativity."
  1503. msgstr ""
  1504. #. type: Plain text
  1505. #: bashref.texi:711
  1506. msgid "An @sc{and} list has the form"
  1507. msgstr ""
  1508. #. type: example
  1509. #: bashref.texi:713
  1510. #, no-wrap
  1511. msgid "@var{command1} && @var{command2}\n"
  1512. msgstr ""
  1513. #. type: Plain text
  1514. #: bashref.texi:718
  1515. msgid ""
  1516. "@var{command2} is executed if, and only if, @var{command1} returns an exit "
  1517. "status of zero."
  1518. msgstr ""
  1519. #. type: Plain text
  1520. #: bashref.texi:720
  1521. msgid "An @sc{or} list has the form"
  1522. msgstr ""
  1523. #. type: example
  1524. #: bashref.texi:722
  1525. #, no-wrap
  1526. msgid "@var{command1} || @var{command2}\n"
  1527. msgstr ""
  1528. #. type: Plain text
  1529. #: bashref.texi:727
  1530. msgid ""
  1531. "@var{command2} is executed if, and only if, @var{command1} returns a non-"
  1532. "zero exit status."
  1533. msgstr ""
  1534. #. type: Plain text
  1535. #: bashref.texi:731
  1536. msgid ""
  1537. "The return status of @sc{and} and @sc{or} lists is the exit status of the "
  1538. "last command executed in the list."
  1539. msgstr ""
  1540. #. type: cindex
  1541. #: bashref.texi:734
  1542. #, no-wrap
  1543. msgid "commands, compound"
  1544. msgstr ""
  1545. #. type: subsubsection
  1546. #: bashref.texi:740 bashref.texi:755 bashref.texi:756
  1547. #, no-wrap
  1548. msgid "Looping Constructs"
  1549. msgstr ""
  1550. #. type: menuentry
  1551. #: bashref.texi:740
  1552. msgid "Shell commands for iterative action."
  1553. msgstr ""
  1554. #. type: subsubsection
  1555. #: bashref.texi:740 bashref.texi:831 bashref.texi:832
  1556. #, no-wrap
  1557. msgid "Conditional Constructs"
  1558. msgstr ""
  1559. #. type: menuentry
  1560. #: bashref.texi:740
  1561. msgid "Shell commands for conditional execution."
  1562. msgstr ""
  1563. #. type: node
  1564. #: bashref.texi:740 bashref.texi:1121
  1565. #, no-wrap
  1566. msgid "Command Grouping"
  1567. msgstr ""
  1568. #. type: menuentry
  1569. #: bashref.texi:740
  1570. msgid "Ways to group commands."
  1571. msgstr ""
  1572. #. type: Plain text
  1573. #: bashref.texi:747
  1574. msgid ""
  1575. "Compound commands are the shell programming constructs. Each construct "
  1576. "begins with a reserved word or control operator and is terminated by a "
  1577. "corresponding reserved word or operator. Any redirections "
  1578. "(@pxref{Redirections}) associated with a compound command apply to all "
  1579. "commands within that compound command unless explicitly overridden."
  1580. msgstr ""
  1581. #. type: Plain text
  1582. #: bashref.texi:751
  1583. msgid ""
  1584. "In most cases a list of commands in a compound command's description may be "
  1585. "separated from the rest of the command by one or more newlines, and may be "
  1586. "followed by a newline in place of a semicolon."
  1587. msgstr ""
  1588. #. type: Plain text
  1589. #: bashref.texi:754
  1590. msgid ""
  1591. "Bash provides looping constructs, conditional commands, and mechanisms to "
  1592. "group commands and execute them as a unit."
  1593. msgstr ""
  1594. #. type: cindex
  1595. #: bashref.texi:757
  1596. #, no-wrap
  1597. msgid "commands, looping"
  1598. msgstr ""
  1599. #. type: Plain text
  1600. #: bashref.texi:760
  1601. msgid "Bash supports the following looping constructs."
  1602. msgstr ""
  1603. #. type: Plain text
  1604. #: bashref.texi:763
  1605. msgid ""
  1606. "Note that wherever a @samp{;} appears in the description of a command's "
  1607. "syntax, it may be replaced with one or more newlines."
  1608. msgstr ""
  1609. #. type: rwindex
  1610. #: bashref.texi:765 bashref.texi:766
  1611. #, no-wrap
  1612. msgid "until"
  1613. msgstr ""
  1614. #. type: rwindex
  1615. #: bashref.texi:767
  1616. #, no-wrap
  1617. msgid "do"
  1618. msgstr ""
  1619. #. type: rwindex
  1620. #: bashref.texi:768
  1621. #, no-wrap
  1622. msgid "done"
  1623. msgstr ""
  1624. #. type: table
  1625. #: bashref.texi:770
  1626. msgid "The syntax of the @code{until} command is:"
  1627. msgstr ""
  1628. #. type: example
  1629. #: bashref.texi:773
  1630. #, no-wrap
  1631. msgid "until @var{test-commands}; do @var{consequent-commands}; done\n"
  1632. msgstr ""
  1633. #. type: table
  1634. #: bashref.texi:779
  1635. msgid ""
  1636. "Execute @var{consequent-commands} as long as @var{test-commands} has an exit "
  1637. "status which is not zero. The return status is the exit status of the last "
  1638. "command executed in @var{consequent-commands}, or zero if none was executed."
  1639. msgstr ""
  1640. #. type: rwindex
  1641. #: bashref.texi:780 bashref.texi:781
  1642. #, no-wrap
  1643. msgid "while"
  1644. msgstr ""
  1645. #. type: table
  1646. #: bashref.texi:783
  1647. msgid "The syntax of the @code{while} command is:"
  1648. msgstr ""
  1649. #. type: example
  1650. #: bashref.texi:786
  1651. #, no-wrap
  1652. msgid "while @var{test-commands}; do @var{consequent-commands}; done\n"
  1653. msgstr ""
  1654. #. type: table
  1655. #: bashref.texi:792
  1656. msgid ""
  1657. "Execute @var{consequent-commands} as long as @var{test-commands} has an exit "
  1658. "status of zero. The return status is the exit status of the last command "
  1659. "executed in @var{consequent-commands}, or zero if none was executed."
  1660. msgstr ""
  1661. #. type: rwindex
  1662. #: bashref.texi:793 bashref.texi:794
  1663. #, no-wrap
  1664. msgid "for"
  1665. msgstr ""
  1666. #. type: table
  1667. #: bashref.texi:796
  1668. msgid "The syntax of the @code{for} command is:"
  1669. msgstr ""
  1670. #. type: example
  1671. #: bashref.texi:799
  1672. #, no-wrap
  1673. msgid "for @var{name} [ [in [@var{words} @dots{}] ] ; ] do @var{commands}; done\n"
  1674. msgstr ""
  1675. #. type: table
  1676. #: bashref.texi:810
  1677. msgid ""
  1678. "Expand @var{words}, and execute @var{commands} once for each member in the "
  1679. "resultant list, with @var{name} bound to the current member. If @samp{in "
  1680. "@var{words}} is not present, the @code{for} command executes the "
  1681. "@var{commands} once for each positional parameter that is set, as if "
  1682. "@samp{in \"$@@\"} had been specified (@pxref{Special Parameters}). The "
  1683. "return status is the exit status of the last command that executes. If "
  1684. "there are no items in the expansion of @var{words}, no commands are "
  1685. "executed, and the return status is zero."
  1686. msgstr ""
  1687. #. type: table
  1688. #: bashref.texi:812
  1689. msgid "An alternate form of the @code{for} command is also supported:"
  1690. msgstr ""
  1691. #. type: example
  1692. #: bashref.texi:815
  1693. #, no-wrap
  1694. msgid "for (( @var{expr1} ; @var{expr2} ; @var{expr3} )) ; do @var{commands} ; done\n"
  1695. msgstr ""
  1696. #. type: table
  1697. #: bashref.texi:826
  1698. msgid ""
  1699. "First, the arithmetic expression @var{expr1} is evaluated according to the "
  1700. "rules described below (@pxref{Shell Arithmetic}). The arithmetic expression "
  1701. "@var{expr2} is then evaluated repeatedly until it evaluates to zero. Each "
  1702. "time @var{expr2} evaluates to a non-zero value, @var{commands} are executed "
  1703. "and the arithmetic expression @var{expr3} is evaluated. If any expression "
  1704. "is omitted, it behaves as if it evaluates to 1. The return value is the "
  1705. "exit status of the last command in @var{commands} that is executed, or false "
  1706. "if any of the expressions is invalid."
  1707. msgstr ""
  1708. #. type: Plain text
  1709. #: bashref.texi:830
  1710. msgid ""
  1711. "The @code{break} and @code{continue} builtins (@pxref{Bourne Shell "
  1712. "Builtins}) may be used to control loop execution."
  1713. msgstr ""
  1714. #. type: cindex
  1715. #: bashref.texi:833
  1716. #, no-wrap
  1717. msgid "commands, conditional"
  1718. msgstr ""
  1719. #. type: rwindex
  1720. #: bashref.texi:836 bashref.texi:837
  1721. #, no-wrap
  1722. msgid "if"
  1723. msgstr ""
  1724. #. type: rwindex
  1725. #: bashref.texi:838
  1726. #, no-wrap
  1727. msgid "then"
  1728. msgstr ""
  1729. #. type: rwindex
  1730. #: bashref.texi:839
  1731. #, no-wrap
  1732. msgid "else"
  1733. msgstr ""
  1734. #. type: rwindex
  1735. #: bashref.texi:840
  1736. #, no-wrap
  1737. msgid "elif"
  1738. msgstr ""
  1739. #. type: rwindex
  1740. #: bashref.texi:841
  1741. #, no-wrap
  1742. msgid "fi"
  1743. msgstr ""
  1744. #. type: table
  1745. #: bashref.texi:843
  1746. msgid "The syntax of the @code{if} command is:"
  1747. msgstr ""
  1748. #. type: example
  1749. #: bashref.texi:851
  1750. #, no-wrap
  1751. msgid ""
  1752. "if @var{test-commands}; then\n"
  1753. " @var{consequent-commands};\n"
  1754. "[elif @var{more-test-commands}; then\n"
  1755. " @var{more-consequents};]\n"
  1756. "[else @var{alternate-consequents};]\n"
  1757. "fi\n"
  1758. msgstr ""
  1759. #. type: table
  1760. #: bashref.texi:864
  1761. msgid ""
  1762. "The @var{test-commands} list is executed, and if its return status is zero, "
  1763. "the @var{consequent-commands} list is executed. If @var{test-commands} "
  1764. "returns a non-zero status, each @code{elif} list is executed in turn, and if "
  1765. "its exit status is zero, the corresponding @var{more-consequents} is "
  1766. "executed and the command completes. If @samp{else @var{alternate-"
  1767. "consequents}} is present, and the final command in the final @code{if} or "
  1768. "@code{elif} clause has a non-zero exit status, then @var{alternate-"
  1769. "consequents} is executed. The return status is the exit status of the last "
  1770. "command executed, or zero if no condition tested true."
  1771. msgstr ""
  1772. #. type: rwindex
  1773. #: bashref.texi:865 bashref.texi:866
  1774. #, no-wrap
  1775. msgid "case"
  1776. msgstr ""
  1777. #. type: rwindex
  1778. #: bashref.texi:867
  1779. #, no-wrap
  1780. msgid "in"
  1781. msgstr ""
  1782. #. type: rwindex
  1783. #: bashref.texi:868
  1784. #, no-wrap
  1785. msgid "esac"
  1786. msgstr ""
  1787. #. type: table
  1788. #: bashref.texi:870
  1789. msgid "The syntax of the @code{case} command is:"
  1790. msgstr ""
  1791. #. type: example
  1792. #: bashref.texi:873
  1793. #, no-wrap
  1794. msgid "case @var{word} in [ [(] @var{pattern} [| @var{pattern}]@dots{}) @var{command-list} ;;]@dots{} esac\n"
  1795. msgstr ""
  1796. #. type: table
  1797. #: bashref.texi:885
  1798. msgid ""
  1799. "@code{case} will selectively execute the @var{command-list} corresponding to "
  1800. "the first @var{pattern} that matches @var{word}. If the @code{nocasematch} "
  1801. "shell option (see the description of @code{shopt} in @ref{The Shopt "
  1802. "Builtin}) is enabled, the match is performed without regard to the case of "
  1803. "alphabetic characters. The @samp{|} is used to separate multiple patterns, "
  1804. "and the @samp{)} operator terminates a pattern list. A list of patterns and "
  1805. "an associated command-list is known as a @var{clause}."
  1806. msgstr ""
  1807. #. type: table
  1808. #: bashref.texi:891
  1809. msgid ""
  1810. "Each clause must be terminated with @samp{;;}, @samp{;&}, or @samp{;;&}. "
  1811. "The @var{word} undergoes tilde expansion, parameter expansion, command "
  1812. "substitution, arithmetic expansion, and quote removal before matching is "
  1813. "attempted. Each @var{pattern} undergoes tilde expansion, parameter "
  1814. "expansion, command substitution, and arithmetic expansion."
  1815. msgstr ""
  1816. #. type: table
  1817. #: bashref.texi:898
  1818. msgid ""
  1819. "There may be an arbitrary number of @code{case} clauses, each terminated by "
  1820. "a @samp{;;}, @samp{;&}, or @samp{;;&}. The first pattern that matches "
  1821. "determines the command-list that is executed. It's a common idiom to use "
  1822. "@samp{*} as the final pattern to define the default case, since that pattern "
  1823. "will always match."
  1824. msgstr ""
  1825. #. type: table
  1826. #: bashref.texi:901
  1827. msgid ""
  1828. "Here is an example using @code{case} in a script that could be used to "
  1829. "describe one interesting feature of an animal:"
  1830. msgstr ""
  1831. #. type: example
  1832. #: bashref.texi:912
  1833. #, no-wrap
  1834. msgid ""
  1835. "echo -n \"Enter the name of an animal: \"\n"
  1836. "read ANIMAL\n"
  1837. "echo -n \"The $ANIMAL has \"\n"
  1838. "case $ANIMAL in\n"
  1839. " horse | dog | cat) echo -n \"four\";;\n"
  1840. " man | kangaroo ) echo -n \"two\";;\n"
  1841. " *) echo -n \"an unknown number of\";;\n"
  1842. "esac\n"
  1843. "echo \" legs.\"\n"
  1844. msgstr ""
  1845. #. type: table
  1846. #: bashref.texi:923
  1847. msgid ""
  1848. "If the @samp{;;} operator is used, no subsequent matches are attempted after "
  1849. "the first pattern match. Using @samp{;&} in place of @samp{;;} causes "
  1850. "execution to continue with the @var{command-list} associated with the next "
  1851. "clause, if any. Using @samp{;;&} in place of @samp{;;} causes the shell to "
  1852. "test the patterns in the next clause, if any, and execute any associated "
  1853. "@var{command-list} on a successful match."
  1854. msgstr ""
  1855. #. type: table
  1856. #: bashref.texi:926
  1857. msgid ""
  1858. "The return status is zero if no @var{pattern} is matched. Otherwise, the "
  1859. "return status is the exit status of the @var{command-list} executed."
  1860. msgstr ""
  1861. #. type: rwindex
  1862. #: bashref.texi:927 bashref.texi:928
  1863. #, no-wrap
  1864. msgid "select"
  1865. msgstr ""
  1866. #. type: table
  1867. #: bashref.texi:932
  1868. msgid ""
  1869. "The @code{select} construct allows the easy generation of menus. It has "
  1870. "almost the same syntax as the @code{for} command:"
  1871. msgstr ""
  1872. #. type: example
  1873. #: bashref.texi:935
  1874. #, no-wrap
  1875. msgid "select @var{name} [in @var{words} @dots{}]; do @var{commands}; done\n"
  1876. msgstr ""
  1877. #. type: table
  1878. #: bashref.texi:950
  1879. msgid ""
  1880. "The list of words following @code{in} is expanded, generating a list of "
  1881. "items. The set of expanded words is printed on the standard error output "
  1882. "stream, each preceded by a number. If the @samp{in @var{words}} is omitted, "
  1883. "the positional parameters are printed, as if @samp{in \"$@@\"} had been "
  1884. "specified. The @env{PS3} prompt is then displayed and a line is read from "
  1885. "the standard input. If the line consists of a number corresponding to one "
  1886. "of the displayed words, then the value of @var{name} is set to that word. "
  1887. "If the line is empty, the words and prompt are displayed again. If "
  1888. "@code{EOF} is read, the @code{select} command completes. Any other value "
  1889. "read causes @var{name} to be set to null. The line read is saved in the "
  1890. "variable @env{REPLY}."
  1891. msgstr ""
  1892. #. type: table
  1893. #: bashref.texi:954
  1894. msgid ""
  1895. "The @var{commands} are executed after each selection until a @code{break} "
  1896. "command is executed, at which point the @code{select} command completes."
  1897. msgstr ""
  1898. #. type: table
  1899. #: bashref.texi:958
  1900. msgid ""
  1901. "Here is an example that allows the user to pick a filename from the current "
  1902. "directory, and displays the name and index of the file selected."
  1903. msgstr ""
  1904. #. type: example
  1905. #: bashref.texi:965
  1906. #, no-wrap
  1907. msgid ""
  1908. "select fname in *;\n"
  1909. "do\n"
  1910. "\techo you picked $fname \\($REPLY\\)\n"
  1911. "\tbreak;\n"
  1912. "done\n"
  1913. msgstr ""
  1914. #. type: item
  1915. #: bashref.texi:967
  1916. #, no-wrap
  1917. msgid "((@dots{}))"
  1918. msgstr ""
  1919. #. type: example
  1920. #: bashref.texi:970
  1921. #, no-wrap
  1922. msgid "(( @var{expression} ))\n"
  1923. msgstr ""
  1924. #. type: table
  1925. #: bashref.texi:976
  1926. msgid ""
  1927. "The arithmetic @var{expression} is evaluated according to the rules "
  1928. "described below (@pxref{Shell Arithmetic}). If the value of the expression "
  1929. "is non-zero, the return status is 0; otherwise the return status is 1. This "
  1930. "is exactly equivalent to"
  1931. msgstr ""
  1932. #. type: example
  1933. #: bashref.texi:978
  1934. #, no-wrap
  1935. msgid "let \"@var{expression}\"\n"
  1936. msgstr ""
  1937. #. type: table
  1938. #: bashref.texi:981
  1939. msgid "@xref{Bash Builtins}, for a full description of the @code{let} builtin."
  1940. msgstr ""
  1941. #. type: item
  1942. #: bashref.texi:982
  1943. #, no-wrap
  1944. msgid "[[@dots{}]]"
  1945. msgstr ""
  1946. #. type: rwindex
  1947. #: bashref.texi:983
  1948. #, no-wrap
  1949. msgid "[["
  1950. msgstr ""
  1951. #. type: rwindex
  1952. #: bashref.texi:984
  1953. #, no-wrap
  1954. msgid "]]"
  1955. msgstr ""
  1956. #. type: example
  1957. #: bashref.texi:987
  1958. #, no-wrap
  1959. msgid "[[ @var{expression} ]]\n"
  1960. msgstr ""
  1961. #. type: table
  1962. #: bashref.texi:999
  1963. msgid ""
  1964. "Return a status of 0 or 1 depending on the evaluation of the conditional "
  1965. "expression @var{expression}. Expressions are composed of the primaries "
  1966. "described below in @ref{Bash Conditional Expressions}. Word splitting and "
  1967. "filename expansion are not performed on the words between the @code{[[} and "
  1968. "@code{]]}; tilde expansion, parameter and variable expansion, arithmetic "
  1969. "expansion, command substitution, process substitution, and quote removal are "
  1970. "performed. Conditional operators such as @samp{-f} must be unquoted to be "
  1971. "recognized as primaries."
  1972. msgstr ""
  1973. #. type: table
  1974. #: bashref.texi:1002
  1975. msgid ""
  1976. "When used with @code{[[}, the @samp{<} and @samp{>} operators sort "
  1977. "lexicographically using the current locale."
  1978. msgstr ""
  1979. #. type: table
  1980. #: bashref.texi:1016
  1981. msgid ""
  1982. "When the @samp{==} and @samp{!=} operators are used, the string to the right "
  1983. "of the operator is considered a pattern and matched according to the rules "
  1984. "described below in @ref{Pattern Matching}, as if the @code{extglob} shell "
  1985. "option were enabled. The @samp{=} operator is identical to @samp{==}. If "
  1986. "the @code{nocasematch} shell option (see the description of @code{shopt} in "
  1987. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  1988. "to the case of alphabetic characters. The return value is 0 if the string "
  1989. "matches (@samp{==}) or does not match (@samp{!=})the pattern, and 1 "
  1990. "otherwise. Any part of the pattern may be quoted to force the quoted "
  1991. "portion to be matched as a string."
  1992. msgstr ""
  1993. #. type: table
  1994. #: bashref.texi:1041
  1995. msgid ""
  1996. "An additional binary operator, @samp{=~}, is available, with the same "
  1997. "precedence as @samp{==} and @samp{!=}. When it is used, the string to the "
  1998. "right of the operator is considered an extended regular expression and "
  1999. "matched accordingly (as in @i{regex}3)). The return value is 0 if the "
  2000. "string matches the pattern, and 1 otherwise. If the regular expression is "
  2001. "syntactically incorrect, the conditional expression's return value is 2. If "
  2002. "the @code{nocasematch} shell option (see the description of @code{shopt} in "
  2003. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  2004. "to the case of alphabetic characters. Any part of the pattern may be quoted "
  2005. "to force the quoted portion to be matched as a string. Bracket expressions "
  2006. "in regular expressions must be treated carefully, since normal quoting "
  2007. "characters lose their meanings between brackets. If the pattern is stored "
  2008. "in a shell variable, quoting the variable expansion forces the entire "
  2009. "pattern to be matched as a string. Substrings matched by parenthesized "
  2010. "subexpressions within the regular expression are saved in the array variable "
  2011. "@code{BASH_REMATCH}. The element of @code{BASH_REMATCH} with index 0 is the "
  2012. "portion of the string matching the entire regular expression. The element "
  2013. "of @code{BASH_REMATCH} with index @var{n} is the portion of the string "
  2014. "matching the @var{n}th parenthesized subexpression."
  2015. msgstr ""
  2016. #. type: table
  2017. #: bashref.texi:1047
  2018. msgid ""
  2019. "For example, the following will match a line (stored in the shell variable "
  2020. "@var{line}) if there is a sequence of characters in the value consisting of "
  2021. "any number, including zero, of space characters, zero or one instances of "
  2022. "@samp{a}, then a @samp{b}:"
  2023. msgstr ""
  2024. #. type: example
  2025. #: bashref.texi:1049
  2026. #, no-wrap
  2027. msgid "[[ $line =~ [[:space:]]*(a)?b ]]\n"
  2028. msgstr ""
  2029. #. type: table
  2030. #: bashref.texi:1054
  2031. msgid ""
  2032. "That means values like @samp{aab} and @samp{ aaaaaab} will match, as will a "
  2033. "line containing a @samp{b} anywhere in its value."
  2034. msgstr ""
  2035. #. type: table
  2036. #: bashref.texi:1063
  2037. msgid ""
  2038. "Storing the regular expression in a shell variable is often a useful way to "
  2039. "avoid problems with quoting characters that are special to the shell. It is "
  2040. "sometimes difficult to specify a regular expression literally without using "
  2041. "quotes, or to keep track of the quoting used by regular expressions while "
  2042. "paying attention to the shell's quote removal. Using a shell variable to "
  2043. "store the pattern decreases these problems. For example, the following is "
  2044. "equivalent to the above:"
  2045. msgstr ""
  2046. #. type: example
  2047. #: bashref.texi:1066
  2048. #, no-wrap
  2049. msgid ""
  2050. "pattern='[[:space:]]*(a)?b'\n"
  2051. "[[ $line =~ $pattern ]]\n"
  2052. msgstr ""
  2053. #. type: table
  2054. #: bashref.texi:1078
  2055. msgid ""
  2056. "If you want to match a character that's special to the regular expression "
  2057. "grammar, it has to be quoted to remove its special meaning. This means that "
  2058. "in the pattern @samp{xxx.txt}, the @samp{.} matches any character in the "
  2059. "string (its usual regular expression meaning), but in the pattern "
  2060. "@samp{\"xxx.txt\"} it can only match a literal @samp{.}. Shell programmers "
  2061. "should take special care with backslashes, since backslashes are used both "
  2062. "by the shell and regular expressions to remove the special meaning from the "
  2063. "following character. The following two sets of commands are @emph{not} "
  2064. "equivalent:"
  2065. msgstr ""
  2066. #. type: example
  2067. #: bashref.texi:1080
  2068. #, no-wrap
  2069. msgid ""
  2070. "pattern='\\.'\n"
  2071. "\n"
  2072. msgstr ""
  2073. #. type: example
  2074. #: bashref.texi:1083
  2075. #, no-wrap
  2076. msgid ""
  2077. "[[ . =~ $pattern ]]\n"
  2078. "[[ . =~ \\. ]]\n"
  2079. "\n"
  2080. msgstr ""
  2081. #. type: example
  2082. #: bashref.texi:1086
  2083. #, no-wrap
  2084. msgid ""
  2085. "[[ . =~ \"$pattern\" ]]\n"
  2086. "[[ . =~ '\\.' ]]\n"
  2087. msgstr ""
  2088. #. type: table
  2089. #: bashref.texi:1096
  2090. msgid ""
  2091. "The first two matches will succeed, but the second two will not, because in "
  2092. "the second two the backslash will be part of the pattern to be matched. In "
  2093. "the first two examples, the backslash removes the special meaning from "
  2094. "@samp{.}, so the literal @samp{.} matches. If the string in the first "
  2095. "examples were anything other than @samp{.}, say @samp{a}, the pattern would "
  2096. "not match, because the quoted @samp{.} in the pattern loses its special "
  2097. "meaning of matching any single character."
  2098. msgstr ""
  2099. #. type: table
  2100. #: bashref.texi:1099
  2101. msgid ""
  2102. "Expressions may be combined using the following operators, listed in "
  2103. "decreasing order of precedence:"
  2104. msgstr ""
  2105. #. type: item
  2106. #: bashref.texi:1101
  2107. #, no-wrap
  2108. msgid "( @var{expression} )"
  2109. msgstr ""
  2110. #. type: table
  2111. #: bashref.texi:1104
  2112. msgid ""
  2113. "Returns the value of @var{expression}. This may be used to override the "
  2114. "normal precedence of operators."
  2115. msgstr ""
  2116. #. type: item
  2117. #: bashref.texi:1105
  2118. #, no-wrap
  2119. msgid "! @var{expression}"
  2120. msgstr ""
  2121. #. type: table
  2122. #: bashref.texi:1107
  2123. msgid "True if @var{expression} is false."
  2124. msgstr ""
  2125. #. type: item
  2126. #: bashref.texi:1108
  2127. #, no-wrap
  2128. msgid "@var{expression1} && @var{expression2}"
  2129. msgstr ""
  2130. #. type: table
  2131. #: bashref.texi:1110
  2132. msgid "True if both @var{expression1} and @var{expression2} are true."
  2133. msgstr ""
  2134. #. type: item
  2135. #: bashref.texi:1111
  2136. #, no-wrap
  2137. msgid "@var{expression1} || @var{expression2}"
  2138. msgstr ""
  2139. #. type: table
  2140. #: bashref.texi:1113
  2141. msgid "True if either @var{expression1} or @var{expression2} is true."
  2142. msgstr ""
  2143. #. type: table
  2144. #: bashref.texi:1119
  2145. msgid ""
  2146. "The @code{&&} and @code{||} operators do not evaluate @var{expression2} if "
  2147. "the value of @var{expression1} is sufficient to determine the return value "
  2148. "of the entire conditional expression."
  2149. msgstr ""
  2150. #. type: subsubsection
  2151. #: bashref.texi:1122
  2152. #, no-wrap
  2153. msgid "Grouping Commands"
  2154. msgstr ""
  2155. #. type: cindex
  2156. #: bashref.texi:1123
  2157. #, no-wrap
  2158. msgid "commands, grouping"
  2159. msgstr ""
  2160. #. type: Plain text
  2161. #: bashref.texi:1129
  2162. msgid ""
  2163. "Bash provides two ways to group a list of commands to be executed as a "
  2164. "unit. When commands are grouped, redirections may be applied to the entire "
  2165. "command list. For example, the output of all the commands in the list may "
  2166. "be redirected to a single stream."
  2167. msgstr ""
  2168. #. type: item
  2169. #: bashref.texi:1131
  2170. #, no-wrap
  2171. msgid "()"
  2172. msgstr ""
  2173. #. type: example
  2174. #: bashref.texi:1134
  2175. #, no-wrap
  2176. msgid "( @var{list} )\n"
  2177. msgstr ""
  2178. #. type: table
  2179. #: bashref.texi:1141
  2180. msgid ""
  2181. "Placing a list of commands between parentheses causes a subshell environment "
  2182. "to be created (@pxref{Command Execution Environment}), and each of the "
  2183. "commands in @var{list} to be executed in that subshell. Since the "
  2184. "@var{list} is executed in a subshell, variable assignments do not remain in "
  2185. "effect after the subshell completes."
  2186. msgstr ""
  2187. #. type: item
  2188. #: bashref.texi:1142
  2189. #, no-wrap
  2190. msgid "@{@}"
  2191. msgstr ""
  2192. #. type: rwindex
  2193. #: bashref.texi:1143
  2194. #, no-wrap
  2195. msgid "@{"
  2196. msgstr ""
  2197. #. type: rwindex
  2198. #: bashref.texi:1144
  2199. #, no-wrap
  2200. msgid "@}"
  2201. msgstr ""
  2202. #. type: example
  2203. #: bashref.texi:1147
  2204. #, no-wrap
  2205. msgid "@{ @var{list}; @}\n"
  2206. msgstr ""
  2207. #. type: table
  2208. #: bashref.texi:1152
  2209. msgid ""
  2210. "Placing a list of commands between curly braces causes the list to be "
  2211. "executed in the current shell context. No subshell is created. The "
  2212. "semicolon (or newline) following @var{list} is required."
  2213. msgstr ""
  2214. #. type: Plain text
  2215. #: bashref.texi:1161
  2216. msgid ""
  2217. "In addition to the creation of a subshell, there is a subtle difference "
  2218. "between these two constructs due to historical reasons. The braces are "
  2219. "@code{reserved words}, so they must be separated from the @var{list} by "
  2220. "@code{blank}s or other shell metacharacters. The parentheses are "
  2221. "@code{operators}, and are recognized as separate tokens by the shell even if "
  2222. "they are not separated from the @var{list} by whitespace."
  2223. msgstr ""
  2224. #. type: Plain text
  2225. #: bashref.texi:1164
  2226. msgid ""
  2227. "The exit status of both of these constructs is the exit status of @var{list}."
  2228. msgstr ""
  2229. #. type: cindex
  2230. #: bashref.texi:1167
  2231. #, no-wrap
  2232. msgid "coprocess"
  2233. msgstr ""
  2234. #. type: Plain text
  2235. #: bashref.texi:1174
  2236. msgid ""
  2237. "A @code{coprocess} is a shell command preceded by the @code{coproc} reserved "
  2238. "word. A coprocess is executed asynchronously in a subshell, as if the "
  2239. "command had been terminated with the @samp{&} control operator, with a two-"
  2240. "way pipe established between the executing shell and the coprocess."
  2241. msgstr ""
  2242. #. type: Plain text
  2243. #: bashref.texi:1176
  2244. msgid "The format for a coprocess is:"
  2245. msgstr ""
  2246. #. type: example
  2247. #: bashref.texi:1178
  2248. #, no-wrap
  2249. msgid "coproc [@var{NAME}] @var{command} [@var{redirections}]\n"
  2250. msgstr ""
  2251. #. type: Plain text
  2252. #: bashref.texi:1186
  2253. msgid ""
  2254. "This creates a coprocess named @var{NAME}. If @var{NAME} is not supplied, "
  2255. "the default name is @var{COPROC}. @var{NAME} must not be supplied if "
  2256. "@var{command} is a simple command (@pxref{Simple Commands}); otherwise, it "
  2257. "is interpreted as the first word of the simple command."
  2258. msgstr ""
  2259. #. type: Plain text
  2260. #: bashref.texi:1201
  2261. msgid ""
  2262. "When the coprocess is executed, the shell creates an array variable "
  2263. "(@pxref{Arrays}) named @env{NAME} in the context of the executing shell. "
  2264. "The standard output of @var{command} is connected via a pipe to a file "
  2265. "descriptor in the executing shell, and that file descriptor is assigned to "
  2266. "@env{NAME}[0]. The standard input of @var{command} is connected via a pipe "
  2267. "to a file descriptor in the executing shell, and that file descriptor is "
  2268. "assigned to @env{NAME}[1]. This pipe is established before any redirections "
  2269. "specified by the command (@pxref{Redirections}). The file descriptors can "
  2270. "be utilized as arguments to shell commands and redirections using standard "
  2271. "word expansions. The file descriptors are not available in subshells."
  2272. msgstr ""
  2273. #. type: Plain text
  2274. #: bashref.texi:1206
  2275. msgid ""
  2276. "The process ID of the shell spawned to execute the coprocess is available as "
  2277. "the value of the variable @env{NAME}_PID. The @code{wait} builtin command "
  2278. "may be used to wait for the coprocess to terminate."
  2279. msgstr ""
  2280. #. type: Plain text
  2281. #: bashref.texi:1210
  2282. msgid ""
  2283. "Since the coprocess is created as an asynchronous command, the @code{coproc} "
  2284. "command always returns success. The return status of a coprocess is the "
  2285. "exit status of @var{command}."
  2286. msgstr ""
  2287. #. type: Plain text
  2288. #: bashref.texi:1216
  2289. msgid ""
  2290. "There are ways to run commands in parallel that are not built into Bash. "
  2291. "GNU Parallel is a tool to do just that."
  2292. msgstr ""
  2293. #. type: Plain text
  2294. #: bashref.texi:1224
  2295. msgid ""
  2296. "GNU Parallel, as its name suggests, can be used to build and run commands in "
  2297. "parallel. You may run the same command with different arguments, whether "
  2298. "they are filenames, usernames, hostnames, or lines read from files. GNU "
  2299. "Parallel provides shorthand references to many of the most common operations "
  2300. "(input lines, various portions of the input line, different ways to specify "
  2301. "the input source, and so on). Parallel can replace @code{xargs} or feed "
  2302. "commands from its input sources to several different instances of Bash."
  2303. msgstr ""
  2304. #. type: Plain text
  2305. #: bashref.texi:1227
  2306. msgid ""
  2307. "For a complete description, refer to the GNU Parallel documentation. A few "
  2308. "examples should provide a brief introduction to its use."
  2309. msgstr ""
  2310. #. type: Plain text
  2311. #: bashref.texi:1230
  2312. msgid ""
  2313. "For example, it is easy to replace @code{xargs} to gzip all html files in "
  2314. "the current directory and its subdirectories:"
  2315. msgstr ""
  2316. #. type: example
  2317. #: bashref.texi:1232
  2318. #, no-wrap
  2319. msgid "find . -type f -name '*.html' -print | parallel gzip\n"
  2320. msgstr ""
  2321. #. type: Plain text
  2322. #: bashref.texi:1236
  2323. msgid ""
  2324. "If you need to protect special characters such as newlines in file names, "
  2325. "use find's @option{-print0} option and parallel's @option{-0} option."
  2326. msgstr ""
  2327. #. type: Plain text
  2328. #: bashref.texi:1239
  2329. msgid ""
  2330. "You can use Parallel to move files from the current directory when the "
  2331. "number of files is too large to process with one @code{mv} invocation:"
  2332. msgstr ""
  2333. #. type: example
  2334. #: bashref.texi:1241
  2335. #, no-wrap
  2336. msgid "ls | parallel mv @{@} destdir\n"
  2337. msgstr ""
  2338. #. type: Plain text
  2339. #: bashref.texi:1247
  2340. msgid ""
  2341. "As you can see, the @{@} is replaced with each line read from standard "
  2342. "input. While using @code{ls} will work in most instances, it is not "
  2343. "sufficient to deal with all filenames. If you need to accommodate special "
  2344. "characters in filenames, you can use"
  2345. msgstr ""
  2346. #. type: example
  2347. #: bashref.texi:1250
  2348. #, no-wrap
  2349. msgid "find . -depth 1 \\! -name '.*' -print0 | parallel -0 mv @{@} destdir\n"
  2350. msgstr ""
  2351. #. type: Plain text
  2352. #: bashref.texi:1254
  2353. msgid "as alluded to above."
  2354. msgstr ""
  2355. #. type: Plain text
  2356. #: bashref.texi:1258
  2357. msgid ""
  2358. "This will run as many @code{mv} commands as there are files in the current "
  2359. "directory. You can emulate a parallel @code{xargs} by adding the @option{-"
  2360. "X} option:"
  2361. msgstr ""
  2362. #. type: example
  2363. #: bashref.texi:1260
  2364. #, no-wrap
  2365. msgid "find . -depth 1 \\! -name '.*' -print0 | parallel -0 -X mv @{@} destdir\n"
  2366. msgstr ""
  2367. #. type: Plain text
  2368. #: bashref.texi:1264
  2369. msgid ""
  2370. "GNU Parallel can replace certain common idioms that operate on lines read "
  2371. "from a file (in this case, filenames listed one per line):"
  2372. msgstr ""
  2373. #. type: example
  2374. #: bashref.texi:1269
  2375. #, no-wrap
  2376. msgid ""
  2377. "\twhile IFS= read -r x; do\n"
  2378. "\t\tdo-something1 \"$x\" \"config-$x\"\n"
  2379. "\t\tdo-something2 < \"$x\"\n"
  2380. "\tdone < file | process-output\n"
  2381. msgstr ""
  2382. #. type: Plain text
  2383. #: bashref.texi:1273
  2384. msgid "with a more compact syntax reminiscent of lambdas:"
  2385. msgstr ""
  2386. #. type: example
  2387. #: bashref.texi:1275
  2388. #, no-wrap
  2389. msgid "cat list | parallel \"do-something1 @{@} config-@{@} ; do-something2 < @{@}\" | process-output\n"
  2390. msgstr ""
  2391. #. type: Plain text
  2392. #: bashref.texi:1279
  2393. msgid ""
  2394. "Parallel provides a built-in mechanism to remove filename extensions, which "
  2395. "lends itself to batch file transformations or renaming:"
  2396. msgstr ""
  2397. #. type: example
  2398. #: bashref.texi:1281
  2399. #, no-wrap
  2400. msgid "ls *.gz | parallel -j+0 \"zcat @{@} | bzip2 >@{.@}.bz2 && rm @{@}\"\n"
  2401. msgstr ""
  2402. #. type: Plain text
  2403. #: bashref.texi:1289
  2404. msgid ""
  2405. "This will recompress all files in the current directory with names ending "
  2406. "in .gz using bzip2, running one job per CPU (-j+0) in parallel. (We use "
  2407. "@code{ls} for brevity here; using @code{find} as above is more robust in the "
  2408. "face of filenames containing unexpected characters.) Parallel can take "
  2409. "arguments from the command line; the above can also be written as"
  2410. msgstr ""
  2411. #. type: example
  2412. #: bashref.texi:1292
  2413. #, no-wrap
  2414. msgid "parallel \"zcat @{@} | bzip2 >@{.@}.bz2 && rm @{@}\" ::: *.gz\n"
  2415. msgstr ""
  2416. #. type: Plain text
  2417. #: bashref.texi:1296
  2418. msgid ""
  2419. "If a command generates output, you may want to preserve the input order in "
  2420. "the output. For instance, the following command"
  2421. msgstr ""
  2422. #. type: example
  2423. #: bashref.texi:1298
  2424. #, no-wrap
  2425. msgid "@{ echo foss.org.my ; echo debian.org; echo freenetproject.org; @} | parallel traceroute\n"
  2426. msgstr ""
  2427. #. type: Plain text
  2428. #: bashref.texi:1302
  2429. msgid ""
  2430. "will display as output the traceroute invocation that finishes first. "
  2431. "Adding the @option{-k} option"
  2432. msgstr ""
  2433. #. type: example
  2434. #: bashref.texi:1304
  2435. #, no-wrap
  2436. msgid "@{ echo foss.org.my ; echo debian.org; echo freenetproject.org; @} | parallel -k traceroute\n"
  2437. msgstr ""
  2438. #. type: Plain text
  2439. #: bashref.texi:1307
  2440. msgid ""
  2441. "will ensure that the output of @code{traceroute foss.org.my} is displayed "
  2442. "first."
  2443. msgstr ""
  2444. #. type: Plain text
  2445. #: bashref.texi:1314
  2446. msgid ""
  2447. "Finally, Parallel can be used to run a sequence of shell commands in "
  2448. "parallel, similar to @samp{cat file | bash}. It is not uncommon to take a "
  2449. "list of filenames, create a series of shell commands to operate on them, and "
  2450. "feed that list of commnds to a shell. Parallel can speed this up. Assuming "
  2451. "that @file{file} contains a list of shell commands, one per line,"
  2452. msgstr ""
  2453. #. type: example
  2454. #: bashref.texi:1317
  2455. #, no-wrap
  2456. msgid "parallel -j 10 < file\n"
  2457. msgstr ""
  2458. #. type: Plain text
  2459. #: bashref.texi:1322
  2460. msgid ""
  2461. "will evaluate the commands using the shell (since no explicit command is "
  2462. "supplied as an argument), in blocks of ten shell jobs at a time."
  2463. msgstr ""
  2464. #. type: cindex
  2465. #: bashref.texi:1325
  2466. #, no-wrap
  2467. msgid "shell function"
  2468. msgstr ""
  2469. #. type: cindex
  2470. #: bashref.texi:1326
  2471. #, no-wrap
  2472. msgid "functions, shell"
  2473. msgstr ""
  2474. #. type: Plain text
  2475. #: bashref.texi:1335
  2476. msgid ""
  2477. "Shell functions are a way to group commands for later execution using a "
  2478. "single name for the group. They are executed just like a \"regular\" "
  2479. "command. When the name of a shell function is used as a simple command "
  2480. "name, the list of commands associated with that function name is executed. "
  2481. "Shell functions are executed in the current shell context; no new process is "
  2482. "created to interpret them."
  2483. msgstr ""
  2484. #. type: Plain text
  2485. #: bashref.texi:1337
  2486. msgid "Functions are declared using this syntax:"
  2487. msgstr ""
  2488. #. type: rwindex
  2489. #: bashref.texi:1337
  2490. #, no-wrap
  2491. msgid "function"
  2492. msgstr ""
  2493. #. type: example
  2494. #: bashref.texi:1340
  2495. #, no-wrap
  2496. msgid "@var{name} () @var{compound-command} [ @var{redirections} ]\n"
  2497. msgstr ""
  2498. #. type: Plain text
  2499. #: bashref.texi:1343 bashref.texi:1788 bashref.texi:2253 bashref.texi:2316
  2500. msgid "or"
  2501. msgstr ""
  2502. #. type: example
  2503. #: bashref.texi:1346
  2504. #, no-wrap
  2505. msgid "function @var{name} [()] @var{compound-command} [ @var{redirections} ]\n"
  2506. msgstr ""
  2507. #. type: Plain text
  2508. #: bashref.texi:1365
  2509. msgid ""
  2510. "This defines a shell function named @var{name}. The reserved word "
  2511. "@code{function} is optional. If the @code{function} reserved word is "
  2512. "supplied, the parentheses are optional. The @var{body} of the function is "
  2513. "the compound command @var{compound-command} (@pxref{Compound Commands}). "
  2514. "That command is usually a @var{list} enclosed between @{ and @}, but may be "
  2515. "any compound command listed above, with one exception: If the "
  2516. "@code{function} reserved word is used, but the parentheses are not supplied, "
  2517. "the braces are required. @var{compound-command} is executed whenever "
  2518. "@var{name} is specified as the name of a command. When the shell is in "
  2519. "@sc{posix} mode (@pxref{Bash POSIX Mode}), @var{name} may not be the same as "
  2520. "one of the special builtins (@pxref{Special Builtins}). Any redirections "
  2521. "(@pxref{Redirections}) associated with the shell function are performed when "
  2522. "the function is executed."
  2523. msgstr ""
  2524. #. type: Plain text
  2525. #: bashref.texi:1368
  2526. msgid ""
  2527. "A function definition may be deleted using the @option{-f} option to the "
  2528. "@code{unset} builtin (@pxref{Bourne Shell Builtins})."
  2529. msgstr ""
  2530. #. type: Plain text
  2531. #: bashref.texi:1373
  2532. msgid ""
  2533. "The exit status of a function definition is zero unless a syntax error "
  2534. "occurs or a readonly function with the same name already exists. When "
  2535. "executed, the exit status of a function is the exit status of the last "
  2536. "command executed in the body."
  2537. msgstr ""
  2538. #. type: Plain text
  2539. #: bashref.texi:1382
  2540. msgid ""
  2541. "Note that for historical reasons, in the most common usage the curly braces "
  2542. "that surround the body of the function must be separated from the body by "
  2543. "@code{blank}s or newlines. This is because the braces are reserved words "
  2544. "and are only recognized as such when they are separated from the command "
  2545. "list by whitespace or another shell metacharacter. Also, when using the "
  2546. "braces, the @var{list} must be terminated by a semicolon, a @samp{&}, or a "
  2547. "newline."
  2548. msgstr ""
  2549. #. type: Plain text
  2550. #: bashref.texi:1391
  2551. msgid ""
  2552. "When a function is executed, the arguments to the function become the "
  2553. "positional parameters during its execution (@pxref{Positional Parameters}). "
  2554. "The special parameter @samp{#} that expands to the number of positional "
  2555. "parameters is updated to reflect the change. Special parameter @code{0} is "
  2556. "unchanged. The first element of the @env{FUNCNAME} variable is set to the "
  2557. "name of the function while the function is executing."
  2558. msgstr ""
  2559. #. type: Plain text
  2560. #: bashref.texi:1405
  2561. msgid ""
  2562. "All other aspects of the shell execution environment are identical between a "
  2563. "function and its caller with these exceptions: the @env{DEBUG} and "
  2564. "@env{RETURN} traps are not inherited unless the function has been given the "
  2565. "@code{trace} attribute using the @code{declare} builtin or the @code{-o "
  2566. "functrace} option has been enabled with the @code{set} builtin, (in which "
  2567. "case all functions inherit the @env{DEBUG} and @env{RETURN} traps), and the "
  2568. "@env{ERR} trap is not inherited unless the @code{-o errtrace} shell option "
  2569. "has been enabled. @xref{Bourne Shell Builtins}, for the description of the "
  2570. "@code{trap} builtin."
  2571. msgstr ""
  2572. #. type: Plain text
  2573. #: bashref.texi:1410
  2574. msgid ""
  2575. "The @env{FUNCNEST} variable, if set to a numeric value greater than 0, "
  2576. "defines a maximum function nesting level. Function invocations that exceed "
  2577. "the limit cause the entire command to abort."
  2578. msgstr ""
  2579. #. type: Plain text
  2580. #: bashref.texi:1424
  2581. msgid ""
  2582. "If the builtin command @code{return} is executed in a function, the function "
  2583. "completes and execution resumes with the next command after the function "
  2584. "call. Any command associated with the @code{RETURN} trap is executed before "
  2585. "execution resumes. When a function completes, the values of the positional "
  2586. "parameters and the special parameter @samp{#} are restored to the values "
  2587. "they had prior to the function's execution. If a numeric argument is given "
  2588. "to @code{return}, that is the function's return status; otherwise the "
  2589. "function's return status is the exit status of the last command executed "
  2590. "before the @code{return}."
  2591. msgstr ""
  2592. #. type: Plain text
  2593. #: bashref.texi:1428
  2594. msgid ""
  2595. "Variables local to the function may be declared with the @code{local} "
  2596. "builtin. These variables are visible only to the function and the commands "
  2597. "it invokes."
  2598. msgstr ""
  2599. #. type: Plain text
  2600. #: bashref.texi:1444
  2601. msgid ""
  2602. "Function names and definitions may be listed with the @option{-f} option to "
  2603. "the @code{declare} (@code{typeset}) builtin command (@pxref{Bash "
  2604. "Builtins}). The @option{-F} option to @code{declare} or @code{typeset} will "
  2605. "list the function names only (and optionally the source file and line "
  2606. "number, if the @code{extdebug} shell option is enabled). Functions may be "
  2607. "exported so that subshells automatically have them defined with the @option{-"
  2608. "f} option to the @code{export} builtin (@pxref{Bourne Shell Builtins}). "
  2609. "Note that shell functions and variables with the same name may result in "
  2610. "multiple identically-named entries in the environment passed to the shell's "
  2611. "children. Care should be taken in cases where this may cause a problem."
  2612. msgstr ""
  2613. #. type: Plain text
  2614. #: bashref.texi:1449
  2615. msgid ""
  2616. "Functions may be recursive. The @code{FUNCNEST} variable may be used to "
  2617. "limit the depth of the function call stack and restrict the number of "
  2618. "function invocations. By default, no limit is placed on the number of "
  2619. "recursive calls."
  2620. msgstr ""
  2621. #. type: cindex
  2622. #: bashref.texi:1452
  2623. #, no-wrap
  2624. msgid "parameters"
  2625. msgstr ""
  2626. #. type: cindex
  2627. #: bashref.texi:1453
  2628. #, no-wrap
  2629. msgid "variable, shell"
  2630. msgstr ""
  2631. #. type: cindex
  2632. #: bashref.texi:1454
  2633. #, no-wrap
  2634. msgid "shell variable"
  2635. msgstr ""
  2636. #. type: subsection
  2637. #: bashref.texi:1459 bashref.texi:1551 bashref.texi:1552
  2638. #, no-wrap
  2639. msgid "Positional Parameters"
  2640. msgstr ""
  2641. #. type: menuentry
  2642. #: bashref.texi:1459
  2643. msgid "The shell's command-line arguments."
  2644. msgstr ""
  2645. #. type: subsection
  2646. #: bashref.texi:1459 bashref.texi:1571 bashref.texi:1572
  2647. #, no-wrap
  2648. msgid "Special Parameters"
  2649. msgstr ""
  2650. #. type: menuentry
  2651. #: bashref.texi:1459
  2652. msgid "Parameters denoted by special characters."
  2653. msgstr ""
  2654. #. type: Plain text
  2655. #: bashref.texi:1468
  2656. msgid ""
  2657. "A @var{parameter} is an entity that stores values. It can be a @code{name}, "
  2658. "a number, or one of the special characters listed below. A @var{variable} "
  2659. "is a parameter denoted by a @code{name}. A variable has a @var{value} and "
  2660. "zero or more @var{attributes}. Attributes are assigned using the "
  2661. "@code{declare} builtin command (see the description of the @code{declare} "
  2662. "builtin in @ref{Bash Builtins})."
  2663. msgstr ""
  2664. #. type: Plain text
  2665. #: bashref.texi:1472
  2666. msgid ""
  2667. "A parameter is set if it has been assigned a value. The null string is a "
  2668. "valid value. Once a variable is set, it may be unset only by using the "
  2669. "@code{unset} builtin command."
  2670. msgstr ""
  2671. #. type: Plain text
  2672. #: bashref.texi:1474
  2673. msgid "A variable may be assigned to by a statement of the form"
  2674. msgstr ""
  2675. #. type: example
  2676. #: bashref.texi:1476
  2677. #, no-wrap
  2678. msgid "@var{name}=[@var{value}]\n"
  2679. msgstr ""
  2680. #. type: Plain text
  2681. #: bashref.texi:1496
  2682. msgid ""
  2683. "If @var{value} is not given, the variable is assigned the null string. All "
  2684. "@var{value}s undergo tilde expansion, parameter and variable expansion, "
  2685. "command substitution, arithmetic expansion, and quote removal (detailed "
  2686. "below). If the variable has its @code{integer} attribute set, then "
  2687. "@var{value} is evaluated as an arithmetic expression even if the "
  2688. "@code{$((@dots{}))} expansion is not used (@pxref{Arithmetic Expansion}). "
  2689. "Word splitting is not performed, with the exception of @code{\"$@@\"} as "
  2690. "explained below. Filename expansion is not performed. Assignment "
  2691. "statements may also appear as arguments to the @code{alias}, @code{declare}, "
  2692. "@code{typeset}, @code{export}, @code{readonly}, and @code{local} builtin "
  2693. "commands (@var{declaration} commands). When in @sc{posix} mode (@pxref{Bash "
  2694. "POSIX Mode}), these builtins may appear in a command after one or more "
  2695. "instances of the @code{command} builtin and retain these assignment "
  2696. "statement properties."
  2697. msgstr ""
  2698. #. type: Plain text
  2699. #: bashref.texi:1514
  2700. msgid ""
  2701. "In the context where an assignment statement is assigning a value to a shell "
  2702. "variable or array index (@pxref{Arrays}), the @samp{+=} operator can be used "
  2703. "to append to or add to the variable's previous value. This includes "
  2704. "arguments to builtin commands such as @code{declare} that accept assignment "
  2705. "statements (@var{declaration} commands). When @samp{+=} is applied to a "
  2706. "variable for which the @var{integer} attribute has been set, @var{value} is "
  2707. "evaluated as an arithmetic expression and added to the variable's current "
  2708. "value, which is also evaluated. When @samp{+=} is applied to an array "
  2709. "variable using compound assignment (@pxref{Arrays}), the variable's value is "
  2710. "not unset (as it is when using @samp{=}), and new values are appended to the "
  2711. "array beginning at one greater than the array's maximum index (for indexed "
  2712. "arrays), or added as additional key-value pairs in an associative array. "
  2713. "When applied to a string-valued variable, @var{value} is expanded and "
  2714. "appended to the variable's value."
  2715. msgstr ""
  2716. #. type: Plain text
  2717. #: bashref.texi:1529
  2718. msgid ""
  2719. "A variable can be assigned the @var{nameref} attribute using the @option{-n} "
  2720. "option to the @code{declare} or @code{local} builtin commands (@pxref{Bash "
  2721. "Builtins}) to create a @var{nameref}, or a reference to another variable. "
  2722. "This allows variables to be manipulated indirectly. Whenever the nameref "
  2723. "variable is referenced, assigned to, unset, or has its attributes modified "
  2724. "(other than using or changing the nameref attribute itself), the operation "
  2725. "is actually performed on the variable specified by the nameref variable's "
  2726. "value. A nameref is commonly used within shell functions to refer to a "
  2727. "variable whose name is passed as an argument to the function. For instance, "
  2728. "if a variable name is passed to a shell function as its first argument, "
  2729. "running"
  2730. msgstr ""
  2731. #. type: example
  2732. #: bashref.texi:1531
  2733. #, no-wrap
  2734. msgid "declare -n ref=$1\n"
  2735. msgstr ""
  2736. #. type: Plain text
  2737. #: bashref.texi:1538
  2738. msgid ""
  2739. "inside the function creates a nameref variable @var{ref} whose value is the "
  2740. "variable name passed as the first argument. References and assignments to "
  2741. "@var{ref}, and changes to its attributes, are treated as references, "
  2742. "assignments, and attribute modifications to the variable whose name was "
  2743. "passed as @code{$1}."
  2744. msgstr ""
  2745. #. type: Plain text
  2746. #: bashref.texi:1550
  2747. msgid ""
  2748. "If the control variable in a @code{for} loop has the nameref attribute, the "
  2749. "list of words can be a list of shell variables, and a name reference will be "
  2750. "established for each word in the list, in turn, when the loop is executed. "
  2751. "Array variables cannot be given the nameref attribute. However, nameref "
  2752. "variables can reference array variables and subscripted array variables. "
  2753. "Namerefs can be unset using the @option{-n} option to the @code{unset} "
  2754. "builtin (@pxref{Bourne Shell Builtins}). Otherwise, if @code{unset} is "
  2755. "executed with the name of a nameref variable as an argument, the variable "
  2756. "referenced by the nameref variable will be unset."
  2757. msgstr ""
  2758. #. type: cindex
  2759. #: bashref.texi:1553
  2760. #, no-wrap
  2761. msgid "parameters, positional"
  2762. msgstr ""
  2763. #. type: Plain text
  2764. #: bashref.texi:1567
  2765. msgid ""
  2766. "A @var{positional parameter} is a parameter denoted by one or more digits, "
  2767. "other than the single digit @code{0}. Positional parameters are assigned "
  2768. "from the shell's arguments when it is invoked, and may be reassigned using "
  2769. "the @code{set} builtin command. Positional parameter @code{N} may be "
  2770. "referenced as @code{$@{N@}}, or as @code{$N} when @code{N} consists of a "
  2771. "single digit. Positional parameters may not be assigned to with assignment "
  2772. "statements. The @code{set} and @code{shift} builtins are used to set and "
  2773. "unset them (@pxref{Shell Builtin Commands}). The positional parameters are "
  2774. "temporarily replaced when a shell function is executed (@pxref{Shell "
  2775. "Functions})."
  2776. msgstr ""
  2777. #. type: Plain text
  2778. #: bashref.texi:1570
  2779. msgid ""
  2780. "When a positional parameter consisting of more than a single digit is "
  2781. "expanded, it must be enclosed in braces."
  2782. msgstr ""
  2783. #. type: cindex
  2784. #: bashref.texi:1573
  2785. #, no-wrap
  2786. msgid "parameters, special"
  2787. msgstr ""
  2788. #. type: Plain text
  2789. #: bashref.texi:1577
  2790. msgid ""
  2791. "The shell treats several parameters specially. These parameters may only be "
  2792. "referenced; assignment to them is not allowed."
  2793. msgstr ""
  2794. #. type: Plain text
  2795. #: bashref.texi:1579 bashref.texi:5396 bashref.texi:5461 bashref.texi:7888
  2796. msgid "@vtable @code"
  2797. msgstr ""
  2798. #. type: item
  2799. #: bashref.texi:1580 bashref.texi:2456
  2800. #, no-wrap
  2801. msgid "*"
  2802. msgstr ""
  2803. #. type: vindex
  2804. #: bashref.texi:1581
  2805. #, no-wrap
  2806. msgid "$*"
  2807. msgstr ""
  2808. #. type: Plain text
  2809. #: bashref.texi:1596
  2810. msgid ""
  2811. "($*) Expands to the positional parameters, starting from one. When the "
  2812. "expansion is not within double quotes, each positional parameter expands to "
  2813. "a separate word. In contexts where it is performed, those words are subject "
  2814. "to further word splitting and pathname expansion. When the expansion occurs "
  2815. "within double quotes, it expands to a single word with the value of each "
  2816. "parameter separated by the first character of the @env{IFS} special "
  2817. "variable. That is, @code{\"$*\"} is equivalent to @code{\"$1@var{c}$2@var{c}"
  2818. "@dots{}\"}, where @var{c} is the first character of the value of the "
  2819. "@code{IFS} variable. If @env{IFS} is unset, the parameters are separated by "
  2820. "spaces. If @env{IFS} is null, the parameters are joined without intervening "
  2821. "separators."
  2822. msgstr ""
  2823. #. type: item
  2824. #: bashref.texi:1597
  2825. #, no-wrap
  2826. msgid "@@"
  2827. msgstr ""
  2828. #. type: vindex
  2829. #: bashref.texi:1598
  2830. #, no-wrap
  2831. msgid "$@@"
  2832. msgstr ""
  2833. #. type: Plain text
  2834. #: bashref.texi:1610
  2835. msgid ""
  2836. "($@@) Expands to the positional parameters, starting from one. When the "
  2837. "expansion occurs within double quotes, each parameter expands to a separate "
  2838. "word. That is, @code{\"$@@\"} is equivalent to @code{\"$1\" \"$2\" "
  2839. "@dots{}}. If the double-quoted expansion occurs within a word, the "
  2840. "expansion of the first parameter is joined with the beginning part of the "
  2841. "original word, and the expansion of the last parameter is joined with the "
  2842. "last part of the original word. When there are no positional parameters, "
  2843. "@code{\"$@@\"} and @code{$@@} expand to nothing (i.e., they are removed)."
  2844. msgstr ""
  2845. #. type: item
  2846. #: bashref.texi:1611
  2847. #, no-wrap
  2848. msgid "#"
  2849. msgstr ""
  2850. #. type: vindex
  2851. #: bashref.texi:1612
  2852. #, no-wrap
  2853. msgid "$#"
  2854. msgstr ""
  2855. #. type: Plain text
  2856. #: bashref.texi:1614
  2857. msgid "($#) Expands to the number of positional parameters in decimal."
  2858. msgstr ""
  2859. #. type: item
  2860. #: bashref.texi:1615 bashref.texi:2464
  2861. #, no-wrap
  2862. msgid "?"
  2863. msgstr ""
  2864. #. type: vindex
  2865. #: bashref.texi:1616
  2866. #, no-wrap
  2867. msgid "$?"
  2868. msgstr ""
  2869. #. type: Plain text
  2870. #: bashref.texi:1619
  2871. msgid ""
  2872. "($?) Expands to the exit status of the most recently executed foreground "
  2873. "pipeline."
  2874. msgstr ""
  2875. #. type: item
  2876. #: bashref.texi:1620 bashref.texi:4939
  2877. #, no-wrap
  2878. msgid "-"
  2879. msgstr ""
  2880. #. type: vindex
  2881. #: bashref.texi:1621
  2882. #, no-wrap
  2883. msgid "$-"
  2884. msgstr ""
  2885. #. type: Plain text
  2886. #: bashref.texi:1626
  2887. msgid ""
  2888. "($-, a hyphen.) Expands to the current option flags as specified upon "
  2889. "invocation, by the @code{set} builtin command, or those set by the shell "
  2890. "itself (such as the @option{-i} option)."
  2891. msgstr ""
  2892. #. type: item
  2893. #: bashref.texi:1627
  2894. #, no-wrap
  2895. msgid "$"
  2896. msgstr ""
  2897. #. type: vindex
  2898. #: bashref.texi:1628
  2899. #, no-wrap
  2900. msgid "$$"
  2901. msgstr ""
  2902. #. type: Plain text
  2903. #: bashref.texi:1631
  2904. msgid ""
  2905. "($$) Expands to the process @sc{id} of the shell. In a @code{()} subshell, "
  2906. "it expands to the process @sc{id} of the invoking shell, not the subshell."
  2907. msgstr ""
  2908. #. type: vindex
  2909. #: bashref.texi:1633
  2910. #, no-wrap
  2911. msgid "$!"
  2912. msgstr ""
  2913. #. type: Plain text
  2914. #: bashref.texi:1637
  2915. msgid ""
  2916. "($!) Expands to the process @sc{id} of the job most recently placed into the "
  2917. "background, whether executed as an asynchronous command or using the "
  2918. "@code{bg} builtin (@pxref{Job Control Builtins})."
  2919. msgstr ""
  2920. #. type: item
  2921. #: bashref.texi:1638
  2922. #, no-wrap
  2923. msgid "0"
  2924. msgstr ""
  2925. #. type: vindex
  2926. #: bashref.texi:1639
  2927. #, no-wrap
  2928. msgid "$0"
  2929. msgstr ""
  2930. #. type: Plain text
  2931. #: bashref.texi:1647
  2932. msgid ""
  2933. "($0) Expands to the name of the shell or shell script. This is set at shell "
  2934. "initialization. If Bash is invoked with a file of commands (@pxref{Shell "
  2935. "Scripts}), @code{$0} is set to the name of that file. If Bash is started "
  2936. "with the @option{-c} option (@pxref{Invoking Bash}), then @code{$0} is set "
  2937. "to the first argument after the string to be executed, if one is present. "
  2938. "Otherwise, it is set to the filename used to invoke Bash, as given by "
  2939. "argument zero."
  2940. msgstr ""
  2941. #. type: item
  2942. #: bashref.texi:1648
  2943. #, no-wrap
  2944. msgid "_"
  2945. msgstr ""
  2946. #. type: vindex
  2947. #: bashref.texi:1649
  2948. #, no-wrap
  2949. msgid "$_"
  2950. msgstr ""
  2951. #. type: Plain text
  2952. #: bashref.texi:1659
  2953. msgid ""
  2954. "($_, an underscore.) At shell startup, set to the absolute pathname used to "
  2955. "invoke the shell or shell script being executed as passed in the environment "
  2956. "or argument list. Subsequently, expands to the last argument to the "
  2957. "previous command, after expansion. Also set to the full pathname used to "
  2958. "invoke each command executed and placed in the environment exported to that "
  2959. "command. When checking mail, this parameter holds the name of the mail file."
  2960. msgstr ""
  2961. #. type: cindex
  2962. #: bashref.texi:1663
  2963. #, no-wrap
  2964. msgid "expansion"
  2965. msgstr ""
  2966. #. type: Plain text
  2967. #: bashref.texi:1667
  2968. msgid ""
  2969. "Expansion is performed on the command line after it has been split into "
  2970. "@code{token}s. There are seven kinds of expansion performed:"
  2971. msgstr ""
  2972. #. type: cindex
  2973. #: bashref.texi:1669 bashref.texi:1722
  2974. #, no-wrap
  2975. msgid "brace expansion"
  2976. msgstr ""
  2977. #. type: cindex
  2978. #: bashref.texi:1670 bashref.texi:1794
  2979. #, no-wrap
  2980. msgid "tilde expansion"
  2981. msgstr ""
  2982. #. type: item
  2983. #: bashref.texi:1671
  2984. #, no-wrap
  2985. msgid "parameter and variable expansion"
  2986. msgstr ""
  2987. #. type: cindex
  2988. #: bashref.texi:1672 bashref.texi:2243
  2989. #, no-wrap
  2990. msgid "command substitution"
  2991. msgstr ""
  2992. #. type: cindex
  2993. #: bashref.texi:1673 bashref.texi:2283
  2994. #, no-wrap
  2995. msgid "arithmetic expansion"
  2996. msgstr ""
  2997. #. type: cindex
  2998. #: bashref.texi:1674 bashref.texi:2341
  2999. #, no-wrap
  3000. msgid "word splitting"
  3001. msgstr ""
  3002. #. type: cindex
  3003. #: bashref.texi:1675 bashref.texi:2390
  3004. #, no-wrap
  3005. msgid "filename expansion"
  3006. msgstr ""
  3007. #. type: subsection
  3008. #: bashref.texi:1691 bashref.texi:1720 bashref.texi:1721
  3009. #, no-wrap
  3010. msgid "Brace Expansion"
  3011. msgstr ""
  3012. #. type: menuentry
  3013. #: bashref.texi:1691
  3014. msgid "Expansion of expressions within braces."
  3015. msgstr ""
  3016. #. type: subsection
  3017. #: bashref.texi:1691 bashref.texi:1792 bashref.texi:1793
  3018. #, no-wrap
  3019. msgid "Tilde Expansion"
  3020. msgstr ""
  3021. #. type: menuentry
  3022. #: bashref.texi:1691
  3023. msgid "Expansion of the ~ character."
  3024. msgstr ""
  3025. #. type: subsection
  3026. #: bashref.texi:1691 bashref.texi:1862 bashref.texi:1863
  3027. #, no-wrap
  3028. msgid "Shell Parameter Expansion"
  3029. msgstr ""
  3030. #. type: menuentry
  3031. #: bashref.texi:1691
  3032. msgid "How Bash expands variables to their values."
  3033. msgstr ""
  3034. #. type: subsection
  3035. #: bashref.texi:1691 bashref.texi:2241 bashref.texi:2242
  3036. #, no-wrap
  3037. msgid "Command Substitution"
  3038. msgstr ""
  3039. #. type: menuentry
  3040. #: bashref.texi:1691
  3041. msgid "Using the output of a command as an argument."
  3042. msgstr ""
  3043. #. type: subsection
  3044. #: bashref.texi:1691 bashref.texi:2280 bashref.texi:2281
  3045. #, no-wrap
  3046. msgid "Arithmetic Expansion"
  3047. msgstr ""
  3048. #. type: menuentry
  3049. #: bashref.texi:1691
  3050. msgid "How to use arithmetic in shell expansions."
  3051. msgstr ""
  3052. #. type: subsection
  3053. #: bashref.texi:1691 bashref.texi:2304 bashref.texi:2305
  3054. #, no-wrap
  3055. msgid "Process Substitution"
  3056. msgstr ""
  3057. #. type: menuentry
  3058. #: bashref.texi:1691
  3059. msgid "A way to write and read to and from a command."
  3060. msgstr ""
  3061. #. type: subsection
  3062. #: bashref.texi:1691 bashref.texi:2339 bashref.texi:2340
  3063. #, no-wrap
  3064. msgid "Word Splitting"
  3065. msgstr ""
  3066. #. type: menuentry
  3067. #: bashref.texi:1691
  3068. msgid "How the results of expansion are split into separate arguments."
  3069. msgstr ""
  3070. #. type: subsection
  3071. #: bashref.texi:1691 bashref.texi:2383 bashref.texi:2384
  3072. #, no-wrap
  3073. msgid "Filename Expansion"
  3074. msgstr ""
  3075. #. type: menuentry
  3076. #: bashref.texi:1691
  3077. msgid "A shorthand for specifying filenames matching patterns."
  3078. msgstr ""
  3079. #. type: subsection
  3080. #: bashref.texi:1691 bashref.texi:2536 bashref.texi:2537
  3081. #, no-wrap
  3082. msgid "Quote Removal"
  3083. msgstr ""
  3084. #. type: menuentry
  3085. #: bashref.texi:1691
  3086. msgid "How and when quote characters are removed from words."
  3087. msgstr ""
  3088. #. type: Plain text
  3089. #: bashref.texi:1699
  3090. msgid ""
  3091. "The order of expansions is: brace expansion; tilde expansion, parameter and "
  3092. "variable expansion, arithmetic expansion, and command substitution (done in "
  3093. "a left-to-right fashion); word splitting; and filename expansion."
  3094. msgstr ""
  3095. #. type: Plain text
  3096. #: bashref.texi:1705
  3097. msgid ""
  3098. "On systems that can support it, there is an additional expansion available: "
  3099. "@var{process substitution}. This is performed at the same time as tilde, "
  3100. "parameter, variable, and arithmetic expansion and command substitution."
  3101. msgstr ""
  3102. #. type: Plain text
  3103. #: bashref.texi:1709
  3104. msgid ""
  3105. "After these expansions are performed, quote characters present in the "
  3106. "original word are removed unless they have been quoted themselves "
  3107. "(@var{quote removal})."
  3108. msgstr ""
  3109. #. type: Plain text
  3110. #: bashref.texi:1716
  3111. msgid ""
  3112. "Only brace expansion, word splitting, and filename expansion can change the "
  3113. "number of words of the expansion; other expansions expand a single word to a "
  3114. "single word. The only exceptions to this are the expansions of @code{\"$@@"
  3115. "\"} (@pxref{Special Parameters}) and @code{\"$@{@var{name}[@@]@}\"} "
  3116. "(@pxref{Arrays})."
  3117. msgstr ""
  3118. #. type: Plain text
  3119. #: bashref.texi:1719
  3120. msgid ""
  3121. "After all expansions, @code{quote removal} (@pxref{Quote Removal}) is "
  3122. "performed."
  3123. msgstr ""
  3124. #. type: cindex
  3125. #: bashref.texi:1723
  3126. #, no-wrap
  3127. msgid "expansion, brace"
  3128. msgstr ""
  3129. #. type: Plain text
  3130. #: bashref.texi:1736
  3131. msgid ""
  3132. "Brace expansion is a mechanism by which arbitrary strings may be generated. "
  3133. "This mechanism is similar to @var{filename expansion} (@pxref{Filename "
  3134. "Expansion}), but the filenames generated need not exist. Patterns to be "
  3135. "brace expanded take the form of an optional @var{preamble}, followed by "
  3136. "either a series of comma-separated strings or a sequence expression between "
  3137. "a pair of braces, followed by an optional @var{postscript}. The preamble is "
  3138. "prefixed to each string contained within the braces, and the postscript is "
  3139. "then appended to each resulting string, expanding left to right."
  3140. msgstr ""
  3141. #. type: Plain text
  3142. #: bashref.texi:1741
  3143. msgid ""
  3144. "Brace expansions may be nested. The results of each expanded string are not "
  3145. "sorted; left to right order is preserved. For example,"
  3146. msgstr ""
  3147. #. type: example
  3148. #: bashref.texi:1744
  3149. #, no-wrap
  3150. msgid ""
  3151. "bash$ echo a@{d,c,b@}e\n"
  3152. "ade ace abe\n"
  3153. msgstr ""
  3154. #. type: Plain text
  3155. #: bashref.texi:1762
  3156. msgid ""
  3157. "A sequence expression takes the form @code{@{@var{x}..@var{y}[.."
  3158. "@var{incr}]@}}, where @var{x} and @var{y} are either integers or single "
  3159. "characters, and @var{incr}, an optional increment, is an integer. When "
  3160. "integers are supplied, the expression expands to each number between @var{x} "
  3161. "and @var{y}, inclusive. Supplied integers may be prefixed with @samp{0} to "
  3162. "force each term to have the same width. When either @var{x} or @var{y} "
  3163. "begins with a zero, the shell attempts to force all generated terms to "
  3164. "contain the same number of digits, zero-padding where necessary. When "
  3165. "characters are supplied, the expression expands to each character "
  3166. "lexicographically between @var{x} and @var{y}, inclusive, using the default "
  3167. "C locale. Note that both @var{x} and @var{y} must be of the same type. "
  3168. "When the increment is supplied, it is used as the difference between each "
  3169. "term. The default increment is 1 or -1 as appropriate."
  3170. msgstr ""
  3171. #. type: Plain text
  3172. #: bashref.texi:1770
  3173. msgid ""
  3174. "Brace expansion is performed before any other expansions, and any characters "
  3175. "special to other expansions are preserved in the result. It is strictly "
  3176. "textual. Bash does not apply any syntactic interpretation to the context of "
  3177. "the expansion or the text between the braces. To avoid conflicts with "
  3178. "parameter expansion, the string @samp{$@{} is not considered eligible for "
  3179. "brace expansion."
  3180. msgstr ""
  3181. #. type: Plain text
  3182. #: bashref.texi:1775
  3183. msgid ""
  3184. "A correctly-formed brace expansion must contain unquoted opening and closing "
  3185. "braces, and at least one unquoted comma or a valid sequence expression. Any "
  3186. "incorrectly formed brace expansion is left unchanged."
  3187. msgstr ""
  3188. #. type: Plain text
  3189. #: bashref.texi:1780
  3190. msgid ""
  3191. "A @{ or @samp{,} may be quoted with a backslash to prevent its being "
  3192. "considered part of a brace expression. To avoid conflicts with parameter "
  3193. "expansion, the string @samp{$@{} is not considered eligible for brace "
  3194. "expansion."
  3195. msgstr ""
  3196. #. type: Plain text
  3197. #: bashref.texi:1784
  3198. msgid ""
  3199. "This construct is typically used as shorthand when the common prefix of the "
  3200. "strings to be generated is longer than in the above example:"
  3201. msgstr ""
  3202. #. type: example
  3203. #: bashref.texi:1786
  3204. #, no-wrap
  3205. msgid "mkdir /usr/local/src/bash/@{old,new,dist,bugs@}\n"
  3206. msgstr ""
  3207. #. type: example
  3208. #: bashref.texi:1790
  3209. #, no-wrap
  3210. msgid "chown root /usr/@{ucb/@{ex,edit@},lib/@{ex?.?*,how_ex@}@}\n"
  3211. msgstr ""
  3212. #. type: cindex
  3213. #: bashref.texi:1795
  3214. #, no-wrap
  3215. msgid "expansion, tilde"
  3216. msgstr ""
  3217. #. type: Plain text
  3218. #: bashref.texi:1809
  3219. msgid ""
  3220. "If a word begins with an unquoted tilde character (@samp{~}), all of the "
  3221. "characters up to the first unquoted slash (or all characters, if there is no "
  3222. "unquoted slash) are considered a @var{tilde-prefix}. If none of the "
  3223. "characters in the tilde-prefix are quoted, the characters in the tilde-"
  3224. "prefix following the tilde are treated as a possible @var{login name}. If "
  3225. "this login name is the null string, the tilde is replaced with the value of "
  3226. "the @env{HOME} shell variable. If @env{HOME} is unset, the home directory "
  3227. "of the user executing the shell is substituted instead. Otherwise, the "
  3228. "tilde-prefix is replaced with the home directory associated with the "
  3229. "specified login name."
  3230. msgstr ""
  3231. #. type: Plain text
  3232. #: bashref.texi:1814
  3233. msgid ""
  3234. "If the tilde-prefix is @samp{~+}, the value of the shell variable @env{PWD} "
  3235. "replaces the tilde-prefix. If the tilde-prefix is @samp{~-}, the value of "
  3236. "the shell variable @env{OLDPWD}, if it is set, is substituted."
  3237. msgstr ""
  3238. #. type: Plain text
  3239. #: bashref.texi:1823
  3240. msgid ""
  3241. "If the characters following the tilde in the tilde-prefix consist of a "
  3242. "number @var{N}, optionally prefixed by a @samp{+} or a @samp{-}, the tilde-"
  3243. "prefix is replaced with the corresponding element from the directory stack, "
  3244. "as it would be displayed by the @code{dirs} builtin invoked with the "
  3245. "characters following tilde in the tilde-prefix as an argument (@pxref{The "
  3246. "Directory Stack}). If the tilde-prefix, sans the tilde, consists of a "
  3247. "number without a leading @samp{+} or @samp{-}, @samp{+} is assumed."
  3248. msgstr ""
  3249. #. type: Plain text
  3250. #: bashref.texi:1826
  3251. msgid ""
  3252. "If the login name is invalid, or the tilde expansion fails, the word is left "
  3253. "unchanged."
  3254. msgstr ""
  3255. #. type: Plain text
  3256. #: bashref.texi:1833
  3257. msgid ""
  3258. "Each variable assignment is checked for unquoted tilde-prefixes immediately "
  3259. "following a @samp{:} or the first @samp{=}. In these cases, tilde expansion "
  3260. "is also performed. Consequently, one may use filenames with tildes in "
  3261. "assignments to @env{PATH}, @env{MAILPATH}, and @env{CDPATH}, and the shell "
  3262. "assigns the expanded value."
  3263. msgstr ""
  3264. #. type: Plain text
  3265. #: bashref.texi:1835
  3266. msgid "The following table shows how Bash treats unquoted tilde-prefixes:"
  3267. msgstr ""
  3268. #. type: item
  3269. #: bashref.texi:1837
  3270. #, no-wrap
  3271. msgid "~"
  3272. msgstr ""
  3273. #. type: table
  3274. #: bashref.texi:1839
  3275. msgid "The value of @code{$HOME}"
  3276. msgstr ""
  3277. #. type: item
  3278. #: bashref.texi:1839
  3279. #, no-wrap
  3280. msgid "~/foo"
  3281. msgstr ""
  3282. #. type: file{#1}
  3283. #: bashref.texi:1841
  3284. msgid "$HOME/foo"
  3285. msgstr ""
  3286. #. type: item
  3287. #: bashref.texi:1842
  3288. #, no-wrap
  3289. msgid "~fred/foo"
  3290. msgstr ""
  3291. #. type: table
  3292. #: bashref.texi:1845
  3293. msgid ""
  3294. "The subdirectory @code{foo} of the home directory of the user @code{fred}"
  3295. msgstr ""
  3296. #. type: item
  3297. #: bashref.texi:1846
  3298. #, no-wrap
  3299. msgid "~+/foo"
  3300. msgstr ""
  3301. #. type: file{#1}
  3302. #: bashref.texi:1848
  3303. msgid "$PWD/foo"
  3304. msgstr ""
  3305. #. type: item
  3306. #: bashref.texi:1849
  3307. #, no-wrap
  3308. msgid "~-/foo"
  3309. msgstr ""
  3310. #. type: file{#1}
  3311. #: bashref.texi:1851
  3312. msgid "$@{OLDPWD-'~-'@}/foo"
  3313. msgstr ""
  3314. #. type: item
  3315. #: bashref.texi:1852
  3316. #, no-wrap
  3317. msgid "~@var{N}"
  3318. msgstr ""
  3319. #. type: table
  3320. #: bashref.texi:1854 bashref.texi:1857
  3321. msgid "The string that would be displayed by @samp{dirs +@var{N}}"
  3322. msgstr ""
  3323. #. type: item
  3324. #: bashref.texi:1855
  3325. #, no-wrap
  3326. msgid "~+@var{N}"
  3327. msgstr ""
  3328. #. type: item
  3329. #: bashref.texi:1858
  3330. #, no-wrap
  3331. msgid "~-@var{N}"
  3332. msgstr ""
  3333. #. type: table
  3334. #: bashref.texi:1860
  3335. msgid "The string that would be displayed by @samp{dirs -@var{N}}"
  3336. msgstr ""
  3337. #. type: cindex
  3338. #: bashref.texi:1864
  3339. #, no-wrap
  3340. msgid "parameter expansion"
  3341. msgstr ""
  3342. #. type: cindex
  3343. #: bashref.texi:1865
  3344. #, no-wrap
  3345. msgid "expansion, parameter"
  3346. msgstr ""
  3347. #. type: Plain text
  3348. #: bashref.texi:1873
  3349. msgid ""
  3350. "The @samp{$} character introduces parameter expansion, command substitution, "
  3351. "or arithmetic expansion. The parameter name or symbol to be expanded may be "
  3352. "enclosed in braces, which are optional but serve to protect the variable to "
  3353. "be expanded from characters immediately following it which could be "
  3354. "interpreted as part of the name."
  3355. msgstr ""
  3356. #. type: Plain text
  3357. #: bashref.texi:1878
  3358. msgid ""
  3359. "When braces are used, the matching ending brace is the first @samp{@}} not "
  3360. "escaped by a backslash or within a quoted string, and not within an embedded "
  3361. "arithmetic expansion, command substitution, or parameter expansion."
  3362. msgstr ""
  3363. #. type: Plain text
  3364. #: bashref.texi:1887
  3365. msgid ""
  3366. "The basic form of parameter expansion is $@{@var{parameter}@}. The value of "
  3367. "@var{parameter} is substituted. The @var{parameter} is a shell parameter as "
  3368. "described above (@pxref{Shell Parameters}) or an array reference "
  3369. "(@pxref{Arrays}). The braces are required when @var{parameter} is a "
  3370. "positional parameter with more than one digit, or when @var{parameter} is "
  3371. "followed by a character that is not to be interpreted as part of its name."
  3372. msgstr ""
  3373. #. type: Plain text
  3374. #: bashref.texi:1904
  3375. msgid ""
  3376. "If the first character of @var{parameter} is an exclamation point (!), and "
  3377. "@var{parameter} is not a @var{nameref}, it introduces a level of variable "
  3378. "indirection. Bash uses the value of the variable formed from the rest of "
  3379. "@var{parameter} as the name of the variable; this variable is then expanded "
  3380. "and that value is used in the rest of the substitution, rather than the "
  3381. "value of @var{parameter} itself. This is known as @code{indirect "
  3382. "expansion}. If @var{parameter} is a nameref, this expands to the name of "
  3383. "the variable referenced by @var{parameter} instead of performing the "
  3384. "complete indirect expansion. The exceptions to this are the expansions of "
  3385. "$@{!@var{prefix}*@} and $@{!@var{name}[@@]@} described below. The "
  3386. "exclamation point must immediately follow the left brace in order to "
  3387. "introduce indirection."
  3388. msgstr ""
  3389. #. type: Plain text
  3390. #: bashref.texi:1907
  3391. msgid ""
  3392. "In each of the cases below, @var{word} is subject to tilde expansion, "
  3393. "parameter expansion, command substitution, and arithmetic expansion."
  3394. msgstr ""
  3395. #. type: Plain text
  3396. #: bashref.texi:1914
  3397. msgid ""
  3398. "When not performing substring expansion, using the form described below (e."
  3399. "g., @samp{:-}), Bash tests for a parameter that is unset or null. Omitting "
  3400. "the colon results in a test only for a parameter that is unset. Put another "
  3401. "way, if the colon is included, the operator tests for both @var{parameter}'s "
  3402. "existence and that its value is not null; if the colon is omitted, the "
  3403. "operator tests only for existence."
  3404. msgstr ""
  3405. #. type: item
  3406. #: bashref.texi:1917
  3407. #, no-wrap
  3408. msgid "$@{@var{parameter}:@minus{}@var{word}@}"
  3409. msgstr ""
  3410. #. type: table
  3411. #: bashref.texi:1921
  3412. msgid ""
  3413. "If @var{parameter} is unset or null, the expansion of @var{word} is "
  3414. "substituted. Otherwise, the value of @var{parameter} is substituted."
  3415. msgstr ""
  3416. #. type: item
  3417. #: bashref.texi:1922
  3418. #, no-wrap
  3419. msgid "$@{@var{parameter}:=@var{word}@}"
  3420. msgstr ""
  3421. #. type: table
  3422. #: bashref.texi:1929
  3423. msgid ""
  3424. "If @var{parameter} is unset or null, the expansion of @var{word} is assigned "
  3425. "to @var{parameter}. The value of @var{parameter} is then substituted. "
  3426. "Positional parameters and special parameters may not be assigned to in this "
  3427. "way."
  3428. msgstr ""
  3429. #. type: item
  3430. #: bashref.texi:1930
  3431. #, no-wrap
  3432. msgid "$@{@var{parameter}:?@var{word}@}"
  3433. msgstr ""
  3434. #. type: table
  3435. #: bashref.texi:1937
  3436. msgid ""
  3437. "If @var{parameter} is null or unset, the expansion of @var{word} (or a "
  3438. "message to that effect if @var{word} is not present) is written to the "
  3439. "standard error and the shell, if it is not interactive, exits. Otherwise, "
  3440. "the value of @var{parameter} is substituted."
  3441. msgstr ""
  3442. #. type: item
  3443. #: bashref.texi:1938
  3444. #, no-wrap
  3445. msgid "$@{@var{parameter}:+@var{word}@}"
  3446. msgstr ""
  3447. #. type: table
  3448. #: bashref.texi:1942
  3449. msgid ""
  3450. "If @var{parameter} is null or unset, nothing is substituted, otherwise the "
  3451. "expansion of @var{word} is substituted."
  3452. msgstr ""
  3453. #. type: item
  3454. #: bashref.texi:1943
  3455. #, no-wrap
  3456. msgid "$@{@var{parameter}:@var{offset}@}"
  3457. msgstr ""
  3458. #. type: itemx
  3459. #: bashref.texi:1944
  3460. #, no-wrap
  3461. msgid "$@{@var{parameter}:@var{offset}:@var{length}@}"
  3462. msgstr ""
  3463. #. type: table
  3464. #: bashref.texi:1956
  3465. msgid ""
  3466. "This is referred to as Substring Expansion. It expands to up to "
  3467. "@var{length} characters of the value of @var{parameter} starting at the "
  3468. "character specified by @var{offset}. If @var{parameter} is @samp{@@}, an "
  3469. "indexed array subscripted by @samp{@@} or @samp{*}, or an associative array "
  3470. "name, the results differ as described below. If @var{length} is omitted, it "
  3471. "expands to the substring of the value of @var{parameter} starting at the "
  3472. "character specified by @var{offset} and extending to the end of the value. "
  3473. "@var{length} and @var{offset} are arithmetic expressions (@pxref{Shell "
  3474. "Arithmetic})."
  3475. msgstr ""
  3476. #. type: table
  3477. #: bashref.texi:1967
  3478. msgid ""
  3479. "If @var{offset} evaluates to a number less than zero, the value is used as "
  3480. "an offset in characters from the end of the value of @var{parameter}. If "
  3481. "@var{length} evaluates to a number less than zero, it is interpreted as an "
  3482. "offset in characters from the end of the value of @var{parameter} rather "
  3483. "than a number of characters, and the expansion is the characters between "
  3484. "@var{offset} and that result. Note that a negative offset must be separated "
  3485. "from the colon by at least one space to avoid being confused with the "
  3486. "@samp{:-} expansion."
  3487. msgstr ""
  3488. #. type: table
  3489. #: bashref.texi:1970
  3490. msgid ""
  3491. "Here are some examples illustrating substring expansion on parameters and "
  3492. "subscripted arrays:"
  3493. msgstr ""
  3494. #. type: verbatim
  3495. #: bashref.texi:1976
  3496. #, no-wrap
  3497. msgid ""
  3498. "$ string=01234567890abcdefgh\n"
  3499. "$ echo ${string:7}\n"
  3500. "7890abcdefgh\n"
  3501. "$ echo ${string:7:0}\n"
  3502. "\n"
  3503. msgstr ""
  3504. #. type: verbatim
  3505. #: bashref.texi:1984
  3506. #, no-wrap
  3507. msgid ""
  3508. "$ echo ${string:7:2}\n"
  3509. "78\n"
  3510. "$ echo ${string:7:-2}\n"
  3511. "7890abcdef\n"
  3512. "$ echo ${string: -7}\n"
  3513. "bcdefgh\n"
  3514. "$ echo ${string: -7:0}\n"
  3515. "\n"
  3516. msgstr ""
  3517. #. type: verbatim
  3518. #: bashref.texi:1993
  3519. #, no-wrap
  3520. msgid ""
  3521. "$ echo ${string: -7:2}\n"
  3522. "bc\n"
  3523. "$ echo ${string: -7:-2}\n"
  3524. "bcdef\n"
  3525. "$ set -- 01234567890abcdefgh\n"
  3526. "$ echo ${1:7}\n"
  3527. "7890abcdefgh\n"
  3528. "$ echo ${1:7:0}\n"
  3529. "\n"
  3530. msgstr ""
  3531. #. type: verbatim
  3532. #: bashref.texi:2001
  3533. #, no-wrap
  3534. msgid ""
  3535. "$ echo ${1:7:2}\n"
  3536. "78\n"
  3537. "$ echo ${1:7:-2}\n"
  3538. "7890abcdef\n"
  3539. "$ echo ${1: -7}\n"
  3540. "bcdefgh\n"
  3541. "$ echo ${1: -7:0}\n"
  3542. "\n"
  3543. msgstr ""
  3544. #. type: verbatim
  3545. #: bashref.texi:2010
  3546. #, no-wrap
  3547. msgid ""
  3548. "$ echo ${1: -7:2}\n"
  3549. "bc\n"
  3550. "$ echo ${1: -7:-2}\n"
  3551. "bcdef\n"
  3552. "$ array[0]=01234567890abcdefgh\n"
  3553. "$ echo ${array[0]:7}\n"
  3554. "7890abcdefgh\n"
  3555. "$ echo ${array[0]:7:0}\n"
  3556. "\n"
  3557. msgstr ""
  3558. #. type: verbatim
  3559. #: bashref.texi:2018
  3560. #, no-wrap
  3561. msgid ""
  3562. "$ echo ${array[0]:7:2}\n"
  3563. "78\n"
  3564. "$ echo ${array[0]:7:-2}\n"
  3565. "7890abcdef\n"
  3566. "$ echo ${array[0]: -7}\n"
  3567. "bcdefgh\n"
  3568. "$ echo ${array[0]: -7:0}\n"
  3569. "\n"
  3570. msgstr ""
  3571. #. type: verbatim
  3572. #: bashref.texi:2023
  3573. #, no-wrap
  3574. msgid ""
  3575. "$ echo ${array[0]: -7:2}\n"
  3576. "bc\n"
  3577. "$ echo ${array[0]: -7:-2}\n"
  3578. "bcdef\n"
  3579. msgstr ""
  3580. #. type: table
  3581. #: bashref.texi:2031
  3582. msgid ""
  3583. "If @var{parameter} is @samp{@@}, the result is @var{length} positional "
  3584. "parameters beginning at @var{offset}. A negative @var{offset} is taken "
  3585. "relative to one greater than the greatest positional parameter, so an offset "
  3586. "of -1 evaluates to the last positional parameter. It is an expansion error "
  3587. "if @var{length} evaluates to a number less than zero."
  3588. msgstr ""
  3589. #. type: table
  3590. #: bashref.texi:2034
  3591. msgid ""
  3592. "The following examples illustrate substring expansion using positional "
  3593. "parameters:"
  3594. msgstr ""
  3595. #. type: verbatim
  3596. #: bashref.texi:2040
  3597. #, no-wrap
  3598. msgid ""
  3599. "$ set -- 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3600. "$ echo ${@:7}\n"
  3601. "7 8 9 0 a b c d e f g h\n"
  3602. "$ echo ${@:7:0}\n"
  3603. "\n"
  3604. msgstr ""
  3605. #. type: verbatim
  3606. #: bashref.texi:2052
  3607. #, no-wrap
  3608. msgid ""
  3609. "$ echo ${@:7:2}\n"
  3610. "7 8\n"
  3611. "$ echo ${@:7:-2}\n"
  3612. "bash: -2: substring expression < 0\n"
  3613. "$ echo ${@: -7:2}\n"
  3614. "b c\n"
  3615. "$ echo ${@:0}\n"
  3616. "./bash 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3617. "$ echo ${@:0:2}\n"
  3618. "./bash 1\n"
  3619. "$ echo ${@: -7:0}\n"
  3620. "\n"
  3621. msgstr ""
  3622. #. type: table
  3623. #: bashref.texi:2061
  3624. msgid ""
  3625. "If @var{parameter} is an indexed array name subscripted by @samp{@@} or "
  3626. "@samp{*}, the result is the @var{length} members of the array beginning with "
  3627. "@code{$@{@var{parameter}[@var{offset}]@}}. A negative @var{offset} is taken "
  3628. "relative to one greater than the maximum index of the specified array. It "
  3629. "is an expansion error if @var{length} evaluates to a number less than zero."
  3630. msgstr ""
  3631. #. type: table
  3632. #: bashref.texi:2064
  3633. msgid ""
  3634. "These examples show how you can use substring expansion with indexed arrays:"
  3635. msgstr ""
  3636. #. type: verbatim
  3637. #: bashref.texi:2080
  3638. #, no-wrap
  3639. msgid ""
  3640. "$ array=(0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h)\n"
  3641. "$ echo ${array[@]:7}\n"
  3642. "7 8 9 0 a b c d e f g h\n"
  3643. "$ echo ${array[@]:7:2}\n"
  3644. "7 8\n"
  3645. "$ echo ${array[@]: -7:2}\n"
  3646. "b c\n"
  3647. "$ echo ${array[@]: -7:-2}\n"
  3648. "bash: -2: substring expression < 0\n"
  3649. "$ echo ${array[@]:0}\n"
  3650. "0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3651. "$ echo ${array[@]:0:2}\n"
  3652. "0 1\n"
  3653. "$ echo ${array[@]: -7:0}\n"
  3654. "\n"
  3655. msgstr ""
  3656. #. type: table
  3657. #: bashref.texi:2085
  3658. msgid ""
  3659. "Substring expansion applied to an associative array produces undefined "
  3660. "results."
  3661. msgstr ""
  3662. #. type: table
  3663. #: bashref.texi:2090
  3664. msgid ""
  3665. "Substring indexing is zero-based unless the positional parameters are used, "
  3666. "in which case the indexing starts at 1 by default. If @var{offset} is 0, "
  3667. "and the positional parameters are used, @code{$@@} is prefixed to the list."
  3668. msgstr ""
  3669. #. type: item
  3670. #: bashref.texi:2091
  3671. #, no-wrap
  3672. msgid "$@{!@var{prefix}*@}"
  3673. msgstr ""
  3674. #. type: itemx
  3675. #: bashref.texi:2092
  3676. #, no-wrap
  3677. msgid "$@{!@var{prefix}@@@}"
  3678. msgstr ""
  3679. #. type: table
  3680. #: bashref.texi:2097
  3681. msgid ""
  3682. "Expands to the names of variables whose names begin with @var{prefix}, "
  3683. "separated by the first character of the @env{IFS} special variable. When "
  3684. "@samp{@@} is used and the expansion appears within double quotes, each "
  3685. "variable name expands to a separate word."
  3686. msgstr ""
  3687. #. type: item
  3688. #: bashref.texi:2098
  3689. #, no-wrap
  3690. msgid "$@{!@var{name}[@@]@}"
  3691. msgstr ""
  3692. #. type: itemx
  3693. #: bashref.texi:2099
  3694. #, no-wrap
  3695. msgid "$@{!@var{name}[*]@}"
  3696. msgstr ""
  3697. #. type: table
  3698. #: bashref.texi:2106
  3699. msgid ""
  3700. "If @var{name} is an array variable, expands to the list of array indices "
  3701. "(keys) assigned in @var{name}. If @var{name} is not an array, expands to 0 "
  3702. "if @var{name} is set and null otherwise. When @samp{@@} is used and the "
  3703. "expansion appears within double quotes, each key expands to a separate word."
  3704. msgstr ""
  3705. #. type: item
  3706. #: bashref.texi:2107
  3707. #, no-wrap
  3708. msgid "$@{#@var{parameter}@}"
  3709. msgstr ""
  3710. #. type: table
  3711. #: bashref.texi:2119
  3712. msgid ""
  3713. "The length in characters of the expanded value of @var{parameter} is "
  3714. "substituted. If @var{parameter} is @samp{*} or @samp{@@}, the value "
  3715. "substituted is the number of positional parameters. If @var{parameter} is "
  3716. "an array name subscripted by @samp{*} or @samp{@@}, the value substituted is "
  3717. "the number of elements in the array. If @var{parameter} is an indexed array "
  3718. "name subscripted by a negative number, that number is interpreted as "
  3719. "relative to one greater than the maximum index of @var{parameter}, so "
  3720. "negative indices count back from the end of the array, and an index of -1 "
  3721. "references the last element."
  3722. msgstr ""
  3723. #. type: item
  3724. #: bashref.texi:2120
  3725. #, no-wrap
  3726. msgid "$@{@var{parameter}#@var{word}@}"
  3727. msgstr ""
  3728. #. type: itemx
  3729. #: bashref.texi:2121
  3730. #, no-wrap
  3731. msgid "$@{@var{parameter}##@var{word}@}"
  3732. msgstr ""
  3733. #. type: table
  3734. #: bashref.texi:2136
  3735. msgid ""
  3736. "The @var{word} is expanded to produce a pattern just as in filename "
  3737. "expansion (@pxref{Filename Expansion}). If the pattern matches the "
  3738. "beginning of the expanded value of @var{parameter}, then the result of the "
  3739. "expansion is the expanded value of @var{parameter} with the shortest "
  3740. "matching pattern (the @samp{#} case) or the longest matching pattern (the "
  3741. "@samp{##} case) deleted. If @var{parameter} is @samp{@@} or @samp{*}, the "
  3742. "pattern removal operation is applied to each positional parameter in turn, "
  3743. "and the expansion is the resultant list. If @var{parameter} is an array "
  3744. "variable subscripted with @samp{@@} or @samp{*}, the pattern removal "
  3745. "operation is applied to each member of the array in turn, and the expansion "
  3746. "is the resultant list."
  3747. msgstr ""
  3748. #. type: item
  3749. #: bashref.texi:2137
  3750. #, no-wrap
  3751. msgid "$@{@var{parameter}%@var{word}@}"
  3752. msgstr ""
  3753. #. type: itemx
  3754. #: bashref.texi:2138
  3755. #, no-wrap
  3756. msgid "$@{@var{parameter}%%@var{word}@}"
  3757. msgstr ""
  3758. #. type: table
  3759. #: bashref.texi:2152
  3760. msgid ""
  3761. "The @var{word} is expanded to produce a pattern just as in filename "
  3762. "expansion. If the pattern matches a trailing portion of the expanded value "
  3763. "of @var{parameter}, then the result of the expansion is the value of "
  3764. "@var{parameter} with the shortest matching pattern (the @samp{%} case) or "
  3765. "the longest matching pattern (the @samp{%%} case) deleted. If "
  3766. "@var{parameter} is @samp{@@} or @samp{*}, the pattern removal operation is "
  3767. "applied to each positional parameter in turn, and the expansion is the "
  3768. "resultant list. If @var{parameter} is an array variable subscripted with "
  3769. "@samp{@@} or @samp{*}, the pattern removal operation is applied to each "
  3770. "member of the array in turn, and the expansion is the resultant list."
  3771. msgstr ""
  3772. #. type: item
  3773. #: bashref.texi:2153
  3774. #, no-wrap
  3775. msgid "$@{@var{parameter}/@var{pattern}/@var{string}@}"
  3776. msgstr ""
  3777. #. type: table
  3778. #: bashref.texi:2178
  3779. msgid ""
  3780. "The @var{pattern} is expanded to produce a pattern just as in filename "
  3781. "expansion. @var{Parameter} is expanded and the longest match of "
  3782. "@var{pattern} against its value is replaced with @var{string}. If "
  3783. "@var{pattern} begins with @samp{/}, all matches of @var{pattern} are "
  3784. "replaced with @var{string}. Normally only the first match is replaced. If "
  3785. "@var{pattern} begins with @samp{#}, it must match at the beginning of the "
  3786. "expanded value of @var{parameter}. If @var{pattern} begins with @samp{%}, "
  3787. "it must match at the end of the expanded value of @var{parameter}. If "
  3788. "@var{string} is null, matches of @var{pattern} are deleted and the @code{/} "
  3789. "following @var{pattern} may be omitted. If the @code{nocasematch} shell "
  3790. "option (see the description of @code{shopt} in @ref{The Shopt Builtin}) is "
  3791. "enabled, the match is performed without regard to the case of alphabetic "
  3792. "characters. If @var{parameter} is @samp{@@} or @samp{*}, the substitution "
  3793. "operation is applied to each positional parameter in turn, and the expansion "
  3794. "is the resultant list. If @var{parameter} is an array variable subscripted "
  3795. "with @samp{@@} or @samp{*}, the substitution operation is applied to each "
  3796. "member of the array in turn, and the expansion is the resultant list."
  3797. msgstr ""
  3798. #. type: item
  3799. #: bashref.texi:2179
  3800. #, no-wrap
  3801. msgid "$@{@var{parameter}^@var{pattern}@}"
  3802. msgstr ""
  3803. #. type: itemx
  3804. #: bashref.texi:2180
  3805. #, no-wrap
  3806. msgid "$@{@var{parameter}^^@var{pattern}@}"
  3807. msgstr ""
  3808. #. type: itemx
  3809. #: bashref.texi:2181
  3810. #, no-wrap
  3811. msgid "$@{@var{parameter},@var{pattern}@}"
  3812. msgstr ""
  3813. #. type: itemx
  3814. #: bashref.texi:2182
  3815. #, no-wrap
  3816. msgid "$@{@var{parameter},,@var{pattern}@}"
  3817. msgstr ""
  3818. #. type: table
  3819. #: bashref.texi:2204
  3820. msgid ""
  3821. "This expansion modifies the case of alphabetic characters in "
  3822. "@var{parameter}. The @var{pattern} is expanded to produce a pattern just as "
  3823. "in filename expansion. Each character in the expanded value of "
  3824. "@var{parameter} is tested against @var{pattern}, and, if it matches the "
  3825. "pattern, its case is converted. The pattern should not attempt to match "
  3826. "more than one character. The @samp{^} operator converts lowercase letters "
  3827. "matching @var{pattern} to uppercase; the @samp{,} operator converts matching "
  3828. "uppercase letters to lowercase. The @samp{^^} and @samp{,,} expansions "
  3829. "convert each matched character in the expanded value; the @samp{^} and "
  3830. "@samp{,} expansions match and convert only the first character in the "
  3831. "expanded value. If @var{pattern} is omitted, it is treated like a @samp{?}, "
  3832. "which matches every character. If @var{parameter} is @samp{@@} or @samp{*}, "
  3833. "the case modification operation is applied to each positional parameter in "
  3834. "turn, and the expansion is the resultant list. If @var{parameter} is an "
  3835. "array variable subscripted with @samp{@@} or @samp{*}, the case modification "
  3836. "operation is applied to each member of the array in turn, and the expansion "
  3837. "is the resultant list."
  3838. msgstr ""
  3839. #. type: item
  3840. #: bashref.texi:2205
  3841. #, no-wrap
  3842. msgid "$@{@var{parameter}@@@var{operator}@}"
  3843. msgstr ""
  3844. #. type: table
  3845. #: bashref.texi:2209
  3846. msgid ""
  3847. "The expansion is either a transformation of the value of @var{parameter} or "
  3848. "information about @var{parameter} itself, depending on the value of "
  3849. "@var{operator}. Each @var{operator} is a single letter:"
  3850. msgstr ""
  3851. #. type: item
  3852. #: bashref.texi:2211
  3853. #, no-wrap
  3854. msgid "Q"
  3855. msgstr ""
  3856. #. type: table
  3857. #: bashref.texi:2214
  3858. msgid ""
  3859. "The expansion is a string that is the value of @var{parameter} quoted in a "
  3860. "format that can be reused as input."
  3861. msgstr ""
  3862. #. type: item
  3863. #: bashref.texi:2214
  3864. #, no-wrap
  3865. msgid "E"
  3866. msgstr ""
  3867. #. type: table
  3868. #: bashref.texi:2217
  3869. msgid ""
  3870. "The expansion is a string that is the value of @var{parameter} with "
  3871. "backslash escape sequences expanded as with the @code{$'@dots{}'} quoting "
  3872. "mechansim."
  3873. msgstr ""
  3874. #. type: item
  3875. #: bashref.texi:2217
  3876. #, no-wrap
  3877. msgid "P"
  3878. msgstr ""
  3879. #. type: table
  3880. #: bashref.texi:2220
  3881. msgid ""
  3882. "The expansion is a string that is the result of expanding the value of "
  3883. "@var{parameter} as if it were a prompt string (@pxref{Controlling the "
  3884. "Prompt})."
  3885. msgstr ""
  3886. #. type: item
  3887. #: bashref.texi:2220
  3888. #, no-wrap
  3889. msgid "A"
  3890. msgstr ""
  3891. #. type: table
  3892. #: bashref.texi:2224
  3893. msgid ""
  3894. "The expansion is a string in the form of an assignment statement or "
  3895. "@code{declare} command that, if evaluated, will recreate @var{parameter} "
  3896. "with its attributes and value."
  3897. msgstr ""
  3898. #. type: item
  3899. #: bashref.texi:2224
  3900. #, no-wrap
  3901. msgid "a"
  3902. msgstr ""
  3903. #. type: table
  3904. #: bashref.texi:2227
  3905. msgid ""
  3906. "The expansion is a string consisting of flag values representing "
  3907. "@var{parameter}'s attributes."
  3908. msgstr ""
  3909. #. type: table
  3910. #: bashref.texi:2236
  3911. msgid ""
  3912. "If @var{parameter} is @samp{@@} or @samp{*}, the operation is applied to "
  3913. "each positional parameter in turn, and the expansion is the resultant list. "
  3914. "If @var{parameter} is an array variable subscripted with @samp{@@} or "
  3915. "@samp{*}, the operation is applied to each member of the array in turn, and "
  3916. "the expansion is the resultant list."
  3917. msgstr ""
  3918. #. type: table
  3919. #: bashref.texi:2239
  3920. msgid ""
  3921. "The result of the expansion is subject to word splitting and pathname "
  3922. "expansion as described below."
  3923. msgstr ""
  3924. #. type: Plain text
  3925. #: bashref.texi:2248
  3926. msgid ""
  3927. "Command substitution allows the output of a command to replace the command "
  3928. "itself. Command substitution occurs when a command is enclosed as follows:"
  3929. msgstr ""
  3930. #. type: example
  3931. #: bashref.texi:2250
  3932. #, no-wrap
  3933. msgid "$(@var{command})\n"
  3934. msgstr ""
  3935. #. type: example
  3936. #: bashref.texi:2255
  3937. #, no-wrap
  3938. msgid "`@var{command}`\n"
  3939. msgstr ""
  3940. #. type: Plain text
  3941. #: bashref.texi:2265
  3942. msgid ""
  3943. "Bash performs the expansion by executing @var{command} in a subshell "
  3944. "environment and replacing the command substitution with the standard output "
  3945. "of the command, with any trailing newlines deleted. Embedded newlines are "
  3946. "not deleted, but they may be removed during word splitting. The command "
  3947. "substitution @code{$(cat @var{file})} can be replaced by the equivalent but "
  3948. "faster @code{$(< @var{file})}."
  3949. msgstr ""
  3950. #. type: Plain text
  3951. #: bashref.texi:2273
  3952. msgid ""
  3953. "When the old-style backquote form of substitution is used, backslash retains "
  3954. "its literal meaning except when followed by @samp{$}, @samp{`}, or "
  3955. "@samp{\\}. The first backquote not preceded by a backslash terminates the "
  3956. "command substitution. When using the @code{$(@var{command})} form, all "
  3957. "characters between the parentheses make up the command; none are treated "
  3958. "specially."
  3959. msgstr ""
  3960. #. type: Plain text
  3961. #: bashref.texi:2276
  3962. msgid ""
  3963. "Command substitutions may be nested. To nest when using the backquoted "
  3964. "form, escape the inner backquotes with backslashes."
  3965. msgstr ""
  3966. #. type: Plain text
  3967. #: bashref.texi:2279
  3968. msgid ""
  3969. "If the substitution appears within double quotes, word splitting and "
  3970. "filename expansion are not performed on the results."
  3971. msgstr ""
  3972. #. type: cindex
  3973. #: bashref.texi:2282
  3974. #, no-wrap
  3975. msgid "expansion, arithmetic"
  3976. msgstr ""
  3977. #. type: Plain text
  3978. #: bashref.texi:2287
  3979. msgid ""
  3980. "Arithmetic expansion allows the evaluation of an arithmetic expression and "
  3981. "the substitution of the result. The format for arithmetic expansion is:"
  3982. msgstr ""
  3983. #. type: example
  3984. #: bashref.texi:2290
  3985. #, no-wrap
  3986. msgid "$(( @var{expression} ))\n"
  3987. msgstr ""
  3988. #. type: Plain text
  3989. #: bashref.texi:2298
  3990. msgid ""
  3991. "The expression is treated as if it were within double quotes, but a double "
  3992. "quote inside the parentheses is not treated specially. All tokens in the "
  3993. "expression undergo parameter and variable expansion, command substitution, "
  3994. "and quote removal. The result is treated as the arithmetic expression to be "
  3995. "evaluated. Arithmetic expansions may be nested."
  3996. msgstr ""
  3997. #. type: Plain text
  3998. #: bashref.texi:2303
  3999. msgid ""
  4000. "The evaluation is performed according to the rules listed below "
  4001. "(@pxref{Shell Arithmetic}). If the expression is invalid, Bash prints a "
  4002. "message indicating failure to the standard error and no substitution occurs."
  4003. msgstr ""
  4004. #. type: cindex
  4005. #: bashref.texi:2306
  4006. #, no-wrap
  4007. msgid "process substitution"
  4008. msgstr ""
  4009. #. type: Plain text
  4010. #: bashref.texi:2311
  4011. msgid ""
  4012. "Process substitution allows a process's input or output to be referred to "
  4013. "using a filename. It takes the form of"
  4014. msgstr ""
  4015. #. type: example
  4016. #: bashref.texi:2313
  4017. #, no-wrap
  4018. msgid "<(@var{list})\n"
  4019. msgstr ""
  4020. #. type: example
  4021. #: bashref.texi:2318
  4022. #, no-wrap
  4023. msgid ">(@var{list})\n"
  4024. msgstr ""
  4025. #. type: Plain text
  4026. #: bashref.texi:2334
  4027. msgid ""
  4028. "The process @var{list} is run asynchronously, and its input or output "
  4029. "appears as a filename. This filename is passed as an argument to the "
  4030. "current command as the result of the expansion. If the @code{>(@var{list})} "
  4031. "form is used, writing to the file will provide input for @var{list}. If the "
  4032. "@code{<(@var{list})} form is used, the file passed as an argument should be "
  4033. "read to obtain the output of @var{list}. Note that no space may appear "
  4034. "between the @code{<} or @code{>} and the left parenthesis, otherwise the "
  4035. "construct would be interpreted as a redirection. Process substitution is "
  4036. "supported on systems that support named pipes (@sc{fifo}s) or the @file{/dev/"
  4037. "fd} method of naming open files."
  4038. msgstr ""
  4039. #. type: Plain text
  4040. #: bashref.texi:2338
  4041. msgid ""
  4042. "When available, process substitution is performed simultaneously with "
  4043. "parameter and variable expansion, command substitution, and arithmetic "
  4044. "expansion."
  4045. msgstr ""
  4046. #. type: Plain text
  4047. #: bashref.texi:2346
  4048. msgid ""
  4049. "The shell scans the results of parameter expansion, command substitution, "
  4050. "and arithmetic expansion that did not occur within double quotes for word "
  4051. "splitting."
  4052. msgstr ""
  4053. #. type: Plain text
  4054. #: bashref.texi:2366
  4055. msgid ""
  4056. "The shell treats each character of @env{$IFS} as a delimiter, and splits the "
  4057. "results of the other expansions into words using these characters as field "
  4058. "terminators. If @env{IFS} is unset, or its value is exactly "
  4059. "@code{<space><tab><newline>}, the default, then sequences of "
  4060. "@code{ <space>}, @code{<tab>}, and @code{<newline>} at the beginning and end "
  4061. "of the results of the previous expansions are ignored, and any sequence of "
  4062. "@env{IFS} characters not at the beginning or end serves to delimit words. "
  4063. "If @env{IFS} has a value other than the default, then sequences of the "
  4064. "whitespace characters @code{space}, @code{tab}, and @code{newline} are "
  4065. "ignored at the beginning and end of the word, as long as the whitespace "
  4066. "character is in the value of @env{IFS} (an @env{IFS} whitespace character). "
  4067. "Any character in @env{IFS} that is not @env{IFS} whitespace, along with any "
  4068. "adjacent @env{IFS} whitespace characters, delimits a field. A sequence of "
  4069. "@env{IFS} whitespace characters is also treated as a delimiter. If the "
  4070. "value of @env{IFS} is null, no word splitting occurs."
  4071. msgstr ""
  4072. #. type: Plain text
  4073. #: bashref.texi:2379
  4074. msgid ""
  4075. "Explicit null arguments (@code{\"\"} or @code{''}) are retained and passed "
  4076. "to commands as empty strings. Unquoted implicit null arguments, resulting "
  4077. "from the expansion of parameters that have no values, are removed. If a "
  4078. "parameter with no value is expanded within double quotes, a null argument "
  4079. "results and is retained and passed to a command as an empty string. When a "
  4080. "quoted null argument appears as part of a word whose expansion is non-null, "
  4081. "the null argument is removed. That is, the word @code{-d''} becomes @code{-"
  4082. "d} after word splitting and null argument removal."
  4083. msgstr ""
  4084. #. type: Plain text
  4085. #: bashref.texi:2382
  4086. msgid "Note that if no expansion occurs, no splitting is performed."
  4087. msgstr ""
  4088. #. type: subsubsection
  4089. #: bashref.texi:2387 bashref.texi:2441 bashref.texi:2442
  4090. #, no-wrap
  4091. msgid "Pattern Matching"
  4092. msgstr ""
  4093. #. type: menuentry
  4094. #: bashref.texi:2387
  4095. msgid "How the shell matches patterns."
  4096. msgstr ""
  4097. #. type: cindex
  4098. #: bashref.texi:2388
  4099. #, no-wrap
  4100. msgid "expansion, filename"
  4101. msgstr ""
  4102. #. type: cindex
  4103. #: bashref.texi:2389
  4104. #, no-wrap
  4105. msgid "expansion, pathname"
  4106. msgstr ""
  4107. #. type: cindex
  4108. #: bashref.texi:2391
  4109. #, no-wrap
  4110. msgid "pathname expansion"
  4111. msgstr ""
  4112. #. type: Plain text
  4113. #: bashref.texi:2409
  4114. msgid ""
  4115. "After word splitting, unless the @option{-f} option has been set (@pxref{The "
  4116. "Set Builtin}), Bash scans each word for the characters @samp{*}, @samp{?}, "
  4117. "and @samp{[}. If one of these characters appears, then the word is regarded "
  4118. "as a @var{pattern}, and replaced with an alphabetically sorted list of "
  4119. "filenames matching the pattern (@pxref{Pattern Matching}). If no matching "
  4120. "filenames are found, and the shell option @code{nullglob} is disabled, the "
  4121. "word is left unchanged. If the @code{nullglob} option is set, and no "
  4122. "matches are found, the word is removed. If the @code{failglob} shell option "
  4123. "is set, and no matches are found, an error message is printed and the "
  4124. "command is not executed. If the shell option @code{nocaseglob} is enabled, "
  4125. "the match is performed without regard to the case of alphabetic characters."
  4126. msgstr ""
  4127. #. type: Plain text
  4128. #: bashref.texi:2416
  4129. msgid ""
  4130. "When a pattern is used for filename expansion, the character @samp{.} at the "
  4131. "start of a filename or immediately following a slash must be matched "
  4132. "explicitly, unless the shell option @code{dotglob} is set. When matching a "
  4133. "filename, the slash character must always be matched explicitly. In other "
  4134. "cases, the @samp{.} character is not treated specially."
  4135. msgstr ""
  4136. #. type: Plain text
  4137. #: bashref.texi:2420
  4138. msgid ""
  4139. "See the description of @code{shopt} in @ref{The Shopt Builtin}, for a "
  4140. "description of the @code{nocaseglob}, @code{nullglob}, @code{failglob}, and "
  4141. "@code{dotglob} options."
  4142. msgstr ""
  4143. #. type: Plain text
  4144. #: bashref.texi:2440
  4145. msgid ""
  4146. "The @env{GLOBIGNORE} shell variable may be used to restrict the set of "
  4147. "filenames matching a pattern. If @env{GLOBIGNORE} is set, each matching "
  4148. "filename that also matches one of the patterns in @env{GLOBIGNORE} is "
  4149. "removed from the list of matches. If the @code{nocaseglob} option is set, "
  4150. "the matching against the patterns in @env{GLOBIGNORE} is performed without "
  4151. "regard to case. The filenames @file{.} and @file{..} are always ignored "
  4152. "when @env{GLOBIGNORE} is set and not null. However, setting "
  4153. "@env{GLOBIGNORE} to a non-null value has the effect of enabling the "
  4154. "@code{dotglob} shell option, so all other filenames beginning with a "
  4155. "@samp{.} will match. To get the old behavior of ignoring filenames "
  4156. "beginning with a @samp{.}, make @samp{.*} one of the patterns in "
  4157. "@env{GLOBIGNORE}. The @code{dotglob} option is disabled when "
  4158. "@env{GLOBIGNORE} is unset."
  4159. msgstr ""
  4160. #. type: cindex
  4161. #: bashref.texi:2443
  4162. #, no-wrap
  4163. msgid "pattern matching"
  4164. msgstr ""
  4165. #. type: cindex
  4166. #: bashref.texi:2444
  4167. #, no-wrap
  4168. msgid "matching, pattern"
  4169. msgstr ""
  4170. #. type: Plain text
  4171. #: bashref.texi:2453
  4172. msgid ""
  4173. "Any character that appears in a pattern, other than the special pattern "
  4174. "characters described below, matches itself. The @sc{nul} character may not "
  4175. "occur in a pattern. A backslash escapes the following character; the "
  4176. "escaping backslash is discarded when matching. The special pattern "
  4177. "characters must be quoted if they are to be matched literally."
  4178. msgstr ""
  4179. #. type: Plain text
  4180. #: bashref.texi:2455
  4181. msgid "The special pattern characters have the following meanings:"
  4182. msgstr ""
  4183. #. type: table
  4184. #: bashref.texi:2464
  4185. msgid ""
  4186. "Matches any string, including the null string. When the @code{globstar} "
  4187. "shell option is enabled, and @samp{*} is used in a filename expansion "
  4188. "context, two adjacent @samp{*}s used as a single pattern will match all "
  4189. "files and zero or more directories and subdirectories. If followed by a "
  4190. "@samp{/}, two adjacent @samp{*}s will match only directories and "
  4191. "subdirectories."
  4192. msgstr ""
  4193. #. type: table
  4194. #: bashref.texi:2466
  4195. msgid "Matches any single character."
  4196. msgstr ""
  4197. #. type: item
  4198. #: bashref.texi:2466
  4199. #, no-wrap
  4200. msgid "[@dots{}]"
  4201. msgstr ""
  4202. #. type: table
  4203. #: bashref.texi:2480
  4204. msgid ""
  4205. "Matches any one of the enclosed characters. A pair of characters separated "
  4206. "by a hyphen denotes a @var{range expression}; any character that falls "
  4207. "between those two characters, inclusive, using the current locale's "
  4208. "collating sequence and character set, is matched. If the first character "
  4209. "following the @samp{[} is a @samp{!} or a @samp{^} then any character not "
  4210. "enclosed is matched. A @samp{@minus{}} may be matched by including it as "
  4211. "the first or last character in the set. A @samp{]} may be matched by "
  4212. "including it as the first character in the set. The sorting order of "
  4213. "characters in range expressions is determined by the current locale and the "
  4214. "values of the @env{LC_COLLATE} and @env{LC_ALL} shell variables, if set."
  4215. msgstr ""
  4216. #. type: table
  4217. #: bashref.texi:2489
  4218. msgid ""
  4219. "For example, in the default C locale, @samp{[a-dx-z]} is equivalent to "
  4220. "@samp{[abcdxyz]}. Many locales sort characters in dictionary order, and in "
  4221. "these locales @samp{[a-dx-z]} is typically not equivalent to "
  4222. "@samp{[abcdxyz]}; it might be equivalent to @samp{[aBbCcDdxXyYz]}, for "
  4223. "example. To obtain the traditional interpretation of ranges in bracket "
  4224. "expressions, you can force the use of the C locale by setting the "
  4225. "@env{LC_COLLATE} or @env{LC_ALL} environment variable to the value @samp{C}, "
  4226. "or enable the @code{globasciiranges} shell option."
  4227. msgstr ""
  4228. #. type: table
  4229. #: bashref.texi:2494
  4230. msgid ""
  4231. "Within @samp{[} and @samp{]}, @var{character classes} can be specified using "
  4232. "the syntax @code{[:}@var{class}@code{:]}, where @var{class} is one of the "
  4233. "following classes defined in the @sc{posix} standard:"
  4234. msgstr ""
  4235. #. type: example
  4236. #: bashref.texi:2497
  4237. #, no-wrap
  4238. msgid ""
  4239. "alnum alpha ascii blank cntrl digit graph lower\n"
  4240. "print punct space upper word xdigit\n"
  4241. msgstr ""
  4242. #. type: table
  4243. #: bashref.texi:2502
  4244. msgid ""
  4245. "A character class matches any character belonging to that class. The "
  4246. "@code{word} character class matches letters, digits, and the character "
  4247. "@samp{_}."
  4248. msgstr ""
  4249. #. type: table
  4250. #: bashref.texi:2507
  4251. msgid ""
  4252. "Within @samp{[} and @samp{]}, an @var{equivalence class} can be specified "
  4253. "using the syntax @code{[=}@var{c}@code{=]}, which matches all characters "
  4254. "with the same collation weight (as defined by the current locale) as the "
  4255. "character @var{c}."
  4256. msgstr ""
  4257. #. type: table
  4258. #: bashref.texi:2510
  4259. msgid ""
  4260. "Within @samp{[} and @samp{]}, the syntax @code{[.}@var{symbol}@code{.]} "
  4261. "matches the collating symbol @var{symbol}."
  4262. msgstr ""
  4263. #. type: Plain text
  4264. #: bashref.texi:2518
  4265. msgid ""
  4266. "If the @code{extglob} shell option is enabled using the @code{shopt} "
  4267. "builtin, several extended pattern matching operators are recognized. In the "
  4268. "following description, a @var{pattern-list} is a list of one or more "
  4269. "patterns separated by a @samp{|}. Composite patterns may be formed using "
  4270. "one or more of the following sub-patterns:"
  4271. msgstr ""
  4272. #. type: item
  4273. #: bashref.texi:2520
  4274. #, no-wrap
  4275. msgid "?(@var{pattern-list})"
  4276. msgstr ""
  4277. #. type: table
  4278. #: bashref.texi:2522
  4279. msgid "Matches zero or one occurrence of the given patterns."
  4280. msgstr ""
  4281. #. type: item
  4282. #: bashref.texi:2523
  4283. #, no-wrap
  4284. msgid "*(@var{pattern-list})"
  4285. msgstr ""
  4286. #. type: table
  4287. #: bashref.texi:2525
  4288. msgid "Matches zero or more occurrences of the given patterns."
  4289. msgstr ""
  4290. #. type: item
  4291. #: bashref.texi:2526
  4292. #, no-wrap
  4293. msgid "+(@var{pattern-list})"
  4294. msgstr ""
  4295. #. type: table
  4296. #: bashref.texi:2528
  4297. msgid "Matches one or more occurrences of the given patterns."
  4298. msgstr ""
  4299. #. type: item
  4300. #: bashref.texi:2529
  4301. #, no-wrap
  4302. msgid "@@(@var{pattern-list})"
  4303. msgstr ""
  4304. #. type: table
  4305. #: bashref.texi:2531
  4306. msgid "Matches one of the given patterns."
  4307. msgstr ""
  4308. #. type: item
  4309. #: bashref.texi:2532
  4310. #, no-wrap
  4311. msgid "!(@var{pattern-list})"
  4312. msgstr ""
  4313. #. type: table
  4314. #: bashref.texi:2534
  4315. msgid "Matches anything except one of the given patterns."
  4316. msgstr ""
  4317. #. type: Plain text
  4318. #: bashref.texi:2542
  4319. msgid ""
  4320. "After the preceding expansions, all unquoted occurrences of the characters "
  4321. "@samp{\\}, @samp{'}, and @samp{\"} that did not result from one of the above "
  4322. "expansions are removed."
  4323. msgstr ""
  4324. #. type: cindex
  4325. #: bashref.texi:2545
  4326. #, no-wrap
  4327. msgid "redirection"
  4328. msgstr ""
  4329. #. type: Plain text
  4330. #: bashref.texi:2560
  4331. msgid ""
  4332. "Before a command is executed, its input and output may be @var{redirected} "
  4333. "using a special notation interpreted by the shell. Redirection allows "
  4334. "commands' file handles to be duplicated, opened, closed, made to refer to "
  4335. "different files, and can change the files the command reads from and writes "
  4336. "to. Redirection may also be used to modify file handles in the current "
  4337. "shell execution environment. The following redirection operators may "
  4338. "precede or appear anywhere within a simple command or may follow a command. "
  4339. "Redirections are processed in the order they appear, from left to right."
  4340. msgstr ""
  4341. #. type: Plain text
  4342. #: bashref.texi:2568
  4343. msgid ""
  4344. "Each redirection that may be preceded by a file descriptor number may "
  4345. "instead be preceded by a word of the form @{@var{varname}@}. In this case, "
  4346. "for each redirection operator except >&- and <&-, the shell will allocate a "
  4347. "file descriptor greater than 10 and assign it to @{@var{varname}@}. If >&- "
  4348. "or <&- is preceded by @{@var{varname}@}, the value of @var{varname} defines "
  4349. "the file descriptor to close."
  4350. msgstr ""
  4351. #. type: Plain text
  4352. #: bashref.texi:2575
  4353. msgid ""
  4354. "In the following descriptions, if the file descriptor number is omitted, and "
  4355. "the first character of the redirection operator is @samp{<}, the redirection "
  4356. "refers to the standard input (file descriptor 0). If the first character of "
  4357. "the redirection operator is @samp{>}, the redirection refers to the standard "
  4358. "output (file descriptor 1)."
  4359. msgstr ""
  4360. #. type: Plain text
  4361. #: bashref.texi:2581
  4362. msgid ""
  4363. "The word following the redirection operator in the following descriptions, "
  4364. "unless otherwise noted, is subjected to brace expansion, tilde expansion, "
  4365. "parameter expansion, command substitution, arithmetic expansion, quote "
  4366. "removal, filename expansion, and word splitting. If it expands to more than "
  4367. "one word, Bash reports an error."
  4368. msgstr ""
  4369. #. type: Plain text
  4370. #: bashref.texi:2584
  4371. msgid ""
  4372. "Note that the order of redirections is significant. For example, the command"
  4373. msgstr ""
  4374. #. type: example
  4375. #: bashref.texi:2586
  4376. #, no-wrap
  4377. msgid "ls > @var{dirlist} 2>&1\n"
  4378. msgstr ""
  4379. #. type: Plain text
  4380. #: bashref.texi:2590
  4381. msgid ""
  4382. "directs both standard output (file descriptor 1) and standard error (file "
  4383. "descriptor 2) to the file @var{dirlist}, while the command"
  4384. msgstr ""
  4385. #. type: example
  4386. #: bashref.texi:2592
  4387. #, no-wrap
  4388. msgid "ls 2>&1 > @var{dirlist}\n"
  4389. msgstr ""
  4390. #. type: Plain text
  4391. #: bashref.texi:2597
  4392. msgid ""
  4393. "directs only the standard output to file @var{dirlist}, because the standard "
  4394. "error was made a copy of the standard output before the standard output was "
  4395. "redirected to @var{dirlist}."
  4396. msgstr ""
  4397. #. type: Plain text
  4398. #: bashref.texi:2603
  4399. msgid ""
  4400. "Bash handles several filenames specially when they are used in redirections, "
  4401. "as described in the following table. If the operating system on which Bash "
  4402. "is running provides these special files, bash will use them; otherwise it "
  4403. "will emulate them internally with the behavior described below."
  4404. msgstr ""
  4405. #. type: item
  4406. #: bashref.texi:2605
  4407. #, no-wrap
  4408. msgid "/dev/fd/@var{fd}"
  4409. msgstr ""
  4410. #. type: table
  4411. #: bashref.texi:2607
  4412. msgid "If @var{fd} is a valid integer, file descriptor @var{fd} is duplicated."
  4413. msgstr ""
  4414. #. type: item
  4415. #: bashref.texi:2608
  4416. #, no-wrap
  4417. msgid "/dev/stdin"
  4418. msgstr ""
  4419. #. type: table
  4420. #: bashref.texi:2610
  4421. msgid "File descriptor 0 is duplicated."
  4422. msgstr ""
  4423. #. type: item
  4424. #: bashref.texi:2611
  4425. #, no-wrap
  4426. msgid "/dev/stdout"
  4427. msgstr ""
  4428. #. type: table
  4429. #: bashref.texi:2613
  4430. msgid "File descriptor 1 is duplicated."
  4431. msgstr ""
  4432. #. type: item
  4433. #: bashref.texi:2614
  4434. #, no-wrap
  4435. msgid "/dev/stderr"
  4436. msgstr ""
  4437. #. type: table
  4438. #: bashref.texi:2616
  4439. msgid "File descriptor 2 is duplicated."
  4440. msgstr ""
  4441. #. type: item
  4442. #: bashref.texi:2617
  4443. #, no-wrap
  4444. msgid "/dev/tcp/@var{host}/@var{port}"
  4445. msgstr ""
  4446. #. type: table
  4447. #: bashref.texi:2621
  4448. msgid ""
  4449. "If @var{host} is a valid hostname or Internet address, and @var{port} is an "
  4450. "integer port number or service name, Bash attempts to open the corresponding "
  4451. "TCP socket."
  4452. msgstr ""
  4453. #. type: item
  4454. #: bashref.texi:2622
  4455. #, no-wrap
  4456. msgid "/dev/udp/@var{host}/@var{port}"
  4457. msgstr ""
  4458. #. type: table
  4459. #: bashref.texi:2626
  4460. msgid ""
  4461. "If @var{host} is a valid hostname or Internet address, and @var{port} is an "
  4462. "integer port number or service name, Bash attempts to open the corresponding "
  4463. "UDP socket."
  4464. msgstr ""
  4465. #. type: Plain text
  4466. #: bashref.texi:2629
  4467. msgid "A failure to open or create a file causes the redirection to fail."
  4468. msgstr ""
  4469. #. type: Plain text
  4470. #: bashref.texi:2633
  4471. msgid ""
  4472. "Redirections using file descriptors greater than 9 should be used with care, "
  4473. "as they may conflict with file descriptors the shell uses internally."
  4474. msgstr ""
  4475. #. type: subsection
  4476. #: bashref.texi:2634
  4477. #, no-wrap
  4478. msgid "Redirecting Input"
  4479. msgstr ""
  4480. #. type: Plain text
  4481. #: bashref.texi:2640
  4482. msgid ""
  4483. "Redirection of input causes the file whose name results from the expansion "
  4484. "of @var{word} to be opened for reading on file descriptor @code{n}, or the "
  4485. "standard input (file descriptor 0) if @code{n} is not specified."
  4486. msgstr ""
  4487. #. type: Plain text
  4488. #: bashref.texi:2642
  4489. msgid "The general format for redirecting input is:"
  4490. msgstr ""
  4491. #. type: example
  4492. #: bashref.texi:2644
  4493. #, no-wrap
  4494. msgid "[@var{n}]<@var{word}\n"
  4495. msgstr ""
  4496. #. type: subsection
  4497. #: bashref.texi:2646
  4498. #, no-wrap
  4499. msgid "Redirecting Output"
  4500. msgstr ""
  4501. #. type: Plain text
  4502. #: bashref.texi:2653
  4503. msgid ""
  4504. "Redirection of output causes the file whose name results from the expansion "
  4505. "of @var{word} to be opened for writing on file descriptor @var{n}, or the "
  4506. "standard output (file descriptor 1) if @var{n} is not specified. If the "
  4507. "file does not exist it is created; if it does exist it is truncated to zero "
  4508. "size."
  4509. msgstr ""
  4510. #. type: Plain text
  4511. #: bashref.texi:2655
  4512. msgid "The general format for redirecting output is:"
  4513. msgstr ""
  4514. #. type: example
  4515. #: bashref.texi:2657
  4516. #, no-wrap
  4517. msgid "[@var{n}]>[|]@var{word}\n"
  4518. msgstr ""
  4519. #. type: Plain text
  4520. #: bashref.texi:2666
  4521. msgid ""
  4522. "If the redirection operator is @samp{>}, and the @code{noclobber} option to "
  4523. "the @code{set} builtin has been enabled, the redirection will fail if the "
  4524. "file whose name results from the expansion of @var{word} exists and is a "
  4525. "regular file. If the redirection operator is @samp{>|}, or the redirection "
  4526. "operator is @samp{>} and the @code{noclobber} option is not enabled, the "
  4527. "redirection is attempted even if the file named by @var{word} exists."
  4528. msgstr ""
  4529. #. type: subsection
  4530. #: bashref.texi:2667
  4531. #, no-wrap
  4532. msgid "Appending Redirected Output"
  4533. msgstr ""
  4534. #. type: Plain text
  4535. #: bashref.texi:2674
  4536. msgid ""
  4537. "Redirection of output in this fashion causes the file whose name results "
  4538. "from the expansion of @var{word} to be opened for appending on file "
  4539. "descriptor @var{n}, or the standard output (file descriptor 1) if @var{n} is "
  4540. "not specified. If the file does not exist it is created."
  4541. msgstr ""
  4542. #. type: Plain text
  4543. #: bashref.texi:2676
  4544. msgid "The general format for appending output is:"
  4545. msgstr ""
  4546. #. type: example
  4547. #: bashref.texi:2678
  4548. #, no-wrap
  4549. msgid "[@var{n}]>>@var{word}\n"
  4550. msgstr ""
  4551. #. type: subsection
  4552. #: bashref.texi:2680
  4553. #, no-wrap
  4554. msgid "Redirecting Standard Output and Standard Error"
  4555. msgstr ""
  4556. #. type: Plain text
  4557. #: bashref.texi:2686
  4558. msgid ""
  4559. "This construct allows both the standard output (file descriptor 1) and the "
  4560. "standard error output (file descriptor 2) to be redirected to the file "
  4561. "whose name is the expansion of @var{word}."
  4562. msgstr ""
  4563. #. type: Plain text
  4564. #: bashref.texi:2689
  4565. msgid ""
  4566. "There are two formats for redirecting standard output and standard error:"
  4567. msgstr ""
  4568. #. type: example
  4569. #: bashref.texi:2691
  4570. #, no-wrap
  4571. msgid "&>@var{word}\n"
  4572. msgstr ""
  4573. #. type: Plain text
  4574. #: bashref.texi:2694
  4575. msgid "and"
  4576. msgstr ""
  4577. #. type: example
  4578. #: bashref.texi:2696
  4579. #, no-wrap
  4580. msgid ">&@var{word}\n"
  4581. msgstr ""
  4582. #. type: Plain text
  4583. #: bashref.texi:2700
  4584. msgid ""
  4585. "Of the two forms, the first is preferred. This is semantically equivalent to"
  4586. msgstr ""
  4587. #. type: example
  4588. #: bashref.texi:2702
  4589. #, no-wrap
  4590. msgid ">@var{word} 2>&1\n"
  4591. msgstr ""
  4592. #. type: Plain text
  4593. #: bashref.texi:2706
  4594. msgid ""
  4595. "When using the second form, @var{word} may not expand to a number or "
  4596. "@samp{-}. If it does, other redirection operators apply (see Duplicating "
  4597. "File Descriptors below) for compatibility reasons."
  4598. msgstr ""
  4599. #. type: subsection
  4600. #: bashref.texi:2707
  4601. #, no-wrap
  4602. msgid "Appending Standard Output and Standard Error"
  4603. msgstr ""
  4604. #. type: Plain text
  4605. #: bashref.texi:2713
  4606. msgid ""
  4607. "This construct allows both the standard output (file descriptor 1) and the "
  4608. "standard error output (file descriptor 2) to be appended to the file whose "
  4609. "name is the expansion of @var{word}."
  4610. msgstr ""
  4611. #. type: Plain text
  4612. #: bashref.texi:2715
  4613. msgid "The format for appending standard output and standard error is:"
  4614. msgstr ""
  4615. #. type: example
  4616. #: bashref.texi:2717
  4617. #, no-wrap
  4618. msgid "&>>@var{word}\n"
  4619. msgstr ""
  4620. #. type: Plain text
  4621. #: bashref.texi:2720
  4622. msgid "This is semantically equivalent to"
  4623. msgstr ""
  4624. #. type: example
  4625. #: bashref.texi:2722
  4626. #, no-wrap
  4627. msgid ">>@var{word} 2>&1\n"
  4628. msgstr ""
  4629. #. type: Plain text
  4630. #: bashref.texi:2724
  4631. msgid "(see Duplicating File Descriptors below)."
  4632. msgstr ""
  4633. #. type: subsection
  4634. #: bashref.texi:2725
  4635. #, no-wrap
  4636. msgid "Here Documents"
  4637. msgstr ""
  4638. #. type: Plain text
  4639. #: bashref.texi:2731
  4640. msgid ""
  4641. "This type of redirection instructs the shell to read input from the current "
  4642. "source until a line containing only @var{word} (with no trailing blanks) is "
  4643. "seen. All of the lines read up to that point are then used as the standard "
  4644. "input (or file descriptor @var{n} if @var{n} is specified) for a command."
  4645. msgstr ""
  4646. #. type: Plain text
  4647. #: bashref.texi:2733
  4648. msgid "The format of here-documents is:"
  4649. msgstr ""
  4650. #. type: example
  4651. #: bashref.texi:2737
  4652. #, no-wrap
  4653. msgid ""
  4654. "[@var{n}]<<[@minus{}]@var{word}\n"
  4655. " @var{here-document}\n"
  4656. "@var{delimiter}\n"
  4657. msgstr ""
  4658. #. type: Plain text
  4659. #: bashref.texi:2750
  4660. msgid ""
  4661. "No parameter and variable expansion, command substitution, arithmetic "
  4662. "expansion, or filename expansion is performed on @var{word}. If any part of "
  4663. "@var{word} is quoted, the @var{delimiter} is the result of quote removal on "
  4664. "@var{word}, and the lines in the here-document are not expanded. If "
  4665. "@var{word} is unquoted, all lines of the here-document are subjected to "
  4666. "parameter expansion, command substitution, and arithmetic expansion, the "
  4667. "character sequence @code{\\newline} is ignored, and @samp{\\} must be used "
  4668. "to quote the characters @samp{\\}, @samp{$}, and @samp{`}."
  4669. msgstr ""
  4670. #. type: Plain text
  4671. #: bashref.texi:2756
  4672. msgid ""
  4673. "If the redirection operator is @samp{<<-}, then all leading tab characters "
  4674. "are stripped from input lines and the line containing @var{delimiter}. This "
  4675. "allows here-documents within shell scripts to be indented in a natural "
  4676. "fashion."
  4677. msgstr ""
  4678. #. type: subsection
  4679. #: bashref.texi:2757
  4680. #, no-wrap
  4681. msgid "Here Strings"
  4682. msgstr ""
  4683. #. type: Plain text
  4684. #: bashref.texi:2759
  4685. msgid "A variant of here documents, the format is:"
  4686. msgstr ""
  4687. #. type: example
  4688. #: bashref.texi:2761
  4689. #, no-wrap
  4690. msgid "[@var{n}]<<< @var{word}\n"
  4691. msgstr ""
  4692. #. type: Plain text
  4693. #: bashref.texi:2771
  4694. msgid ""
  4695. "The @var{word} undergoes brace expansion, tilde expansion, parameter and "
  4696. "variable expansion, command substitution, arithmetic expansion, and quote "
  4697. "removal. Pathname expansion and word splitting are not performed. The "
  4698. "result is supplied as a single string, with a newline appended, to the "
  4699. "command on its standard input (or file descriptor @var{n} if @var{n} is "
  4700. "specified)."
  4701. msgstr ""
  4702. #. type: subsection
  4703. #: bashref.texi:2772
  4704. #, no-wrap
  4705. msgid "Duplicating File Descriptors"
  4706. msgstr ""
  4707. #. type: Plain text
  4708. #: bashref.texi:2774 bashref.texi:2805 bashref.texi:2823
  4709. msgid "The redirection operator"
  4710. msgstr ""
  4711. #. type: example
  4712. #: bashref.texi:2776
  4713. #, no-wrap
  4714. msgid "[@var{n}]<&@var{word}\n"
  4715. msgstr ""
  4716. #. type: Plain text
  4717. #: bashref.texi:2787
  4718. msgid ""
  4719. "is used to duplicate input file descriptors. If @var{word} expands to one "
  4720. "or more digits, the file descriptor denoted by @var{n} is made to be a copy "
  4721. "of that file descriptor. If the digits in @var{word} do not specify a file "
  4722. "descriptor open for input, a redirection error occurs. If @var{word} "
  4723. "evaluates to @samp{-}, file descriptor @var{n} is closed. If @var{n} is not "
  4724. "specified, the standard input (file descriptor 0) is used."
  4725. msgstr ""
  4726. #. type: Plain text
  4727. #: bashref.texi:2789
  4728. msgid "The operator"
  4729. msgstr ""
  4730. #. type: example
  4731. #: bashref.texi:2791
  4732. #, no-wrap
  4733. msgid "[@var{n}]>&@var{word}\n"
  4734. msgstr ""
  4735. #. type: Plain text
  4736. #: bashref.texi:2802
  4737. msgid ""
  4738. "is used similarly to duplicate output file descriptors. If @var{n} is not "
  4739. "specified, the standard output (file descriptor 1) is used. If the digits "
  4740. "in @var{word} do not specify a file descriptor open for output, a "
  4741. "redirection error occurs. If @var{word} evaluates to @samp{-}, file "
  4742. "descriptor @var{n} is closed. As a special case, if @var{n} is omitted, and "
  4743. "@var{word} does not expand to one or more digits or @samp{-}, the standard "
  4744. "output and standard error are redirected as described previously."
  4745. msgstr ""
  4746. #. type: subsection
  4747. #: bashref.texi:2803
  4748. #, no-wrap
  4749. msgid "Moving File Descriptors"
  4750. msgstr ""
  4751. #. type: example
  4752. #: bashref.texi:2807
  4753. #, no-wrap
  4754. msgid "[@var{n}]<&@var{digit}-\n"
  4755. msgstr ""
  4756. #. type: Plain text
  4757. #: bashref.texi:2812
  4758. msgid ""
  4759. "moves the file descriptor @var{digit} to file descriptor @var{n}, or the "
  4760. "standard input (file descriptor 0) if @var{n} is not specified. @var{digit} "
  4761. "is closed after being duplicated to @var{n}."
  4762. msgstr ""
  4763. #. type: Plain text
  4764. #: bashref.texi:2814
  4765. msgid "Similarly, the redirection operator"
  4766. msgstr ""
  4767. #. type: example
  4768. #: bashref.texi:2816
  4769. #, no-wrap
  4770. msgid "[@var{n}]>&@var{digit}-\n"
  4771. msgstr ""
  4772. #. type: Plain text
  4773. #: bashref.texi:2820
  4774. msgid ""
  4775. "moves the file descriptor @var{digit} to file descriptor @var{n}, or the "
  4776. "standard output (file descriptor 1) if @var{n} is not specified."
  4777. msgstr ""
  4778. #. type: subsection
  4779. #: bashref.texi:2821
  4780. #, no-wrap
  4781. msgid "Opening File Descriptors for Reading and Writing"
  4782. msgstr ""
  4783. #. type: example
  4784. #: bashref.texi:2825
  4785. #, no-wrap
  4786. msgid "[@var{n}]<>@var{word}\n"
  4787. msgstr ""
  4788. #. type: Plain text
  4789. #: bashref.texi:2831
  4790. msgid ""
  4791. "causes the file whose name is the expansion of @var{word} to be opened for "
  4792. "both reading and writing on file descriptor @var{n}, or on file descriptor 0 "
  4793. "if @var{n} is not specified. If the file does not exist, it is created."
  4794. msgstr ""
  4795. #. type: subsection
  4796. #: bashref.texi:2847 bashref.texi:2849 bashref.texi:2850
  4797. #, no-wrap
  4798. msgid "Simple Command Expansion"
  4799. msgstr ""
  4800. #. type: menuentry
  4801. #: bashref.texi:2847
  4802. msgid "How Bash expands simple commands before executing them."
  4803. msgstr ""
  4804. #. type: subsection
  4805. #: bashref.texi:2847 bashref.texi:2894 bashref.texi:2895
  4806. #, no-wrap
  4807. msgid "Command Search and Execution"
  4808. msgstr ""
  4809. #. type: menuentry
  4810. #: bashref.texi:2847
  4811. msgid "How Bash finds commands and runs them."
  4812. msgstr ""
  4813. #. type: subsection
  4814. #: bashref.texi:2847 bashref.texi:2950 bashref.texi:2951
  4815. #, no-wrap
  4816. msgid "Command Execution Environment"
  4817. msgstr ""
  4818. #. type: menuentry
  4819. #: bashref.texi:2847
  4820. msgid ""
  4821. "The environment in which Bash executes commands that are not shell builtins."
  4822. msgstr ""
  4823. #. type: subsection
  4824. #: bashref.texi:2847 bashref.texi:3046 bashref.texi:3047
  4825. #, no-wrap
  4826. msgid "Environment"
  4827. msgstr ""
  4828. #. type: menuentry
  4829. #: bashref.texi:2847
  4830. msgid "The environment given to a command."
  4831. msgstr ""
  4832. #. type: subsection
  4833. #: bashref.texi:2847 bashref.texi:3084 bashref.texi:3085
  4834. #, no-wrap
  4835. msgid "Exit Status"
  4836. msgstr ""
  4837. #. type: menuentry
  4838. #: bashref.texi:2847
  4839. msgid "The status returned by commands and how Bash interprets it."
  4840. msgstr ""
  4841. #. type: subsection
  4842. #: bashref.texi:2847 bashref.texi:3122 bashref.texi:3123
  4843. #, no-wrap
  4844. msgid "Signals"
  4845. msgstr ""
  4846. #. type: menuentry
  4847. #: bashref.texi:2847
  4848. msgid "What happens when Bash or a command it runs receives a signal."
  4849. msgstr ""
  4850. #. type: cindex
  4851. #: bashref.texi:2851
  4852. #, no-wrap
  4853. msgid "command expansion"
  4854. msgstr ""
  4855. #. type: Plain text
  4856. #: bashref.texi:2855
  4857. msgid ""
  4858. "When a simple command is executed, the shell performs the following "
  4859. "expansions, assignments, and redirections, from left to right."
  4860. msgstr ""
  4861. #. type: enumerate
  4862. #: bashref.texi:2861
  4863. msgid ""
  4864. "The words that the parser has marked as variable assignments (those "
  4865. "preceding the command name) and redirections are saved for later processing."
  4866. msgstr ""
  4867. #. type: enumerate
  4868. #: bashref.texi:2868
  4869. msgid ""
  4870. "The words that are not variable assignments or redirections are expanded "
  4871. "(@pxref{Shell Expansions}). If any words remain after expansion, the first "
  4872. "word is taken to be the name of the command and the remaining words are the "
  4873. "arguments."
  4874. msgstr ""
  4875. #. type: enumerate
  4876. #: bashref.texi:2871
  4877. msgid "Redirections are performed as described above (@pxref{Redirections})."
  4878. msgstr ""
  4879. #. type: enumerate
  4880. #: bashref.texi:2876
  4881. msgid ""
  4882. "The text after the @samp{=} in each variable assignment undergoes tilde "
  4883. "expansion, parameter expansion, command substitution, arithmetic expansion, "
  4884. "and quote removal before being assigned to the variable."
  4885. msgstr ""
  4886. #. type: Plain text
  4887. #: bashref.texi:2883
  4888. msgid ""
  4889. "If no command name results, the variable assignments affect the current "
  4890. "shell environment. Otherwise, the variables are added to the environment of "
  4891. "the executed command and do not affect the current shell environment. If "
  4892. "any of the assignments attempts to assign a value to a readonly variable, an "
  4893. "error occurs, and the command exits with a non-zero status."
  4894. msgstr ""
  4895. #. type: Plain text
  4896. #: bashref.texi:2887
  4897. msgid ""
  4898. "If no command name results, redirections are performed, but do not affect "
  4899. "the current shell environment. A redirection error causes the command to "
  4900. "exit with a non-zero status."
  4901. msgstr ""
  4902. #. type: Plain text
  4903. #: bashref.texi:2893
  4904. msgid ""
  4905. "If there is a command name left after expansion, execution proceeds as "
  4906. "described below. Otherwise, the command exits. If one of the expansions "
  4907. "contained a command substitution, the exit status of the command is the exit "
  4908. "status of the last command substitution performed. If there were no command "
  4909. "substitutions, the command exits with a status of zero."
  4910. msgstr ""
  4911. #. type: cindex
  4912. #: bashref.texi:2896
  4913. #, no-wrap
  4914. msgid "command execution"
  4915. msgstr ""
  4916. #. type: cindex
  4917. #: bashref.texi:2897
  4918. #, no-wrap
  4919. msgid "command search"
  4920. msgstr ""
  4921. #. type: Plain text
  4922. #: bashref.texi:2902
  4923. msgid ""
  4924. "After a command has been split into words, if it results in a simple command "
  4925. "and an optional list of arguments, the following actions are taken."
  4926. msgstr ""
  4927. #. type: enumerate
  4928. #: bashref.texi:2908
  4929. msgid ""
  4930. "If the command name contains no slashes, the shell attempts to locate it. "
  4931. "If there exists a shell function by that name, that function is invoked as "
  4932. "described in @ref{Shell Functions}."
  4933. msgstr ""
  4934. #. type: enumerate
  4935. #: bashref.texi:2913
  4936. msgid ""
  4937. "If the name does not match a function, the shell searches for it in the list "
  4938. "of shell builtins. If a match is found, that builtin is invoked."
  4939. msgstr ""
  4940. #. type: enumerate
  4941. #: bashref.texi:2930
  4942. msgid ""
  4943. "If the name is neither a shell function nor a builtin, and contains no "
  4944. "slashes, Bash searches each element of @env{$PATH} for a directory "
  4945. "containing an executable file by that name. Bash uses a hash table to "
  4946. "remember the full pathnames of executable files to avoid multiple @env{PATH} "
  4947. "searches (see the description of @code{hash} in @ref{Bourne Shell "
  4948. "Builtins}). A full search of the directories in @env{$PATH} is performed "
  4949. "only if the command is not found in the hash table. If the search is "
  4950. "unsuccessful, the shell searches for a defined shell function named "
  4951. "@code{command_not_found_handle}. If that function exists, it is invoked "
  4952. "with the original command and the original command's arguments as its "
  4953. "arguments, and the function's exit status becomes the exit status of the "
  4954. "shell. If that function is not defined, the shell prints an error message "
  4955. "and returns an exit status of 127."
  4956. msgstr ""
  4957. #. type: enumerate
  4958. #: bashref.texi:2937
  4959. msgid ""
  4960. "If the search is successful, or if the command name contains one or more "
  4961. "slashes, the shell executes the named program in a separate execution "
  4962. "environment. Argument 0 is set to the name given, and the remaining "
  4963. "arguments to the command are set to the arguments supplied, if any."
  4964. msgstr ""
  4965. #. type: enumerate
  4966. #: bashref.texi:2943
  4967. msgid ""
  4968. "If this execution fails because the file is not in executable format, and "
  4969. "the file is not a directory, it is assumed to be a @var{shell script} and "
  4970. "the shell executes it as described in @ref{Shell Scripts}."
  4971. msgstr ""
  4972. #. type: enumerate
  4973. #: bashref.texi:2947
  4974. msgid ""
  4975. "If the command was not begun asynchronously, the shell waits for the command "
  4976. "to complete and collects its exit status."
  4977. msgstr ""
  4978. #. type: cindex
  4979. #: bashref.texi:2952
  4980. #, no-wrap
  4981. msgid "execution environment"
  4982. msgstr ""
  4983. #. type: Plain text
  4984. #: bashref.texi:2956
  4985. msgid ""
  4986. "The shell has an @var{execution environment}, which consists of the "
  4987. "following:"
  4988. msgstr ""
  4989. #. type: itemize
  4990. #: bashref.texi:2961
  4991. msgid ""
  4992. "open files inherited by the shell at invocation, as modified by redirections "
  4993. "supplied to the @code{exec} builtin"
  4994. msgstr ""
  4995. #. type: itemize
  4996. #: bashref.texi:2965
  4997. msgid ""
  4998. "the current working directory as set by @code{cd}, @code{pushd}, or "
  4999. "@code{popd}, or inherited by the shell at invocation"
  5000. msgstr ""
  5001. #. type: itemize
  5002. #: bashref.texi:2969
  5003. msgid ""
  5004. "the file creation mode mask as set by @code{umask} or inherited from the "
  5005. "shell's parent"
  5006. msgstr ""
  5007. #. type: itemize
  5008. #: bashref.texi:2972
  5009. msgid "current traps set by @code{trap}"
  5010. msgstr ""
  5011. #. type: itemize
  5012. #: bashref.texi:2976
  5013. msgid ""
  5014. "shell parameters that are set by variable assignment or with @code{set} or "
  5015. "inherited from the shell's parent in the environment"
  5016. msgstr ""
  5017. #. type: itemize
  5018. #: bashref.texi:2980
  5019. msgid ""
  5020. "shell functions defined during execution or inherited from the shell's "
  5021. "parent in the environment"
  5022. msgstr ""
  5023. #. type: itemize
  5024. #: bashref.texi:2984
  5025. msgid ""
  5026. "options enabled at invocation (either by default or with command-line "
  5027. "arguments) or by @code{set}"
  5028. msgstr ""
  5029. #. type: itemize
  5030. #: bashref.texi:2987
  5031. msgid "options enabled by @code{shopt} (@pxref{The Shopt Builtin})"
  5032. msgstr ""
  5033. #. type: itemize
  5034. #: bashref.texi:2990
  5035. msgid "shell aliases defined with @code{alias} (@pxref{Aliases})"
  5036. msgstr ""
  5037. #. type: itemize
  5038. #: bashref.texi:2995
  5039. msgid ""
  5040. "various process @sc{id}s, including those of background jobs "
  5041. "(@pxref{Lists}), the value of @code{$$}, and the value of @env{$PPID}"
  5042. msgstr ""
  5043. #. type: Plain text
  5044. #: bashref.texi:3003
  5045. msgid ""
  5046. "When a simple command other than a builtin or shell function is to be "
  5047. "executed, it is invoked in a separate execution environment that consists of "
  5048. "the following. Unless otherwise noted, the values are inherited from the "
  5049. "shell."
  5050. msgstr ""
  5051. #. type: itemize
  5052. #: bashref.texi:3008
  5053. msgid ""
  5054. "the shell's open files, plus any modifications and additions specified by "
  5055. "redirections to the command"
  5056. msgstr ""
  5057. #. type: itemize
  5058. #: bashref.texi:3011
  5059. msgid "the current working directory"
  5060. msgstr ""
  5061. #. type: itemize
  5062. #: bashref.texi:3014
  5063. msgid "the file creation mode mask"
  5064. msgstr ""
  5065. #. type: itemize
  5066. #: bashref.texi:3018
  5067. msgid ""
  5068. "shell variables and functions marked for export, along with variables "
  5069. "exported for the command, passed in the environment (@pxref{Environment})"
  5070. msgstr ""
  5071. #. type: itemize
  5072. #: bashref.texi:3022
  5073. msgid ""
  5074. "traps caught by the shell are reset to the values inherited from the shell's "
  5075. "parent, and traps ignored by the shell are ignored"
  5076. msgstr ""
  5077. #. type: Plain text
  5078. #: bashref.texi:3027
  5079. msgid ""
  5080. "A command invoked in this separate environment cannot affect the shell's "
  5081. "execution environment."
  5082. msgstr ""
  5083. #. type: Plain text
  5084. #: bashref.texi:3036
  5085. msgid ""
  5086. "Command substitution, commands grouped with parentheses, and asynchronous "
  5087. "commands are invoked in a subshell environment that is a duplicate of the "
  5088. "shell environment, except that traps caught by the shell are reset to the "
  5089. "values that the shell inherited from its parent at invocation. Builtin "
  5090. "commands that are invoked as part of a pipeline are also executed in a "
  5091. "subshell environment. Changes made to the subshell environment cannot "
  5092. "affect the shell's execution environment."
  5093. msgstr ""
  5094. #. type: Plain text
  5095. #: bashref.texi:3040
  5096. msgid ""
  5097. "Subshells spawned to execute command substitutions inherit the value of the "
  5098. "@option{-e} option from the parent shell. When not in @sc{posix} mode, Bash "
  5099. "clears the @option{-e} option in such subshells."
  5100. msgstr ""
  5101. #. type: Plain text
  5102. #: bashref.texi:3045
  5103. msgid ""
  5104. "If a command is followed by a @samp{&} and job control is not active, the "
  5105. "default standard input for the command is the empty file @file{/dev/null}. "
  5106. "Otherwise, the invoked command inherits the file descriptors of the calling "
  5107. "shell as modified by redirections."
  5108. msgstr ""
  5109. #. type: cindex
  5110. #: bashref.texi:3048
  5111. #, no-wrap
  5112. msgid "environment"
  5113. msgstr ""
  5114. #. type: Plain text
  5115. #: bashref.texi:3053
  5116. msgid ""
  5117. "When a program is invoked it is given an array of strings called the "
  5118. "@var{environment}. This is a list of name-value pairs, of the form "
  5119. "@code{name=value}."
  5120. msgstr ""
  5121. #. type: Plain text
  5122. #: bashref.texi:3069
  5123. msgid ""
  5124. "Bash provides several ways to manipulate the environment. On invocation, "
  5125. "the shell scans its own environment and creates a parameter for each name "
  5126. "found, automatically marking it for @var{export} to child processes. "
  5127. "Executed commands inherit the environment. The @code{export} and "
  5128. "@samp{declare -x} commands allow parameters and functions to be added to and "
  5129. "deleted from the environment. If the value of a parameter in the "
  5130. "environment is modified, the new value becomes part of the environment, "
  5131. "replacing the old. The environment inherited by any executed command "
  5132. "consists of the shell's initial environment, whose values may be modified in "
  5133. "the shell, less any pairs removed by the @code{unset} and @samp{export -n} "
  5134. "commands, plus any additions via the @code{export} and @samp{declare -x} "
  5135. "commands."
  5136. msgstr ""
  5137. #. type: Plain text
  5138. #: bashref.texi:3075
  5139. msgid ""
  5140. "The environment for any simple command or function may be augmented "
  5141. "temporarily by prefixing it with parameter assignments, as described in "
  5142. "@ref{Shell Parameters}. These assignment statements affect only the "
  5143. "environment seen by that command."
  5144. msgstr ""
  5145. #. type: Plain text
  5146. #: bashref.texi:3079
  5147. msgid ""
  5148. "If the @option{-k} option is set (@pxref{The Set Builtin}), then all "
  5149. "parameter assignments are placed in the environment for a command, not just "
  5150. "those that precede the command name."
  5151. msgstr ""
  5152. #. type: Plain text
  5153. #: bashref.texi:3083
  5154. msgid ""
  5155. "When Bash invokes an external command, the variable @samp{$_} is set to the "
  5156. "full pathname of the command and passed to that command in its environment."
  5157. msgstr ""
  5158. #. type: Plain text
  5159. #: bashref.texi:3095
  5160. msgid ""
  5161. "The exit status of an executed command is the value returned by the "
  5162. "@var{waitpid} system call or equivalent function. Exit statuses fall "
  5163. "between 0 and 255, though, as explained below, the shell may use values "
  5164. "above 125 specially. Exit statuses from shell builtins and compound "
  5165. "commands are also limited to this range. Under certain circumstances, the "
  5166. "shell will use special values to indicate specific failure modes."
  5167. msgstr ""
  5168. #. type: Plain text
  5169. #: bashref.texi:3104
  5170. msgid ""
  5171. "For the shell's purposes, a command which exits with a zero exit status has "
  5172. "succeeded. A non-zero exit status indicates failure. This seemingly "
  5173. "counter-intuitive scheme is used so there is one well-defined way to "
  5174. "indicate success and a variety of ways to indicate various failure modes. "
  5175. "When a command terminates on a fatal signal whose number is @var{N}, Bash "
  5176. "uses the value 128+@var{N} as the exit status."
  5177. msgstr ""
  5178. #. type: Plain text
  5179. #: bashref.texi:3108
  5180. msgid ""
  5181. "If a command is not found, the child process created to execute it returns a "
  5182. "status of 127. If a command is found but is not executable, the return "
  5183. "status is 126."
  5184. msgstr ""
  5185. #. type: Plain text
  5186. #: bashref.texi:3111
  5187. msgid ""
  5188. "If a command fails because of an error during expansion or redirection, the "
  5189. "exit status is greater than zero."
  5190. msgstr ""
  5191. #. type: Plain text
  5192. #: bashref.texi:3115
  5193. msgid ""
  5194. "The exit status is used by the Bash conditional commands (@pxref{Conditional "
  5195. "Constructs}) and some of the list constructs (@pxref{Lists})."
  5196. msgstr ""
  5197. #. type: Plain text
  5198. #: bashref.texi:3121
  5199. msgid ""
  5200. "All of the Bash builtins return an exit status of zero if they succeed and a "
  5201. "non-zero status on failure, so they may be used by the conditional and list "
  5202. "constructs. All builtins return an exit status of 2 to indicate incorrect "
  5203. "usage, generally invalid options or missing arguments."
  5204. msgstr ""
  5205. #. type: cindex
  5206. #: bashref.texi:3124
  5207. #, no-wrap
  5208. msgid "signal handling"
  5209. msgstr ""
  5210. #. type: Plain text
  5211. #: bashref.texi:3134
  5212. msgid ""
  5213. "When Bash is interactive, in the absence of any traps, it ignores "
  5214. "@code{SIGTERM} (so that @samp{kill 0} does not kill an interactive shell), "
  5215. "and @code{SIGINT} is caught and handled (so that the @code{wait} builtin is "
  5216. "interruptible). When Bash receives a @code{SIGINT}, it breaks out of any "
  5217. "executing loops. In all cases, Bash ignores @code{SIGQUIT}. If job control "
  5218. "is in effect (@pxref{Job Control}), Bash ignores @code{SIGTTIN}, "
  5219. "@code{SIGTTOU}, and @code{SIGTSTP}."
  5220. msgstr ""
  5221. #. type: Plain text
  5222. #: bashref.texi:3143
  5223. msgid ""
  5224. "Non-builtin commands started by Bash have signal handlers set to the values "
  5225. "inherited by the shell from its parent. When job control is not in effect, "
  5226. "asynchronous commands ignore @code{SIGINT} and @code{SIGQUIT} in addition to "
  5227. "these inherited handlers. Commands run as a result of command substitution "
  5228. "ignore the keyboard-generated job control signals @code{SIGTTIN}, "
  5229. "@code{SIGTTOU}, and @code{SIGTSTP}."
  5230. msgstr ""
  5231. #. type: Plain text
  5232. #: bashref.texi:3154
  5233. msgid ""
  5234. "The shell exits by default upon receipt of a @code{SIGHUP}. Before exiting, "
  5235. "an interactive shell resends the @code{SIGHUP} to all jobs, running or "
  5236. "stopped. Stopped jobs are sent @code{SIGCONT} to ensure that they receive "
  5237. "the @code{SIGHUP}. To prevent the shell from sending the @code{SIGHUP} "
  5238. "signal to a particular job, it should be removed from the jobs table with "
  5239. "the @code{disown} builtin (@pxref{Job Control Builtins}) or marked to not "
  5240. "receive @code{SIGHUP} using @code{disown -h}."
  5241. msgstr ""
  5242. #. type: Plain text
  5243. #: bashref.texi:3158
  5244. msgid ""
  5245. "If the @code{huponexit} shell option has been set with @code{shopt} "
  5246. "(@pxref{The Shopt Builtin}), Bash sends a @code{SIGHUP} to all jobs when an "
  5247. "interactive login shell exits."
  5248. msgstr ""
  5249. #. type: Plain text
  5250. #: bashref.texi:3167
  5251. msgid ""
  5252. "If Bash is waiting for a command to complete and receives a signal for which "
  5253. "a trap has been set, the trap will not be executed until the command "
  5254. "completes. When Bash is waiting for an asynchronous command via the "
  5255. "@code{wait} builtin, the reception of a signal for which a trap has been set "
  5256. "will cause the @code{wait} builtin to return immediately with an exit status "
  5257. "greater than 128, immediately after which the trap is executed."
  5258. msgstr ""
  5259. #. type: cindex
  5260. #: bashref.texi:3170
  5261. #, no-wrap
  5262. msgid "shell script"
  5263. msgstr ""
  5264. #. type: Plain text
  5265. #: bashref.texi:3180
  5266. msgid ""
  5267. "A shell script is a text file containing shell commands. When such a file "
  5268. "is used as the first non-option argument when invoking Bash, and neither the "
  5269. "@option{-c} nor @option{-s} option is supplied (@pxref{Invoking Bash}), Bash "
  5270. "reads and executes commands from the file, then exits. This mode of "
  5271. "operation creates a non-interactive shell. The shell first searches for the "
  5272. "file in the current directory, and looks in the directories in @env{$PATH} "
  5273. "if not found there."
  5274. msgstr ""
  5275. #. type: Plain text
  5276. #: bashref.texi:3187
  5277. msgid ""
  5278. "When Bash runs a shell script, it sets the special parameter @code{0} to the "
  5279. "name of the file, rather than the name of the shell, and the positional "
  5280. "parameters are set to the remaining arguments, if any are given. If no "
  5281. "additional arguments are supplied, the positional parameters are unset."
  5282. msgstr ""
  5283. #. type: Plain text
  5284. #: bashref.texi:3192
  5285. msgid ""
  5286. "A shell script may be made executable by using the @code{chmod} command to "
  5287. "turn on the execute bit. When Bash finds such a file while searching the "
  5288. "@env{$PATH} for a command, it spawns a subshell to execute it. In other "
  5289. "words, executing"
  5290. msgstr ""
  5291. #. type: example
  5292. #: bashref.texi:3194
  5293. #, no-wrap
  5294. msgid "filename @var{arguments}\n"
  5295. msgstr ""
  5296. #. type: Plain text
  5297. #: bashref.texi:3197
  5298. msgid "is equivalent to executing"
  5299. msgstr ""
  5300. #. type: example
  5301. #: bashref.texi:3199
  5302. #, no-wrap
  5303. msgid "bash filename @var{arguments}\n"
  5304. msgstr ""
  5305. #. type: Plain text
  5306. #: bashref.texi:3208
  5307. msgid ""
  5308. "if @code{filename} is an executable shell script. This subshell "
  5309. "reinitializes itself, so that the effect is as if a new shell had been "
  5310. "invoked to interpret the script, with the exception that the locations of "
  5311. "commands remembered by the parent (see the description of @code{hash} in "
  5312. "@ref{Bourne Shell Builtins}) are retained by the child."
  5313. msgstr ""
  5314. #. type: Plain text
  5315. #: bashref.texi:3215
  5316. msgid ""
  5317. "Most versions of Unix make this a part of the operating system's command "
  5318. "execution mechanism. If the first line of a script begins with the two "
  5319. "characters @samp{#!}, the remainder of the line specifies an interpreter for "
  5320. "the program. Thus, you can specify Bash, @code{awk}, Perl, or some other "
  5321. "interpreter and write the rest of the script file in that language."
  5322. msgstr ""
  5323. #. type: Plain text
  5324. #: bashref.texi:3223
  5325. msgid ""
  5326. "The arguments to the interpreter consist of a single optional argument "
  5327. "following the interpreter name on the first line of the script file, "
  5328. "followed by the name of the script file, followed by the rest of the "
  5329. "arguments. Bash will perform this action on operating systems that do not "
  5330. "handle it themselves. Note that some older versions of Unix limit the "
  5331. "interpreter name and argument to a maximum of 32 characters."
  5332. msgstr ""
  5333. #. type: Plain text
  5334. #: bashref.texi:3228
  5335. msgid ""
  5336. "Bash scripts often begin with @code{#! /bin/bash} (assuming that Bash has "
  5337. "been installed in @file{/bin}), since this ensures that Bash will be used to "
  5338. "interpret the script, even if it is executed under another shell."
  5339. msgstr ""
  5340. #. type: section
  5341. #: bashref.texi:3240 bashref.texi:3275 bashref.texi:3276
  5342. #, no-wrap
  5343. msgid "Bourne Shell Builtins"
  5344. msgstr ""
  5345. #. type: menuentry
  5346. #: bashref.texi:3240
  5347. msgid "Builtin commands inherited from the Bourne Shell."
  5348. msgstr ""
  5349. #. type: node
  5350. #: bashref.texi:3240 bashref.texi:3825
  5351. #, no-wrap
  5352. msgid "Bash Builtins"
  5353. msgstr ""
  5354. #. type: menuentry
  5355. #: bashref.texi:3240
  5356. msgid "Table of builtins specific to Bash."
  5357. msgstr ""
  5358. #. type: section
  5359. #: bashref.texi:3240 bashref.texi:4657 bashref.texi:4658
  5360. #, no-wrap
  5361. msgid "Modifying Shell Behavior"
  5362. msgstr ""
  5363. #. type: menuentry
  5364. #: bashref.texi:3240
  5365. msgid "Builtins to modify shell attributes and optional behavior."
  5366. msgstr ""
  5367. #. type: section
  5368. #: bashref.texi:3240 bashref.texi:5346 bashref.texi:5347
  5369. #, no-wrap
  5370. msgid "Special Builtins"
  5371. msgstr ""
  5372. #. type: menuentry
  5373. #: bashref.texi:3240
  5374. msgid "Builtin commands classified specially by POSIX."
  5375. msgstr ""
  5376. #. type: Plain text
  5377. #: bashref.texi:3248
  5378. msgid ""
  5379. "Builtin commands are contained within the shell itself. When the name of a "
  5380. "builtin command is used as the first word of a simple command (@pxref{Simple "
  5381. "Commands}), the shell executes the command directly, without invoking "
  5382. "another program. Builtin commands are necessary to implement functionality "
  5383. "impossible or inconvenient to obtain with separate utilities."
  5384. msgstr ""
  5385. #. type: Plain text
  5386. #: bashref.texi:3252
  5387. msgid ""
  5388. "This section briefly describes the builtins which Bash inherits from the "
  5389. "Bourne Shell, as well as the builtin commands which are unique to or have "
  5390. "been extended in Bash."
  5391. msgstr ""
  5392. #. type: Plain text
  5393. #: bashref.texi:3259
  5394. msgid ""
  5395. "Several builtin commands are described in other chapters: builtin commands "
  5396. "which provide the Bash interface to the job control facilities (@pxref{Job "
  5397. "Control Builtins}), the directory stack (@pxref{Directory Stack Builtins}), "
  5398. "the command history (@pxref{Bash History Builtins}), and the programmable "
  5399. "completion facilities (@pxref{Programmable Completion Builtins})."
  5400. msgstr ""
  5401. #. type: Plain text
  5402. #: bashref.texi:3261
  5403. msgid "Many of the builtins have been extended by @sc{posix} or Bash."
  5404. msgstr ""
  5405. #. type: Plain text
  5406. #: bashref.texi:3274
  5407. msgid ""
  5408. "Unless otherwise noted, each builtin command documented as accepting options "
  5409. "preceded by @samp{-} accepts @samp{--} to signify the end of the options. "
  5410. "The @code{:}, @code{true}, @code{false}, and @code{test} builtins do not "
  5411. "accept options and do not treat @samp{--} specially. The @code{exit}, "
  5412. "@code{logout}, @code{return}, @code{break}, @code{continue}, @code{let}, and "
  5413. "@code{shift} builtins accept and process arguments beginning with @samp{-} "
  5414. "without requiring @samp{--}. Other builtins that accept arguments but are "
  5415. "not specified as accepting options interpret arguments beginning with "
  5416. "@samp{-} as invalid options and require @samp{--} to prevent this "
  5417. "interpretation."
  5418. msgstr ""
  5419. #. type: Plain text
  5420. #: bashref.texi:3280
  5421. msgid ""
  5422. "The following shell builtin commands are inherited from the Bourne Shell. "
  5423. "These commands are implemented as specified by the @sc{posix} standard."
  5424. msgstr ""
  5425. #. type: item
  5426. #: bashref.texi:3282
  5427. #, no-wrap
  5428. msgid ": @r{(a colon)}"
  5429. msgstr ""
  5430. #. type: btindex
  5431. #: bashref.texi:3283
  5432. #, no-wrap
  5433. msgid ":"
  5434. msgstr ""
  5435. #. type: example
  5436. #: bashref.texi:3286
  5437. #, no-wrap
  5438. msgid ": [@var{arguments}]\n"
  5439. msgstr ""
  5440. #. type: table
  5441. #: bashref.texi:3290
  5442. msgid ""
  5443. "Do nothing beyond expanding @var{arguments} and performing redirections. "
  5444. "The return status is zero."
  5445. msgstr ""
  5446. #. type: item
  5447. #: bashref.texi:3291
  5448. #, no-wrap
  5449. msgid ". @r{(a period)}"
  5450. msgstr ""
  5451. #. type: btindex
  5452. #: bashref.texi:3292
  5453. #, no-wrap
  5454. msgid "."
  5455. msgstr ""
  5456. #. type: example
  5457. #: bashref.texi:3295
  5458. #, no-wrap
  5459. msgid ". @var{filename} [@var{arguments}]\n"
  5460. msgstr ""
  5461. #. type: table
  5462. #: bashref.texi:3315
  5463. msgid ""
  5464. "Read and execute commands from the @var{filename} argument in the current "
  5465. "shell context. If @var{filename} does not contain a slash, the @env{PATH} "
  5466. "variable is used to find @var{filename}. When Bash is not in @sc{posix} "
  5467. "mode, the current directory is searched if @var{filename} is not found in "
  5468. "@env{$PATH}. If any @var{arguments} are supplied, they become the "
  5469. "positional parameters when @var{filename} is executed. Otherwise the "
  5470. "positional parameters are unchanged. If the @option{-T} option is enabled, "
  5471. "@code{source} inherits any trap on @code{DEBUG}; if it is not, any "
  5472. "@code{DEBUG} trap string is saved and restored around the call to "
  5473. "@code{source}, and @code{source} unsets the @code{DEBUG} trap while it "
  5474. "executes. If @option{-T} is not set, and the sourced file changes the "
  5475. "@code{DEBUG} trap, the new value is retained when @code{source} completes. "
  5476. "The return status is the exit status of the last command executed, or zero "
  5477. "if no commands are executed. If @var{filename} is not found, or cannot be "
  5478. "read, the return status is non-zero. This builtin is equivalent to "
  5479. "@code{source}."
  5480. msgstr ""
  5481. #. type: btindex
  5482. #: bashref.texi:3316 bashref.texi:3317
  5483. #, no-wrap
  5484. msgid "break"
  5485. msgstr ""
  5486. #. type: example
  5487. #: bashref.texi:3320
  5488. #, no-wrap
  5489. msgid "break [@var{n}]\n"
  5490. msgstr ""
  5491. #. type: table
  5492. #: bashref.texi:3326
  5493. msgid ""
  5494. "Exit from a @code{for}, @code{while}, @code{until}, or @code{select} loop. "
  5495. "If @var{n} is supplied, the @var{n}th enclosing loop is exited. @var{n} "
  5496. "must be greater than or equal to 1. The return status is zero unless "
  5497. "@var{n} is not greater than or equal to 1."
  5498. msgstr ""
  5499. #. type: btindex
  5500. #: bashref.texi:3327 bashref.texi:3328
  5501. #, no-wrap
  5502. msgid "cd"
  5503. msgstr ""
  5504. #. type: example
  5505. #: bashref.texi:3331
  5506. #, no-wrap
  5507. msgid "cd [-L|[-P [-e]] [-@@] [@var{directory}]\n"
  5508. msgstr ""
  5509. #. type: table
  5510. #: bashref.texi:3343
  5511. msgid ""
  5512. "Change the current working directory to @var{directory}. If @var{directory} "
  5513. "is not supplied, the value of the @env{HOME} shell variable is used. Any "
  5514. "additional arguments following @var{directory} are ignored. If the shell "
  5515. "variable @env{CDPATH} exists, it is used as a search path: each directory "
  5516. "name in @env{CDPATH} is searched for @var{directory}, with alternative "
  5517. "directory names in @env{CDPATH} separated by a colon (@samp{:}). If "
  5518. "@var{directory} begins with a slash, @env{CDPATH} is not used."
  5519. msgstr ""
  5520. #. type: table
  5521. #: bashref.texi:3347
  5522. msgid ""
  5523. "The @option{-P} option means to not follow symbolic links: symbolic links "
  5524. "are resolved while @code{cd} is traversing @var{directory} and before "
  5525. "processing an instance of @samp{..} in @var{directory}."
  5526. msgstr ""
  5527. #. type: table
  5528. #: bashref.texi:3351
  5529. msgid ""
  5530. "By default, or when the @option{-L} option is supplied, symbolic links in "
  5531. "@var{directory} are resolved after @code{cd} processes an instance of "
  5532. "@samp{..} in @var{directory}."
  5533. msgstr ""
  5534. #. type: table
  5535. #: bashref.texi:3355
  5536. msgid ""
  5537. "If @samp{..} appears in @var{directory}, it is processed by removing the "
  5538. "immediately preceding pathname component, back to a slash or the beginning "
  5539. "of @var{directory}."
  5540. msgstr ""
  5541. #. type: table
  5542. #: bashref.texi:3360
  5543. msgid ""
  5544. "If the @option{-e} option is supplied with @option{-P} and the current "
  5545. "working directory cannot be successfully determined after a successful "
  5546. "directory change, @code{cd} will return an unsuccessful status."
  5547. msgstr ""
  5548. #. type: table
  5549. #: bashref.texi:3363
  5550. msgid ""
  5551. "On systems that support it, the @option{-@@} option presents the extended "
  5552. "attributes associated with a file as a directory."
  5553. msgstr ""
  5554. #. type: table
  5555. #: bashref.texi:3366
  5556. msgid ""
  5557. "If @var{directory} is @samp{-}, it is converted to @env{$OLDPWD} before the "
  5558. "directory change is attempted."
  5559. msgstr ""
  5560. #. type: table
  5561. #: bashref.texi:3371
  5562. msgid ""
  5563. "If a non-empty directory name from @env{CDPATH} is used, or if @samp{-} is "
  5564. "the first argument, and the directory change is successful, the absolute "
  5565. "pathname of the new working directory is written to the standard output."
  5566. msgstr ""
  5567. #. type: table
  5568. #: bashref.texi:3374
  5569. msgid ""
  5570. "The return status is zero if the directory is successfully changed, non-zero "
  5571. "otherwise."
  5572. msgstr ""
  5573. #. type: btindex
  5574. #: bashref.texi:3375 bashref.texi:3376
  5575. #, no-wrap
  5576. msgid "continue"
  5577. msgstr ""
  5578. #. type: example
  5579. #: bashref.texi:3379
  5580. #, no-wrap
  5581. msgid "continue [@var{n}]\n"
  5582. msgstr ""
  5583. #. type: table
  5584. #: bashref.texi:3387
  5585. msgid ""
  5586. "Resume the next iteration of an enclosing @code{for}, @code{while}, "
  5587. "@code{until}, or @code{select} loop. If @var{n} is supplied, the execution "
  5588. "of the @var{n}th enclosing loop is resumed. @var{n} must be greater than or "
  5589. "equal to 1. The return status is zero unless @var{n} is not greater than or "
  5590. "equal to 1."
  5591. msgstr ""
  5592. #. type: btindex
  5593. #: bashref.texi:3388 bashref.texi:3389
  5594. #, no-wrap
  5595. msgid "eval"
  5596. msgstr ""
  5597. #. type: example
  5598. #: bashref.texi:3392
  5599. #, no-wrap
  5600. msgid "eval [@var{arguments}]\n"
  5601. msgstr ""
  5602. #. type: table
  5603. #: bashref.texi:3399
  5604. msgid ""
  5605. "The arguments are concatenated together into a single command, which is then "
  5606. "read and executed, and its exit status returned as the exit status of "
  5607. "@code{eval}. If there are no arguments or only empty arguments, the return "
  5608. "status is zero."
  5609. msgstr ""
  5610. #. type: btindex
  5611. #: bashref.texi:3400 bashref.texi:3401
  5612. #, no-wrap
  5613. msgid "exec"
  5614. msgstr ""
  5615. #. type: example
  5616. #: bashref.texi:3404
  5617. #, no-wrap
  5618. msgid "exec [-cl] [-a @var{name}] [@var{command} [@var{arguments}]]\n"
  5619. msgstr ""
  5620. #. type: table
  5621. #: bashref.texi:3423
  5622. msgid ""
  5623. "If @var{command} is supplied, it replaces the shell without creating a new "
  5624. "process. If the @option{-l} option is supplied, the shell places a dash at "
  5625. "the beginning of the zeroth argument passed to @var{command}. This is what "
  5626. "the @code{login} program does. The @option{-c} option causes @var{command} "
  5627. "to be executed with an empty environment. If @option{-a} is supplied, the "
  5628. "shell passes @var{name} as the zeroth argument to @var{command}. If "
  5629. "@var{command} cannot be executed for some reason, a non-interactive shell "
  5630. "exits, unless the @code{execfail} shell option is enabled. In that case, it "
  5631. "returns failure. An interactive shell returns failure if the file cannot be "
  5632. "executed. If no @var{command} is specified, redirections may be used to "
  5633. "affect the current shell environment. If there are no redirection errors, "
  5634. "the return status is zero; otherwise the return status is non-zero."
  5635. msgstr ""
  5636. #. type: btindex
  5637. #: bashref.texi:3424 bashref.texi:3425
  5638. #, no-wrap
  5639. msgid "exit"
  5640. msgstr ""
  5641. #. type: example
  5642. #: bashref.texi:3428
  5643. #, no-wrap
  5644. msgid "exit [@var{n}]\n"
  5645. msgstr ""
  5646. #. type: table
  5647. #: bashref.texi:3433
  5648. msgid ""
  5649. "Exit the shell, returning a status of @var{n} to the shell's parent. If "
  5650. "@var{n} is omitted, the exit status is that of the last command executed. "
  5651. "Any trap on @code{EXIT} is executed before the shell terminates."
  5652. msgstr ""
  5653. #. type: btindex
  5654. #: bashref.texi:3434 bashref.texi:3435
  5655. #, no-wrap
  5656. msgid "export"
  5657. msgstr ""
  5658. #. type: example
  5659. #: bashref.texi:3438
  5660. #, no-wrap
  5661. msgid "export [-fn] [-p] [@var{name}[=@var{value}]]\n"
  5662. msgstr ""
  5663. #. type: table
  5664. #: bashref.texi:3449
  5665. msgid ""
  5666. "Mark each @var{name} to be passed to child processes in the environment. If "
  5667. "the @option{-f} option is supplied, the @var{name}s refer to shell "
  5668. "functions; otherwise the names refer to shell variables. The @option{-n} "
  5669. "option means to no longer mark each @var{name} for export. If no "
  5670. "@var{names} are supplied, or if the @option{-p} option is given, a list of "
  5671. "names of all exported variables is displayed. The @option{-p} option "
  5672. "displays output in a form that may be reused as input. If a variable name "
  5673. "is followed by =@var{value}, the value of the variable is set to @var{value}."
  5674. msgstr ""
  5675. #. type: table
  5676. #: bashref.texi:3453
  5677. msgid ""
  5678. "The return status is zero unless an invalid option is supplied, one of the "
  5679. "names is not a valid shell variable name, or @option{-f} is supplied with a "
  5680. "name that is not a shell function."
  5681. msgstr ""
  5682. #. type: btindex
  5683. #: bashref.texi:3454 bashref.texi:3455
  5684. #, no-wrap
  5685. msgid "getopts"
  5686. msgstr ""
  5687. #. type: example
  5688. #: bashref.texi:3458
  5689. #, no-wrap
  5690. msgid "getopts @var{optstring} @var{name} [@var{args}]\n"
  5691. msgstr ""
  5692. #. type: table
  5693. #: bashref.texi:3478
  5694. msgid ""
  5695. "@code{getopts} is used by shell scripts to parse positional parameters. "
  5696. "@var{optstring} contains the option characters to be recognized; if a "
  5697. "character is followed by a colon, the option is expected to have an "
  5698. "argument, which should be separated from it by whitespace. The colon "
  5699. "(@samp{:}) and question mark (@samp{?}) may not be used as option "
  5700. "characters. Each time it is invoked, @code{getopts} places the next option "
  5701. "in the shell variable @var{name}, initializing @var{name} if it does not "
  5702. "exist, and the index of the next argument to be processed into the variable "
  5703. "@env{OPTIND}. @env{OPTIND} is initialized to 1 each time the shell or a "
  5704. "shell script is invoked. When an option requires an argument, "
  5705. "@code{getopts} places that argument into the variable @env{OPTARG}. The "
  5706. "shell does not reset @env{OPTIND} automatically; it must be manually reset "
  5707. "between multiple calls to @code{getopts} within the same shell invocation if "
  5708. "a new set of parameters is to be used."
  5709. msgstr ""
  5710. #. type: table
  5711. #: bashref.texi:3483
  5712. msgid ""
  5713. "When the end of options is encountered, @code{getopts} exits with a return "
  5714. "value greater than zero. @env{OPTIND} is set to the index of the first non-"
  5715. "option argument, and @var{name} is set to @samp{?}."
  5716. msgstr ""
  5717. #. type: table
  5718. #: bashref.texi:3487
  5719. msgid ""
  5720. "@code{getopts} normally parses the positional parameters, but if more "
  5721. "arguments are given in @var{args}, @code{getopts} parses those instead."
  5722. msgstr ""
  5723. #. type: table
  5724. #: bashref.texi:3496
  5725. msgid ""
  5726. "@code{getopts} can report errors in two ways. If the first character of "
  5727. "@var{optstring} is a colon, @var{silent} error reporting is used. In normal "
  5728. "operation, diagnostic messages are printed when invalid options or missing "
  5729. "option arguments are encountered. If the variable @env{OPTERR} is set to 0, "
  5730. "no error messages will be displayed, even if the first character of "
  5731. "@code{optstring} is not a colon."
  5732. msgstr ""
  5733. #. type: table
  5734. #: bashref.texi:3502
  5735. msgid ""
  5736. "If an invalid option is seen, @code{getopts} places @samp{?} into @var{name} "
  5737. "and, if not silent, prints an error message and unsets @env{OPTARG}. If "
  5738. "@code{getopts} is silent, the option character found is placed in "
  5739. "@env{OPTARG} and no diagnostic message is printed."
  5740. msgstr ""
  5741. #. type: table
  5742. #: bashref.texi:3508
  5743. msgid ""
  5744. "If a required argument is not found, and @code{getopts} is not silent, a "
  5745. "question mark (@samp{?}) is placed in @var{name}, @code{OPTARG} is unset, "
  5746. "and a diagnostic message is printed. If @code{getopts} is silent, then a "
  5747. "colon (@samp{:}) is placed in @var{name} and @env{OPTARG} is set to the "
  5748. "option character found."
  5749. msgstr ""
  5750. #. type: btindex
  5751. #: bashref.texi:3509 bashref.texi:3510
  5752. #, no-wrap
  5753. msgid "hash"
  5754. msgstr ""
  5755. #. type: example
  5756. #: bashref.texi:3513
  5757. #, no-wrap
  5758. msgid "hash [-r] [-p @var{filename}] [-dt] [@var{name}]\n"
  5759. msgstr ""
  5760. #. type: table
  5761. #: bashref.texi:3536
  5762. msgid ""
  5763. "Each time @code{hash} is invoked, it remembers the full pathnames of the "
  5764. "commands specified as @var{name} arguments, so they need not be searched for "
  5765. "on subsequent invocations. The commands are found by searching through the "
  5766. "directories listed in @env{$PATH}. Any previously-remembered pathname is "
  5767. "discarded. The @option{-p} option inhibits the path search, and "
  5768. "@var{filename} is used as the location of @var{name}. The @option{-r} "
  5769. "option causes the shell to forget all remembered locations. The @option{-d} "
  5770. "option causes the shell to forget the remembered location of each "
  5771. "@var{name}. If the @option{-t} option is supplied, the full pathname to "
  5772. "which each @var{name} corresponds is printed. If multiple @var{name} "
  5773. "arguments are supplied with @option{-t} the @var{name} is printed before the "
  5774. "hashed full pathname. The @option{-l} option causes output to be displayed "
  5775. "in a format that may be reused as input. If no arguments are given, or if "
  5776. "only @option{-l} is supplied, information about remembered commands is "
  5777. "printed. The return status is zero unless a @var{name} is not found or an "
  5778. "invalid option is supplied."
  5779. msgstr ""
  5780. #. type: btindex
  5781. #: bashref.texi:3537 bashref.texi:3538
  5782. #, no-wrap
  5783. msgid "pwd"
  5784. msgstr ""
  5785. #. type: example
  5786. #: bashref.texi:3541
  5787. #, no-wrap
  5788. msgid "pwd [-LP]\n"
  5789. msgstr ""
  5790. #. type: table
  5791. #: bashref.texi:3551
  5792. msgid ""
  5793. "Print the absolute pathname of the current working directory. If the "
  5794. "@option{-P} option is supplied, the pathname printed will not contain "
  5795. "symbolic links. If the @option{-L} option is supplied, the pathname printed "
  5796. "may contain symbolic links. The return status is zero unless an error is "
  5797. "encountered while determining the name of the current directory or an "
  5798. "invalid option is supplied."
  5799. msgstr ""
  5800. #. type: btindex
  5801. #: bashref.texi:3552 bashref.texi:3553
  5802. #, no-wrap
  5803. msgid "readonly"
  5804. msgstr ""
  5805. #. type: example
  5806. #: bashref.texi:3556
  5807. #, no-wrap
  5808. msgid "readonly [-aAf] [-p] [@var{name}[=@var{value}]] @dots{}\n"
  5809. msgstr ""
  5810. #. type: table
  5811. #: bashref.texi:3577
  5812. msgid ""
  5813. "Mark each @var{name} as readonly. The values of these names may not be "
  5814. "changed by subsequent assignment. If the @option{-f} option is supplied, "
  5815. "each @var{name} refers to a shell function. The @option{-a} option means "
  5816. "each @var{name} refers to an indexed array variable; the @option{-A} option "
  5817. "means each @var{name} refers to an associative array variable. If both "
  5818. "options are supplied, @option{-A} takes precedence. If no @var{name} "
  5819. "arguments are given, or if the @option{-p} option is supplied, a list of all "
  5820. "readonly names is printed. The other options may be used to restrict the "
  5821. "output to a subset of the set of readonly names. The @option{-p} option "
  5822. "causes output to be displayed in a format that may be reused as input. If a "
  5823. "variable name is followed by =@var{value}, the value of the variable is set "
  5824. "to @var{value}. The return status is zero unless an invalid option is "
  5825. "supplied, one of the @var{name} arguments is not a valid shell variable or "
  5826. "function name, or the @option{-f} option is supplied with a name that is not "
  5827. "a shell function."
  5828. msgstr ""
  5829. #. type: btindex
  5830. #: bashref.texi:3578 bashref.texi:3579
  5831. #, no-wrap
  5832. msgid "return"
  5833. msgstr ""
  5834. #. type: example
  5835. #: bashref.texi:3582
  5836. #, no-wrap
  5837. msgid "return [@var{n}]\n"
  5838. msgstr ""
  5839. #. type: table
  5840. #: bashref.texi:3605
  5841. msgid ""
  5842. "Cause a shell function to stop executing and return the value @var{n} to its "
  5843. "caller. If @var{n} is not supplied, the return value is the exit status of "
  5844. "the last command executed in the function. If @code{return} is executed by "
  5845. "a trap handler, the last command used to determine the status is the last "
  5846. "command executed before the trap handler. if @code{return} is executed "
  5847. "during a @code{DEBUG} trap, the last command used to determine the status is "
  5848. "the last command executed by the trap handler before @code{return} was "
  5849. "invoked. @code{return} may also be used to terminate execution of a script "
  5850. "being executed with the @code{.} (@code{source}) builtin, returning either "
  5851. "@var{n} or the exit status of the last command executed within the script as "
  5852. "the exit status of the script. If @var{n} is supplied, the return value is "
  5853. "its least significant 8 bits. Any command associated with the @code{RETURN} "
  5854. "trap is executed before execution resumes after the function or script. The "
  5855. "return status is non-zero if @code{return} is supplied a non-numeric "
  5856. "argument or is used outside a function and not during the execution of a "
  5857. "script by @code{.} or @code{source}."
  5858. msgstr ""
  5859. #. type: btindex
  5860. #: bashref.texi:3606 bashref.texi:3607
  5861. #, no-wrap
  5862. msgid "shift"
  5863. msgstr ""
  5864. #. type: example
  5865. #: bashref.texi:3610
  5866. #, no-wrap
  5867. msgid "shift [@var{n}]\n"
  5868. msgstr ""
  5869. #. type: table
  5870. #: bashref.texi:3623
  5871. msgid ""
  5872. "Shift the positional parameters to the left by @var{n}. The positional "
  5873. "parameters from @var{n}+1 @dots{} @code{$#} are renamed to @code{$1} @dots{} "
  5874. "@code{$#}-@var{n}. Parameters represented by the numbers @code{$#} to "
  5875. "@code{$#}-@var{n}+1 are unset. @var{n} must be a non-negative number less "
  5876. "than or equal to @code{$#}. If @var{n} is zero or greater than @code{$#}, "
  5877. "the positional parameters are not changed. If @var{n} is not supplied, it "
  5878. "is assumed to be 1. The return status is zero unless @var{n} is greater "
  5879. "than @code{$#} or less than zero, non-zero otherwise."
  5880. msgstr ""
  5881. #. type: btindex
  5882. #: bashref.texi:3624 bashref.texi:3626
  5883. #, no-wrap
  5884. msgid "test"
  5885. msgstr ""
  5886. #. type: btindex
  5887. #: bashref.texi:3625 bashref.texi:3627
  5888. #, no-wrap
  5889. msgid "["
  5890. msgstr ""
  5891. #. type: example
  5892. #: bashref.texi:3630
  5893. #, no-wrap
  5894. msgid "test @var{expr}\n"
  5895. msgstr ""
  5896. #. type: table
  5897. #: bashref.texi:3639
  5898. msgid ""
  5899. "Evaluate a conditional expression @var{expr} and return a status of 0 (true) "
  5900. "or 1 (false). Each operator and operand must be a separate argument. "
  5901. "Expressions are composed of the primaries described below in @ref{Bash "
  5902. "Conditional Expressions}. @code{test} does not accept any options, nor does "
  5903. "it accept and ignore an argument of @option{--} as signifying the end of "
  5904. "options."
  5905. msgstr ""
  5906. #. type: table
  5907. #: bashref.texi:3642
  5908. msgid ""
  5909. "When the @code{[} form is used, the last argument to the command must be a "
  5910. "@code{]}."
  5911. msgstr ""
  5912. #. type: table
  5913. #: bashref.texi:3647
  5914. msgid ""
  5915. "Expressions may be combined using the following operators, listed in "
  5916. "decreasing order of precedence. The evaluation depends on the number of "
  5917. "arguments; see below. Operator precedence is used when there are five or "
  5918. "more arguments."
  5919. msgstr ""
  5920. #. type: item
  5921. #: bashref.texi:3649
  5922. #, no-wrap
  5923. msgid "! @var{expr}"
  5924. msgstr ""
  5925. #. type: table
  5926. #: bashref.texi:3651
  5927. msgid "True if @var{expr} is false."
  5928. msgstr ""
  5929. #. type: item
  5930. #: bashref.texi:3652
  5931. #, no-wrap
  5932. msgid "( @var{expr} )"
  5933. msgstr ""
  5934. #. type: table
  5935. #: bashref.texi:3655
  5936. msgid ""
  5937. "Returns the value of @var{expr}. This may be used to override the normal "
  5938. "precedence of operators."
  5939. msgstr ""
  5940. #. type: item
  5941. #: bashref.texi:3656
  5942. #, no-wrap
  5943. msgid "@var{expr1} -a @var{expr2}"
  5944. msgstr ""
  5945. #. type: table
  5946. #: bashref.texi:3658
  5947. msgid "True if both @var{expr1} and @var{expr2} are true."
  5948. msgstr ""
  5949. #. type: item
  5950. #: bashref.texi:3659
  5951. #, no-wrap
  5952. msgid "@var{expr1} -o @var{expr2}"
  5953. msgstr ""
  5954. #. type: table
  5955. #: bashref.texi:3661
  5956. msgid "True if either @var{expr1} or @var{expr2} is true."
  5957. msgstr ""
  5958. #. type: table
  5959. #: bashref.texi:3665
  5960. msgid ""
  5961. "The @code{test} and @code{[} builtins evaluate conditional expressions using "
  5962. "a set of rules based on the number of arguments."
  5963. msgstr ""
  5964. #. type: item
  5965. #: bashref.texi:3667
  5966. #, no-wrap
  5967. msgid "0 arguments"
  5968. msgstr ""
  5969. #. type: table
  5970. #: bashref.texi:3669
  5971. msgid "The expression is false."
  5972. msgstr ""
  5973. #. type: item
  5974. #: bashref.texi:3670
  5975. #, no-wrap
  5976. msgid "1 argument"
  5977. msgstr ""
  5978. #. type: table
  5979. #: bashref.texi:3672
  5980. msgid "The expression is true if and only if the argument is not null."
  5981. msgstr ""
  5982. #. type: item
  5983. #: bashref.texi:3673
  5984. #, no-wrap
  5985. msgid "2 arguments"
  5986. msgstr ""
  5987. #. type: table
  5988. #: bashref.texi:3681
  5989. msgid ""
  5990. "If the first argument is @samp{!}, the expression is true if and only if the "
  5991. "second argument is null. If the first argument is one of the unary "
  5992. "conditional operators (@pxref{Bash Conditional Expressions}), the expression "
  5993. "is true if the unary test is true. If the first argument is not a valid "
  5994. "unary operator, the expression is false."
  5995. msgstr ""
  5996. #. type: item
  5997. #: bashref.texi:3682
  5998. #, no-wrap
  5999. msgid "3 arguments"
  6000. msgstr ""
  6001. #. type: table
  6002. #: bashref.texi:3696
  6003. msgid ""
  6004. "The following conditions are applied in the order listed. If the second "
  6005. "argument is one of the binary conditional operators (@pxref{Bash Conditional "
  6006. "Expressions}), the result of the expression is the result of the binary test "
  6007. "using the first and third arguments as operands. The @samp{-a} and @samp{-"
  6008. "o} operators are considered binary operators when there are three "
  6009. "arguments. If the first argument is @samp{!}, the value is the negation of "
  6010. "the two-argument test using the second and third arguments. If the first "
  6011. "argument is exactly @samp{(} and the third argument is exactly @samp{)}, the "
  6012. "result is the one-argument test of the second argument. Otherwise, the "
  6013. "expression is false."
  6014. msgstr ""
  6015. #. type: item
  6016. #: bashref.texi:3697
  6017. #, no-wrap
  6018. msgid "4 arguments"
  6019. msgstr ""
  6020. #. type: table
  6021. #: bashref.texi:3702
  6022. msgid ""
  6023. "If the first argument is @samp{!}, the result is the negation of the three-"
  6024. "argument expression composed of the remaining arguments. Otherwise, the "
  6025. "expression is parsed and evaluated according to precedence using the rules "
  6026. "listed above."
  6027. msgstr ""
  6028. #. type: item
  6029. #: bashref.texi:3703
  6030. #, no-wrap
  6031. msgid "5 or more arguments"
  6032. msgstr ""
  6033. #. type: table
  6034. #: bashref.texi:3706
  6035. msgid ""
  6036. "The expression is parsed and evaluated according to precedence using the "
  6037. "rules listed above."
  6038. msgstr ""
  6039. #. type: table
  6040. #: bashref.texi:3710
  6041. msgid ""
  6042. "When used with @code{test} or @samp{[}, the @samp{<} and @samp{>} operators "
  6043. "sort lexicographically using ASCII ordering."
  6044. msgstr ""
  6045. #. type: btindex
  6046. #: bashref.texi:3711 bashref.texi:3712
  6047. #, no-wrap
  6048. msgid "times"
  6049. msgstr ""
  6050. #. type: example
  6051. #: bashref.texi:3715
  6052. #, no-wrap
  6053. msgid "times\n"
  6054. msgstr ""
  6055. #. type: table
  6056. #: bashref.texi:3719
  6057. msgid ""
  6058. "Print out the user and system times used by the shell and its children. The "
  6059. "return status is zero."
  6060. msgstr ""
  6061. #. type: btindex
  6062. #: bashref.texi:3720 bashref.texi:3721
  6063. #, no-wrap
  6064. msgid "trap"
  6065. msgstr ""
  6066. #. type: example
  6067. #: bashref.texi:3724
  6068. #, no-wrap
  6069. msgid "trap [-lp] [@var{arg}] [@var{sigspec} @dots{}]\n"
  6070. msgstr ""
  6071. #. type: table
  6072. #: bashref.texi:3743
  6073. msgid ""
  6074. "The commands in @var{arg} are to be read and executed when the shell "
  6075. "receives signal @var{sigspec}. If @var{arg} is absent (and there is a "
  6076. "single @var{sigspec}) or equal to @samp{-}, each specified signal's "
  6077. "disposition is reset to the value it had when the shell was started. If "
  6078. "@var{arg} is the null string, then the signal specified by each "
  6079. "@var{sigspec} is ignored by the shell and commands it invokes. If @var{arg} "
  6080. "is not present and @option{-p} has been supplied, the shell displays the "
  6081. "trap commands associated with each @var{sigspec}. If no arguments are "
  6082. "supplied, or only @option{-p} is given, @code{trap} prints the list of "
  6083. "commands associated with each signal number in a form that may be reused as "
  6084. "shell input. The @option{-l} option causes the shell to print a list of "
  6085. "signal names and their corresponding numbers. Each @var{sigspec} is either "
  6086. "a signal name or a signal number. Signal names are case insensitive and the "
  6087. "@code{SIG} prefix is optional."
  6088. msgstr ""
  6089. #. type: table
  6090. #: bashref.texi:3756
  6091. msgid ""
  6092. "If a @var{sigspec} is @code{0} or @code{EXIT}, @var{arg} is executed when "
  6093. "the shell exits. If a @var{sigspec} is @code{DEBUG}, the command @var{arg} "
  6094. "is executed before every simple command, @code{for} command, @code{case} "
  6095. "command, @code{select} command, every arithmetic @code{for} command, and "
  6096. "before the first command executes in a shell function. Refer to the "
  6097. "description of the @code{extdebug} option to the @code{shopt} builtin "
  6098. "(@pxref{The Shopt Builtin}) for details of its effect on the @code{DEBUG} "
  6099. "trap. If a @var{sigspec} is @code{RETURN}, the command @var{arg} is "
  6100. "executed each time a shell function or a script executed with the @code{.} "
  6101. "or @code{source} builtins finishes executing."
  6102. msgstr ""
  6103. #. type: table
  6104. #: bashref.texi:3773
  6105. msgid ""
  6106. "If a @var{sigspec} is @code{ERR}, the command @var{arg} is executed whenever "
  6107. "a pipeline (which may consist of a single simple command), a list, or a "
  6108. "compound command returns a non-zero exit status, subject to the following "
  6109. "conditions. The @code{ERR} trap is not executed if the failed command is "
  6110. "part of the command list immediately following an @code{until} or "
  6111. "@code{while} keyword, part of the test following the @code{if} or "
  6112. "@code{elif} reserved words, part of a command executed in a @code{&&} or "
  6113. "@code{||} list except the command following the final @code{&&} or "
  6114. "@code{||}, any command in a pipeline but the last, or if the command's "
  6115. "return status is being inverted using @code{!}. These are the same "
  6116. "conditions obeyed by the @code{errexit} (@option{-e}) option."
  6117. msgstr ""
  6118. #. type: table
  6119. #: bashref.texi:3777
  6120. msgid ""
  6121. "Signals ignored upon entry to the shell cannot be trapped or reset. Trapped "
  6122. "signals that are not being ignored are reset to their original values in a "
  6123. "subshell or subshell environment when one is created."
  6124. msgstr ""
  6125. #. type: table
  6126. #: bashref.texi:3780
  6127. msgid ""
  6128. "The return status is zero unless a @var{sigspec} does not specify a valid "
  6129. "signal."
  6130. msgstr ""
  6131. #. type: btindex
  6132. #: bashref.texi:3781 bashref.texi:3782
  6133. #, no-wrap
  6134. msgid "umask"
  6135. msgstr ""
  6136. #. type: example
  6137. #: bashref.texi:3785
  6138. #, no-wrap
  6139. msgid "umask [-p] [-S] [@var{mode}]\n"
  6140. msgstr ""
  6141. #. type: table
  6142. #: bashref.texi:3798
  6143. msgid ""
  6144. "Set the shell process's file creation mask to @var{mode}. If @var{mode} "
  6145. "begins with a digit, it is interpreted as an octal number; if not, it is "
  6146. "interpreted as a symbolic mode mask similar to that accepted by the "
  6147. "@code{chmod} command. If @var{mode} is omitted, the current value of the "
  6148. "mask is printed. If the @option{-S} option is supplied without a @var{mode} "
  6149. "argument, the mask is printed in a symbolic format. If the @option{-p} "
  6150. "option is supplied, and @var{mode} is omitted, the output is in a form that "
  6151. "may be reused as input. The return status is zero if the mode is "
  6152. "successfully changed or if no @var{mode} argument is supplied, and non-zero "
  6153. "otherwise."
  6154. msgstr ""
  6155. #. type: table
  6156. #: bashref.texi:3802
  6157. msgid ""
  6158. "Note that when the mode is interpreted as an octal number, each number of "
  6159. "the umask is subtracted from @code{7}. Thus, a umask of @code{022} results "
  6160. "in permissions of @code{755}."
  6161. msgstr ""
  6162. #. type: btindex
  6163. #: bashref.texi:3803 bashref.texi:3804
  6164. #, no-wrap
  6165. msgid "unset"
  6166. msgstr ""
  6167. #. type: example
  6168. #: bashref.texi:3807
  6169. #, no-wrap
  6170. msgid "unset [-fnv] [@var{name}]\n"
  6171. msgstr ""
  6172. #. type: table
  6173. #: bashref.texi:3823
  6174. msgid ""
  6175. "Remove each variable or function @var{name}. If the @option{-v} option is "
  6176. "given, each @var{name} refers to a shell variable and that variable is "
  6177. "removed. If the @option{-f} option is given, the @var{name}s refer to shell "
  6178. "functions, and the function definition is removed. If the @option{-n} "
  6179. "option is supplied, and @var{name} is a variable with the @var{nameref} "
  6180. "attribute, @var{name} will be unset rather than the variable it references. "
  6181. "@option{-n} has no effect if the @option{-f} option is supplied. If no "
  6182. "options are supplied, each @var{name} refers to a variable; if there is no "
  6183. "variable by that name, any function with that name is unset. Readonly "
  6184. "variables and functions may not be unset. The return status is zero unless "
  6185. "a @var{name} is readonly."
  6186. msgstr ""
  6187. #. type: section
  6188. #: bashref.texi:3826
  6189. #, no-wrap
  6190. msgid "Bash Builtin Commands"
  6191. msgstr ""
  6192. #. type: Plain text
  6193. #: bashref.texi:3831
  6194. msgid ""
  6195. "This section describes builtin commands which are unique to or have been "
  6196. "extended in Bash. Some of these commands are specified in the @sc{posix} "
  6197. "standard."
  6198. msgstr ""
  6199. #. type: btindex
  6200. #: bashref.texi:3834 bashref.texi:3835
  6201. #, no-wrap
  6202. msgid "alias"
  6203. msgstr ""
  6204. #. type: example
  6205. #: bashref.texi:3838
  6206. #, no-wrap
  6207. msgid "alias [-p] [@var{name}[=@var{value}] @dots{}]\n"
  6208. msgstr ""
  6209. #. type: table
  6210. #: bashref.texi:3847
  6211. msgid ""
  6212. "Without arguments or with the @option{-p} option, @code{alias} prints the "
  6213. "list of aliases on the standard output in a form that allows them to be "
  6214. "reused as input. If arguments are supplied, an alias is defined for each "
  6215. "@var{name} whose @var{value} is given. If no @var{value} is given, the name "
  6216. "and value of the alias is printed. Aliases are described in @ref{Aliases}."
  6217. msgstr ""
  6218. #. type: btindex
  6219. #: bashref.texi:3848 bashref.texi:3849
  6220. #, no-wrap
  6221. msgid "bind"
  6222. msgstr ""
  6223. #. type: example
  6224. #: bashref.texi:3857
  6225. #, no-wrap
  6226. msgid ""
  6227. "bind [-m @var{keymap}] [-lpsvPSVX]\n"
  6228. "bind [-m @var{keymap}] [-q @var{function}] [-u @var{function}] [-r @var{keyseq}]\n"
  6229. "bind [-m @var{keymap}] -f @var{filename}\n"
  6230. "bind [-m @var{keymap}] -x @var{keyseq:shell-command}\n"
  6231. "bind [-m @var{keymap}] @var{keyseq:function-name}\n"
  6232. "bind [-m @var{keymap}] @var{keyseq:readline-command}\n"
  6233. msgstr ""
  6234. #. type: table
  6235. #: bashref.texi:3867
  6236. msgid ""
  6237. "Display current Readline (@pxref{Command Line Editing}) key and function "
  6238. "bindings, bind a key sequence to a Readline function or macro, or set a "
  6239. "Readline variable. Each non-option argument is a command as it would appear "
  6240. "in a Readline initialization file (@pxref{Readline Init File}), but each "
  6241. "binding or command must be passed as a separate argument; e.g., @samp{\"\\C-x"
  6242. "\\C-r\":re-read-init-file}."
  6243. msgstr ""
  6244. #. type: table
  6245. #: bashref.texi:3869 bashref.texi:4212 bashref.texi:4397
  6246. msgid "Options, if supplied, have the following meanings:"
  6247. msgstr ""
  6248. #. type: item
  6249. #: bashref.texi:3871
  6250. #, no-wrap
  6251. msgid "-m @var{keymap}"
  6252. msgstr ""
  6253. #. type: table
  6254. #: bashref.texi:3885
  6255. msgid ""
  6256. "Use @var{keymap} as the keymap to be affected by the subsequent bindings. "
  6257. "Acceptable @var{keymap} names are @code{emacs}, @code{emacs-standard}, "
  6258. "@code{emacs-meta}, @code{emacs-ctlx}, @code{vi}, @code{vi-move}, @code{vi-"
  6259. "command}, and @code{vi-insert}. @code{vi} is equivalent to @code{vi-"
  6260. "command} (@code{vi-move} is also a synonym); @code{emacs} is equivalent to "
  6261. "@code{emacs-standard}."
  6262. msgstr ""
  6263. #. type: item
  6264. #: bashref.texi:3886 bashref.texi:4053 bashref.texi:4579 bashref.texi:6271
  6265. #: bashref.texi:7106 bashref.texi:7784
  6266. #, no-wrap
  6267. msgid "-l"
  6268. msgstr ""
  6269. #. type: table
  6270. #: bashref.texi:3888
  6271. msgid "List the names of all Readline functions."
  6272. msgstr ""
  6273. #. type: item
  6274. #: bashref.texi:3889 bashref.texi:4589 bashref.texi:4851 bashref.texi:7109
  6275. #: bashref.texi:7791
  6276. #, no-wrap
  6277. msgid "-p"
  6278. msgstr ""
  6279. #. type: table
  6280. #: bashref.texi:3892
  6281. msgid ""
  6282. "Display Readline function names and bindings in such a way that they can be "
  6283. "used as input or in a Readline initialization file."
  6284. msgstr ""
  6285. #. type: item
  6286. #: bashref.texi:3893 bashref.texi:4614 bashref.texi:4902
  6287. #, no-wrap
  6288. msgid "-P"
  6289. msgstr ""
  6290. #. type: table
  6291. #: bashref.texi:3895
  6292. msgid "List current Readline function names and bindings."
  6293. msgstr ""
  6294. #. type: item
  6295. #: bashref.texi:3896 bashref.texi:4607 bashref.texi:4874 bashref.texi:7112
  6296. #, no-wrap
  6297. msgid "-v"
  6298. msgstr ""
  6299. #. type: table
  6300. #: bashref.texi:3899
  6301. msgid ""
  6302. "Display Readline variable names and values in such a way that they can be "
  6303. "used as input or in a Readline initialization file."
  6304. msgstr ""
  6305. #. type: item
  6306. #: bashref.texi:3900
  6307. #, no-wrap
  6308. msgid "-V"
  6309. msgstr ""
  6310. #. type: table
  6311. #: bashref.texi:3902
  6312. msgid "List current Readline variable names and values."
  6313. msgstr ""
  6314. #. type: item
  6315. #: bashref.texi:3903 bashref.texi:4218 bashref.texi:4288 bashref.texi:4445
  6316. #: bashref.texi:4598 bashref.texi:4981 bashref.texi:6285 bashref.texi:7797
  6317. #, no-wrap
  6318. msgid "-s"
  6319. msgstr ""
  6320. #. type: table
  6321. #: bashref.texi:3907
  6322. msgid ""
  6323. "Display Readline key sequences bound to macros and the strings they output "
  6324. "in such a way that they can be used as input or in a Readline initialization "
  6325. "file."
  6326. msgstr ""
  6327. #. type: item
  6328. #: bashref.texi:3908 bashref.texi:4549
  6329. #, no-wrap
  6330. msgid "-S"
  6331. msgstr ""
  6332. #. type: table
  6333. #: bashref.texi:3910
  6334. msgid ""
  6335. "Display Readline key sequences bound to macros and the strings they output."
  6336. msgstr ""
  6337. #. type: item
  6338. #: bashref.texi:3911
  6339. #, no-wrap
  6340. msgid "-f @var{filename}"
  6341. msgstr ""
  6342. #. type: table
  6343. #: bashref.texi:3913
  6344. msgid "Read key bindings from @var{filename}."
  6345. msgstr ""
  6346. #. type: item
  6347. #: bashref.texi:3914
  6348. #, no-wrap
  6349. msgid "-q @var{function}"
  6350. msgstr ""
  6351. #. type: table
  6352. #: bashref.texi:3916
  6353. msgid "Query about which keys invoke the named @var{function}."
  6354. msgstr ""
  6355. #. type: item
  6356. #: bashref.texi:3917
  6357. #, no-wrap
  6358. msgid "-u @var{function}"
  6359. msgstr ""
  6360. #. type: table
  6361. #: bashref.texi:3919
  6362. msgid "Unbind all keys bound to the named @var{function}."
  6363. msgstr ""
  6364. #. type: item
  6365. #: bashref.texi:3920
  6366. #, no-wrap
  6367. msgid "-r @var{keyseq}"
  6368. msgstr ""
  6369. #. type: table
  6370. #: bashref.texi:3922
  6371. msgid "Remove any current binding for @var{keyseq}."
  6372. msgstr ""
  6373. #. type: item
  6374. #: bashref.texi:3923
  6375. #, no-wrap
  6376. msgid "-x @var{keyseq:shell-command}"
  6377. msgstr ""
  6378. #. type: table
  6379. #: bashref.texi:3933
  6380. msgid ""
  6381. "Cause @var{shell-command} to be executed whenever @var{keyseq} is entered. "
  6382. "When @var{shell-command} is executed, the shell sets the "
  6383. "@code{READLINE_LINE} variable to the contents of the Readline line buffer "
  6384. "and the @code{READLINE_POINT} variable to the current location of the "
  6385. "insertion point. If the executed command changes the value of "
  6386. "@code{READLINE_LINE} or @code{READLINE_POINT}, those new values will be "
  6387. "reflected in the editing state."
  6388. msgstr ""
  6389. #. type: item
  6390. #: bashref.texi:3934
  6391. #, no-wrap
  6392. msgid "-X"
  6393. msgstr ""
  6394. #. type: table
  6395. #: bashref.texi:3937
  6396. msgid ""
  6397. "List all key sequences bound to shell commands and the associated commands "
  6398. "in a format that can be reused as input."
  6399. msgstr ""
  6400. #. type: table
  6401. #: bashref.texi:3942
  6402. msgid ""
  6403. "The return status is zero unless an invalid option is supplied or an error "
  6404. "occurs."
  6405. msgstr ""
  6406. #. type: example
  6407. #: bashref.texi:3947
  6408. #, no-wrap
  6409. msgid "builtin [@var{shell-builtin} [@var{args}]]\n"
  6410. msgstr ""
  6411. #. type: table
  6412. #: bashref.texi:3955
  6413. msgid ""
  6414. "Run a shell builtin, passing it @var{args}, and return its exit status. "
  6415. "This is useful when defining a shell function with the same name as a shell "
  6416. "builtin, retaining the functionality of the builtin within the function. "
  6417. "The return status is non-zero if @var{shell-builtin} is not a shell builtin "
  6418. "command."
  6419. msgstr ""
  6420. #. type: btindex
  6421. #: bashref.texi:3956 bashref.texi:3957
  6422. #, no-wrap
  6423. msgid "caller"
  6424. msgstr ""
  6425. #. type: example
  6426. #: bashref.texi:3960
  6427. #, no-wrap
  6428. msgid "caller [@var{expr}]\n"
  6429. msgstr ""
  6430. #. type: table
  6431. #: bashref.texi:3964
  6432. msgid ""
  6433. "Returns the context of any active subroutine call (a shell function or a "
  6434. "script executed with the @code{.} or @code{source} builtins)."
  6435. msgstr ""
  6436. #. type: table
  6437. #: bashref.texi:3972
  6438. msgid ""
  6439. "Without @var{expr}, @code{caller} displays the line number and source "
  6440. "filename of the current subroutine call. If a non-negative integer is "
  6441. "supplied as @var{expr}, @code{caller} displays the line number, subroutine "
  6442. "name, and source file corresponding to that position in the current "
  6443. "execution call stack. This extra information may be used, for example, to "
  6444. "print a stack trace. The current frame is frame 0."
  6445. msgstr ""
  6446. #. type: table
  6447. #: bashref.texi:3976
  6448. msgid ""
  6449. "The return value is 0 unless the shell is not executing a subroutine call or "
  6450. "@var{expr} does not correspond to a valid position in the call stack."
  6451. msgstr ""
  6452. #. type: btindex
  6453. #: bashref.texi:3977 bashref.texi:3978
  6454. #, no-wrap
  6455. msgid "command"
  6456. msgstr ""
  6457. #. type: example
  6458. #: bashref.texi:3981
  6459. #, no-wrap
  6460. msgid "command [-pVv] @var{command} [@var{arguments} @dots{}]\n"
  6461. msgstr ""
  6462. #. type: table
  6463. #: bashref.texi:3995
  6464. msgid ""
  6465. "Runs @var{command} with @var{arguments} ignoring any shell function named "
  6466. "@var{command}. Only shell builtin commands or commands found by searching "
  6467. "the @env{PATH} are executed. If there is a shell function named @code{ls}, "
  6468. "running @samp{command ls} within the function will execute the external "
  6469. "command @code{ls} instead of calling the function recursively. The @option{-"
  6470. "p} option means to use a default value for @env{PATH} that is guaranteed to "
  6471. "find all of the standard utilities. The return status in this case is 127 "
  6472. "if @var{command} cannot be found or an error occurred, and the exit status "
  6473. "of @var{command} otherwise."
  6474. msgstr ""
  6475. #. type: table
  6476. #: bashref.texi:4002
  6477. msgid ""
  6478. "If either the @option{-V} or @option{-v} option is supplied, a description "
  6479. "of @var{command} is printed. The @option{-v} option causes a single word "
  6480. "indicating the command or file name used to invoke @var{command} to be "
  6481. "displayed; the @option{-V} option produces a more verbose description. In "
  6482. "this case, the return status is zero if @var{command} is found, and non-zero "
  6483. "if not."
  6484. msgstr ""
  6485. #. type: btindex
  6486. #: bashref.texi:4003 bashref.texi:4004
  6487. #, no-wrap
  6488. msgid "declare"
  6489. msgstr ""
  6490. #. type: example
  6491. #: bashref.texi:4007
  6492. #, no-wrap
  6493. msgid "declare [-aAfFgilnrtux] [-p] [@var{name}[=@var{value}] @dots{}]\n"
  6494. msgstr ""
  6495. #. type: table
  6496. #: bashref.texi:4011
  6497. msgid ""
  6498. "Declare variables and give them attributes. If no @var{name}s are given, "
  6499. "then display the values of variables instead."
  6500. msgstr ""
  6501. #. type: table
  6502. #: bashref.texi:4016
  6503. msgid ""
  6504. "The @option{-p} option will display the attributes and values of each "
  6505. "@var{name}. When @option{-p} is used with @var{name} arguments, additional "
  6506. "options, other than @option{-f} and @option{-F}, are ignored."
  6507. msgstr ""
  6508. #. type: table
  6509. #: bashref.texi:4023
  6510. msgid ""
  6511. "When @option{-p} is supplied without @var{name} arguments, @code{declare} "
  6512. "will display the attributes and values of all variables having the "
  6513. "attributes specified by the additional options. If no other options are "
  6514. "supplied with @option{-p}, @code{declare} will display the attributes and "
  6515. "values of all shell variables. The @option{-f} option will restrict the "
  6516. "display to shell functions."
  6517. msgstr ""
  6518. #. type: table
  6519. #: bashref.texi:4030
  6520. msgid ""
  6521. "The @option{-F} option inhibits the display of function definitions; only "
  6522. "the function name and attributes are printed. If the @code{extdebug} shell "
  6523. "option is enabled using @code{shopt} (@pxref{The Shopt Builtin}), the source "
  6524. "file name and line number where each @var{name} is defined are displayed as "
  6525. "well. @option{-F} implies @option{-f}."
  6526. msgstr ""
  6527. #. type: table
  6528. #: bashref.texi:4034
  6529. msgid ""
  6530. "The @option{-g} option forces variables to be created or modified at the "
  6531. "global scope, even when @code{declare} is executed in a shell function. It "
  6532. "is ignored in all other cases."
  6533. msgstr ""
  6534. #. type: table
  6535. #: bashref.texi:4037
  6536. msgid ""
  6537. "The following options can be used to restrict output to variables with the "
  6538. "specified attributes or to give variables attributes:"
  6539. msgstr ""
  6540. #. type: item
  6541. #: bashref.texi:4039 bashref.texi:4555 bashref.texi:4692
  6542. #, no-wrap
  6543. msgid "-a"
  6544. msgstr ""
  6545. #. type: table
  6546. #: bashref.texi:4041
  6547. msgid "Each @var{name} is an indexed array variable (@pxref{Arrays})."
  6548. msgstr ""
  6549. #. type: item
  6550. #: bashref.texi:4042
  6551. #, no-wrap
  6552. msgid "-A"
  6553. msgstr ""
  6554. #. type: table
  6555. #: bashref.texi:4044
  6556. msgid "Each @var{name} is an associative array variable (@pxref{Arrays})."
  6557. msgstr ""
  6558. #. type: item
  6559. #: bashref.texi:4045 bashref.texi:4570 bashref.texi:4734
  6560. #, no-wrap
  6561. msgid "-f"
  6562. msgstr ""
  6563. #. type: table
  6564. #: bashref.texi:4047
  6565. msgid "Use function names only."
  6566. msgstr ""
  6567. #. type: item
  6568. #: bashref.texi:4048 bashref.texi:4573 bashref.texi:6267
  6569. #, no-wrap
  6570. msgid "-i"
  6571. msgstr ""
  6572. #. type: table
  6573. #: bashref.texi:4052
  6574. msgid ""
  6575. "The variable is to be treated as an integer; arithmetic evaluation "
  6576. "(@pxref{Shell Arithmetic}) is performed when the variable is assigned a "
  6577. "value."
  6578. msgstr ""
  6579. #. type: table
  6580. #: bashref.texi:4057
  6581. msgid ""
  6582. "When the variable is assigned a value, all upper-case characters are "
  6583. "converted to lower-case. The upper-case attribute is disabled."
  6584. msgstr ""
  6585. #. type: item
  6586. #: bashref.texi:4058 bashref.texi:4283 bashref.texi:4585 bashref.texi:4752
  6587. #: bashref.texi:7138 bashref.texi:7161 bashref.texi:7787
  6588. #, no-wrap
  6589. msgid "-n"
  6590. msgstr ""
  6591. #. type: table
  6592. #: bashref.texi:4067
  6593. msgid ""
  6594. "Give each @var{name} the @var{nameref} attribute, making it a name reference "
  6595. "to another variable. That other variable is defined by the value of "
  6596. "@var{name}. All references, assignments, and attribute modifications to "
  6597. "@var{name}, except for those using or changing the @option{-n} attribute "
  6598. "itself, are performed on the variable referenced by @var{name}'s value. The "
  6599. "nameref attribute cannot be applied to array variables."
  6600. msgstr ""
  6601. #. type: item
  6602. #: bashref.texi:4068 bashref.texi:4439 bashref.texi:4595 bashref.texi:6282
  6603. #: bashref.texi:7794
  6604. #, no-wrap
  6605. msgid "-r"
  6606. msgstr ""
  6607. #. type: table
  6608. #: bashref.texi:4071
  6609. msgid ""
  6610. "Make @var{name}s readonly. These names cannot then be assigned values by "
  6611. "subsequent assignment statements or unset."
  6612. msgstr ""
  6613. #. type: item
  6614. #: bashref.texi:4072 bashref.texi:4290 bashref.texi:4601 bashref.texi:4865
  6615. #, no-wrap
  6616. msgid "-t"
  6617. msgstr ""
  6618. #. type: table
  6619. #: bashref.texi:4077
  6620. msgid ""
  6621. "Give each @var{name} the @code{trace} attribute. Traced functions inherit "
  6622. "the @code{DEBUG} and @code{RETURN} traps from the calling shell. The trace "
  6623. "attribute has no special meaning for variables."
  6624. msgstr ""
  6625. #. type: item
  6626. #: bashref.texi:4078 bashref.texi:4292 bashref.texi:4604 bashref.texi:4868
  6627. #: bashref.texi:4984
  6628. #, no-wrap
  6629. msgid "-u"
  6630. msgstr ""
  6631. #. type: table
  6632. #: bashref.texi:4082
  6633. msgid ""
  6634. "When the variable is assigned a value, all lower-case characters are "
  6635. "converted to upper-case. The lower-case attribute is disabled."
  6636. msgstr ""
  6637. #. type: item
  6638. #: bashref.texi:4083 bashref.texi:4611 bashref.texi:4877
  6639. #, no-wrap
  6640. msgid "-x"
  6641. msgstr ""
  6642. #. type: table
  6643. #: bashref.texi:4086
  6644. msgid ""
  6645. "Mark each @var{name} for export to subsequent commands via the environment."
  6646. msgstr ""
  6647. #. type: table
  6648. #: bashref.texi:4096
  6649. msgid ""
  6650. "Using @samp{+} instead of @samp{-} turns off the attribute instead, with the "
  6651. "exceptions that @samp{+a} may not be used to destroy an array variable and "
  6652. "@samp{+r} will not remove the readonly attribute. When used in a function, "
  6653. "@code{declare} makes each @var{name} local, as with the @code{local} "
  6654. "command, unless the @option{-g} option is used. If a variable name is "
  6655. "followed by =@var{value}, the value of the variable is set to @var{value}."
  6656. msgstr ""
  6657. #. type: table
  6658. #: bashref.texi:4100
  6659. msgid ""
  6660. "When using @option{-a} or @option{-A} and the compound assignment syntax to "
  6661. "create array variables, additional attributes do not take effect until "
  6662. "subsequent assignments."
  6663. msgstr ""
  6664. #. type: table
  6665. #: bashref.texi:4110
  6666. msgid ""
  6667. "The return status is zero unless an invalid option is encountered, an "
  6668. "attempt is made to define a function using @samp{-f foo=bar}, an attempt is "
  6669. "made to assign a value to a readonly variable, an attempt is made to assign "
  6670. "a value to an array variable without using the compound assignment syntax "
  6671. "(@pxref{Arrays}), one of the @var{names} is not a valid shell variable name, "
  6672. "an attempt is made to turn off readonly status for a readonly variable, an "
  6673. "attempt is made to turn off array status for an array variable, or an "
  6674. "attempt is made to display a non-existent function with @option{-f}."
  6675. msgstr ""
  6676. #. type: btindex
  6677. #: bashref.texi:4111 bashref.texi:4112
  6678. #, no-wrap
  6679. msgid "echo"
  6680. msgstr ""
  6681. #. type: example
  6682. #: bashref.texi:4115
  6683. #, no-wrap
  6684. msgid "echo [-neE] [@var{arg} @dots{}]\n"
  6685. msgstr ""
  6686. #. type: table
  6687. #: bashref.texi:4129
  6688. msgid ""
  6689. "Output the @var{arg}s, separated by spaces, terminated with a newline. The "
  6690. "return status is 0 unless a write error occurs. If @option{-n} is "
  6691. "specified, the trailing newline is suppressed. If the @option{-e} option is "
  6692. "given, interpretation of the following backslash-escaped characters is "
  6693. "enabled. The @option{-E} option disables the interpretation of these escape "
  6694. "characters, even on systems where they are interpreted by default. The "
  6695. "@code{xpg_echo} shell option may be used to dynamically determine whether or "
  6696. "not @code{echo} expands these escape characters by default. @code{echo} "
  6697. "does not interpret @option{--} to mean the end of options."
  6698. msgstr ""
  6699. #. type: table
  6700. #: bashref.texi:4131
  6701. msgid "@code{echo} interprets the following escape sequences:"
  6702. msgstr ""
  6703. #. type: item
  6704. #: bashref.texi:4136
  6705. #, no-wrap
  6706. msgid "\\c"
  6707. msgstr ""
  6708. #. type: table
  6709. #: bashref.texi:4138
  6710. msgid "suppress further output"
  6711. msgstr ""
  6712. #. type: table
  6713. #: bashref.texi:4141
  6714. msgid "escape"
  6715. msgstr ""
  6716. #. type: table
  6717. #: bashref.texi:4145
  6718. msgid "new line"
  6719. msgstr ""
  6720. #. type: item
  6721. #: bashref.texi:4153
  6722. #, no-wrap
  6723. msgid "\\0@var{nnn}"
  6724. msgstr ""
  6725. #. type: table
  6726. #: bashref.texi:4156
  6727. msgid ""
  6728. "the eight-bit character whose value is the octal value @var{nnn} (zero to "
  6729. "three octal digits)"
  6730. msgstr ""
  6731. #. type: btindex
  6732. #: bashref.texi:4167 bashref.texi:4168
  6733. #, no-wrap
  6734. msgid "enable"
  6735. msgstr ""
  6736. #. type: example
  6737. #: bashref.texi:4171
  6738. #, no-wrap
  6739. msgid "enable [-a] [-dnps] [-f @var{filename}] [@var{name} @dots{}]\n"
  6740. msgstr ""
  6741. #. type: table
  6742. #: bashref.texi:4181
  6743. msgid ""
  6744. "Enable and disable builtin shell commands. Disabling a builtin allows a "
  6745. "disk command which has the same name as a shell builtin to be executed "
  6746. "without specifying a full pathname, even though the shell normally searches "
  6747. "for builtins before disk commands. If @option{-n} is used, the @var{name}s "
  6748. "become disabled. Otherwise @var{name}s are enabled. For example, to use "
  6749. "the @code{test} binary found via @env{$PATH} instead of the shell builtin "
  6750. "version, type @samp{enable -n test}."
  6751. msgstr ""
  6752. #. type: table
  6753. #: bashref.texi:4187
  6754. msgid ""
  6755. "If the @option{-p} option is supplied, or no @var{name} arguments appear, a "
  6756. "list of shell builtins is printed. With no other arguments, the list "
  6757. "consists of all enabled shell builtins. The @option{-a} option means to "
  6758. "list each builtin with an indication of whether or not it is enabled."
  6759. msgstr ""
  6760. #. type: table
  6761. #: bashref.texi:4191
  6762. msgid ""
  6763. "The @option{-f} option means to load the new builtin command @var{name} from "
  6764. "shared object @var{filename}, on systems that support dynamic loading. The "
  6765. "@option{-d} option will delete a builtin loaded with @option{-f}."
  6766. msgstr ""
  6767. #. type: table
  6768. #: bashref.texi:4196
  6769. msgid ""
  6770. "If there are no options, a list of the shell builtins is displayed. The "
  6771. "@option{-s} option restricts @code{enable} to the @sc{posix} special "
  6772. "builtins. If @option{-s} is used with @option{-f}, the new builtin becomes "
  6773. "a special builtin (@pxref{Special Builtins})."
  6774. msgstr ""
  6775. #. type: table
  6776. #: bashref.texi:4199
  6777. msgid ""
  6778. "The return status is zero unless a @var{name} is not a shell builtin or "
  6779. "there is an error loading a new builtin from a shared object."
  6780. msgstr ""
  6781. #. type: btindex
  6782. #: bashref.texi:4200 bashref.texi:4201
  6783. #, no-wrap
  6784. msgid "help"
  6785. msgstr ""
  6786. #. type: example
  6787. #: bashref.texi:4204
  6788. #, no-wrap
  6789. msgid "help [-dms] [@var{pattern}]\n"
  6790. msgstr ""
  6791. #. type: table
  6792. #: bashref.texi:4210
  6793. msgid ""
  6794. "Display helpful information about builtin commands. If @var{pattern} is "
  6795. "specified, @code{help} gives detailed help on all commands matching "
  6796. "@var{pattern}, otherwise a list of the builtins is printed."
  6797. msgstr ""
  6798. #. type: item
  6799. #: bashref.texi:4214 bashref.texi:4280 bashref.texi:4564
  6800. #, no-wrap
  6801. msgid "-d"
  6802. msgstr ""
  6803. #. type: table
  6804. #: bashref.texi:4216
  6805. msgid "Display a short description of each @var{pattern}"
  6806. msgstr ""
  6807. #. type: item
  6808. #: bashref.texi:4216 bashref.texi:4582 bashref.texi:4746
  6809. #, no-wrap
  6810. msgid "-m"
  6811. msgstr ""
  6812. #. type: table
  6813. #: bashref.texi:4218
  6814. msgid "Display the description of each @var{pattern} in a manpage-like format"
  6815. msgstr ""
  6816. #. type: table
  6817. #: bashref.texi:4220
  6818. msgid "Display only a short usage synopsis for each @var{pattern}"
  6819. msgstr ""
  6820. #. type: table
  6821. #: bashref.texi:4223
  6822. msgid "The return status is zero unless no command matches @var{pattern}."
  6823. msgstr ""
  6824. #. type: btindex
  6825. #: bashref.texi:4224 bashref.texi:4225
  6826. #, no-wrap
  6827. msgid "let"
  6828. msgstr ""
  6829. #. type: example
  6830. #: bashref.texi:4228
  6831. #, no-wrap
  6832. msgid "let @var{expression} [@var{expression} @dots{}]\n"
  6833. msgstr ""
  6834. #. type: table
  6835. #: bashref.texi:4235
  6836. msgid ""
  6837. "The @code{let} builtin allows arithmetic to be performed on shell "
  6838. "variables. Each @var{expression} is evaluated according to the rules given "
  6839. "below in @ref{Shell Arithmetic}. If the last @var{expression} evaluates to "
  6840. "0, @code{let} returns 1; otherwise 0 is returned."
  6841. msgstr ""
  6842. #. type: btindex
  6843. #: bashref.texi:4236 bashref.texi:4237
  6844. #, no-wrap
  6845. msgid "local"
  6846. msgstr ""
  6847. #. type: example
  6848. #: bashref.texi:4240
  6849. #, no-wrap
  6850. msgid "local [@var{option}] @var{name}[=@var{value}] @dots{}\n"
  6851. msgstr ""
  6852. #. type: table
  6853. #: bashref.texi:4255
  6854. msgid ""
  6855. "For each argument, a local variable named @var{name} is created, and "
  6856. "assigned @var{value}. The @var{option} can be any of the options accepted "
  6857. "by @code{declare}. @code{local} can only be used within a function; it "
  6858. "makes the variable @var{name} have a visible scope restricted to that "
  6859. "function and its children. If @var{name} is @samp{-}, the set of shell "
  6860. "options is made local to the function in which @code{local} is invoked: "
  6861. "shell options changed using the @code{set} builtin inside the function are "
  6862. "restored to their original values when the function returns. The return "
  6863. "status is zero unless @code{local} is used outside a function, an invalid "
  6864. "@var{name} is supplied, or @var{name} is a readonly variable."
  6865. msgstr ""
  6866. #. type: btindex
  6867. #: bashref.texi:4256 bashref.texi:4257
  6868. #, no-wrap
  6869. msgid "logout"
  6870. msgstr ""
  6871. #. type: example
  6872. #: bashref.texi:4260
  6873. #, no-wrap
  6874. msgid "logout [@var{n}]\n"
  6875. msgstr ""
  6876. #. type: table
  6877. #: bashref.texi:4264
  6878. msgid ""
  6879. "Exit a login shell, returning a status of @var{n} to the shell's parent."
  6880. msgstr ""
  6881. #. type: btindex
  6882. #: bashref.texi:4265 bashref.texi:4266
  6883. #, no-wrap
  6884. msgid "mapfile"
  6885. msgstr ""
  6886. #. type: example
  6887. #: bashref.texi:4270
  6888. #, no-wrap
  6889. msgid ""
  6890. "mapfile [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}]\n"
  6891. " [-C @var{callback}] [-c @var{quantum}] [@var{array}]\n"
  6892. msgstr ""
  6893. #. type: table
  6894. #: bashref.texi:4277
  6895. msgid ""
  6896. "Read lines from the standard input into the indexed array variable "
  6897. "@var{array}, or from file descriptor @var{fd} if the @option{-u} option is "
  6898. "supplied. The variable @code{MAPFILE} is the default @var{array}. Options, "
  6899. "if supplied, have the following meanings:"
  6900. msgstr ""
  6901. #. type: table
  6902. #: bashref.texi:4283
  6903. msgid ""
  6904. "The first character of @var{delim} is used to terminate each input line, "
  6905. "rather than newline."
  6906. msgstr ""
  6907. #. type: table
  6908. #: bashref.texi:4285
  6909. msgid ""
  6910. "Copy at most @var{count} lines. If @var{count} is 0, all lines are copied."
  6911. msgstr ""
  6912. #. type: item
  6913. #: bashref.texi:4285
  6914. #, no-wrap
  6915. msgid "-O"
  6916. msgstr ""
  6917. #. type: table
  6918. #: bashref.texi:4288
  6919. msgid ""
  6920. "Begin assigning to @var{array} at index @var{origin}. The default index is "
  6921. "0."
  6922. msgstr ""
  6923. #. type: table
  6924. #: bashref.texi:4290
  6925. msgid "Discard the first @var{count} lines read."
  6926. msgstr ""
  6927. #. type: table
  6928. #: bashref.texi:4292
  6929. msgid "Remove a trailing @var{delim} (default newline) from each line read."
  6930. msgstr ""
  6931. #. type: table
  6932. #: bashref.texi:4294
  6933. msgid "Read lines from file descriptor @var{fd} instead of the standard input."
  6934. msgstr ""
  6935. #. type: item
  6936. #: bashref.texi:4294 bashref.texi:4889
  6937. #, no-wrap
  6938. msgid "-C"
  6939. msgstr ""
  6940. #. type: table
  6941. #: bashref.texi:4297
  6942. msgid ""
  6943. "Evaluate @var{callback} each time @var{quantum}P lines are read. The "
  6944. "@option{-c} option specifies @var{quantum}."
  6945. msgstr ""
  6946. #. type: item
  6947. #: bashref.texi:4297 bashref.texi:4561 bashref.texi:6258 bashref.texi:7104
  6948. #, no-wrap
  6949. msgid "-c"
  6950. msgstr ""
  6951. #. type: table
  6952. #: bashref.texi:4299
  6953. msgid "Specify the number of lines read between each call to @var{callback}."
  6954. msgstr ""
  6955. #. type: table
  6956. #: bashref.texi:4308
  6957. msgid ""
  6958. "If @option{-C} is specified without @option{-c}, the default quantum is "
  6959. "5000. When @var{callback} is evaluated, it is supplied the index of the "
  6960. "next array element to be assigned and the line to be assigned to that "
  6961. "element as additional arguments. @var{callback} is evaluated after the line "
  6962. "is read but before the array element is assigned."
  6963. msgstr ""
  6964. #. type: table
  6965. #: bashref.texi:4311
  6966. msgid ""
  6967. "If not supplied with an explicit origin, @code{mapfile} will clear "
  6968. "@var{array} before assigning to it."
  6969. msgstr ""
  6970. #. type: table
  6971. #: bashref.texi:4315
  6972. msgid ""
  6973. "@code{mapfile} returns successfully unless an invalid option or option "
  6974. "argument is supplied, @var{array} is invalid or unassignable, or @var{array} "
  6975. "is not an indexed array."
  6976. msgstr ""
  6977. #. type: btindex
  6978. #: bashref.texi:4316 bashref.texi:4317
  6979. #, no-wrap
  6980. msgid "printf"
  6981. msgstr ""
  6982. #. type: example
  6983. #: bashref.texi:4320
  6984. #, no-wrap
  6985. msgid "printf [-v @var{var}] @var{format} [@var{arguments}]\n"
  6986. msgstr ""
  6987. #. type: table
  6988. #: bashref.texi:4326
  6989. msgid ""
  6990. "Write the formatted @var{arguments} to the standard output under the control "
  6991. "of the @var{format}. The @option{-v} option causes the output to be "
  6992. "assigned to the variable @var{var} rather than being printed to the standard "
  6993. "output."
  6994. msgstr ""
  6995. #. type: table
  6996. #: bashref.texi:4334
  6997. msgid ""
  6998. "The @var{format} is a character string which contains three types of "
  6999. "objects: plain characters, which are simply copied to standard output, "
  7000. "character escape sequences, which are converted and copied to the standard "
  7001. "output, and format specifications, each of which causes printing of the next "
  7002. "successive @var{argument}. In addition to the standard @code{printf(1)} "
  7003. "formats, @code{printf} interprets the following extensions:"
  7004. msgstr ""
  7005. #. type: item
  7006. #: bashref.texi:4336
  7007. #, no-wrap
  7008. msgid "%b"
  7009. msgstr ""
  7010. #. type: table
  7011. #: bashref.texi:4340
  7012. msgid ""
  7013. "Causes @code{printf} to expand backslash escape sequences in the "
  7014. "corresponding @var{argument} in the same way as @code{echo -e} (@pxref{Bash "
  7015. "Builtins})."
  7016. msgstr ""
  7017. #. type: item
  7018. #: bashref.texi:4340
  7019. #, no-wrap
  7020. msgid "%q"
  7021. msgstr ""
  7022. #. type: table
  7023. #: bashref.texi:4343
  7024. msgid ""
  7025. "Causes @code{printf} to output the corresponding @var{argument} in a format "
  7026. "that can be reused as shell input."
  7027. msgstr ""
  7028. #. type: item
  7029. #: bashref.texi:4343
  7030. #, no-wrap
  7031. msgid "%(@var{datefmt})T"
  7032. msgstr ""
  7033. #. type: table
  7034. #: bashref.texi:4352
  7035. msgid ""
  7036. "Causes @code{printf} to output the date-time string resulting from using "
  7037. "@var{datefmt} as a format string for @code{strftime}(3). The corresponding "
  7038. "@var{argument} is an integer representing the number of seconds since the "
  7039. "epoch. Two special argument values may be used: -1 represents the current "
  7040. "time, and -2 represents the time the shell was invoked. If no argument is "
  7041. "specified, conversion behaves as if -1 had been given. This is an exception "
  7042. "to the usual @code{printf} behavior."
  7043. msgstr ""
  7044. #. type: table
  7045. #: bashref.texi:4359
  7046. msgid ""
  7047. "Arguments to non-string format specifiers are treated as C language "
  7048. "constants, except that a leading plus or minus sign is allowed, and if the "
  7049. "leading character is a single or double quote, the value is the ASCII value "
  7050. "of the following character."
  7051. msgstr ""
  7052. #. type: table
  7053. #: bashref.texi:4365
  7054. msgid ""
  7055. "The @var{format} is reused as necessary to consume all of the "
  7056. "@var{arguments}. If the @var{format} requires more @var{arguments} than are "
  7057. "supplied, the extra format specifications behave as if a zero value or null "
  7058. "string, as appropriate, had been supplied. The return value is zero on "
  7059. "success, non-zero on failure."
  7060. msgstr ""
  7061. #. type: btindex
  7062. #: bashref.texi:4366 bashref.texi:4367
  7063. #, no-wrap
  7064. msgid "read"
  7065. msgstr ""
  7066. #. type: example
  7067. #: bashref.texi:4371
  7068. #, no-wrap
  7069. msgid ""
  7070. "read [-ers] [-a @var{aname}] [-d @var{delim}] [-i @var{text}] [-n @var{nchars}]\n"
  7071. " [-N @var{nchars}] [-p @var{prompt}] [-t @var{timeout}] [-u @var{fd}] [@var{name} @dots{}]\n"
  7072. msgstr ""
  7073. #. type: table
  7074. #: bashref.texi:4395
  7075. msgid ""
  7076. "One line is read from the standard input, or from the file descriptor "
  7077. "@var{fd} supplied as an argument to the @option{-u} option, split into words "
  7078. "as described above in @ref{Word Splitting}, and the first word is assigned "
  7079. "to the first @var{name}, the second word to the second @var{name}, and so "
  7080. "on. If there are more words than names, the remaining words and their "
  7081. "intervening delimiters are assigned to the last @var{name}. If there are "
  7082. "fewer words read from the input stream than names, the remaining names are "
  7083. "assigned empty values. The characters in the value of the @env{IFS} "
  7084. "variable are used to split the line into words using the same rules the "
  7085. "shell uses for expansion (described above in @ref{Word Splitting}). The "
  7086. "backslash character @samp{\\} may be used to remove any special meaning for "
  7087. "the next character read and for line continuation. If no names are "
  7088. "supplied, the line read is assigned to the variable @env{REPLY}. The exit "
  7089. "status is zero, unless end-of-file is encountered, @code{read} times out (in "
  7090. "which case the status is greater than 128), a variable assignment error "
  7091. "(such as assigning to a readonly variable) occurs, or an invalid file "
  7092. "descriptor is supplied as the argument to @option{-u}."
  7093. msgstr ""
  7094. #. type: item
  7095. #: bashref.texi:4399
  7096. #, no-wrap
  7097. msgid "-a @var{aname}"
  7098. msgstr ""
  7099. #. type: table
  7100. #: bashref.texi:4404
  7101. msgid ""
  7102. "The words are assigned to sequential indices of the array variable "
  7103. "@var{aname}, starting at 0. All elements are removed from @var{aname} "
  7104. "before the assignment. Other @var{name} arguments are ignored."
  7105. msgstr ""
  7106. #. type: item
  7107. #: bashref.texi:4405
  7108. #, no-wrap
  7109. msgid "-d @var{delim}"
  7110. msgstr ""
  7111. #. type: table
  7112. #: bashref.texi:4408
  7113. msgid ""
  7114. "The first character of @var{delim} is used to terminate the input line, "
  7115. "rather than newline."
  7116. msgstr ""
  7117. #. type: item
  7118. #: bashref.texi:4409 bashref.texi:4567 bashref.texi:4701
  7119. #, no-wrap
  7120. msgid "-e"
  7121. msgstr ""
  7122. #. type: table
  7123. #: bashref.texi:4413
  7124. msgid ""
  7125. "Readline (@pxref{Command Line Editing}) is used to obtain the line. "
  7126. "Readline uses the current (or default, if line editing was not previously "
  7127. "active) editing settings."
  7128. msgstr ""
  7129. #. type: item
  7130. #: bashref.texi:4414
  7131. #, no-wrap
  7132. msgid "-i @var{text}"
  7133. msgstr ""
  7134. #. type: table
  7135. #: bashref.texi:4417
  7136. msgid ""
  7137. "If Readline is being used to read the line, @var{text} is placed into the "
  7138. "editing buffer before editing begins."
  7139. msgstr ""
  7140. #. type: item
  7141. #: bashref.texi:4418
  7142. #, no-wrap
  7143. msgid "-n @var{nchars}"
  7144. msgstr ""
  7145. #. type: table
  7146. #: bashref.texi:4422
  7147. msgid ""
  7148. "@code{read} returns after reading @var{nchars} characters rather than "
  7149. "waiting for a complete line of input, but honors a delimiter if fewer than "
  7150. "@var{nchars} characters are read before the delimiter."
  7151. msgstr ""
  7152. #. type: item
  7153. #: bashref.texi:4423
  7154. #, no-wrap
  7155. msgid "-N @var{nchars}"
  7156. msgstr ""
  7157. #. type: table
  7158. #: bashref.texi:4433
  7159. msgid ""
  7160. "@code{read} returns after reading exactly @var{nchars} characters rather "
  7161. "than waiting for a complete line of input, unless EOF is encountered or "
  7162. "@code{read} times out. Delimiter characters encountered in the input are "
  7163. "not treated specially and do not cause @code{read} to return until "
  7164. "@var{nchars} characters are read. The result is not split on the characters "
  7165. "in @code{IFS}; the intent is that the variable is assigned exactly the "
  7166. "characters read (with the exception of backslash; see the @option{-r} option "
  7167. "below)."
  7168. msgstr ""
  7169. #. type: item
  7170. #: bashref.texi:4434
  7171. #, no-wrap
  7172. msgid "-p @var{prompt}"
  7173. msgstr ""
  7174. #. type: table
  7175. #: bashref.texi:4438
  7176. msgid ""
  7177. "Display @var{prompt}, without a trailing newline, before attempting to read "
  7178. "any input. The prompt is displayed only if input is coming from a terminal."
  7179. msgstr ""
  7180. #. type: table
  7181. #: bashref.texi:4444
  7182. msgid ""
  7183. "If this option is given, backslash does not act as an escape character. The "
  7184. "backslash is considered to be part of the line. In particular, a backslash-"
  7185. "newline pair may not be used as a line continuation."
  7186. msgstr ""
  7187. #. type: table
  7188. #: bashref.texi:4448
  7189. msgid ""
  7190. "Silent mode. If input is coming from a terminal, characters are not echoed."
  7191. msgstr ""
  7192. #. type: item
  7193. #: bashref.texi:4449
  7194. #, no-wrap
  7195. msgid "-t @var{timeout}"
  7196. msgstr ""
  7197. #. type: table
  7198. #: bashref.texi:4464
  7199. msgid ""
  7200. "Cause @code{read} to time out and return failure if a complete line of input "
  7201. "(or a specified number of characters) is not read within @var{timeout} "
  7202. "seconds. @var{timeout} may be a decimal number with a fractional portion "
  7203. "following the decimal point. This option is only effective if @code{read} "
  7204. "is reading input from a terminal, pipe, or other special file; it has no "
  7205. "effect when reading from regular files. If @code{read} times out, "
  7206. "@code{read} saves any partial input read into the specified variable "
  7207. "@var{name}. If @var{timeout} is 0, @code{read} returns immediately, without "
  7208. "trying to read and data. The exit status is 0 if input is available on the "
  7209. "specified file descriptor, non-zero otherwise. The exit status is greater "
  7210. "than 128 if the timeout is exceeded."
  7211. msgstr ""
  7212. #. type: item
  7213. #: bashref.texi:4465
  7214. #, no-wrap
  7215. msgid "-u @var{fd}"
  7216. msgstr ""
  7217. #. type: table
  7218. #: bashref.texi:4467
  7219. msgid "Read input from file descriptor @var{fd}."
  7220. msgstr ""
  7221. #. type: btindex
  7222. #: bashref.texi:4469 bashref.texi:4470
  7223. #, no-wrap
  7224. msgid "readarray"
  7225. msgstr ""
  7226. #. type: example
  7227. #: bashref.texi:4474
  7228. #, no-wrap
  7229. msgid ""
  7230. "readarray [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}]\n"
  7231. " [-C @var{callback}] [-c @var{quantum}] [@var{array}]\n"
  7232. msgstr ""
  7233. #. type: table
  7234. #: bashref.texi:4479
  7235. msgid ""
  7236. "Read lines from the standard input into the indexed array variable "
  7237. "@var{array}, or from file descriptor @var{fd} if the @option{-u} option is "
  7238. "supplied."
  7239. msgstr ""
  7240. #. type: table
  7241. #: bashref.texi:4481
  7242. msgid "A synonym for @code{mapfile}."
  7243. msgstr ""
  7244. #. type: btindex
  7245. #: bashref.texi:4482 bashref.texi:4483
  7246. #, no-wrap
  7247. msgid "source"
  7248. msgstr ""
  7249. #. type: example
  7250. #: bashref.texi:4486
  7251. #, no-wrap
  7252. msgid "source @var{filename}\n"
  7253. msgstr ""
  7254. #. type: table
  7255. #: bashref.texi:4489
  7256. msgid "A synonym for @code{.} (@pxref{Bourne Shell Builtins})."
  7257. msgstr ""
  7258. #. type: btindex
  7259. #: bashref.texi:4490 bashref.texi:4491
  7260. #, no-wrap
  7261. msgid "type"
  7262. msgstr ""
  7263. #. type: example
  7264. #: bashref.texi:4494
  7265. #, no-wrap
  7266. msgid "type [-afptP] [@var{name} @dots{}]\n"
  7267. msgstr ""
  7268. #. type: table
  7269. #: bashref.texi:4498
  7270. msgid ""
  7271. "For each @var{name}, indicate how it would be interpreted if used as a "
  7272. "command name."
  7273. msgstr ""
  7274. #. type: table
  7275. #: bashref.texi:4506
  7276. msgid ""
  7277. "If the @option{-t} option is used, @code{type} prints a single word which is "
  7278. "one of @samp{alias}, @samp{function}, @samp{builtin}, @samp{file} or "
  7279. "@samp{keyword}, if @var{name} is an alias, shell function, shell builtin, "
  7280. "disk file, or shell reserved word, respectively. If the @var{name} is not "
  7281. "found, then nothing is printed, and @code{type} returns a failure status."
  7282. msgstr ""
  7283. #. type: table
  7284. #: bashref.texi:4510
  7285. msgid ""
  7286. "If the @option{-p} option is used, @code{type} either returns the name of "
  7287. "the disk file that would be executed, or nothing if @option{-t} would not "
  7288. "return @samp{file}."
  7289. msgstr ""
  7290. #. type: table
  7291. #: bashref.texi:4513
  7292. msgid ""
  7293. "The @option{-P} option forces a path search for each @var{name}, even if "
  7294. "@option{-t} would not return @samp{file}."
  7295. msgstr ""
  7296. #. type: table
  7297. #: bashref.texi:4516
  7298. msgid ""
  7299. "If a command is hashed, @option{-p} and @option{-P} print the hashed value, "
  7300. "which is not necessarily the file that appears first in @code{$PATH}."
  7301. msgstr ""
  7302. #. type: table
  7303. #: bashref.texi:4521
  7304. msgid ""
  7305. "If the @option{-a} option is used, @code{type} returns all of the places "
  7306. "that contain an executable named @var{file}. This includes aliases and "
  7307. "functions, if and only if the @option{-p} option is not also used."
  7308. msgstr ""
  7309. #. type: table
  7310. #: bashref.texi:4524
  7311. msgid ""
  7312. "If the @option{-f} option is used, @code{type} does not attempt to find "
  7313. "shell functions, as with the @code{command} builtin."
  7314. msgstr ""
  7315. #. type: table
  7316. #: bashref.texi:4527
  7317. msgid ""
  7318. "The return status is zero if all of the @var{names} are found, non-zero if "
  7319. "any are not found."
  7320. msgstr ""
  7321. #. type: btindex
  7322. #: bashref.texi:4528 bashref.texi:4529
  7323. #, no-wrap
  7324. msgid "typeset"
  7325. msgstr ""
  7326. #. type: example
  7327. #: bashref.texi:4532
  7328. #, no-wrap
  7329. msgid "typeset [-afFgrxilnrtux] [-p] [@var{name}[=@var{value}] @dots{}]\n"
  7330. msgstr ""
  7331. #. type: table
  7332. #: bashref.texi:4537
  7333. msgid ""
  7334. "The @code{typeset} command is supplied for compatibility with the Korn "
  7335. "shell. It is a synonym for the @code{declare} builtin command."
  7336. msgstr ""
  7337. #. type: btindex
  7338. #: bashref.texi:4538 bashref.texi:4539
  7339. #, no-wrap
  7340. msgid "ulimit"
  7341. msgstr ""
  7342. #. type: example
  7343. #: bashref.texi:4542
  7344. #, no-wrap
  7345. msgid "ulimit [-HSabcdefiklmnpqrstuvxPT] [@var{limit}]\n"
  7346. msgstr ""
  7347. #. type: table
  7348. #: bashref.texi:4547
  7349. msgid ""
  7350. "@code{ulimit} provides control over the resources available to processes "
  7351. "started by the shell, on systems that allow such control. If an option is "
  7352. "given, it is interpreted as follows:"
  7353. msgstr ""
  7354. #. type: table
  7355. #: bashref.texi:4551
  7356. msgid "Change and report the soft limit associated with a resource."
  7357. msgstr ""
  7358. #. type: item
  7359. #: bashref.texi:4552 bashref.texi:4898
  7360. #, no-wrap
  7361. msgid "-H"
  7362. msgstr ""
  7363. #. type: table
  7364. #: bashref.texi:4554
  7365. msgid "Change and report the hard limit associated with a resource."
  7366. msgstr ""
  7367. #. type: table
  7368. #: bashref.texi:4557
  7369. msgid "All current limits are reported."
  7370. msgstr ""
  7371. #. type: item
  7372. #: bashref.texi:4558 bashref.texi:4697
  7373. #, no-wrap
  7374. msgid "-b"
  7375. msgstr ""
  7376. #. type: table
  7377. #: bashref.texi:4560
  7378. msgid "The maximum socket buffer size."
  7379. msgstr ""
  7380. #. type: table
  7381. #: bashref.texi:4563
  7382. msgid "The maximum size of core files created."
  7383. msgstr ""
  7384. #. type: table
  7385. #: bashref.texi:4566
  7386. msgid "The maximum size of a process's data segment."
  7387. msgstr ""
  7388. #. type: table
  7389. #: bashref.texi:4569
  7390. msgid "The maximum scheduling priority (\"nice\")."
  7391. msgstr ""
  7392. #. type: table
  7393. #: bashref.texi:4572
  7394. msgid "The maximum size of files written by the shell and its children."
  7395. msgstr ""
  7396. #. type: table
  7397. #: bashref.texi:4575
  7398. msgid "The maximum number of pending signals."
  7399. msgstr ""
  7400. #. type: item
  7401. #: bashref.texi:4576 bashref.texi:4741
  7402. #, no-wrap
  7403. msgid "-k"
  7404. msgstr ""
  7405. #. type: table
  7406. #: bashref.texi:4578
  7407. msgid "The maximum number of kqueues that may be allocated."
  7408. msgstr ""
  7409. #. type: table
  7410. #: bashref.texi:4581
  7411. msgid "The maximum size that may be locked into memory."
  7412. msgstr ""
  7413. #. type: table
  7414. #: bashref.texi:4584
  7415. msgid "The maximum resident set size (many systems do not honor this limit)."
  7416. msgstr ""
  7417. #. type: table
  7418. #: bashref.texi:4588
  7419. msgid ""
  7420. "The maximum number of open file descriptors (most systems do not allow this "
  7421. "value to be set)."
  7422. msgstr ""
  7423. #. type: table
  7424. #: bashref.texi:4591
  7425. msgid "The pipe buffer size."
  7426. msgstr ""
  7427. #. type: itemx
  7428. #: bashref.texi:4592 bashref.texi:4987 bashref.texi:8145
  7429. #, no-wrap
  7430. msgid "-q"
  7431. msgstr ""
  7432. #. type: table
  7433. #: bashref.texi:4594
  7434. msgid "The maximum number of bytes in POSIX message queues."
  7435. msgstr ""
  7436. #. type: table
  7437. #: bashref.texi:4597
  7438. msgid "The maximum real-time scheduling priority."
  7439. msgstr ""
  7440. #. type: table
  7441. #: bashref.texi:4600
  7442. msgid "The maximum stack size."
  7443. msgstr ""
  7444. #. type: table
  7445. #: bashref.texi:4603
  7446. msgid "The maximum amount of cpu time in seconds."
  7447. msgstr ""
  7448. #. type: table
  7449. #: bashref.texi:4606
  7450. msgid "The maximum number of processes available to a single user."
  7451. msgstr ""
  7452. #. type: table
  7453. #: bashref.texi:4610
  7454. msgid ""
  7455. "The maximum amount of virtual memory available to the shell, and, on some "
  7456. "systems, to its children."
  7457. msgstr ""
  7458. #. type: table
  7459. #: bashref.texi:4613
  7460. msgid "The maximum number of file locks."
  7461. msgstr ""
  7462. #. type: table
  7463. #: bashref.texi:4616
  7464. msgid "The maximum number of pseudoterminals."
  7465. msgstr ""
  7466. #. type: item
  7467. #: bashref.texi:4617 bashref.texi:4927
  7468. #, no-wrap
  7469. msgid "-T"
  7470. msgstr ""
  7471. #. type: table
  7472. #: bashref.texi:4619
  7473. msgid "The maximum number of threads."
  7474. msgstr ""
  7475. #. type: table
  7476. #: bashref.texi:4642
  7477. msgid ""
  7478. "If @var{limit} is given, and the @option{-a} option is not used, @var{limit} "
  7479. "is the new value of the specified resource. The special @var{limit} values "
  7480. "@code{hard}, @code{soft}, and @code{unlimited} stand for the current hard "
  7481. "limit, the current soft limit, and no limit, respectively. A hard limit "
  7482. "cannot be increased by a non-root user once it is set; a soft limit may be "
  7483. "increased up to the value of the hard limit. Otherwise, the current value "
  7484. "of the soft limit for the specified resource is printed, unless the @option{-"
  7485. "H} option is supplied. When setting new limits, if neither @option{-H} nor "
  7486. "@option{-S} is supplied, both the hard and soft limits are set. If no "
  7487. "option is given, then @option{-f} is assumed. Values are in 1024-byte "
  7488. "increments, except for @option{-t}, which is in seconds; @option{-p}, which "
  7489. "is in units of 512-byte blocks; @option{-P}, @option{-T}, @option{-b}, "
  7490. "@option{-k}, @option{-n} and @option{-u}, which are unscaled values; and, "
  7491. "when in @sc{posix} Mode (@pxref{Bash POSIX Mode}), @option{-c} and @option{-"
  7492. "f}, which are in 512-byte increments."
  7493. msgstr ""
  7494. #. type: table
  7495. #: bashref.texi:4645
  7496. msgid ""
  7497. "The return status is zero unless an invalid option or argument is supplied, "
  7498. "or an error occurs while setting a new limit."
  7499. msgstr ""
  7500. #. type: btindex
  7501. #: bashref.texi:4646 bashref.texi:4647
  7502. #, no-wrap
  7503. msgid "unalias"
  7504. msgstr ""
  7505. #. type: example
  7506. #: bashref.texi:4650
  7507. #, no-wrap
  7508. msgid "unalias [-a] [@var{name} @dots{} ]\n"
  7509. msgstr ""
  7510. #. type: table
  7511. #: bashref.texi:4655
  7512. msgid ""
  7513. "Remove each @var{name} from the list of aliases. If @option{-a} is "
  7514. "supplied, all aliases are removed. Aliases are described in @ref{Aliases}."
  7515. msgstr ""
  7516. #. type: subsection
  7517. #: bashref.texi:4664 bashref.texi:4666 bashref.texi:4667
  7518. #, no-wrap
  7519. msgid "The Set Builtin"
  7520. msgstr ""
  7521. #. type: menuentry
  7522. #: bashref.texi:4664
  7523. msgid "Change the values of shell attributes and positional parameters."
  7524. msgstr ""
  7525. #. type: subsection
  7526. #: bashref.texi:4664 bashref.texi:4957 bashref.texi:4958
  7527. #, no-wrap
  7528. msgid "The Shopt Builtin"
  7529. msgstr ""
  7530. #. type: menuentry
  7531. #: bashref.texi:4664
  7532. msgid "Modify shell optional behavior."
  7533. msgstr ""
  7534. #. type: Plain text
  7535. #: bashref.texi:4672
  7536. msgid ""
  7537. "This builtin is so complicated that it deserves its own section. @code{set} "
  7538. "allows you to change the values of shell options and set the positional "
  7539. "parameters, or to display the names and values of shell variables."
  7540. msgstr ""
  7541. #. type: btindex
  7542. #: bashref.texi:4674 bashref.texi:4675
  7543. #, no-wrap
  7544. msgid "set"
  7545. msgstr ""
  7546. #. type: example
  7547. #: bashref.texi:4679
  7548. #, no-wrap
  7549. msgid ""
  7550. "set [--abefhkmnptuvxBCEHPT] [-o @var{option-name}] [@var{argument} @dots{}]\n"
  7551. "set [+abefhkmnptuvxBCEHPT] [+o @var{option-name}] [@var{argument} @dots{}]\n"
  7552. msgstr ""
  7553. #. type: table
  7554. #: bashref.texi:4687
  7555. msgid ""
  7556. "If no options or arguments are supplied, @code{set} displays the names and "
  7557. "values of all shell variables and functions, sorted according to the current "
  7558. "locale, in a format that may be reused as input for setting or resetting the "
  7559. "currently-set variables. Read-only variables cannot be reset. In "
  7560. "@sc{posix} mode, only shell variables are listed."
  7561. msgstr ""
  7562. #. type: table
  7563. #: bashref.texi:4690
  7564. msgid ""
  7565. "When options are supplied, they set or unset shell attributes. Options, if "
  7566. "specified, have the following meanings:"
  7567. msgstr ""
  7568. #. type: table
  7569. #: bashref.texi:4696
  7570. msgid ""
  7571. "Each variable or function that is created or modified is given the export "
  7572. "attribute and marked for export to the environment of subsequent commands."
  7573. msgstr ""
  7574. #. type: table
  7575. #: bashref.texi:4700
  7576. msgid ""
  7577. "Cause the status of terminated background jobs to be reported immediately, "
  7578. "rather than before printing the next primary prompt."
  7579. msgstr ""
  7580. #. type: table
  7581. #: bashref.texi:4719
  7582. msgid ""
  7583. "Exit immediately if a pipeline (@pxref{Pipelines}), which may consist of a "
  7584. "single simple command (@pxref{Simple Commands}), a list (@pxref{Lists}), or "
  7585. "a compound command (@pxref{Compound Commands}) returns a non-zero status. "
  7586. "The shell does not exit if the command that fails is part of the command "
  7587. "list immediately following a @code{while} or @code{until} keyword, part of "
  7588. "the test in an @code{if} statement, part of any command executed in a "
  7589. "@code{&&} or @code{||} list except the command following the final @code{&&} "
  7590. "or @code{||}, any command in a pipeline but the last, or if the command's "
  7591. "return status is being inverted with @code{!}. If a compound command other "
  7592. "than a subshell returns a non-zero status because a command failed while "
  7593. "@option{-e} was being ignored, the shell does not exit. A trap on "
  7594. "@code{ERR}, if set, is executed before the shell exits."
  7595. msgstr ""
  7596. #. type: table
  7597. #: bashref.texi:4723
  7598. msgid ""
  7599. "This option applies to the shell environment and each subshell environment "
  7600. "separately (@pxref{Command Execution Environment}), and may cause subshells "
  7601. "to exit before executing all the commands in the subshell."
  7602. msgstr ""
  7603. #. type: table
  7604. #: bashref.texi:4733
  7605. msgid ""
  7606. "If a compound command or shell function executes in a context where @option{-"
  7607. "e} is being ignored, none of the commands executed within the compound "
  7608. "command or function body will be affected by the @option{-e} setting, even "
  7609. "if @option{-e} is set and a command returns a failure status. If a compound "
  7610. "command or shell function sets @option{-e} while executing in a context "
  7611. "where @option{-e} is ignored, that setting will not have any effect until "
  7612. "the compound command or the command containing the function call completes."
  7613. msgstr ""
  7614. #. type: table
  7615. #: bashref.texi:4736
  7616. msgid "Disable filename expansion (globbing)."
  7617. msgstr ""
  7618. #. type: item
  7619. #: bashref.texi:4737
  7620. #, no-wrap
  7621. msgid "-h"
  7622. msgstr ""
  7623. #. type: table
  7624. #: bashref.texi:4740
  7625. msgid ""
  7626. "Locate and remember (hash) commands as they are looked up for execution. "
  7627. "This option is enabled by default."
  7628. msgstr ""
  7629. #. type: table
  7630. #: bashref.texi:4745
  7631. msgid ""
  7632. "All arguments in the form of assignment statements are placed in the "
  7633. "environment for a command, not just those that precede the command name."
  7634. msgstr ""
  7635. #. type: table
  7636. #: bashref.texi:4751
  7637. msgid ""
  7638. "Job control is enabled (@pxref{Job Control}). All processes run in a "
  7639. "separate process group. When a background job completes, the shell prints a "
  7640. "line containing its exit status."
  7641. msgstr ""
  7642. #. type: table
  7643. #: bashref.texi:4756
  7644. msgid ""
  7645. "Read commands but do not execute them. This may be used to check a script "
  7646. "for syntax errors. This option is ignored by interactive shells."
  7647. msgstr ""
  7648. #. type: item
  7649. #: bashref.texi:4757
  7650. #, no-wrap
  7651. msgid "-o @var{option-name}"
  7652. msgstr ""
  7653. #. type: table
  7654. #: bashref.texi:4760
  7655. msgid "Set the option corresponding to @var{option-name}:"
  7656. msgstr ""
  7657. #. type: item
  7658. #: bashref.texi:4762
  7659. #, no-wrap
  7660. msgid "allexport"
  7661. msgstr ""
  7662. #. type: table
  7663. #: bashref.texi:4764
  7664. msgid "Same as @code{-a}."
  7665. msgstr ""
  7666. #. type: item
  7667. #: bashref.texi:4765
  7668. #, no-wrap
  7669. msgid "braceexpand"
  7670. msgstr ""
  7671. #. type: table
  7672. #: bashref.texi:4767
  7673. msgid "Same as @code{-B}."
  7674. msgstr ""
  7675. #. type: item
  7676. #: bashref.texi:4768
  7677. #, no-wrap
  7678. msgid "emacs"
  7679. msgstr ""
  7680. #. type: table
  7681. #: bashref.texi:4771
  7682. msgid ""
  7683. "Use an @code{emacs}-style line editing interface (@pxref{Command Line "
  7684. "Editing}). This also affects the editing interface used for @code{read -e}."
  7685. msgstr ""
  7686. #. type: item
  7687. #: bashref.texi:4772
  7688. #, no-wrap
  7689. msgid "errexit"
  7690. msgstr ""
  7691. #. type: table
  7692. #: bashref.texi:4774
  7693. msgid "Same as @code{-e}."
  7694. msgstr ""
  7695. #. type: item
  7696. #: bashref.texi:4775
  7697. #, no-wrap
  7698. msgid "errtrace"
  7699. msgstr ""
  7700. #. type: table
  7701. #: bashref.texi:4777
  7702. msgid "Same as @code{-E}."
  7703. msgstr ""
  7704. #. type: item
  7705. #: bashref.texi:4778
  7706. #, no-wrap
  7707. msgid "functrace"
  7708. msgstr ""
  7709. #. type: table
  7710. #: bashref.texi:4780
  7711. msgid "Same as @code{-T}."
  7712. msgstr ""
  7713. #. type: item
  7714. #: bashref.texi:4781
  7715. #, no-wrap
  7716. msgid "hashall"
  7717. msgstr ""
  7718. #. type: table
  7719. #: bashref.texi:4783
  7720. msgid "Same as @code{-h}."
  7721. msgstr ""
  7722. #. type: item
  7723. #: bashref.texi:4784
  7724. #, no-wrap
  7725. msgid "histexpand"
  7726. msgstr ""
  7727. #. type: table
  7728. #: bashref.texi:4786
  7729. msgid "Same as @code{-H}."
  7730. msgstr ""
  7731. #. type: item
  7732. #: bashref.texi:4787
  7733. #, no-wrap
  7734. msgid "history"
  7735. msgstr ""
  7736. #. type: table
  7737. #: bashref.texi:4790
  7738. msgid ""
  7739. "Enable command history, as described in @ref{Bash History Facilities}. This "
  7740. "option is on by default in interactive shells."
  7741. msgstr ""
  7742. #. type: item
  7743. #: bashref.texi:4791
  7744. #, no-wrap
  7745. msgid "ignoreeof"
  7746. msgstr ""
  7747. #. type: table
  7748. #: bashref.texi:4793
  7749. msgid "An interactive shell will not exit upon reading EOF."
  7750. msgstr ""
  7751. #. type: item
  7752. #: bashref.texi:4794
  7753. #, no-wrap
  7754. msgid "keyword"
  7755. msgstr ""
  7756. #. type: table
  7757. #: bashref.texi:4796
  7758. msgid "Same as @code{-k}."
  7759. msgstr ""
  7760. #. type: item
  7761. #: bashref.texi:4797
  7762. #, no-wrap
  7763. msgid "monitor"
  7764. msgstr ""
  7765. #. type: table
  7766. #: bashref.texi:4799
  7767. msgid "Same as @code{-m}."
  7768. msgstr ""
  7769. #. type: item
  7770. #: bashref.texi:4800
  7771. #, no-wrap
  7772. msgid "noclobber"
  7773. msgstr ""
  7774. #. type: table
  7775. #: bashref.texi:4802
  7776. msgid "Same as @code{-C}."
  7777. msgstr ""
  7778. #. type: item
  7779. #: bashref.texi:4803
  7780. #, no-wrap
  7781. msgid "noexec"
  7782. msgstr ""
  7783. #. type: table
  7784. #: bashref.texi:4805
  7785. msgid "Same as @code{-n}."
  7786. msgstr ""
  7787. #. type: item
  7788. #: bashref.texi:4806
  7789. #, no-wrap
  7790. msgid "noglob"
  7791. msgstr ""
  7792. #. type: table
  7793. #: bashref.texi:4808
  7794. msgid "Same as @code{-f}."
  7795. msgstr ""
  7796. #. type: item
  7797. #: bashref.texi:4809
  7798. #, no-wrap
  7799. msgid "nolog"
  7800. msgstr ""
  7801. #. type: table
  7802. #: bashref.texi:4811
  7803. msgid "Currently ignored."
  7804. msgstr ""
  7805. #. type: item
  7806. #: bashref.texi:4812
  7807. #, no-wrap
  7808. msgid "notify"
  7809. msgstr ""
  7810. #. type: table
  7811. #: bashref.texi:4814
  7812. msgid "Same as @code{-b}."
  7813. msgstr ""
  7814. #. type: item
  7815. #: bashref.texi:4815
  7816. #, no-wrap
  7817. msgid "nounset"
  7818. msgstr ""
  7819. #. type: table
  7820. #: bashref.texi:4817
  7821. msgid "Same as @code{-u}."
  7822. msgstr ""
  7823. #. type: item
  7824. #: bashref.texi:4818
  7825. #, no-wrap
  7826. msgid "onecmd"
  7827. msgstr ""
  7828. #. type: table
  7829. #: bashref.texi:4820
  7830. msgid "Same as @code{-t}."
  7831. msgstr ""
  7832. #. type: item
  7833. #: bashref.texi:4821
  7834. #, no-wrap
  7835. msgid "physical"
  7836. msgstr ""
  7837. #. type: table
  7838. #: bashref.texi:4823
  7839. msgid "Same as @code{-P}."
  7840. msgstr ""
  7841. #. type: item
  7842. #: bashref.texi:4824
  7843. #, no-wrap
  7844. msgid "pipefail"
  7845. msgstr ""
  7846. #. type: table
  7847. #: bashref.texi:4829
  7848. msgid ""
  7849. "If set, the return value of a pipeline is the value of the last (rightmost) "
  7850. "command to exit with a non-zero status, or zero if all commands in the "
  7851. "pipeline exit successfully. This option is disabled by default."
  7852. msgstr ""
  7853. #. type: item
  7854. #: bashref.texi:4830
  7855. #, no-wrap
  7856. msgid "posix"
  7857. msgstr ""
  7858. #. type: table
  7859. #: bashref.texi:4836
  7860. msgid ""
  7861. "Change the behavior of Bash where the default operation differs from the "
  7862. "@sc{posix} standard to match the standard (@pxref{Bash POSIX Mode}). This "
  7863. "is intended to make Bash behave as a strict superset of that standard."
  7864. msgstr ""
  7865. #. type: item
  7866. #: bashref.texi:4837
  7867. #, no-wrap
  7868. msgid "privileged"
  7869. msgstr ""
  7870. #. type: table
  7871. #: bashref.texi:4839
  7872. msgid "Same as @code{-p}."
  7873. msgstr ""
  7874. #. type: item
  7875. #: bashref.texi:4840
  7876. #, no-wrap
  7877. msgid "verbose"
  7878. msgstr ""
  7879. #. type: table
  7880. #: bashref.texi:4842
  7881. msgid "Same as @code{-v}."
  7882. msgstr ""
  7883. #. type: item
  7884. #: bashref.texi:4843
  7885. #, no-wrap
  7886. msgid "vi"
  7887. msgstr ""
  7888. #. type: table
  7889. #: bashref.texi:4846
  7890. msgid ""
  7891. "Use a @code{vi}-style line editing interface. This also affects the editing "
  7892. "interface used for @code{read -e}."
  7893. msgstr ""
  7894. #. type: item
  7895. #: bashref.texi:4847
  7896. #, no-wrap
  7897. msgid "xtrace"
  7898. msgstr ""
  7899. #. type: table
  7900. #: bashref.texi:4849
  7901. msgid "Same as @code{-x}."
  7902. msgstr ""
  7903. #. type: table
  7904. #: bashref.texi:4864
  7905. msgid ""
  7906. "Turn on privileged mode. In this mode, the @env{$BASH_ENV} and @env{$ENV} "
  7907. "files are not processed, shell functions are not inherited from the "
  7908. "environment, and the @env{SHELLOPTS}, @env{BASHOPTS}, @env{CDPATH} and "
  7909. "@env{GLOBIGNORE} variables, if they appear in the environment, are ignored. "
  7910. "If the shell is started with the effective user (group) id not equal to the "
  7911. "real user (group) id, and the @option{-p} option is not supplied, these "
  7912. "actions are taken and the effective user id is set to the real user id. If "
  7913. "the @option{-p} option is supplied at startup, the effective user id is not "
  7914. "reset. Turning this option off causes the effective user and group ids to "
  7915. "be set to the real user and group ids."
  7916. msgstr ""
  7917. #. type: table
  7918. #: bashref.texi:4867
  7919. msgid "Exit after reading and executing one command."
  7920. msgstr ""
  7921. #. type: table
  7922. #: bashref.texi:4873
  7923. msgid ""
  7924. "Treat unset variables and parameters other than the special parameters "
  7925. "@samp{@@} or @samp{*} as an error when performing parameter expansion. An "
  7926. "error message will be written to the standard error, and a non-interactive "
  7927. "shell will exit."
  7928. msgstr ""
  7929. #. type: table
  7930. #: bashref.texi:4876
  7931. msgid "Print shell input lines as they are read."
  7932. msgstr ""
  7933. #. type: table
  7934. #: bashref.texi:4884
  7935. msgid ""
  7936. "Print a trace of simple commands, @code{for} commands, @code{case} commands, "
  7937. "@code{select} commands, and arithmetic @code{for} commands and their "
  7938. "arguments or associated word lists after they are expanded and before they "
  7939. "are executed. The value of the @env{PS4} variable is expanded and the "
  7940. "resultant value is printed before the command and its expanded arguments."
  7941. msgstr ""
  7942. #. type: item
  7943. #: bashref.texi:4885
  7944. #, no-wrap
  7945. msgid "-B"
  7946. msgstr ""
  7947. #. type: table
  7948. #: bashref.texi:4888
  7949. msgid ""
  7950. "The shell will perform brace expansion (@pxref{Brace Expansion}). This "
  7951. "option is on by default."
  7952. msgstr ""
  7953. #. type: table
  7954. #: bashref.texi:4892
  7955. msgid ""
  7956. "Prevent output redirection using @samp{>}, @samp{>&}, and @samp{<>} from "
  7957. "overwriting existing files."
  7958. msgstr ""
  7959. #. type: item
  7960. #: bashref.texi:4893
  7961. #, no-wrap
  7962. msgid "-E"
  7963. msgstr ""
  7964. #. type: table
  7965. #: bashref.texi:4897
  7966. msgid ""
  7967. "If set, any trap on @code{ERR} is inherited by shell functions, command "
  7968. "substitutions, and commands executed in a subshell environment. The "
  7969. "@code{ERR} trap is normally not inherited in such cases."
  7970. msgstr ""
  7971. #. type: table
  7972. #: bashref.texi:4901
  7973. msgid ""
  7974. "Enable @samp{!} style history substitution (@pxref{History Interaction}). "
  7975. "This option is on by default for interactive shells."
  7976. msgstr ""
  7977. #. type: table
  7978. #: bashref.texi:4908
  7979. msgid ""
  7980. "If set, do not resolve symbolic links when performing commands such as "
  7981. "@code{cd} which change the current directory. The physical directory is "
  7982. "used instead. By default, Bash follows the logical chain of directories "
  7983. "when performing commands which change the current directory."
  7984. msgstr ""
  7985. #. type: table
  7986. #: bashref.texi:4911
  7987. msgid ""
  7988. "For example, if @file{/usr/sys} is a symbolic link to @file{/usr/local/sys} "
  7989. "then:"
  7990. msgstr ""
  7991. #. type: example
  7992. #: bashref.texi:4916
  7993. #, no-wrap
  7994. msgid ""
  7995. "$ cd /usr/sys; echo $PWD\n"
  7996. "/usr/sys\n"
  7997. "$ cd ..; pwd\n"
  7998. "/usr\n"
  7999. msgstr ""
  8000. #. type: table
  8001. #: bashref.texi:4920
  8002. msgid "If @code{set -P} is on, then:"
  8003. msgstr ""
  8004. #. type: example
  8005. #: bashref.texi:4925
  8006. #, no-wrap
  8007. msgid ""
  8008. "$ cd /usr/sys; echo $PWD\n"
  8009. "/usr/local/sys\n"
  8010. "$ cd ..; pwd\n"
  8011. "/usr/local\n"
  8012. msgstr ""
  8013. #. type: table
  8014. #: bashref.texi:4933
  8015. msgid ""
  8016. "If set, any trap on @code{DEBUG} and @code{RETURN} are inherited by shell "
  8017. "functions, command substitutions, and commands executed in a subshell "
  8018. "environment. The @code{DEBUG} and @code{RETURN} traps are normally not "
  8019. "inherited in such cases."
  8020. msgstr ""
  8021. #. type: item
  8022. #: bashref.texi:4934 bashref.texi:6309
  8023. #, no-wrap
  8024. msgid "--"
  8025. msgstr ""
  8026. #. type: table
  8027. #: bashref.texi:4938
  8028. msgid ""
  8029. "If no arguments follow this option, then the positional parameters are "
  8030. "unset. Otherwise, the positional parameters are set to the @var{arguments}, "
  8031. "even if some of them begin with a @samp{-}."
  8032. msgstr ""
  8033. #. type: table
  8034. #: bashref.texi:4944
  8035. msgid ""
  8036. "Signal the end of options, cause all remaining @var{arguments} to be "
  8037. "assigned to the positional parameters. The @option{-x} and @option{-v} "
  8038. "options are turned off. If there are no arguments, the positional "
  8039. "parameters remain unchanged."
  8040. msgstr ""
  8041. #. type: table
  8042. #: bashref.texi:4949
  8043. msgid ""
  8044. "Using @samp{+} rather than @samp{-} causes these options to be turned off. "
  8045. "The options can also be used upon invocation of the shell. The current set "
  8046. "of options may be found in @code{$-}."
  8047. msgstr ""
  8048. #. type: table
  8049. #: bashref.texi:4953
  8050. msgid ""
  8051. "The remaining N @var{arguments} are positional parameters and are assigned, "
  8052. "in order, to @code{$1}, @code{$2}, @dots{} @code{$N}. The special parameter "
  8053. "@code{#} is set to N."
  8054. msgstr ""
  8055. #. type: table
  8056. #: bashref.texi:4955
  8057. msgid "The return status is always zero unless an invalid option is supplied."
  8058. msgstr ""
  8059. #. type: Plain text
  8060. #: bashref.texi:4961
  8061. msgid "This builtin allows you to change additional shell optional behavior."
  8062. msgstr ""
  8063. #. type: btindex
  8064. #: bashref.texi:4964 bashref.texi:4965
  8065. #, no-wrap
  8066. msgid "shopt"
  8067. msgstr ""
  8068. #. type: example
  8069. #: bashref.texi:4968
  8070. #, no-wrap
  8071. msgid "shopt [-pqsu] [-o] [@var{optname} @dots{}]\n"
  8072. msgstr ""
  8073. #. type: table
  8074. #: bashref.texi:4979
  8075. msgid ""
  8076. "Toggle the values of settings controlling optional shell behavior. The "
  8077. "settings can be either those listed below, or, if the @option{-o} option is "
  8078. "used, those available with the @option{-o} option to the @code{set} builtin "
  8079. "command (@pxref{The Set Builtin}). With no options, or with the @option{-p} "
  8080. "option, a list of all settable options is displayed, with an indication of "
  8081. "whether or not each is set. The @option{-p} option causes output to be "
  8082. "displayed in a form that may be reused as input. Other options have the "
  8083. "following meanings:"
  8084. msgstr ""
  8085. #. type: table
  8086. #: bashref.texi:4983
  8087. msgid "Enable (set) each @var{optname}."
  8088. msgstr ""
  8089. #. type: table
  8090. #: bashref.texi:4986
  8091. msgid "Disable (unset) each @var{optname}."
  8092. msgstr ""
  8093. #. type: table
  8094. #: bashref.texi:4993
  8095. msgid ""
  8096. "Suppresses normal output; the return status indicates whether the "
  8097. "@var{optname} is set or unset. If multiple @var{optname} arguments are "
  8098. "given with @option{-q}, the return status is zero if all @var{optnames} are "
  8099. "enabled; non-zero otherwise."
  8100. msgstr ""
  8101. #. type: item
  8102. #: bashref.texi:4994
  8103. #, no-wrap
  8104. msgid "-o"
  8105. msgstr ""
  8106. #. type: table
  8107. #: bashref.texi:4998
  8108. msgid ""
  8109. "Restricts the values of @var{optname} to be those defined for the @option{-"
  8110. "o} option to the @code{set} builtin (@pxref{The Set Builtin})."
  8111. msgstr ""
  8112. #. type: table
  8113. #: bashref.texi:5003
  8114. msgid ""
  8115. "If either @option{-s} or @option{-u} is used with no @var{optname} "
  8116. "arguments, @code{shopt} shows only those options which are set or unset, "
  8117. "respectively."
  8118. msgstr ""
  8119. #. type: table
  8120. #: bashref.texi:5006
  8121. msgid ""
  8122. "Unless otherwise noted, the @code{shopt} options are disabled (off) by "
  8123. "default."
  8124. msgstr ""
  8125. #. type: table
  8126. #: bashref.texi:5011 bashref.texi:5344
  8127. msgid ""
  8128. "The return status when listing options is zero if all @var{optnames} are "
  8129. "enabled, non-zero otherwise. When setting or unsetting options, the return "
  8130. "status is zero unless an @var{optname} is not a valid shell option."
  8131. msgstr ""
  8132. #. type: table
  8133. #: bashref.texi:5013
  8134. msgid "The list of @code{shopt} options is:"
  8135. msgstr ""
  8136. #. type: item
  8137. #: bashref.texi:5015
  8138. #, no-wrap
  8139. msgid "autocd"
  8140. msgstr ""
  8141. #. type: table
  8142. #: bashref.texi:5019
  8143. msgid ""
  8144. "If set, a command name that is the name of a directory is executed as if it "
  8145. "were the argument to the @code{cd} command. This option is only used by "
  8146. "interactive shells."
  8147. msgstr ""
  8148. #. type: item
  8149. #: bashref.texi:5020
  8150. #, no-wrap
  8151. msgid "cdable_vars"
  8152. msgstr ""
  8153. #. type: table
  8154. #: bashref.texi:5024
  8155. msgid ""
  8156. "If this is set, an argument to the @code{cd} builtin command that is not a "
  8157. "directory is assumed to be the name of a variable whose value is the "
  8158. "directory to change to."
  8159. msgstr ""
  8160. #. type: item
  8161. #: bashref.texi:5025
  8162. #, no-wrap
  8163. msgid "cdspell"
  8164. msgstr ""
  8165. #. type: table
  8166. #: bashref.texi:5033
  8167. msgid ""
  8168. "If set, minor errors in the spelling of a directory component in a @code{cd} "
  8169. "command will be corrected. The errors checked for are transposed "
  8170. "characters, a missing character, and a character too many. If a correction "
  8171. "is found, the corrected path is printed, and the command proceeds. This "
  8172. "option is only used by interactive shells."
  8173. msgstr ""
  8174. #. type: item
  8175. #: bashref.texi:5034
  8176. #, no-wrap
  8177. msgid "checkhash"
  8178. msgstr ""
  8179. #. type: table
  8180. #: bashref.texi:5038
  8181. msgid ""
  8182. "If this is set, Bash checks that a command found in the hash table exists "
  8183. "before trying to execute it. If a hashed command no longer exists, a normal "
  8184. "path search is performed."
  8185. msgstr ""
  8186. #. type: item
  8187. #: bashref.texi:5039
  8188. #, no-wrap
  8189. msgid "checkjobs"
  8190. msgstr ""
  8191. #. type: table
  8192. #: bashref.texi:5045
  8193. msgid ""
  8194. "If set, Bash lists the status of any stopped and running jobs before exiting "
  8195. "an interactive shell. If any jobs are running, this causes the exit to be "
  8196. "deferred until a second exit is attempted without an intervening command "
  8197. "(@pxref{Job Control}). The shell always postpones exiting if any jobs are "
  8198. "stopped."
  8199. msgstr ""
  8200. #. type: item
  8201. #: bashref.texi:5046
  8202. #, no-wrap
  8203. msgid "checkwinsize"
  8204. msgstr ""
  8205. #. type: table
  8206. #: bashref.texi:5050
  8207. msgid ""
  8208. "If set, Bash checks the window size after each command and, if necessary, "
  8209. "updates the values of @env{LINES} and @env{COLUMNS}."
  8210. msgstr ""
  8211. #. type: item
  8212. #: bashref.texi:5051
  8213. #, no-wrap
  8214. msgid "cmdhist"
  8215. msgstr ""
  8216. #. type: table
  8217. #: bashref.texi:5056
  8218. msgid ""
  8219. "If set, Bash attempts to save all lines of a multiple-line command in the "
  8220. "same history entry. This allows easy re-editing of multi-line commands."
  8221. msgstr ""
  8222. #. type: item
  8223. #: bashref.texi:5057
  8224. #, no-wrap
  8225. msgid "compat31"
  8226. msgstr ""
  8227. #. type: table
  8228. #: bashref.texi:5066
  8229. msgid ""
  8230. "If set, Bash changes its behavior to that of version 3.1 with respect to "
  8231. "quoted arguments to the conditional command's @samp{=~} operator and with "
  8232. "respect to locale-specific string comparison when using the @code{[[} "
  8233. "conditional command's @samp{<} and @samp{>} operators. Bash versions prior "
  8234. "to bash-4.1 use ASCII collation and strcmp(3); bash-4.1 and later use the "
  8235. "current locale's collation sequence and strcoll(3)."
  8236. msgstr ""
  8237. #. type: item
  8238. #: bashref.texi:5067
  8239. #, no-wrap
  8240. msgid "compat32"
  8241. msgstr ""
  8242. #. type: table
  8243. #: bashref.texi:5075
  8244. msgid ""
  8245. "If set, Bash changes its behavior to that of version 3.2 with respect to "
  8246. "locale-specific string comparison when using the @code{[[} conditional "
  8247. "command's @samp{<} and @samp{>} operators (see previous item) and the "
  8248. "effect of interrupting a command list. Bash versions 3.2 and earlier "
  8249. "continue with the next command in the list after one terminates due to an "
  8250. "interrupt."
  8251. msgstr ""
  8252. #. type: item
  8253. #: bashref.texi:5076
  8254. #, no-wrap
  8255. msgid "compat40"
  8256. msgstr ""
  8257. #. type: table
  8258. #: bashref.texi:5085
  8259. msgid ""
  8260. "If set, Bash changes its behavior to that of version 4.0 with respect to "
  8261. "locale-specific string comparison when using the @code{[[} conditional "
  8262. "command's @samp{<} and @samp{>} operators (see description of "
  8263. "@code{compat31}) and the effect of interrupting a command list. Bash "
  8264. "versions 4.0 and later interrupt the list as if the shell received the "
  8265. "interrupt; previous versions continue with the next command in the list."
  8266. msgstr ""
  8267. #. type: item
  8268. #: bashref.texi:5086
  8269. #, no-wrap
  8270. msgid "compat41"
  8271. msgstr ""
  8272. #. type: table
  8273. #: bashref.texi:5092
  8274. msgid ""
  8275. "If set, Bash, when in @sc{posix} mode, treats a single quote in a double-"
  8276. "quoted parameter expansion as a special character. The single quotes must "
  8277. "match (an even number) and the characters between the single quotes are "
  8278. "considered quoted. This is the behavior of @sc{posix} mode through version "
  8279. "4.1. The default Bash behavior remains as in previous versions."
  8280. msgstr ""
  8281. #. type: item
  8282. #: bashref.texi:5093
  8283. #, no-wrap
  8284. msgid "compat42"
  8285. msgstr ""
  8286. #. type: table
  8287. #: bashref.texi:5097
  8288. msgid ""
  8289. "If set, Bash does not process the replacement string in the pattern "
  8290. "substitution word expansion using quote removal."
  8291. msgstr ""
  8292. #. type: item
  8293. #: bashref.texi:5098
  8294. #, no-wrap
  8295. msgid "compat43"
  8296. msgstr ""
  8297. #. type: table
  8298. #: bashref.texi:5108
  8299. msgid ""
  8300. "If set, Bash does not print a warning message if an attempt is made to use a "
  8301. "quoted compound array assignment as an argument to @code{declare}, makes "
  8302. "word expansion errors non-fatal errors that cause the current command to "
  8303. "fail (the default behavior is to make them fatal errors that cause the shell "
  8304. "to exit), and does not reset the loop state when a shell function is "
  8305. "executed (this allows @code{break} or @code{continue} in a shell function to "
  8306. "affect loops in the caller's context)."
  8307. msgstr ""
  8308. #. type: item
  8309. #: bashref.texi:5109
  8310. #, no-wrap
  8311. msgid "complete_fullquote"
  8312. msgstr ""
  8313. #. type: table
  8314. #: bashref.texi:5125
  8315. msgid ""
  8316. "If set, Bash quotes all shell metacharacters in filenames and directory "
  8317. "names when performing completion. If not set, Bash removes metacharacters "
  8318. "such as the dollar sign from the set of characters that will be quoted in "
  8319. "completed filenames when these metacharacters appear in shell variable "
  8320. "references in words to be completed. This means that dollar signs in "
  8321. "variable names that expand to directories will not be quoted; however, any "
  8322. "dollar signs appearing in filenames will not be quoted, either. This is "
  8323. "active only when bash is using backslashes to quote completed filenames. "
  8324. "This variable is set by default, which is the default Bash behavior in "
  8325. "versions through 4.2."
  8326. msgstr ""
  8327. #. type: item
  8328. #: bashref.texi:5126
  8329. #, no-wrap
  8330. msgid "direxpand"
  8331. msgstr ""
  8332. #. type: table
  8333. #: bashref.texi:5132
  8334. msgid ""
  8335. "If set, Bash replaces directory names with the results of word expansion "
  8336. "when performing filename completion. This changes the contents of the "
  8337. "readline editing buffer. If not set, Bash attempts to preserve what the "
  8338. "user typed."
  8339. msgstr ""
  8340. #. type: item
  8341. #: bashref.texi:5133
  8342. #, no-wrap
  8343. msgid "dirspell"
  8344. msgstr ""
  8345. #. type: table
  8346. #: bashref.texi:5137
  8347. msgid ""
  8348. "If set, Bash attempts spelling correction on directory names during word "
  8349. "completion if the directory name initially supplied does not exist."
  8350. msgstr ""
  8351. #. type: item
  8352. #: bashref.texi:5138
  8353. #, no-wrap
  8354. msgid "dotglob"
  8355. msgstr ""
  8356. #. type: table
  8357. #: bashref.texi:5141
  8358. msgid ""
  8359. "If set, Bash includes filenames beginning with a `.' in the results of "
  8360. "filename expansion."
  8361. msgstr ""
  8362. #. type: item
  8363. #: bashref.texi:5142
  8364. #, no-wrap
  8365. msgid "execfail"
  8366. msgstr ""
  8367. #. type: table
  8368. #: bashref.texi:5147
  8369. msgid ""
  8370. "If this is set, a non-interactive shell will not exit if it cannot execute "
  8371. "the file specified as an argument to the @code{exec} builtin command. An "
  8372. "interactive shell does not exit if @code{exec} fails."
  8373. msgstr ""
  8374. #. type: item
  8375. #: bashref.texi:5148
  8376. #, no-wrap
  8377. msgid "expand_aliases"
  8378. msgstr ""
  8379. #. type: table
  8380. #: bashref.texi:5152
  8381. msgid ""
  8382. "If set, aliases are expanded as described below under Aliases, "
  8383. "@ref{Aliases}. This option is enabled by default for interactive shells."
  8384. msgstr ""
  8385. #. type: item
  8386. #: bashref.texi:5153
  8387. #, no-wrap
  8388. msgid "extdebug"
  8389. msgstr ""
  8390. #. type: table
  8391. #: bashref.texi:5157
  8392. msgid ""
  8393. "If set at shell invocation, arrange to execute the debugger profile before "
  8394. "the shell starts, identical to the @option{--debugger} option. If set after "
  8395. "invocation, behavior intended for use by debuggers is enabled:"
  8396. msgstr ""
  8397. #. type: enumerate
  8398. #: bashref.texi:5163
  8399. msgid ""
  8400. "The @option{-F} option to the @code{declare} builtin (@pxref{Bash "
  8401. "Builtins}) displays the source file name and line number corresponding to "
  8402. "each function name supplied as an argument."
  8403. msgstr ""
  8404. #. type: enumerate
  8405. #: bashref.texi:5167
  8406. msgid ""
  8407. "If the command run by the @code{DEBUG} trap returns a non-zero value, the "
  8408. "next command is skipped and not executed."
  8409. msgstr ""
  8410. #. type: enumerate
  8411. #: bashref.texi:5173
  8412. msgid ""
  8413. "If the command run by the @code{DEBUG} trap returns a value of 2, and the "
  8414. "shell is executing in a subroutine (a shell function or a shell script "
  8415. "executed by the @code{.} or @code{source} builtins), the shell simulates a "
  8416. "call to @code{return}."
  8417. msgstr ""
  8418. #. type: enumerate
  8419. #: bashref.texi:5177
  8420. msgid ""
  8421. "@code{BASH_ARGC} and @code{BASH_ARGV} are updated as described in their "
  8422. "descriptions (@pxref{Bash Variables})."
  8423. msgstr ""
  8424. #. type: enumerate
  8425. #: bashref.texi:5182
  8426. msgid ""
  8427. "Function tracing is enabled: command substitution, shell functions, and "
  8428. "subshells invoked with @code{( @var{command} )} inherit the @code{DEBUG} and "
  8429. "@code{RETURN} traps."
  8430. msgstr ""
  8431. #. type: enumerate
  8432. #: bashref.texi:5187
  8433. msgid ""
  8434. "Error tracing is enabled: command substitution, shell functions, and "
  8435. "subshells invoked with @code{( @var{command} )} inherit the @code{ERR} trap."
  8436. msgstr ""
  8437. #. type: item
  8438. #: bashref.texi:5189
  8439. #, no-wrap
  8440. msgid "extglob"
  8441. msgstr ""
  8442. #. type: table
  8443. #: bashref.texi:5192
  8444. msgid ""
  8445. "If set, the extended pattern matching features described above "
  8446. "(@pxref{Pattern Matching}) are enabled."
  8447. msgstr ""
  8448. #. type: item
  8449. #: bashref.texi:5193
  8450. #, no-wrap
  8451. msgid "extquote"
  8452. msgstr ""
  8453. #. type: table
  8454. #: bashref.texi:5197
  8455. msgid ""
  8456. "If set, @code{$'@var{string}'} and @code{$\"@var{string}\"} quoting is "
  8457. "performed within @code{$@{@var{parameter}@}} expansions enclosed in double "
  8458. "quotes. This option is enabled by default."
  8459. msgstr ""
  8460. #. type: item
  8461. #: bashref.texi:5198
  8462. #, no-wrap
  8463. msgid "failglob"
  8464. msgstr ""
  8465. #. type: table
  8466. #: bashref.texi:5201
  8467. msgid ""
  8468. "If set, patterns which fail to match filenames during filename expansion "
  8469. "result in an expansion error."
  8470. msgstr ""
  8471. #. type: item
  8472. #: bashref.texi:5202
  8473. #, no-wrap
  8474. msgid "force_fignore"
  8475. msgstr ""
  8476. #. type: table
  8477. #: bashref.texi:5208
  8478. msgid ""
  8479. "If set, the suffixes specified by the @env{FIGNORE} shell variable cause "
  8480. "words to be ignored when performing word completion even if the ignored "
  8481. "words are the only possible completions. @xref{Bash Variables}, for a "
  8482. "description of @env{FIGNORE}. This option is enabled by default."
  8483. msgstr ""
  8484. #. type: item
  8485. #: bashref.texi:5209
  8486. #, no-wrap
  8487. msgid "globasciiranges"
  8488. msgstr ""
  8489. #. type: table
  8490. #: bashref.texi:5217
  8491. msgid ""
  8492. "If set, range expressions used in pattern matching bracket expressions "
  8493. "(@pxref{Pattern Matching}) behave as if in the traditional C locale when "
  8494. "performing comparisons. That is, the current locale's collating sequence is "
  8495. "not taken into account, so @samp{b} will not collate between @samp{A} and "
  8496. "@samp{B}, and upper-case and lower-case ASCII characters will collate "
  8497. "together."
  8498. msgstr ""
  8499. #. type: item
  8500. #: bashref.texi:5218
  8501. #, no-wrap
  8502. msgid "globstar"
  8503. msgstr ""
  8504. #. type: table
  8505. #: bashref.texi:5223
  8506. msgid ""
  8507. "If set, the pattern @samp{**} used in a filename expansion context will "
  8508. "match all files and zero or more directories and subdirectories. If the "
  8509. "pattern is followed by a @samp{/}, only directories and subdirectories match."
  8510. msgstr ""
  8511. #. type: item
  8512. #: bashref.texi:5224
  8513. #, no-wrap
  8514. msgid "gnu_errfmt"
  8515. msgstr ""
  8516. #. type: table
  8517. #: bashref.texi:5227
  8518. msgid ""
  8519. "If set, shell error messages are written in the standard @sc{gnu} error "
  8520. "message format."
  8521. msgstr ""
  8522. #. type: item
  8523. #: bashref.texi:5228
  8524. #, no-wrap
  8525. msgid "histappend"
  8526. msgstr ""
  8527. #. type: table
  8528. #: bashref.texi:5232
  8529. msgid ""
  8530. "If set, the history list is appended to the file named by the value of the "
  8531. "@env{HISTFILE} variable when the shell exits, rather than overwriting the "
  8532. "file."
  8533. msgstr ""
  8534. #. type: item
  8535. #: bashref.texi:5233
  8536. #, no-wrap
  8537. msgid "histreedit"
  8538. msgstr ""
  8539. #. type: table
  8540. #: bashref.texi:5237
  8541. msgid ""
  8542. "If set, and Readline is being used, a user is given the opportunity to re-"
  8543. "edit a failed history substitution."
  8544. msgstr ""
  8545. #. type: item
  8546. #: bashref.texi:5238
  8547. #, no-wrap
  8548. msgid "histverify"
  8549. msgstr ""
  8550. #. type: table
  8551. #: bashref.texi:5243
  8552. msgid ""
  8553. "If set, and Readline is being used, the results of history substitution are "
  8554. "not immediately passed to the shell parser. Instead, the resulting line is "
  8555. "loaded into the Readline editing buffer, allowing further modification."
  8556. msgstr ""
  8557. #. type: item
  8558. #: bashref.texi:5244
  8559. #, no-wrap
  8560. msgid "hostcomplete"
  8561. msgstr ""
  8562. #. type: table
  8563. #: bashref.texi:5249
  8564. msgid ""
  8565. "If set, and Readline is being used, Bash will attempt to perform hostname "
  8566. "completion when a word containing a @samp{@@} is being completed "
  8567. "(@pxref{Commands For Completion}). This option is enabled by default."
  8568. msgstr ""
  8569. #. type: item
  8570. #: bashref.texi:5250
  8571. #, no-wrap
  8572. msgid "huponexit"
  8573. msgstr ""
  8574. #. type: table
  8575. #: bashref.texi:5253
  8576. msgid ""
  8577. "If set, Bash will send @code{SIGHUP} to all jobs when an interactive login "
  8578. "shell exits (@pxref{Signals})."
  8579. msgstr ""
  8580. #. type: item
  8581. #: bashref.texi:5254
  8582. #, no-wrap
  8583. msgid "inherit_errexit"
  8584. msgstr ""
  8585. #. type: table
  8586. #: bashref.texi:5258
  8587. msgid ""
  8588. "If set, command substitution inherits the value of the @code{errexit} "
  8589. "option, instead of unsetting it in the subshell environment. This option is "
  8590. "enabled when @sc{posix} mode is enabled."
  8591. msgstr ""
  8592. #. type: item
  8593. #: bashref.texi:5259
  8594. #, no-wrap
  8595. msgid "interactive_comments"
  8596. msgstr ""
  8597. #. type: table
  8598. #: bashref.texi:5264
  8599. msgid ""
  8600. "Allow a word beginning with @samp{#} to cause that word and all remaining "
  8601. "characters on that line to be ignored in an interactive shell. This option "
  8602. "is enabled by default."
  8603. msgstr ""
  8604. #. type: item
  8605. #: bashref.texi:5265
  8606. #, no-wrap
  8607. msgid "lastpipe"
  8608. msgstr ""
  8609. #. type: table
  8610. #: bashref.texi:5268
  8611. msgid ""
  8612. "If set, and job control is not active, the shell runs the last command of a "
  8613. "pipeline not executed in the background in the current shell environment."
  8614. msgstr ""
  8615. #. type: item
  8616. #: bashref.texi:5269
  8617. #, no-wrap
  8618. msgid "lithist"
  8619. msgstr ""
  8620. #. type: table
  8621. #: bashref.texi:5273
  8622. msgid ""
  8623. "If enabled, and the @code{cmdhist} option is enabled, multi-line commands "
  8624. "are saved to the history with embedded newlines rather than using semicolon "
  8625. "separators where possible."
  8626. msgstr ""
  8627. #. type: item
  8628. #: bashref.texi:5274
  8629. #, no-wrap
  8630. msgid "login_shell"
  8631. msgstr ""
  8632. #. type: table
  8633. #: bashref.texi:5278
  8634. msgid ""
  8635. "The shell sets this option if it is started as a login shell "
  8636. "(@pxref{Invoking Bash}). The value may not be changed."
  8637. msgstr ""
  8638. #. type: item
  8639. #: bashref.texi:5279
  8640. #, no-wrap
  8641. msgid "mailwarn"
  8642. msgstr ""
  8643. #. type: table
  8644. #: bashref.texi:5283
  8645. msgid ""
  8646. "If set, and a file that Bash is checking for mail has been accessed since "
  8647. "the last time it was checked, the message @code{\"The mail in @var{mailfile} "
  8648. "has been read\"} is displayed."
  8649. msgstr ""
  8650. #. type: item
  8651. #: bashref.texi:5284
  8652. #, no-wrap
  8653. msgid "no_empty_cmd_completion"
  8654. msgstr ""
  8655. #. type: table
  8656. #: bashref.texi:5288
  8657. msgid ""
  8658. "If set, and Readline is being used, Bash will not attempt to search the "
  8659. "@env{PATH} for possible completions when completion is attempted on an empty "
  8660. "line."
  8661. msgstr ""
  8662. #. type: item
  8663. #: bashref.texi:5289
  8664. #, no-wrap
  8665. msgid "nocaseglob"
  8666. msgstr ""
  8667. #. type: table
  8668. #: bashref.texi:5292
  8669. msgid ""
  8670. "If set, Bash matches filenames in a case-insensitive fashion when performing "
  8671. "filename expansion."
  8672. msgstr ""
  8673. #. type: item
  8674. #: bashref.texi:5293
  8675. #, no-wrap
  8676. msgid "nocasematch"
  8677. msgstr ""
  8678. #. type: table
  8679. #: bashref.texi:5299
  8680. msgid ""
  8681. "If set, Bash matches patterns in a case-insensitive fashion when performing "
  8682. "matching while executing @code{case} or @code{[[} conditional commands, when "
  8683. "performing pattern substitution word expansions, or when filtering possible "
  8684. "completions as part of programmable completion."
  8685. msgstr ""
  8686. #. type: item
  8687. #: bashref.texi:5300
  8688. #, no-wrap
  8689. msgid "nullglob"
  8690. msgstr ""
  8691. #. type: table
  8692. #: bashref.texi:5303
  8693. msgid ""
  8694. "If set, Bash allows filename patterns which match no files to expand to a "
  8695. "null string, rather than themselves."
  8696. msgstr ""
  8697. #. type: item
  8698. #: bashref.texi:5304
  8699. #, no-wrap
  8700. msgid "progcomp"
  8701. msgstr ""
  8702. #. type: table
  8703. #: bashref.texi:5308
  8704. msgid ""
  8705. "If set, the programmable completion facilities (@pxref{Programmable "
  8706. "Completion}) are enabled. This option is enabled by default."
  8707. msgstr ""
  8708. #. type: item
  8709. #: bashref.texi:5309
  8710. #, no-wrap
  8711. msgid "promptvars"
  8712. msgstr ""
  8713. #. type: table
  8714. #: bashref.texi:5315
  8715. msgid ""
  8716. "If set, prompt strings undergo parameter expansion, command substitution, "
  8717. "arithmetic expansion, and quote removal after being expanded as described "
  8718. "below (@pxref{Controlling the Prompt}). This option is enabled by default."
  8719. msgstr ""
  8720. #. type: item
  8721. #: bashref.texi:5316
  8722. #, no-wrap
  8723. msgid "restricted_shell"
  8724. msgstr ""
  8725. #. type: table
  8726. #: bashref.texi:5322
  8727. msgid ""
  8728. "The shell sets this option if it is started in restricted mode (@pxref{The "
  8729. "Restricted Shell}). The value may not be changed. This is not reset when "
  8730. "the startup files are executed, allowing the startup files to discover "
  8731. "whether or not a shell is restricted."
  8732. msgstr ""
  8733. #. type: item
  8734. #: bashref.texi:5323
  8735. #, no-wrap
  8736. msgid "shift_verbose"
  8737. msgstr ""
  8738. #. type: table
  8739. #: bashref.texi:5327
  8740. msgid ""
  8741. "If this is set, the @code{shift} builtin prints an error message when the "
  8742. "shift count exceeds the number of positional parameters."
  8743. msgstr ""
  8744. #. type: item
  8745. #: bashref.texi:5328
  8746. #, no-wrap
  8747. msgid "sourcepath"
  8748. msgstr ""
  8749. #. type: table
  8750. #: bashref.texi:5332
  8751. msgid ""
  8752. "If set, the @code{source} builtin uses the value of @env{PATH} to find the "
  8753. "directory containing the file supplied as an argument. This option is "
  8754. "enabled by default."
  8755. msgstr ""
  8756. #. type: item
  8757. #: bashref.texi:5333
  8758. #, no-wrap
  8759. msgid "xpg_echo"
  8760. msgstr ""
  8761. #. type: table
  8762. #: bashref.texi:5336
  8763. msgid ""
  8764. "If set, the @code{echo} builtin expands backslash-escape sequences by "
  8765. "default."
  8766. msgstr ""
  8767. #. type: Plain text
  8768. #: bashref.texi:5354
  8769. msgid ""
  8770. "For historical reasons, the @sc{posix} standard has classified several "
  8771. "builtin commands as @emph{special}. When Bash is executing in @sc{posix} "
  8772. "mode, the special builtins differ from other builtin commands in three "
  8773. "respects:"
  8774. msgstr ""
  8775. #. type: enumerate
  8776. #: bashref.texi:5358
  8777. msgid ""
  8778. "Special builtins are found before shell functions during command lookup."
  8779. msgstr ""
  8780. #. type: enumerate
  8781. #: bashref.texi:5361
  8782. msgid ""
  8783. "If a special builtin returns an error status, a non-interactive shell exits."
  8784. msgstr ""
  8785. #. type: enumerate
  8786. #: bashref.texi:5365
  8787. msgid ""
  8788. "Assignment statements preceding the command stay in effect in the shell "
  8789. "environment after the command completes."
  8790. msgstr ""
  8791. #. type: Plain text
  8792. #: bashref.texi:5370
  8793. msgid ""
  8794. "When Bash is not executing in @sc{posix} mode, these builtins behave no "
  8795. "differently than the rest of the Bash builtin commands. The Bash @sc{posix} "
  8796. "mode is described in @ref{Bash POSIX Mode}."
  8797. msgstr ""
  8798. #. type: Plain text
  8799. #: bashref.texi:5372
  8800. msgid "These are the @sc{posix} special builtins:"
  8801. msgstr ""
  8802. #. type: example
  8803. #: bashref.texi:5375
  8804. #, no-wrap
  8805. msgid ""
  8806. "@w{break : . continue eval exec exit export readonly return set}\n"
  8807. "@w{shift trap unset}\n"
  8808. msgstr ""
  8809. #. type: section
  8810. #: bashref.texi:5384 bashref.texi:5389 bashref.texi:5390
  8811. #, no-wrap
  8812. msgid "Bourne Shell Variables"
  8813. msgstr ""
  8814. #. type: menuentry
  8815. #: bashref.texi:5384
  8816. msgid "Variables which Bash uses in the same way as the Bourne Shell."
  8817. msgstr ""
  8818. #. type: section
  8819. #: bashref.texi:5384 bashref.texi:5450 bashref.texi:5451
  8820. #, no-wrap
  8821. msgid "Bash Variables"
  8822. msgstr ""
  8823. #. type: menuentry
  8824. #: bashref.texi:5384
  8825. msgid "List of variables that exist in Bash."
  8826. msgstr ""
  8827. #. type: Plain text
  8828. #: bashref.texi:5388
  8829. msgid ""
  8830. "This chapter describes the shell variables that Bash uses. Bash "
  8831. "automatically assigns default values to a number of variables."
  8832. msgstr "Este capítulo describe las variables del intérprete que Bash utiliza. Bash asigna automáticamente valores por defecto a cierto número de variables."
  8833. #. type: Plain text
  8834. #: bashref.texi:5394
  8835. msgid ""
  8836. "Bash uses certain shell variables in the same way as the Bourne shell. In "
  8837. "some cases, Bash assigns a default value to the variable."
  8838. msgstr "Bash utiliza cierto número de variables de intérprete del mismo modo que el intérprete Bourne. En algunos casos, Bash asigna un valor por defecto a la variable."
  8839. #. type: item
  8840. #: bashref.texi:5397
  8841. #, no-wrap
  8842. msgid "CDPATH"
  8843. msgstr ""
  8844. #. type: Plain text
  8845. #: bashref.texi:5400
  8846. msgid ""
  8847. "A colon-separated list of directories used as a search path for the "
  8848. "@code{cd} builtin command."
  8849. msgstr "Una lista separada por dos puntos de los directorios usados como ruta de busqueda de la orden integrada @code{cd}."
  8850. #. type: item
  8851. #: bashref.texi:5401
  8852. #, no-wrap
  8853. msgid "HOME"
  8854. msgstr ""
  8855. #. type: Plain text
  8856. #: bashref.texi:5406
  8857. msgid ""
  8858. "The current user's home directory; the default for the @code{cd} builtin "
  8859. "command. The value of this variable is also used by tilde expansion "
  8860. "(@pxref{Tilde Expansion})."
  8861. msgstr "El directorio home del usuario actual; el valor por defecto para la orden integrada @code{cd}. El valor de esta variable también es usado por la expansión de tilde. (@pxref{Tilde Expansion})."
  8862. #. type: item
  8863. #: bashref.texi:5407
  8864. #, no-wrap
  8865. msgid "IFS"
  8866. msgstr ""
  8867. #. type: Plain text
  8868. #: bashref.texi:5410
  8869. msgid ""
  8870. "A list of characters that separate fields; used when the shell splits words "
  8871. "as part of expansion."
  8872. msgstr "Una lista de caracteres que separan campos; usado cuanto el intérprete separa palabras como parte de la expansión."
  8873. #. type: item
  8874. #: bashref.texi:5411
  8875. #, no-wrap
  8876. msgid "MAIL"
  8877. msgstr ""
  8878. #. type: Plain text
  8879. #: bashref.texi:5416
  8880. msgid ""
  8881. "If this parameter is set to a filename or directory name and the "
  8882. "@env{MAILPATH} variable is not set, Bash informs the user of the arrival of "
  8883. "mail in the specified file or Maildir-format directory."
  8884. msgstr "Si este parámetro es asignado a un nombre de archivo o directorio y la variable @env{MAILPATH} no fue asignada, Bash informa al usuario de la llegada de correo in archivo especificado o en el directorio de formato Maildir."
  8885. #. type: item
  8886. #: bashref.texi:5417
  8887. #, no-wrap
  8888. msgid "MAILPATH"
  8889. msgstr ""
  8890. #. type: Plain text
  8891. #: bashref.texi:5425
  8892. msgid ""
  8893. "A colon-separated list of filenames which the shell periodically checks for "
  8894. "new mail. Each list entry can specify the message that is printed when new "
  8895. "mail arrives in the mail file by separating the filename from the message "
  8896. "with a @samp{?}. When used in the text of the message, @code{$_} expands to "
  8897. "the name of the current mail file."
  8898. msgstr "Una lista de nombres de archivo separadas por dos puntos que el intérprete revisa periodicamente buscando correo nuevo. Cada entrada de la lista especifica el mensaje que será mostrado cuando llegue nuevo correo en el archivo de correo separando el nombre de archivo del mensaje con un @samp{?}. Cuando es usado en el texto del mensaje, @code{$_} se expande al nombre del archivo de correo actual."
  8899. #. type: item
  8900. #: bashref.texi:5426
  8901. #, no-wrap
  8902. msgid "OPTARG"
  8903. msgstr ""
  8904. #. type: Plain text
  8905. #: bashref.texi:5428
  8906. msgid ""
  8907. "The value of the last option argument processed by the @code{getopts} "
  8908. "builtin."
  8909. msgstr "El valor del último parámetro de opción procesado por el integrado @code{getopts}."
  8910. #. type: item
  8911. #: bashref.texi:5429
  8912. #, no-wrap
  8913. msgid "OPTIND"
  8914. msgstr ""
  8915. #. type: Plain text
  8916. #: bashref.texi:5431
  8917. msgid ""
  8918. "The index of the last option argument processed by the @code{getopts} "
  8919. "builtin."
  8920. msgstr "El índice del último parámetro de opción procesado por el integrado @code{getopts}."
  8921. #. type: item
  8922. #: bashref.texi:5432
  8923. #, no-wrap
  8924. msgid "PATH"
  8925. msgstr ""
  8926. #. type: Plain text
  8927. #: bashref.texi:5439
  8928. msgid ""
  8929. "A colon-separated list of directories in which the shell looks for "
  8930. "commands. A zero-length (null) directory name in the value of @code{PATH} "
  8931. "indicates the current directory. A null directory name may appear as two "
  8932. "adjacent colons, or as an initial or trailing colon."
  8933. msgstr "Una lista de directorios separados por dos puntos en lo cuales el intérprete busca ordenes. Un nombre de directorio de tamaño cero (null) en el valor de @code{PATH} indica el directorio actual. Un nombre de directorio nulo puede aparecer como un par de dos puntos adyacentes, o como dos puntos iniciales o finales."
  8934. #. type: item
  8935. #: bashref.texi:5440
  8936. #, no-wrap
  8937. msgid "PS1"
  8938. msgstr ""
  8939. #. type: Plain text
  8940. #: bashref.texi:5444
  8941. msgid ""
  8942. "The primary prompt string. The default value is @samp{\\s-\\v\\$ }. "
  8943. "@xref{Controlling the Prompt}, for the complete list of escape sequences "
  8944. "that are expanded before @env{PS1} is displayed."
  8945. msgstr "La cadena primaria del prompt. El valor por defecto es @samp{\\s-\\v\\$ }. @xref{Controlling the Prompt}, para una lista completa de las secuencias de escape que son expandidas antes de que @code{PS1} sea mostrado."
  8946. #. type: item
  8947. #: bashref.texi:5445
  8948. #, no-wrap
  8949. msgid "PS2"
  8950. msgstr ""
  8951. #. type: Plain text
  8952. #: bashref.texi:5447
  8953. msgid "The secondary prompt string. The default value is @samp{> }."
  8954. msgstr "La cadena secundaria del prompt. El valor por defecto es @samp{> }."
  8955. #. type: Plain text
  8956. #: bashref.texi:5455
  8957. msgid ""
  8958. "These variables are set or used by Bash, but other shells do not normally "
  8959. "treat them specially."
  8960. msgstr "Estas variables son asignadas o usadas por Bash, pero otros intérpretes no lo hacen normalmente."
  8961. #. type: Plain text
  8962. #: bashref.texi:5459
  8963. msgid ""
  8964. "A few variables used by Bash are described in different chapters: variables "
  8965. "for controlling the job control facilities (@pxref{Job Control Variables})."
  8966. msgstr "Algunas variables usadas por Bash son descritas en diferentes capítulos: variables para controlar las capacidades del control de tareas (@pxred{Job Control Variables})."
  8967. #. type: item
  8968. #: bashref.texi:5462
  8969. #, no-wrap
  8970. msgid "BASH"
  8971. msgstr ""
  8972. #. type: Plain text
  8973. #: bashref.texi:5464
  8974. msgid "The full pathname used to execute the current instance of Bash."
  8975. msgstr "La ruta completa usada para ejecutar la instancia actual de Bash."
  8976. #. type: item
  8977. #: bashref.texi:5465
  8978. #, no-wrap
  8979. msgid "BASHOPTS"
  8980. msgstr ""
  8981. #. type: Plain text
  8982. #: bashref.texi:5474
  8983. msgid ""
  8984. "A colon-separated list of enabled shell options. Each word in the list is a "
  8985. "valid argument for the @option{-s} option to the @code{shopt} builtin "
  8986. "command (@pxref{The Shopt Builtin}). The options appearing in "
  8987. "@env{BASHOPTS} are those reported as @samp{on} by @samp{shopt}. If this "
  8988. "variable is in the environment when Bash starts up, each shell option in the "
  8989. "list will be enabled before reading any startup files. This variable is "
  8990. "readonly."
  8991. msgstr "Una lista de las opciones activas en el intérprete separadas por dos puntos. Cada palabra en la lista es un parámetro válido para la opción @option{-s} en la orden integrada @code{shopt} (@pxref{The Shipt Builtin}). Las opciones que aparecen en @env{BASHOPTS} son aquellos reportados como @samp{on} por @samp{shopt}. Si esta variables esta en el entorno cuando Bash inicia, cada opción del intérprete en la lista será habilitada antes de leer cualquier archivo de inicio. Esta variable es de solo lectura."
  8992. #. type: item
  8993. #: bashref.texi:5475
  8994. #, no-wrap
  8995. msgid "BASHPID"
  8996. msgstr ""
  8997. #. type: Plain text
  8998. #: bashref.texi:5479
  8999. msgid ""
  9000. "Expands to the process ID of the current Bash process. This differs from "
  9001. "@code{$$} under certain circumstances, such as subshells that do not require "
  9002. "Bash to be re-initialized."
  9003. msgstr "Se expande al ID del proceso actual de Bash. Esto difiere de @code{$$} bajo ciertas circunstancias, como los sub-intépretes que no requieren que Bash sea reinicializado."
  9004. #. type: item
  9005. #: bashref.texi:5480
  9006. #, no-wrap
  9007. msgid "BASH_ALIASES"
  9008. msgstr ""
  9009. #. type: Plain text
  9010. #: bashref.texi:5490
  9011. msgid ""
  9012. "An associative array variable whose members correspond to the internal list "
  9013. "of aliases as maintained by the @code{alias} builtin. (@pxref{Bourne Shell "
  9014. "Builtins}). Elements added to this array appear in the alias list; however, "
  9015. "unsetting array elements currently does not cause aliases to be removed from "
  9016. "the alias list. If @code{BASH_ALIASES} is unset, it loses its special "
  9017. "properties, even if it is subsequently reset."
  9018. msgstr "Una variable de arreglo asociativo cuyos miembros corresponden a la lista interna de alias como son mantenidas por el integrado @code{alias}. (@pxref{Bourne Shell Builtins}). Los elementos agregados a este arreglo aparecen en la lista de alias; sin embargo, elementos del arreglo no-fijados no ocasionan que los alias sean removidos de la lista de alias. Si @code{BASH_ALIASES} es no-fijado, pieder sus propiedades especiales, incluso si es subsecuentemente reiniciado."
  9019. #. type: item
  9020. #: bashref.texi:5491
  9021. #, no-wrap
  9022. msgid "BASH_ARGC"
  9023. msgstr ""
  9024. #. type: Plain text
  9025. #: bashref.texi:5502
  9026. msgid ""
  9027. "An array variable whose values are the number of parameters in each frame of "
  9028. "the current bash execution call stack. The number of parameters to the "
  9029. "current subroutine (shell function or script executed with @code{.} or "
  9030. "@code{source}) is at the top of the stack. When a subroutine is executed, "
  9031. "the number of parameters passed is pushed onto @code{BASH_ARGC}. The shell "
  9032. "sets @code{BASH_ARGC} only when in extended debugging mode (see @ref{The "
  9033. "Shopt Builtin} for a description of the @code{extdebug} option to the "
  9034. "@code{shopt} builtin)."
  9035. msgstr "Una variable de arreglo cuyos valores son el número de parámetros en cada cuadro de la pila de llamadas de ejecución actual de Bash. El número de parámetros de la subrutina actual (función del intérprete o script ejecutado con @code{.} o @code{source}) está al tope se la pila. Cuando una subrutina es ejecutada, el número de parámetros pasados es llevado a @code{BASH_ARGC}. El intérprete asigna @code{BASH_ARGC} solo cuando esta en modo extendido de depuración (ver @ref{The Shopt Bultin}) para una descripción desde la opción @code{extdebug} a el integrado @code{shopt})."
  9036. #. type: item
  9037. #: bashref.texi:5503
  9038. #, no-wrap
  9039. msgid "BASH_ARGV"
  9040. msgstr ""
  9041. #. type: Plain text
  9042. #: bashref.texi:5513
  9043. msgid ""
  9044. "An array variable containing all of the parameters in the current bash "
  9045. "execution call stack. The final parameter of the last subroutine call is at "
  9046. "the top of the stack; the first parameter of the initial call is at the "
  9047. "bottom. When a subroutine is executed, the parameters supplied are pushed "
  9048. "onto @code{BASH_ARGV}. The shell sets @code{BASH_ARGV} only when in "
  9049. "extended debugging mode (see @ref{The Shopt Builtin} for a description of "
  9050. "the @code{extdebug} option to the @code{shopt} builtin)."
  9051. msgstr "Una variable de arreglo que continene todos los parámetros de la pila actual de llamadas de ejecución de Bash. El parámetro final de la última llamada de subrutina esta hasta el tope de la pila; el primer parámetro de la llamada inicial esta al fondo. Cuando una subrutina es ejecutada, los parámetros proporcionados son llevados hacia @code{BASH_ARGV}. El intérprete asigna @code{BASH_ARGV} solo cuando esta en modo de depuración extendida (ver @red{The Shopt Builtin} para una descrición desde la ocpión @code{extdebug} hasta el integrado @code{shopt})."
  9052. #. type: item
  9053. #: bashref.texi:5514
  9054. #, no-wrap
  9055. msgid "BASH_CMDS"
  9056. msgstr ""
  9057. #. type: Plain text
  9058. #: bashref.texi:5524
  9059. msgid ""
  9060. "An associative array variable whose members correspond to the internal hash "
  9061. "table of commands as maintained by the @code{hash} builtin (@pxref{Bourne "
  9062. "Shell Builtins}). Elements added to this array appear in the hash table; "
  9063. "however, unsetting array elements currently does not cause command names to "
  9064. "be removed from the hash table. If @code{BASH_CMDS} is unset, it loses its "
  9065. "special properties, even if it is subsequently reset."
  9066. msgstr "Una variable de arreglo asociativa cuyos miembros corresponden a la matríz asociativa de ordenes como es mantenida por el integrado @code{hash} (@pxref{Bourne Shell Builtins}). Los elementos agregados a este arreglo aparecen en la matríz asociativa; sin embargo, no fijando elementos del arreglo actualmente no ocasiona que los nombres de ordenes sean removidos de la matríz asociativa, Si @code{BASH_CMDS} es no fijado, pierde sus propiedades especiales, incluso si es subsecuentemente reiniciado."
  9067. #. type: item
  9068. #: bashref.texi:5525
  9069. #, no-wrap
  9070. msgid "BASH_COMMAND"
  9071. msgstr ""
  9072. #. type: Plain text
  9073. #: bashref.texi:5529
  9074. msgid ""
  9075. "The command currently being executed or about to be executed, unless the "
  9076. "shell is executing a command as the result of a trap, in which case it is "
  9077. "the command executing at the time of the trap."
  9078. msgstr "La orden que está siendo ejecutada o proxima de serlo, a menos que el intérprete esté ejecutando una orden como resultado de una trampa, en ese caso es la orden siendo ejecutada al tiempo que los es la trampa."
  9079. #. type: item
  9080. #: bashref.texi:5530
  9081. #, no-wrap
  9082. msgid "BASH_COMPAT"
  9083. msgstr ""
  9084. #. type: Plain text
  9085. #: bashref.texi:5545
  9086. msgid ""
  9087. "The value is used to set the shell's compatibility level. @xref{The Shopt "
  9088. "Builtin}, for a description of the various compatibility levels and their "
  9089. "effects. The value may be a decimal number (e.g., 4.2) or an integer (e.g., "
  9090. "42) corresponding to the desired compatibility level. If "
  9091. "@code{BASH_COMPAT} is unset or set to the empty string, the compatibility "
  9092. "level is set to the default for the current version. If @code{BASH_COMPAT} "
  9093. "is set to a value that is not one of the valid compatibility levels, the "
  9094. "shell prints an error message and sets the compatibility level to the "
  9095. "default for the current version. The valid compatibility levels correspond "
  9096. "to the compatibility options accepted by the @code{shopt} builtin described "
  9097. "above (for example, @var{compat42} means that 4.2 and 42 are valid values). "
  9098. "The current version is also a valid value."
  9099. msgstr "El valor es usado para asignar el nivel de compatibilñidad del intérprete. @xref{The Shopt Builtin}, para una descripción de los varios niveles de compatibilidad y sus efectos. El valor puede ser un número decimal (por ejemplo, 4.2) o un entero (por ejemplo 42) correspondiendo al nivel de compatibilidad deseado. Si @code{BASH_COMPAT} es no fijado o fijado como la cadena vacía, el nivel de compatibilidad es fijado como el valor por defecto de la versión actual. Si @code{BASH_COMPAT} es fijado como un valor que no se encuentra en los niveles de compatibilidad, el intérprete imprime un mensaje de error y asigna el nivel de compatibilidad al valor por defecto de la versión actual. Los niveles de compatibilidad corresponden a las opciones de compatibilidad aceptadas por el integrado @code{shopt} descrito anteriormente (por ejemplo, @var{compat42} significa que 4.2 y 42 son valores válidos). La versión que se ejecuta es un valor válido."
  9100. #. type: item
  9101. #: bashref.texi:5546
  9102. #, no-wrap
  9103. msgid "BASH_ENV"
  9104. msgstr ""
  9105. #. type: Plain text
  9106. #: bashref.texi:5550
  9107. msgid ""
  9108. "If this variable is set when Bash is invoked to execute a shell script, its "
  9109. "value is expanded and used as the name of a startup file to read before "
  9110. "executing the script. @xref{Bash Startup Files}."
  9111. msgstr "Si esta variable es asignada cuando Bash es llamado a ejecutar un script de intérprete, su valor es expandido y usado como el nombre del archivo de inicio a leer antes de ejecutar el script. @xref{Bash Startup Files}."
  9112. #. type: item
  9113. #: bashref.texi:5551
  9114. #, no-wrap
  9115. msgid "BASH_EXECUTION_STRING"
  9116. msgstr ""
  9117. #. type: Plain text
  9118. #: bashref.texi:5553
  9119. msgid "The command argument to the @option{-c} invocation option."
  9120. msgstr "El argumento a la opción de llamada @option{-c}."
  9121. #. type: item
  9122. #: bashref.texi:5554
  9123. #, no-wrap
  9124. msgid "BASH_LINENO"
  9125. msgstr ""
  9126. #. type: Plain text
  9127. #: bashref.texi:5562
  9128. msgid ""
  9129. "An array variable whose members are the line numbers in source files where "
  9130. "each corresponding member of @var{FUNCNAME} was invoked. "
  9131. "@code{$@{BASH_LINENO[$i]@}} is the line number in the source file "
  9132. "(@code{$@{BASH_SOURCE[$i+1]@}}) where @code{$@{FUNCNAME[$i]@}} was called "
  9133. "(or @code{$@{BASH_LINENO[$i-1]@}} if referenced within another shell "
  9134. "function). Use @code{LINENO} to obtain the current line number."
  9135. msgstr "Una variable de arreglo cuyos miembros es el número de lineas en los archivos fuente donde cada miembro correspondiente de @var{FUNCNAME} fue llamado. @code{$@{BASH_LINENO[$i]@}} es el número de lineas en el archivo fuente (@code{$@{BASH_SOURCE[$i+1]@}}) donde @code{$@{FUNCNAME[$i]@}} fue llamado (o @code{$@{BASH_LINENO[$i-1]@}} si fue referenciado con otra función de intérprete). Use @code{LINENO} para obtener el número de linea actual."
  9136. #. type: item
  9137. #: bashref.texi:5563
  9138. #, no-wrap
  9139. msgid "BASH_LOADABLES_PATH"
  9140. msgstr ""
  9141. #. type: Plain text
  9142. #: bashref.texi:5567
  9143. msgid ""
  9144. "A colon-separated list of directories in which the shell looks for "
  9145. "dynamically loadable builtins specified by the @code{enable} command."
  9146. msgstr "Una lista separada por dos puntos de los directorios en los cuales el intérprete se busca integrados dinamicamente cargables especificados por la orden @code{enable}."
  9147. #. type: item
  9148. #: bashref.texi:5568
  9149. #, no-wrap
  9150. msgid "BASH_REMATCH"
  9151. msgstr ""
  9152. #. type: Plain text
  9153. #: bashref.texi:5577
  9154. msgid ""
  9155. "An array variable whose members are assigned by the @samp{=~} binary "
  9156. "operator to the @code{[[} conditional command (@pxref{Conditional "
  9157. "Constructs}). The element with index 0 is the portion of the string "
  9158. "matching the entire regular expression. The element with index @var{n} is "
  9159. "the portion of the string matching the @var{n}th parenthesized "
  9160. "subexpression. This variable is read-only."
  9161. msgstr "Una variable de arreglo cuyos miembros son asignados por el operador binario @samp{=~} a la orden condicionañ @code{[[} (@pxref{Conditional Constructs}). El elemento con índice 0 es la porción de la cadena que coincide con la expresión regular completa. El elemento con índice @var{n} es la porción de la cadena que coincide con la enécima subexpresión entre paréntesis. Esta variable es de solo lectura."
  9162. #. type: item
  9163. #: bashref.texi:5578
  9164. #, no-wrap
  9165. msgid "BASH_SOURCE"
  9166. msgstr ""
  9167. #. type: Plain text
  9168. #: bashref.texi:5584
  9169. msgid ""
  9170. "An array variable whose members are the source filenames where the "
  9171. "corresponding shell function names in the @code{FUNCNAME} array variable are "
  9172. "defined. The shell function @code{$@{FUNCNAME[$i]@}} is defined in the file "
  9173. "@code{$@{BASH_SOURCE[$i]@}} and called from @code{$@{BASH_SOURCE[$i+1]@}}"
  9174. msgstr "Una variable de arreglo cuyos miembros son los nombres de los archivos fuente donde los nombres de las funciones de intérprete corresponientes en la variable de arreglo @code{FUNCNAME} están definidos. La función de intérprete @code{$@{FUNCNAME[$i]@}} está definida en el archivo @code{$@{BASH_SOURCE[$i]@}} y es llamada desde @code{$@{BASH_SOURCE[$i+1]@}}."
  9175. #. type: item
  9176. #: bashref.texi:5585
  9177. #, no-wrap
  9178. msgid "BASH_SUBSHELL"
  9179. msgstr ""
  9180. #. type: Plain text
  9181. #: bashref.texi:5589
  9182. msgid ""
  9183. "Incremented by one within each subshell or subshell environment when the "
  9184. "shell begins executing in that environment. The initial value is 0."
  9185. msgstr "Incrementada en uno con cada subintéprete o entorno de subintérprete cuando el intérprete comienza a ejecutarse en ese entorno. El valor inicial es 0."
  9186. #. type: item
  9187. #: bashref.texi:5590
  9188. #, no-wrap
  9189. msgid "BASH_VERSINFO"
  9190. msgstr ""
  9191. #. type: Plain text
  9192. #: bashref.texi:5594
  9193. msgid ""
  9194. "A readonly array variable (@pxref{Arrays}) whose members hold version "
  9195. "information for this instance of Bash. The values assigned to the array "
  9196. "members are as follows:"
  9197. msgstr "Una variable de arreglo de solo lectura (@pxref{Arrays}) cuyos miembros mantienen la información de la versión de la instancia Bash siendo usada. Los valores asignados a los miembros del arreglo son del siguiente modo:"
  9198. #. type: item
  9199. #: bashref.texi:5597
  9200. #, no-wrap
  9201. msgid "BASH_VERSINFO[0]"
  9202. msgstr ""
  9203. #. type: table
  9204. #: bashref.texi:5599
  9205. msgid "The major version number (the @var{release})."
  9206. msgstr "El número de versión principal (el @var{lanzamiento})."
  9207. #. type: item
  9208. #: bashref.texi:5600
  9209. #, no-wrap
  9210. msgid "BASH_VERSINFO[1]"
  9211. msgstr ""
  9212. #. type: table
  9213. #: bashref.texi:5602
  9214. msgid "The minor version number (the @var{version})."
  9215. msgstr "El número de versión secundario (la @var{versión})."
  9216. #. type: item
  9217. #: bashref.texi:5603
  9218. #, no-wrap
  9219. msgid "BASH_VERSINFO[2]"
  9220. msgstr ""
  9221. #. type: table
  9222. #: bashref.texi:5605
  9223. msgid "The patch level."
  9224. msgstr "El nivel del parche."
  9225. #. type: item
  9226. #: bashref.texi:5606
  9227. #, no-wrap
  9228. msgid "BASH_VERSINFO[3]"
  9229. msgstr ""
  9230. #. type: table
  9231. #: bashref.texi:5608
  9232. msgid "The build version."
  9233. msgstr "La versión de la compilación."
  9234. #. type: item
  9235. #: bashref.texi:5609
  9236. #, no-wrap
  9237. msgid "BASH_VERSINFO[4]"
  9238. msgstr ""
  9239. #. type: table
  9240. #: bashref.texi:5611
  9241. msgid "The release status (e.g., @var{beta1})."
  9242. msgstr "El estado del lanzamiento (por ejemplo, beta1)."
  9243. #. type: item
  9244. #: bashref.texi:5612
  9245. #, no-wrap
  9246. msgid "BASH_VERSINFO[5]"
  9247. msgstr ""
  9248. #. type: table
  9249. #: bashref.texi:5614
  9250. msgid "The value of @env{MACHTYPE}."
  9251. msgstr "El valor de @env{MACHTYPE}."
  9252. #. type: item
  9253. #: bashref.texi:5616
  9254. #, no-wrap
  9255. msgid "BASH_VERSION"
  9256. msgstr ""
  9257. #. type: Plain text
  9258. #: bashref.texi:5618
  9259. msgid "The version number of the current instance of Bash."
  9260. msgstr "El número de versión de la instancia actual de Bash."
  9261. #. type: item
  9262. #: bashref.texi:5619
  9263. #, no-wrap
  9264. msgid "BASH_XTRACEFD"
  9265. msgstr ""
  9266. #. type: Plain text
  9267. #: bashref.texi:5632
  9268. msgid ""
  9269. "If set to an integer corresponding to a valid file descriptor, Bash will "
  9270. "write the trace output generated when @samp{set -x} is enabled to that file "
  9271. "descriptor. This allows tracing output to be separated from diagnostic and "
  9272. "error messages. The file descriptor is closed when @code{BASH_XTRACEFD} is "
  9273. "unset or assigned a new value. Unsetting @code{BASH_XTRACEFD} or assigning "
  9274. "it the empty string causes the trace output to be sent to the standard "
  9275. "error. Note that setting @code{BASH_XTRACEFD} to 2 (the standard error file "
  9276. "descriptor) and then unsetting it will result in the standard error being "
  9277. "closed."
  9278. msgstr "Si es asignado a un entero correspondiente a un descriptor de archivo, Bash escribirá el rastro de la salida generada cuando @samp{set -x} esta activo a ese descriptor de archivo. Esto permite separar el rastro de la salida de los mensajes de diagnóstico y de error. El descriptor de archivo es cerrado cuando @code{BASH_XTRACEFD} es desasignado o un nuevo valor es asigando. Desasignar @code{BASH_XTRACEFD} o asignarle una cadena vacia causa que el rastro de la salida sea mandado al error estándar. Nótese que asignar 2 a @code{BASH_XTRACEFD} (el descriptor de archivo del error estándar) y después desasignarlo resultará en el cierre del error estándar."
  9279. #. type: item
  9280. #: bashref.texi:5633
  9281. #, no-wrap
  9282. msgid "CHILD_MAX"
  9283. msgstr ""
  9284. #. type: Plain text
  9285. #: bashref.texi:5639
  9286. msgid ""
  9287. "Set the number of exited child status values for the shell to remember. "
  9288. "Bash will not allow this value to be decreased below a @sc{posix}-mandated "
  9289. "minimum, and there is a maximum value (currently 8192) that this may not "
  9290. "exceed. The minimum value is system-dependent."
  9291. msgstr "Asigna el número de valores de estado subordinados terminados a recordar por el intérprete. Bash no permitirá que este valor sea menor al un mínimo obligado @sc{posix}, y hay un valor máximo (actualmente 8192) que no se puede exceder. El mínimo es dependiente del sistema."
  9292. #. type: item
  9293. #: bashref.texi:5640
  9294. #, no-wrap
  9295. msgid "COLUMNS"
  9296. msgstr ""
  9297. #. type: Plain text
  9298. #: bashref.texi:5646
  9299. msgid ""
  9300. "Used by the @code{select} command to determine the terminal width when "
  9301. "printing selection lists. Automatically set if the @code{checkwinsize} "
  9302. "option is enabled (@pxref{The Shopt Builtin}), or in an interactive shell "
  9303. "upon receipt of a @code{SIGWINCH}."
  9304. msgstr "Usado por la orden @code{select} para determinar el ancho de la terminal cuando imprima listas de selección. Es asignado automáticamente si la opción @code{checkwinsize} esta activa (@pxref{The Shopt Builtin}), o en un intérprete interactivo tras recibo de un @code{SIGWINCH}."
  9305. #. type: item
  9306. #: bashref.texi:5647
  9307. #, no-wrap
  9308. msgid "COMP_CWORD"
  9309. msgstr ""
  9310. #. type: Plain text
  9311. #: bashref.texi:5652
  9312. msgid ""
  9313. "An index into @env{$@{COMP_WORDS@}} of the word containing the current "
  9314. "cursor position. This variable is available only in shell functions invoked "
  9315. "by the programmable completion facilities (@pxref{Programmable Completion})."
  9316. msgstr "Un índice en @env{$@{COMP_WORDS@}} de la palabra que contiene la posición actual del cursor. Esta variable solo está disponible en las funciones del intéprete llamadas por las capacidades de completamiento programable. (@pxref{Programmable Completion})."
  9317. #. type: item
  9318. #: bashref.texi:5653
  9319. #, no-wrap
  9320. msgid "COMP_LINE"
  9321. msgstr ""
  9322. #. type: Plain text
  9323. #: bashref.texi:5658
  9324. msgid ""
  9325. "The current command line. This variable is available only in shell "
  9326. "functions and external commands invoked by the programmable completion "
  9327. "facilities (@pxref{Programmable Completion})."
  9328. msgstr "La línea de ordenes actual. Esta variable solo está disponible en funciones de intérpete y ordenes externas llamadas por las capacidades de completamiento programable. (@pxref{Programmable Completion})."
  9329. #. type: item
  9330. #: bashref.texi:5659
  9331. #, no-wrap
  9332. msgid "COMP_POINT"
  9333. msgstr ""
  9334. #. type: Plain text
  9335. #: bashref.texi:5667
  9336. msgid ""
  9337. "The index of the current cursor position relative to the beginning of the "
  9338. "current command. If the current cursor position is at the end of the "
  9339. "current command, the value of this variable is equal to "
  9340. "@code{$@{#COMP_LINE@}}. This variable is available only in shell functions "
  9341. "and external commands invoked by the programmable completion facilities "
  9342. "(@pxref{Programmable Completion})."
  9343. msgstr "El índice de la posición actual del cursor en relación al comienzo de la orden actual. Si la posición actual del cursor está al final de la orden actual, el valor de esta variable es equivalente a @code{$@{#COMP_LINE@}}. Esta variable solo está disponible en funciones de intéprete y ordenes externas llamadas por las capacidades de completamiento programable (@pxref{Programmable Completion})."
  9344. #. type: item
  9345. #: bashref.texi:5668
  9346. #, no-wrap
  9347. msgid "COMP_TYPE"
  9348. msgstr ""
  9349. #. type: Plain text
  9350. #: bashref.texi:5680
  9351. msgid ""
  9352. "Set to an integer value corresponding to the type of completion attempted "
  9353. "that caused a completion function to be called: @var{TAB}, for normal "
  9354. "completion, @samp{?}, for listing completions after successive tabs, "
  9355. "@samp{!}, for listing alternatives on partial word completion, @samp{@@}, to "
  9356. "list completions if the word is not unmodified, or @samp{%}, for menu "
  9357. "completion. This variable is available only in shell functions and external "
  9358. "commands invoked by the programmable completion facilities "
  9359. "(@pxref{Programmable Completion})."
  9360. msgstr "Asignado a un valor entero correspondiente al tipo de completamiento pretendido que causa que una función de completamiento sea llamada: @var{TAB}, para un completamiento normal, @samp{?}, para listar completamientos después de tabulaciones sucesivas, @samp{!}, para listar alternativas en completamiento parcial de palabras, @samp{@@}, para completamiento. Esta variable está disponible solo en funciones de intérprete y ordenes externas llamadas por las capacidades de completamiento programable (@pxref{Programmable Completion})."
  9361. #. type: item
  9362. #: bashref.texi:5681
  9363. #, no-wrap
  9364. msgid "COMP_KEY"
  9365. msgstr ""
  9366. #. type: Plain text
  9367. #: bashref.texi:5684
  9368. msgid ""
  9369. "The key (or final key of a key sequence) used to invoke the current "
  9370. "completion function."
  9371. msgstr "La tecla (o la tecla final de una secuencia de teclas) usada para llamar la función de completamiento actual."
  9372. #. type: item
  9373. #: bashref.texi:5685
  9374. #, no-wrap
  9375. msgid "COMP_WORDBREAKS"
  9376. msgstr ""
  9377. #. type: Plain text
  9378. #: bashref.texi:5690
  9379. msgid ""
  9380. "The set of characters that the Readline library treats as word separators "
  9381. "when performing word completion. If @code{COMP_WORDBREAKS} is unset, it "
  9382. "loses its special properties, even if it is subsequently reset."
  9383. msgstr "El conjunto de caracteres que la biblioteca Readline tomas como separadores de palabras cuando hace un completamiento de palabra. Si @code{COMP_WORDBREAKS} es desasignado, pierde sus propiedades especiales, incluso si es reiniciado subsecuentemente."
  9384. #. type: item
  9385. #: bashref.texi:5691
  9386. #, no-wrap
  9387. msgid "COMP_WORDS"
  9388. msgstr ""
  9389. #. type: Plain text
  9390. #: bashref.texi:5698
  9391. msgid ""
  9392. "An array variable consisting of the individual words in the current command "
  9393. "line. The line is split into words as Readline would split it, using "
  9394. "@code{COMP_WORDBREAKS} as described above. This variable is available only "
  9395. "in shell functions invoked by the programmable completion facilities "
  9396. "(@pxref{Programmable Completion})."
  9397. msgstr "Una variable de arreglo consistente en las palabras individuales en la linea de ordenes actual. Esta linea es dividida en palabras como lo haría Readline, usando @code{COMP_WORDBREAKS} como se describío anteriormente. Esta variable solo está disponible en funciones de intérprete llamadas por las capacidades de completamiento programable(@pxref{Programmable Completion})."
  9398. #. type: item
  9399. #: bashref.texi:5699
  9400. #, no-wrap
  9401. msgid "COMPREPLY"
  9402. msgstr ""
  9403. #. type: Plain text
  9404. #: bashref.texi:5704
  9405. msgid ""
  9406. "An array variable from which Bash reads the possible completions generated "
  9407. "by a shell function invoked by the programmable completion facility "
  9408. "(@pxref{Programmable Completion}). Each array element contains one possible "
  9409. "completion."
  9410. msgstr "Una variable de arreglo desde la cual Bash lee los completamientos posibles generados por una función de intéprete llamada por la capacidad de completamiento programable(@pxref{Programmable Completion}). Cada elemento del arreglo contiene un completamiento posible."
  9411. #. type: item
  9412. #: bashref.texi:5705
  9413. #, no-wrap
  9414. msgid "COPROC"
  9415. msgstr ""
  9416. #. type: Plain text
  9417. #: bashref.texi:5708
  9418. msgid ""
  9419. "An array variable created to hold the file descriptors for output from and "
  9420. "input to an unnamed coprocess (@pxref{Coprocesses})."
  9421. msgstr "Una variable de arreglo creada para mantener los descriptores de archivo para la salida y entrada a un coproceso no nombrado (@pxref{Coprocesses})."
  9422. #. type: item
  9423. #: bashref.texi:5709
  9424. #, no-wrap
  9425. msgid "DIRSTACK"
  9426. msgstr ""
  9427. #. type: Plain text
  9428. #: bashref.texi:5719
  9429. msgid ""
  9430. "An array variable containing the current contents of the directory stack. "
  9431. "Directories appear in the stack in the order they are displayed by the "
  9432. "@code{dirs} builtin. Assigning to members of this array variable may be "
  9433. "used to modify directories already in the stack, but the @code{pushd} and "
  9434. "@code{popd} builtins must be used to add and remove directories. Assignment "
  9435. "to this variable will not change the current directory. If @env{DIRSTACK} "
  9436. "is unset, it loses its special properties, even if it is subsequently reset."
  9437. msgstr "Una variable de arreglo que contiene los contenidos actuales de la pila de directorios. Los directorios aparecen en la pila en el orden en que son mostrados por el integrado @code{dirs}. Asignar a lo miembros de esta variable de arreglo puede ser usado para modificar directorios que ya se encuentran en la pila, pero los integrados @code{pushd} y @code{popd} deben ser usados para agregar y remover directorios. Asignaciones a esta variable no cambia el directorio actual. Si @env{DIRSTACK} es desasignado, pierdes sus propiedades especiales, incluso si es reiniciado subsecuentemente."
  9438. #. type: item
  9439. #: bashref.texi:5720
  9440. #, no-wrap
  9441. msgid "EMACS"
  9442. msgstr ""
  9443. #. type: Plain text
  9444. #: bashref.texi:5724
  9445. msgid ""
  9446. "If Bash finds this variable in the environment when the shell starts with "
  9447. "value @samp{t}, it assumes that the shell is running in an Emacs shell "
  9448. "buffer and disables line editing."
  9449. msgstr "Si Bash encuentra esta variable en el entorno cuando el intérprete inicia con el valor @samp{t}, asume que el intéprete está corriendo en un intérpete de Emacs."
  9450. #. type: item
  9451. #: bashref.texi:5725
  9452. #, no-wrap
  9453. msgid "ENV"
  9454. msgstr ""
  9455. #. type: Plain text
  9456. #: bashref.texi:5728
  9457. msgid ""
  9458. "Similar to @code{BASH_ENV}; used when the shell is invoked in @sc{posix} "
  9459. "Mode (@pxref{Bash POSIX Mode})."
  9460. msgstr "Similar a @code{BASH_ENV}; usado cuando el intérprete es llamado en modo @sc{posix} (@pxref{Bash POSIX Mode})."
  9461. #. type: item
  9462. #: bashref.texi:5729
  9463. #, no-wrap
  9464. msgid "EUID"
  9465. msgstr ""
  9466. #. type: Plain text
  9467. #: bashref.texi:5732
  9468. msgid ""
  9469. "The numeric effective user id of the current user. This variable is "
  9470. "readonly."
  9471. msgstr "El identificador de usuario efectivo numérico del usuario actual. Esta variable es de solo lectura."
  9472. #. type: item
  9473. #: bashref.texi:5733
  9474. #, no-wrap
  9475. msgid "EXECIGNORE"
  9476. msgstr ""
  9477. #. type: Plain text
  9478. #: bashref.texi:5747
  9479. msgid ""
  9480. "A colon-separated list of shell patterns (@pxref{Pattern Matching}) "
  9481. "defining the list of filenames to be ignored by command search using "
  9482. "@code{PATH}. Files whose full pathnames match one of these patterns are not "
  9483. "considered executable files for the purposes of completion and command "
  9484. "execution via @code{PATH} lookup. This does not affect the behavior of the "
  9485. "@code{[}, @code{test}, and @code{[[} commands. Full pathnames in the "
  9486. "command hash table are not subject to @code{EXECIGNORE}. Use this variable "
  9487. "to ignore shared library files that have the executable bit set, but are not "
  9488. "executable files. The pattern matching honors the setting of the "
  9489. "@code{extglob} shell option."
  9490. msgstr "Una lista de patrones de intérprete separados por dos puntos (@pxref{Pattern Matching}) que definen la lista de nombres de archivo a ser ignorada por la orden de busqueda usando @code{PATH}. Los archivos cuyos nombres de ruta completos coinciden con alguno de estos patrones no son considerados archivos ejecutables para propósitos de completamiento y ejecución de ordenes para la búsqueda en @code{PATH}. Esto no afecta el comportamiento de las ordenes @code{[}, @code{test} y @code{[[}. Los nombres de ruta completos en la matríz asociativa de ordenes no son susceptibles a @code{EXECIGNORE}. Use esta variable para ignorar los archivos de bibliotecas compartidas que tienen el bit de ejecución asignado, pero que no son archivos ejecutables. El emparejamiento de patrones respeta la configuración de la opción de intréprete @code{extglob}."
  9491. #. type: item
  9492. #: bashref.texi:5748
  9493. #, no-wrap
  9494. msgid "FCEDIT"
  9495. msgstr ""
  9496. #. type: Plain text
  9497. #: bashref.texi:5751
  9498. msgid ""
  9499. "The editor used as a default by the @option{-e} option to the @code{fc} "
  9500. "builtin command."
  9501. msgstr "El editor usado por defecto por la opción @option{-e} a la orden integrada @code{fc}."
  9502. #. type: item
  9503. #: bashref.texi:5752
  9504. #, no-wrap
  9505. msgid "FIGNORE"
  9506. msgstr ""
  9507. #. type: Plain text
  9508. #: bashref.texi:5759
  9509. msgid ""
  9510. "A colon-separated list of suffixes to ignore when performing filename "
  9511. "completion. A filename whose suffix matches one of the entries in "
  9512. "@env{FIGNORE} is excluded from the list of matched filenames. A sample "
  9513. "value is @samp{.o:~}"
  9514. msgstr "Una lista de sufijos separados por dos puntos a ignorar cuando se efectue el completamiento de nombres de archivo. Un nombre de archivo cuyo sufijo coincida con una de las entradas en @env{FIGNORE} es excluido de la lista de nombres de archivo relacionados. Un valor de prueba es @samp{.o:~}"
  9515. #. type: item
  9516. #: bashref.texi:5760
  9517. #, no-wrap
  9518. msgid "FUNCNAME"
  9519. msgstr ""
  9520. #. type: Plain text
  9521. #: bashref.texi:5771
  9522. msgid ""
  9523. "An array variable containing the names of all shell functions currently in "
  9524. "the execution call stack. The element with index 0 is the name of any "
  9525. "currently-executing shell function. The bottom-most element (the one with "
  9526. "the highest index) is @code{\"main\"}. This variable exists only when a "
  9527. "shell function is executing. Assignments to @env{FUNCNAME} have no effect. "
  9528. "If @env{FUNCNAME} is unset, it loses its special properties, even if it is "
  9529. "subsequently reset."
  9530. msgstr "Una variable de arreglo que contiene los nombres de todas las funciones del intérprete que se encuentran en la pila de llamadas de ejecución. El elemento con índice 0 es el nombre de cualquier función de intérprete que se esté ejecutando. El último elemento (aquel con el índice mas grande) es @code{\\\"main\\\"}. Esta variable existe solo cuando una función de intérprete se está ejecutando. Las asignaciones a @env{FUNCNAME} no tienen efecto. Si @env{FUNCNAME} es desasignado, pierde sus propiedades especiales, incluso si es reiniciado subsecuentemente."
  9531. #. type: Plain text
  9532. #: bashref.texi:5779
  9533. msgid ""
  9534. "This variable can be used with @code{BASH_LINENO} and @code{BASH_SOURCE}. "
  9535. "Each element of @code{FUNCNAME} has corresponding elements in "
  9536. "@code{BASH_LINENO} and @code{BASH_SOURCE} to describe the call stack. For "
  9537. "instance, @code{$@{FUNCNAME[$i]@}} was called from the file "
  9538. "@code{$@{BASH_SOURCE[$i+1]@}} at line number @code{$@{BASH_LINENO[$i]@}}. "
  9539. "The @code{caller} builtin displays the current call stack using this "
  9540. "information."
  9541. msgstr "Esta variable puede ser usada con @code{BASH_LINENO} y @code{BASH_SOURCE}. Cada elemento de @code{FUNCNAME} tiene sus elementos correspondientes en @code{BASH_LINENO} y @code{BASH_SOURCE} para describir la pila de llamadas. Por instancia, @code{$@{FUNCNAME[$i]@}} fue llamado desde el archivo @code{$@{BASH_SOURCE[$i+1]@}} en la linea número @code{$@{BASH_LINENO[$i]@}}. El integrado @code{caller} muestra la pila de llamadas actual que usa esta información."
  9542. #. type: item
  9543. #: bashref.texi:5780
  9544. #, no-wrap
  9545. msgid "FUNCNEST"
  9546. msgstr ""
  9547. #. type: Plain text
  9548. #: bashref.texi:5784
  9549. msgid ""
  9550. "If set to a numeric value greater than 0, defines a maximum function nesting "
  9551. "level. Function invocations that exceed this nesting level will cause the "
  9552. "current command to abort."
  9553. msgstr "Si le es asignado un valor numérico mayor a 0, define un nivel máximo de incrustación de funciones. Llamadas de función que excedan este nivel de incrustación causarán que la orden actual sea abortada."
  9554. #. type: item
  9555. #: bashref.texi:5785
  9556. #, no-wrap
  9557. msgid "GLOBIGNORE"
  9558. msgstr ""
  9559. #. type: Plain text
  9560. #: bashref.texi:5793
  9561. msgid ""
  9562. "A colon-separated list of patterns defining the set of filenames to be "
  9563. "ignored by filename expansion. If a filename matched by a filename "
  9564. "expansion pattern also matches one of the patterns in @env{GLOBIGNORE}, it "
  9565. "is removed from the list of matches. The pattern matching honors the "
  9566. "setting of the @code{extglob} shell option."
  9567. msgstr "Una lista de patrones separada por dos puntos que definen el conjunto de nombres de archivo a ser ignorados por la expansion de nombres de archivo. Si un nombre de archivo que coincidió con un patrón de expansión también coincide con uno de los patrones en @env{GLOBIGNORE}, es removido de la lista de coincidencias. El emparejamiento de patrones respeta la configuración de la opción de intérprete @code{extglob}."
  9568. #. type: item
  9569. #: bashref.texi:5794
  9570. #, no-wrap
  9571. msgid "GROUPS"
  9572. msgstr ""
  9573. #. type: Plain text
  9574. #: bashref.texi:5800
  9575. msgid ""
  9576. "An array variable containing the list of groups of which the current user is "
  9577. "a member. Assignments to @env{GROUPS} have no effect. If @env{GROUPS} is "
  9578. "unset, it loses its special properties, even if it is subsequently reset."
  9579. msgstr "Una variable de arreglo que contiene la lista de grupos de los cuales el usuario actual es miembro. Las asiganciones a @env{GROUPS} no tienen efecto. Si @env{GROUPS} es desasignada, pierde sus propiedades especiales, incluso si es reiniciada subsecuentemente."
  9580. #. type: item
  9581. #: bashref.texi:5801
  9582. #, no-wrap
  9583. msgid "histchars"
  9584. msgstr ""
  9585. #. type: Plain text
  9586. #: bashref.texi:5814
  9587. msgid ""
  9588. "Up to three characters which control history expansion, quick substitution, "
  9589. "and tokenization (@pxref{History Interaction}). The first character is the "
  9590. "@var{history expansion} character, that is, the character which signifies "
  9591. "the start of a history expansion, normally @samp{!}. The second character "
  9592. "is the character which signifies `quick substitution' when seen as the first "
  9593. "character on a line, normally @samp{^}. The optional third character is the "
  9594. "character which indicates that the remainder of the line is a comment when "
  9595. "found as the first character of a word, usually @samp{#}. The history "
  9596. "comment character causes history substitution to be skipped for the "
  9597. "remaining words on the line. It does not necessarily cause the shell parser "
  9598. "to treat the rest of the line as a comment."
  9599. msgstr "Hasta tres caracteres que controlan la expansión del historial, la sustitución rápida y el enfichamiento (@pxref{History Interaction}). El primero es el caracter de @var{history_expansion}, que es, el caracter que significa el principio de una expansión del historial, normalmente @samp{!}. El segundo es el caracter que significa `sustitución rápida' cuando es visto como el primer caracter en una linea, normalmente @samp{^}. El tercer caracter opcional es el que indica que los restante de una linea es un comentario cuando es encontrado como el primer caracter de una palabra, usualmente @samp{#}. El caracter de comentario del historial ocasiona que la sustitución del historial sea saltada para las palabras restantes en la linea. No causa necesariamente que el analizador del intérprete trate el resto de la linea como un comentario."
  9600. #. type: item
  9601. #: bashref.texi:5815
  9602. #, no-wrap
  9603. msgid "HISTCMD"
  9604. msgstr ""
  9605. #. type: Plain text
  9606. #: bashref.texi:5819
  9607. msgid ""
  9608. "The history number, or index in the history list, of the current command. "
  9609. "If @env{HISTCMD} is unset, it loses its special properties, even if it is "
  9610. "subsequently reset."
  9611. msgstr "El número del historial, o índice en la lista del historial, de la orden actual. Si @env{HISTCMD} es desasignado, pierde sus propiedades especiales, incluso si es reiniciada subsecuentemente."
  9612. #. type: item
  9613. #: bashref.texi:5820
  9614. #, no-wrap
  9615. msgid "HISTCONTROL"
  9616. msgstr ""
  9617. #. type: Plain text
  9618. #: bashref.texi:5839
  9619. msgid ""
  9620. "A colon-separated list of values controlling how commands are saved on the "
  9621. "history list. If the list of values includes @samp{ignorespace}, lines "
  9622. "which begin with a space character are not saved in the history list. A "
  9623. "value of @samp{ignoredups} causes lines which match the previous history "
  9624. "entry to not be saved. A value of @samp{ignoreboth} is shorthand for "
  9625. "@samp{ignorespace} and @samp{ignoredups}. A value of @samp{erasedups} "
  9626. "causes all previous lines matching the current line to be removed from the "
  9627. "history list before that line is saved. Any value not in the above list is "
  9628. "ignored. If @env{HISTCONTROL} is unset, or does not include a valid value, "
  9629. "all lines read by the shell parser are saved on the history list, subject to "
  9630. "the value of @env{HISTIGNORE}. The second and subsequent lines of a multi-"
  9631. "line compound command are not tested, and are added to the history "
  9632. "regardless of the value of @env{HISTCONTROL}."
  9633. msgstr "Una lista de valores separados por dos puntos que controlan como las ordenes son salvados en la lista del historial. Si la lista de valores incluye @samp{ignorespace}, la lineas que inician con un caracter espacio no son salvadas en la lista del hitorial. Un valor de @samp{ignoredups} causa que las lineas que coinciden con las entradas anteriores del historial no sean salvadas. Un valor de @samp{ignoreboth} es una abreviación de @samp{ignorespace} y @samp{ignoredups}. Un valor de @samp{erasedups} ocasiona que todas las lineas previas que coinciden con la linea actual sean removidas de la lista del historial antes de que esa linea sea salvada. Cualquier valor que no se encuentre en la lista anterior es ignorado. Si @env{HISTCONTROL} es desasignado, o no incluye un valor válido, todas las lineas leidas por el analizador del intérprete son salvadas en la lista del historial, susceptible al valor de @env{HISTIGNORE}. La segunda linea y subsecuentes de una orden compuesta multi linea no son comprobadas y son agregadas al historial sin importar el valor de @env{HISTCONTROL}."
  9634. #. type: item
  9635. #: bashref.texi:5840
  9636. #, no-wrap
  9637. msgid "HISTFILE"
  9638. msgstr ""
  9639. #. type: Plain text
  9640. #: bashref.texi:5843
  9641. msgid ""
  9642. "The name of the file to which the command history is saved. The default "
  9643. "value is @file{~/.bash_history}."
  9644. msgstr "El nombre del archivo en el que será guardado el historial de ordenes. El valor por defecto es @file{~/.bash_history}."
  9645. #. type: item
  9646. #: bashref.texi:5844
  9647. #, no-wrap
  9648. msgid "HISTFILESIZE"
  9649. msgstr ""
  9650. #. type: Plain text
  9651. #: bashref.texi:5855
  9652. msgid ""
  9653. "The maximum number of lines contained in the history file. When this "
  9654. "variable is assigned a value, the history file is truncated, if necessary, "
  9655. "to contain no more than that number of lines by removing the oldest "
  9656. "entries. The history file is also truncated to this size after writing it "
  9657. "when a shell exits. If the value is 0, the history file is truncated to "
  9658. "zero size. Non-numeric values and numeric values less than zero inhibit "
  9659. "truncation. The shell sets the default value to the value of @env{HISTSIZE} "
  9660. "after reading any startup files."
  9661. msgstr "El número máximo de lineas contenidas en el archivo del historial. Cuando a esta variable se le asigna un valor, el historial es truncado, si es necesario, para no contener mas que el número de lineas removiendo las entradas mas antiguas. El archivo del historial también es truncado a este valor después de escribirlo cuando el intérprete sale. Si el valor es 0, el archivo del historial es truncado a tamaño cero. Valore no numéricos y valores numéricos menores a cero inhiben el truncamiento. El intérprete asigna el valor por defecto al valor de @env{HISTSIZE} después de leer cualquier archivo de inicialización."
  9662. #. type: item
  9663. #: bashref.texi:5856
  9664. #, no-wrap
  9665. msgid "HISTIGNORE"
  9666. msgstr ""
  9667. #. type: Plain text
  9668. #: bashref.texi:5871
  9669. msgid ""
  9670. "A colon-separated list of patterns used to decide which command lines should "
  9671. "be saved on the history list. Each pattern is anchored at the beginning of "
  9672. "the line and must match the complete line (no implicit @samp{*} is "
  9673. "appended). Each pattern is tested against the line after the checks "
  9674. "specified by @env{HISTCONTROL} are applied. In addition to the normal shell "
  9675. "pattern matching characters, @samp{&} matches the previous history line. "
  9676. "@samp{&} may be escaped using a backslash; the backslash is removed before "
  9677. "attempting a match. The second and subsequent lines of a multi-line "
  9678. "compound command are not tested, and are added to the history regardless of "
  9679. "the value of @env{HISTIGNORE}. The pattern matching honors the setting of "
  9680. "the @code{extglob} shell option."
  9681. msgstr "Una lista de patrones separada por dos puntos usada para decidir cual linea de ordenes debe ser salvada en el historial. Cada patron es anclado al principio de la linea y debe coindicir la linea completa (no es agregado un @samp{*} implícito). Cada patron es probado contra la linea después de las revisiones especificadas por @env{HISTCONTROL} son aplicadas. Adicionalmente a los caracteres de coincidencia de patrones normales del intérprete, @samp{&} relaciona las linea previa del historial. @samp{&} puede ser escapado usando una diagonal invertida; la diagonal invertida es removida antes de intentar el emparejamiento. La segunda y subsecuentes lineas de una orden compuesta multilinea no son probadas, y son agregadas al historial sin importar el valor de @env{HISTIGNORE}. La coincidencia de patrones respeta el asignamiento de la opción de intérprete @code{extglob}. "
  9682. #. type: Plain text
  9683. #: bashref.texi:5877
  9684. msgid ""
  9685. "@env{HISTIGNORE} subsumes the function of @env{HISTCONTROL}. A pattern of "
  9686. "@samp{&} is identical to @code{ignoredups}, and a pattern of @samp{[ ]*} is "
  9687. "identical to @code{ignorespace}. Combining these two patterns, separating "
  9688. "them with a colon, provides the functionality of @code{ignoreboth}."
  9689. msgstr "@env{HISTIGNORE} subsume la funcióm de @env{HISTCONTROL}. Un patrón de @samp{&} es identico a @code{ignoredups}, y un patrón de @samp{[ ]*} es identico a @code{ignorespace}. Combinar estos dos patrones, separandolos por dos puntos, proporciona la funcionalidad de @code{ignoreboth}.\n"
  9690. #. type: item
  9691. #: bashref.texi:5878
  9692. #, no-wrap
  9693. msgid "HISTSIZE"
  9694. msgstr ""
  9695. #. type: Plain text
  9696. #: bashref.texi:5884
  9697. msgid ""
  9698. "The maximum number of commands to remember on the history list. If the "
  9699. "value is 0, commands are not saved in the history list. Numeric values less "
  9700. "than zero result in every command being saved on the history list (there is "
  9701. "no limit). The shell sets the default value to 500 after reading any "
  9702. "startup files."
  9703. msgstr "El número máximo de ordenes a recordar en la lista del historial. Si el valor es 0, las ordenes no son salvadas en la lista del historial. Valores numéricos menores a cero ocasionan que cada orden sea salvada en la lista del historial (no hay límite). El intérprete asigna 500 como valor por defecto después de leer cualquier archivo de inicialización."
  9704. #. type: item
  9705. #: bashref.texi:5885
  9706. #, no-wrap
  9707. msgid "HISTTIMEFORMAT"
  9708. msgstr ""
  9709. #. type: Plain text
  9710. #: bashref.texi:5893
  9711. msgid ""
  9712. "If this variable is set and not null, its value is used as a format string "
  9713. "for @var{strftime} to print the time stamp associated with each history "
  9714. "entry displayed by the @code{history} builtin. If this variable is set, "
  9715. "time stamps are written to the history file so they may be preserved across "
  9716. "shell sessions. This uses the history comment character to distinguish "
  9717. "timestamps from other history lines."
  9718. msgstr "Si esta variable es asignada y no es núla, su valor es usado como cadena de formato por @var{strftime} para imprimir la estampa de tiempo asociada con cada entrada del historial mostrada por el integrado @code{history}. Si esta variable es asignada, las estampas de tiempo son escritas al archivo del historial para que puedan ser salvadas entre sesiones de intérprete. Esto usa el caracter de comentario del historial para distinguir estampas de tiempo de otras lineas del historial."
  9719. #. type: item
  9720. #: bashref.texi:5894
  9721. #, no-wrap
  9722. msgid "HOSTFILE"
  9723. msgstr ""
  9724. #. type: Plain text
  9725. #: bashref.texi:5906
  9726. msgid ""
  9727. "Contains the name of a file in the same format as @file{/etc/hosts} that "
  9728. "should be read when the shell needs to complete a hostname. The list of "
  9729. "possible hostname completions may be changed while the shell is running; the "
  9730. "next time hostname completion is attempted after the value is changed, Bash "
  9731. "adds the contents of the new file to the existing list. If @env{HOSTFILE} "
  9732. "is set, but has no value, or does not name a readable file, Bash attempts to "
  9733. "read @file{/etc/hosts} to obtain the list of possible hostname completions. "
  9734. "When @env{HOSTFILE} is unset, the hostname list is cleared."
  9735. msgstr "Contiene el nombre de un archivo de mismo formato que @file{/etc/hosts} que debe ser leido cuando el intérprete necesite completar un nombre de servidor. La lista de posibles completamientos de nombres de servidor puedes ser cambiada cuando el intérprete esta corriendo; la siguiente vez que se intente un completamiento de nombre de servidor después de que el valor sea cambiado, Bash agrega los contenidos de el nuevo archivo a la lista existente. Si @env{HOSTFILE} es asignada, pero no tiene un valor, o no menciona un archivo legible, Bash intenta leer @file{/etc/hosts} para obtener la lista de completamiento de nombres de servidor posibles. Cuando @env{HOSTFILE} es deasignado, la lista de nombres de servidor es limpiada."
  9736. #. type: item
  9737. #: bashref.texi:5907
  9738. #, no-wrap
  9739. msgid "HOSTNAME"
  9740. msgstr ""
  9741. #. type: Plain text
  9742. #: bashref.texi:5909
  9743. msgid "The name of the current host."
  9744. msgstr "El nombre del servidor actual."
  9745. #. type: item
  9746. #: bashref.texi:5910
  9747. #, no-wrap
  9748. msgid "HOSTTYPE"
  9749. msgstr ""
  9750. #. type: Plain text
  9751. #: bashref.texi:5912
  9752. msgid "A string describing the machine Bash is running on."
  9753. msgstr "Una cadena que describe la maquina en la que Bash está corriendo."
  9754. #. type: item
  9755. #: bashref.texi:5913
  9756. #, no-wrap
  9757. msgid "IGNOREEOF"
  9758. msgstr ""
  9759. #. type: Plain text
  9760. #: bashref.texi:5922
  9761. msgid ""
  9762. "Controls the action of the shell on receipt of an @code{EOF} character as "
  9763. "the sole input. If set, the value denotes the number of consecutive "
  9764. "@code{EOF} characters that can be read as the first character on an input "
  9765. "line before the shell will exit. If the variable exists but does not have a "
  9766. "numeric value (or has no value) then the default is 10. If the variable "
  9767. "does not exist, then @code{EOF} signifies the end of input to the shell. "
  9768. "This is only in effect for interactive shells."
  9769. msgstr "Controla la acción del intérprete cuando recibe un caracter @code{EOF} como única entrada. Si esta asignado, el valor denota el número de caracteres @code{EOF}consecutivos que pueden ser leidos como primer caracter en una linea entrada antes de que el intérprete salga. Si la variable existe pero no tiene un valor numérico (o no tiene valor) entonces el valor por defecto es 10. Si la variable no existe, entonces @code{EOF} significa el final de la entrada al intérprete. Esto solo tiene efecto en intérpretes interactivos."
  9770. #. type: item
  9771. #: bashref.texi:5923
  9772. #, no-wrap
  9773. msgid "INPUTRC"
  9774. msgstr ""
  9775. #. type: Plain text
  9776. #: bashref.texi:5926
  9777. msgid ""
  9778. "The name of the Readline initialization file, overriding the default of "
  9779. "@file{~/.inputrc}."
  9780. msgstr "El nombre del archivo de inicialización Readline, invalidando el valor por defecto @file{~/.inputrc}."
  9781. #. type: item
  9782. #: bashref.texi:5927
  9783. #, no-wrap
  9784. msgid "LANG"
  9785. msgstr ""
  9786. #. type: Plain text
  9787. #: bashref.texi:5930
  9788. msgid ""
  9789. "Used to determine the locale category for any category not specifically "
  9790. "selected with a variable starting with @code{LC_}."
  9791. msgstr "Usado para determinar la categoria local para cualquier categoria seleccionada no especificamente con una variable empezando con @code{LC_}."
  9792. #. type: item
  9793. #: bashref.texi:5931
  9794. #, no-wrap
  9795. msgid "LC_ALL"
  9796. msgstr ""
  9797. #. type: Plain text
  9798. #: bashref.texi:5934
  9799. msgid ""
  9800. "This variable overrides the value of @env{LANG} and any other @code{LC_} "
  9801. "variable specifying a locale category."
  9802. msgstr "Esta varibale invalída el valor de @env{LANG} y cualquier otra variable @code{LC_} especificando una categoria local."
  9803. #. type: item
  9804. #: bashref.texi:5935
  9805. #, no-wrap
  9806. msgid "LC_COLLATE"
  9807. msgstr ""
  9808. #. type: Plain text
  9809. #: bashref.texi:5941
  9810. msgid ""
  9811. "This variable determines the collation order used when sorting the results "
  9812. "of filename expansion, and determines the behavior of range expressions, "
  9813. "equivalence classes, and collating sequences within filename expansion and "
  9814. "pattern matching (@pxref{Filename Expansion})."
  9815. msgstr "Esta variable determina el orden de recopilación usado cuando se ordenan los resultados de la expansión de nombres de archivo, y determina el comportamiento de las expresiones de rango, clases de equivalencias, y secuencias de recopilación con expansión de nombres de archivo y coincidencia de patrones (@pxref{Filename Expansion})."
  9816. #. type: item
  9817. #: bashref.texi:5942
  9818. #, no-wrap
  9819. msgid "LC_CTYPE"
  9820. msgstr ""
  9821. #. type: Plain text
  9822. #: bashref.texi:5946
  9823. msgid ""
  9824. "This variable determines the interpretation of characters and the behavior "
  9825. "of character classes within filename expansion and pattern matching "
  9826. "(@pxref{Filename Expansion})."
  9827. msgstr "Esta variable determina la interpretación de caracteres y el comportamiento de las clases de caracteres con expansion de nombres de archivo y coincidencia de patrones (@pxref{Filname Expansion})."
  9828. #. type: Plain text
  9829. #: bashref.texi:5950
  9830. msgid ""
  9831. "This variable determines the locale used to translate double-quoted strings "
  9832. "preceded by a @samp{$} (@pxref{Locale Translation})."
  9833. msgstr "Esta variable determina el area local usada para traducir las cadenas entre comillas dobles precedidas por @samp{$} (@pxref{Local Translation})."
  9834. #. type: item
  9835. #: bashref.texi:5951
  9836. #, no-wrap
  9837. msgid "LC_NUMERIC"
  9838. msgstr ""
  9839. #. type: Plain text
  9840. #: bashref.texi:5953
  9841. msgid ""
  9842. "This variable determines the locale category used for number formatting."
  9843. msgstr "Esta variable determina la categoría del area local usada para el formateo numérico."
  9844. #. type: item
  9845. #: bashref.texi:5954
  9846. #, no-wrap
  9847. msgid "LC_TIME"
  9848. msgstr ""
  9849. #. type: Plain text
  9850. #: bashref.texi:5957
  9851. msgid ""
  9852. "This variable determines the locale category used for data and time "
  9853. "formatting."
  9854. msgstr "Esta variable determina la categoría de area local usada para el formateo de datos y el tiempo."
  9855. #. type: item
  9856. #: bashref.texi:5958
  9857. #, no-wrap
  9858. msgid "LINENO"
  9859. msgstr ""
  9860. #. type: Plain text
  9861. #: bashref.texi:5960
  9862. msgid "The line number in the script or shell function currently executing."
  9863. msgstr "El número de linea en el script o función de intérprete ejecutándose."
  9864. #. type: item
  9865. #: bashref.texi:5961
  9866. #, no-wrap
  9867. msgid "LINES"
  9868. msgstr ""
  9869. #. type: Plain text
  9870. #: bashref.texi:5967
  9871. msgid ""
  9872. "Used by the @code{select} command to determine the column length for "
  9873. "printing selection lists. Automatically set if the @code{checkwinsize} "
  9874. "option is enabled (@pxref{The Shopt Builtin}), or in an interactive shell "
  9875. "upon receipt of a @code{SIGWINCH}."
  9876. msgstr "Usado por la orden @code{select} para determinar el largo de la columna para imprimir listas de selección. Asignado automáticamente si la opción @code{checkwinsize} esta activa (@pxref{The Shopt Builtin}), o en un intérprete interactivo después de la recepción de un @code{SIGWINCH}."
  9877. #. type: item
  9878. #: bashref.texi:5968
  9879. #, no-wrap
  9880. msgid "MACHTYPE"
  9881. msgstr ""
  9882. #. type: Plain text
  9883. #: bashref.texi:5971
  9884. msgid ""
  9885. "A string that fully describes the system type on which Bash is executing, in "
  9886. "the standard @sc{gnu} @var{cpu-company-system} format."
  9887. msgstr "Una cadena que describe completamente el tipo de sistema en el que Bash esta siendo ejecutado, en el formato estandar @sc{gnu} @var{cpu-compañia-sistema}."
  9888. #. type: item
  9889. #: bashref.texi:5972
  9890. #, no-wrap
  9891. msgid "MAILCHECK"
  9892. msgstr ""
  9893. #. type: Plain text
  9894. #: bashref.texi:5979
  9895. msgid ""
  9896. "How often (in seconds) that the shell should check for mail in the files "
  9897. "specified in the @env{MAILPATH} or @env{MAIL} variables. The default is 60 "
  9898. "seconds. When it is time to check for mail, the shell does so before "
  9899. "displaying the primary prompt. If this variable is unset, or set to a value "
  9900. "that is not a number greater than or equal to zero, the shell disables mail "
  9901. "checking."
  9902. msgstr "Que tan seguido (en segundos) el intérprete debe buscar correo en los archivos especificados en las variables @env{MAILPATH} o @env{MAIL}. Por defecto son 60 segundos. Cuando es tiempo de buscar correo, el intérprete lo hace antes de mostrar el prompt primario. Si esta variable es desasignada, or asignada a un valor que no es mayor o igual a cero, el intérprete desactiva la revisión de correo."
  9903. #. type: item
  9904. #: bashref.texi:5980
  9905. #, no-wrap
  9906. msgid "MAPFILE"
  9907. msgstr ""
  9908. #. type: Plain text
  9909. #: bashref.texi:5983
  9910. msgid ""
  9911. "An array variable created to hold the text read by the @code{mapfile} "
  9912. "builtin when no variable name is supplied."
  9913. msgstr "Una variable de arreglo creada para mantener la lectura de texto por el integrado @code{mapfile} cuando no se proporciona un nombre de variable."
  9914. #. type: item
  9915. #: bashref.texi:5984
  9916. #, no-wrap
  9917. msgid "OLDPWD"
  9918. msgstr ""
  9919. #. type: Plain text
  9920. #: bashref.texi:5986
  9921. msgid "The previous working directory as set by the @code{cd} builtin."
  9922. msgstr "El directorio de trabajo previo como fue asignado por el integrado @code{cd}."
  9923. #. type: item
  9924. #: bashref.texi:5987
  9925. #, no-wrap
  9926. msgid "OPTERR"
  9927. msgstr ""
  9928. #. type: Plain text
  9929. #: bashref.texi:5990
  9930. msgid ""
  9931. "If set to the value 1, Bash displays error messages generated by the "
  9932. "@code{getopts} builtin command."
  9933. msgstr "Si se le asigna el valor de 1, Bash muestra mensajes de error generados por la orden integrada @code{getopts}."
  9934. #. type: item
  9935. #: bashref.texi:5991
  9936. #, no-wrap
  9937. msgid "OSTYPE"
  9938. msgstr ""
  9939. #. type: Plain text
  9940. #: bashref.texi:5993
  9941. msgid "A string describing the operating system Bash is running on."
  9942. msgstr "Una cadena que describe el sistema operativo en el que Bash esta corriendo."
  9943. #. type: item
  9944. #: bashref.texi:5994
  9945. #, no-wrap
  9946. msgid "PIPESTATUS"
  9947. msgstr ""
  9948. #. type: Plain text
  9949. #: bashref.texi:5999
  9950. msgid ""
  9951. "An array variable (@pxref{Arrays}) containing a list of exit status values "
  9952. "from the processes in the most-recently-executed foreground pipeline (which "
  9953. "may contain only a single command)."
  9954. msgstr "Una variable de arreglo (@pxref{Arrays}) que contiene una lista de los valores de los estados de salida de los procesos en la tuberia de primer plano ejecutada mas recientemente (que puede contener una sola orden)."
  9955. #. type: item
  9956. #: bashref.texi:6000
  9957. #, no-wrap
  9958. msgid "POSIXLY_CORRECT"
  9959. msgstr ""
  9960. #. type: Plain text
  9961. #: bashref.texi:6006
  9962. msgid ""
  9963. "If this variable is in the environment when Bash starts, the shell enters "
  9964. "@sc{posix} mode (@pxref{Bash POSIX Mode}) before reading the startup files, "
  9965. "as if the @option{--posix} invocation option had been supplied. If it is "
  9966. "set while the shell is running, Bash enables @sc{posix} mode, as if the "
  9967. "command"
  9968. msgstr "Si esta variable esta en el entorno cuando Bash inicia, el intérprete entra en modo @sc{posix} (@pxref{Bash POSIX Mode}) antes de leer los archivos de inicialización, como si la opción @option{--posix} hubiese sido proporcionada. Si es asignada cuando el intérprete esta corriendo, Bash activa el modo @sc{posix}, como si la orden"
  9969. #. type: example
  9970. #: bashref.texi:6008
  9971. #, no-wrap
  9972. msgid "@code{set -o posix}\n"
  9973. msgstr ""
  9974. #. type: Plain text
  9975. #: bashref.texi:6011
  9976. msgid "had been executed."
  9977. msgstr "hubiese sido ejecutada."
  9978. #. type: item
  9979. #: bashref.texi:6012
  9980. #, no-wrap
  9981. msgid "PPID"
  9982. msgstr ""
  9983. #. type: Plain text
  9984. #: bashref.texi:6015
  9985. msgid ""
  9986. "The process @sc{id} of the shell's parent process. This variable is "
  9987. "readonly."
  9988. msgstr "El @sc{id} de proceso del processo superior del intérprete. Esta variable es de solo lectura."
  9989. #. type: item
  9990. #: bashref.texi:6016
  9991. #, no-wrap
  9992. msgid "PROMPT_COMMAND"
  9993. msgstr ""
  9994. #. type: Plain text
  9995. #: bashref.texi:6019
  9996. msgid ""
  9997. "If set, the value is interpreted as a command to execute before the printing "
  9998. "of each primary prompt (@env{$PS1})."
  9999. msgstr "Si es asignada, el valor es interpretado como una orden a ejecutar antes de imprimir cada prompt primario (@env{$PS1})."
  10000. #. type: item
  10001. #: bashref.texi:6020
  10002. #, no-wrap
  10003. msgid "PROMPT_DIRTRIM"
  10004. msgstr ""
  10005. #. type: Plain text
  10006. #: bashref.texi:6025
  10007. msgid ""
  10008. "If set to a number greater than zero, the value is used as the number of "
  10009. "trailing directory components to retain when expanding the @code{\\w} and "
  10010. "@code{\\W} prompt string escapes (@pxref{Controlling the Prompt}). "
  10011. "Characters removed are replaced with an ellipsis."
  10012. msgstr "Si se le asigna un número mayor a cero, el valor es usado como el número de componentes de directorio de cola a retener cuando se expanden las cadenas de escape del prompt @code{\\\\w} y @code{\\\\W}(@pxref{Controlling the Prompt}). Los caracteres removidos son reemplazados con puntos suspensivos."
  10013. #. type: item
  10014. #: bashref.texi:6026
  10015. #, no-wrap
  10016. msgid "PS0"
  10017. msgstr ""
  10018. #. type: Plain text
  10019. #: bashref.texi:6030
  10020. msgid ""
  10021. "The value of this parameter is expanded like @var{PS1} and displayed by "
  10022. "interactive shells after reading a command and before the command is "
  10023. "executed."
  10024. msgstr "El valor de este parámetro es expandido como @var{PS1} y mostrado por intérpretes interactivos después de leer una orden y antes de que la orden sea ejecutada."
  10025. #. type: item
  10026. #: bashref.texi:6031
  10027. #, no-wrap
  10028. msgid "PS3"
  10029. msgstr ""
  10030. #. type: Plain text
  10031. #: bashref.texi:6035
  10032. msgid ""
  10033. "The value of this variable is used as the prompt for the @code{select} "
  10034. "command. If this variable is not set, the @code{select} command prompts "
  10035. "with @samp{#? }"
  10036. msgstr "El valor de esta variable es usado como el prompt para la orden @code{select}. Si esta variables no está asignada, la orden @code{select} muestra el prompt con @samp{#? }"
  10037. #. type: item
  10038. #: bashref.texi:6036
  10039. #, no-wrap
  10040. msgid "PS4"
  10041. msgstr ""
  10042. #. type: Plain text
  10043. #: bashref.texi:6042
  10044. msgid ""
  10045. "The value is the prompt printed before the command line is echoed when the "
  10046. "@option{-x} option is set (@pxref{The Set Builtin}). The first character of "
  10047. "@env{PS4} is replicated multiple times, as necessary, to indicate multiple "
  10048. "levels of indirection. The default is @samp{+ }."
  10049. msgstr "Su valor es el prompt imprimido antes de que la linea de ordenes sea repetida (eco) cuando la opción @option{-x} es asignada (@pxref{The Set Builtin}). El primer caracter de @env{PS4} es replicado múltiples veces, cuanto sea necesario, para indicar niveles múltiples de ambigüedad. El valor por defecto es @samp{+ }."
  10050. #. type: item
  10051. #: bashref.texi:6043
  10052. #, no-wrap
  10053. msgid "PWD"
  10054. msgstr ""
  10055. #. type: Plain text
  10056. #: bashref.texi:6045
  10057. msgid "The current working directory as set by the @code{cd} builtin."
  10058. msgstr "El directorio de trabajo actual como fue asigado por el integrado @code{cd}."
  10059. #. type: item
  10060. #: bashref.texi:6046
  10061. #, no-wrap
  10062. msgid "RANDOM"
  10063. msgstr ""
  10064. #. type: Plain text
  10065. #: bashref.texi:6050
  10066. msgid ""
  10067. "Each time this parameter is referenced, a random integer between 0 and 32767 "
  10068. "is generated. Assigning a value to this variable seeds the random number "
  10069. "generator."
  10070. msgstr "Cada vez que este parámetro es referenciado, un entero aleatorio entre 0 y 32767 es generado. Asignar un valor a esta variable proporciona un valor a la semilla del generador de números aleatorio."
  10071. #. type: item
  10072. #: bashref.texi:6051
  10073. #, no-wrap
  10074. msgid "READLINE_LINE"
  10075. msgstr ""
  10076. #. type: Plain text
  10077. #: bashref.texi:6054
  10078. msgid ""
  10079. "The contents of the Readline line buffer, for use with @samp{bind -x} "
  10080. "(@pxref{Bash Builtins})."
  10081. msgstr "Los contenidos del buffer de la linea de Readline, para su uso con @samp{bind -x} (@pxref{Bash Builtins})."
  10082. #. type: item
  10083. #: bashref.texi:6055
  10084. #, no-wrap
  10085. msgid "READLINE_POINT"
  10086. msgstr ""
  10087. #. type: Plain text
  10088. #: bashref.texi:6058
  10089. msgid ""
  10090. "The position of the insertion point in the Readline line buffer, for use "
  10091. "with @samp{bind -x} (@pxref{Bash Builtins})."
  10092. msgstr "La posición del punto de inserción en el buffer de la linea de Readline, oara su uso con @samp{bind -x} (@pxref{Bash Builtins})."
  10093. #. type: item
  10094. #: bashref.texi:6059
  10095. #, no-wrap
  10096. msgid "REPLY"
  10097. msgstr ""
  10098. #. type: Plain text
  10099. #: bashref.texi:6061
  10100. msgid "The default variable for the @code{read} builtin."
  10101. msgstr "La variable por defecto para el integrado @code{read}."
  10102. #. type: item
  10103. #: bashref.texi:6062
  10104. #, no-wrap
  10105. msgid "SECONDS"
  10106. msgstr ""
  10107. #. type: Plain text
  10108. #: bashref.texi:6068
  10109. msgid ""
  10110. "This variable expands to the number of seconds since the shell was started. "
  10111. "Assignment to this variable resets the count to the value assigned, and the "
  10112. "expanded value becomes the value assigned plus the number of seconds since "
  10113. "the assignment."
  10114. msgstr "Esta variable se expande al número de segundos desde que el intérprete inició. Asignamientos a esta variable reinicia la cuenta al valor asignado, y el valor expandido se convierte en el valor asignado mas el número en segundos desde el asignamiento."
  10115. #. type: item
  10116. #: bashref.texi:6069
  10117. #, no-wrap
  10118. msgid "SHELL"
  10119. msgstr ""
  10120. #. type: Plain text
  10121. #: bashref.texi:6073
  10122. msgid ""
  10123. "The full pathname to the shell is kept in this environment variable. If it "
  10124. "is not set when the shell starts, Bash assigns to it the full pathname of "
  10125. "the current user's login shell."
  10126. msgstr "La nombre de ruta completo al intérprete es mantenido en esta variable de entorno. Si no es asignada cuando el intéprete inicia, Bash la asigna al nombre de ruta completo del intérprete de inicio de sesión del usuario actual."
  10127. #. type: item
  10128. #: bashref.texi:6074
  10129. #, no-wrap
  10130. msgid "SHELLOPTS"
  10131. msgstr ""
  10132. #. type: Plain text
  10133. #: bashref.texi:6083
  10134. msgid ""
  10135. "A colon-separated list of enabled shell options. Each word in the list is a "
  10136. "valid argument for the @option{-o} option to the @code{set} builtin command "
  10137. "(@pxref{The Set Builtin}). The options appearing in @env{SHELLOPTS} are "
  10138. "those reported as @samp{on} by @samp{set -o}. If this variable is in the "
  10139. "environment when Bash starts up, each shell option in the list will be "
  10140. "enabled before reading any startup files. This variable is readonly."
  10141. msgstr "Una lista de opciones de intérprete separada por dos puntos. Cada palabra en la lista es un parámetro válido para la opción @option{-o} para la orden integrada @code{set} (@pxref{The Set Builtin}). Las opciones que aparecen en @env{SHELLOPTS} son aquellas reportadas como @samp{on} por @samp{set -o}. Si esta variable esta en el entorno cuando Bash inicia. cada opción de intérprete en la lista será activada antes de leer cualquier archivo de inicialización. Esta variable es de solo lectura."
  10142. #. type: item
  10143. #: bashref.texi:6084
  10144. #, no-wrap
  10145. msgid "SHLVL"
  10146. msgstr ""
  10147. #. type: Plain text
  10148. #: bashref.texi:6087
  10149. msgid ""
  10150. "Incremented by one each time a new instance of Bash is started. This is "
  10151. "intended to be a count of how deeply your Bash shells are nested."
  10152. msgstr "Incrementa en uno cada vez que una nueva instancia de Bash es iniciada. Esto está pensado para ser una cuenta de que tan profundo tus intérpretes de Bash están anidados."
  10153. #. type: item
  10154. #: bashref.texi:6088
  10155. #, no-wrap
  10156. msgid "TIMEFORMAT"
  10157. msgstr ""
  10158. #. type: Plain text
  10159. #: bashref.texi:6097
  10160. msgid ""
  10161. "The value of this parameter is used as a format string specifying how the "
  10162. "timing information for pipelines prefixed with the @code{time} reserved word "
  10163. "should be displayed. The @samp{%} character introduces an escape sequence "
  10164. "that is expanded to a time value or other information. The escape sequences "
  10165. "and their meanings are as follows; the braces denote optional portions."
  10166. msgstr "El valor de este parametro es usado como una cadena de formato que especifica como se debe mostrar la información del tiempo para las tuberias que tienen de prefijo la palabra reservada @code{time}. El caracter @samp{%} inserta una secuencia de escape que es expandida a un valor de tiempo o otra información. Las secuencias de escape y sus significados son del siguiente modo; los corchetes indican porciones opcionales."
  10167. #. type: item
  10168. #: bashref.texi:6100
  10169. #, no-wrap
  10170. msgid "%%"
  10171. msgstr ""
  10172. #. type: table
  10173. #: bashref.texi:6102
  10174. msgid "A literal @samp{%}."
  10175. msgstr "Literalmente un @samp{%}."
  10176. #. type: item
  10177. #: bashref.texi:6103
  10178. #, no-wrap
  10179. msgid "%[@var{p}][l]R"
  10180. msgstr ""
  10181. #. type: table
  10182. #: bashref.texi:6105
  10183. msgid "The elapsed time in seconds."
  10184. msgstr "El tiempo trnascurrido en segundos."
  10185. #. type: item
  10186. #: bashref.texi:6106
  10187. #, no-wrap
  10188. msgid "%[@var{p}][l]U"
  10189. msgstr ""
  10190. #. type: table
  10191. #: bashref.texi:6108
  10192. msgid "The number of CPU seconds spent in user mode."
  10193. msgstr "El número de segundos del CPU gastados en modo usuario."
  10194. #. type: item
  10195. #: bashref.texi:6109
  10196. #, no-wrap
  10197. msgid "%[@var{p}][l]S"
  10198. msgstr ""
  10199. #. type: table
  10200. #: bashref.texi:6111
  10201. msgid "The number of CPU seconds spent in system mode."
  10202. msgstr "El número de segundos del CPU gastados en modo sistema."
  10203. #. type: item
  10204. #: bashref.texi:6112
  10205. #, no-wrap
  10206. msgid "%P"
  10207. msgstr ""
  10208. #. type: table
  10209. #: bashref.texi:6114
  10210. msgid "The CPU percentage, computed as (%U + %S) / %R."
  10211. msgstr "El porcentaje del CPU, calculado como (%U + %S) / %R."
  10212. #. type: Plain text
  10213. #: bashref.texi:6122
  10214. msgid ""
  10215. "The optional @var{p} is a digit specifying the precision, the number of "
  10216. "fractional digits after a decimal point. A value of 0 causes no decimal "
  10217. "point or fraction to be output. At most three places after the decimal "
  10218. "point may be specified; values of @var{p} greater than 3 are changed to 3. "
  10219. "If @var{p} is not specified, the value 3 is used."
  10220. msgstr "La opcional @var{p} es un dígito que especifíca la precisión, el número de dígitos fraccionales después de un punto decimal. Un valor de 0 ocasiona que no se regrese un valor decimal o fraccionario. Como máximo tres lugares despues del punto decimal pueden ser especificadas; valores de @var{p} mayores a 3 son cambiados a 3. Si @var{p} no es especificada, el valor 3 es usado."
  10221. #. type: Plain text
  10222. #: bashref.texi:6126
  10223. msgid ""
  10224. "The optional @code{l} specifies a longer format, including minutes, of the "
  10225. "form @var{MM}m@var{SS}.@var{FF}s. The value of @var{p} determines whether "
  10226. "or not the fraction is included."
  10227. msgstr "La opcional @code{l} especifíca un formato mas largo, incluyendo minutos, de la forma @var{MM}m@var{SS}.@var{FF}s. El valor de @var{p} determina si la fracción es incluida o no."
  10228. #. type: Plain text
  10229. #: bashref.texi:6128
  10230. msgid "If this variable is not set, Bash acts as if it had the value"
  10231. msgstr "Si esta variable no es asignada, Bash actua como si tuviera el valor"
  10232. #. type: example
  10233. #: bashref.texi:6130
  10234. #, no-wrap
  10235. msgid "@code{$'\\nreal\\t%3lR\\nuser\\t%3lU\\nsys\\t%3lS'}\n"
  10236. msgstr ""
  10237. #. type: Plain text
  10238. #: bashref.texi:6133
  10239. msgid ""
  10240. "If the value is null, no timing information is displayed. A trailing "
  10241. "newline is added when the format string is displayed."
  10242. msgstr "Si su valor es nulo, no se muestra información del tiempo. Un salto de linea al final es agregado cuando la cadena de formato es mostrada."
  10243. #. type: item
  10244. #: bashref.texi:6134
  10245. #, no-wrap
  10246. msgid "TMOUT"
  10247. msgstr ""
  10248. #. type: Plain text
  10249. #: bashref.texi:6140
  10250. msgid ""
  10251. "If set to a value greater than zero, @code{TMOUT} is treated as the default "
  10252. "timeout for the @code{read} builtin (@pxref{Bash Builtins}). The "
  10253. "@code{select} command (@pxref{Conditional Constructs}) terminates if input "
  10254. "does not arrive after @code{TMOUT} seconds when input is coming from a "
  10255. "terminal."
  10256. msgstr "Si es asignado un valor mayor que cero, @code{TMOUT} es tratadi como el tiempo muerto por defecto para el integrado @code{read} (@pxref{Bash Builtins}). La orden @code{select} (@pxref{Conditional Constructs}) termina si la entrada no llega después de @code{TMOUT} segundos cuando la entrada llega desde una terminal.\n\n"
  10257. #. type: Plain text
  10258. #: bashref.texi:6147
  10259. msgid ""
  10260. "In an interactive shell, the value is interpreted as the number of seconds "
  10261. "to wait for a line of input after issuing the primary prompt. Bash "
  10262. "terminates after waiting for that number of seconds if a complete line of "
  10263. "input does not arrive."
  10264. msgstr "En un intérprete interactivo, el valor es interpretado como el número de segundos a esperar una linea de entrada despues de que se emita el prompt primario. Bash termina despues de esperar ese número de segundos si una linea completa de entrada no llega."
  10265. #. type: item
  10266. #: bashref.texi:6148
  10267. #, no-wrap
  10268. msgid "TMPDIR"
  10269. msgstr ""
  10270. #. type: Plain text
  10271. #: bashref.texi:6151
  10272. msgid ""
  10273. "If set, Bash uses its value as the name of a directory in which Bash creates "
  10274. "temporary files for the shell's use."
  10275. msgstr "Si es asignada, Bash usa su valor como el nombre del directorio en el cual Bash crea archivos temporales para el uso del intérprete."
  10276. #. type: item
  10277. #: bashref.texi:6152
  10278. #, no-wrap
  10279. msgid "UID"
  10280. msgstr ""
  10281. #. type: Plain text
  10282. #: bashref.texi:6154
  10283. msgid ""
  10284. "The numeric real user id of the current user. This variable is readonly."
  10285. msgstr "El identificador de usuario numérico real del usuario actual. Esta variable es de solo lectura."
  10286. #. type: Plain text
  10287. #: bashref.texi:6161
  10288. msgid "This chapter describes features unique to Bash."
  10289. msgstr "Este capítuo describe características únicas de Bash."
  10290. #. type: section
  10291. #: bashref.texi:6177 bashref.texi:6179 bashref.texi:6180
  10292. #, no-wrap
  10293. msgid "Invoking Bash"
  10294. msgstr "Llamando a Bash"
  10295. #. type: menuentry
  10296. #: bashref.texi:6177
  10297. msgid "Command line options that you can give to Bash."
  10298. msgstr ""
  10299. #. type: section
  10300. #: bashref.texi:6177 bashref.texi:6338 bashref.texi:6339
  10301. #, no-wrap
  10302. msgid "Bash Startup Files"
  10303. msgstr ""
  10304. #. type: menuentry
  10305. #: bashref.texi:6177
  10306. msgid "When and how Bash executes scripts."
  10307. msgstr ""
  10308. #. type: section
  10309. #: bashref.texi:6177 bashref.texi:6456 bashref.texi:6457
  10310. #, no-wrap
  10311. msgid "Interactive Shells"
  10312. msgstr ""
  10313. #. type: menuentry
  10314. #: bashref.texi:6177
  10315. msgid "What an interactive shell is."
  10316. msgstr ""
  10317. #. type: section
  10318. #: bashref.texi:6177 bashref.texi:6614 bashref.texi:6615
  10319. #, no-wrap
  10320. msgid "Bash Conditional Expressions"
  10321. msgstr ""
  10322. #. type: menuentry
  10323. #: bashref.texi:6177
  10324. msgid "Primitives used in composing expressions for the @code{test} builtin."
  10325. msgstr ""
  10326. #. type: section
  10327. #: bashref.texi:6177 bashref.texi:6763 bashref.texi:6764
  10328. #, no-wrap
  10329. msgid "Shell Arithmetic"
  10330. msgstr ""
  10331. #. type: menuentry
  10332. #: bashref.texi:6177
  10333. msgid "Arithmetic on shell variables."
  10334. msgstr ""
  10335. #. type: section
  10336. #: bashref.texi:6177 bashref.texi:6870 bashref.texi:6871
  10337. #, no-wrap
  10338. msgid "Aliases"
  10339. msgstr ""
  10340. #. type: menuentry
  10341. #: bashref.texi:6177
  10342. msgid "Substituting one command for another."
  10343. msgstr ""
  10344. #. type: section
  10345. #: bashref.texi:6177 bashref.texi:6930 bashref.texi:6931
  10346. #, no-wrap
  10347. msgid "Arrays"
  10348. msgstr ""
  10349. #. type: menuentry
  10350. #: bashref.texi:6177
  10351. msgid "Array Variables."
  10352. msgstr ""
  10353. #. type: section
  10354. #: bashref.texi:6177 bashref.texi:7067 bashref.texi:7068
  10355. #, no-wrap
  10356. msgid "The Directory Stack"
  10357. msgstr ""
  10358. #. type: menuentry
  10359. #: bashref.texi:6177
  10360. msgid "History of visited directories."
  10361. msgstr ""
  10362. #. type: section
  10363. #: bashref.texi:6177 bashref.texi:7179 bashref.texi:7180
  10364. #, no-wrap
  10365. msgid "Controlling the Prompt"
  10366. msgstr ""
  10367. #. type: menuentry
  10368. #: bashref.texi:6177
  10369. msgid "Customizing the various prompt strings."
  10370. msgstr ""
  10371. #. type: section
  10372. #: bashref.texi:6177 bashref.texi:7265 bashref.texi:7266
  10373. #, no-wrap
  10374. msgid "The Restricted Shell"
  10375. msgstr ""
  10376. #. type: menuentry
  10377. #: bashref.texi:6177
  10378. msgid "A more controlled mode of shell execution."
  10379. msgstr ""
  10380. #. type: section
  10381. #: bashref.texi:6177 bashref.texi:7319 bashref.texi:7320
  10382. #, no-wrap
  10383. msgid "Bash POSIX Mode"
  10384. msgstr ""
  10385. #. type: menuentry
  10386. #: bashref.texi:6177
  10387. msgid "Making Bash behave more closely to what the POSIX standard specifies."
  10388. msgstr ""
  10389. #. type: example
  10390. #: bashref.texi:6186
  10391. #, no-wrap
  10392. msgid ""
  10393. "bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @var{option}] [-O @var{shopt_option}] [@var{argument} @dots{}]\n"
  10394. "bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @var{option}] [-O @var{shopt_option}] -c @var{string} [@var{argument} @dots{}]\n"
  10395. "bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @var{option}] [-O @var{shopt_option}] [@var{argument} @dots{}]\n"
  10396. msgstr ""
  10397. #. type: Plain text
  10398. #: bashref.texi:6193
  10399. msgid ""
  10400. "All of the single-character options used with the @code{set} builtin "
  10401. "(@pxref{The Set Builtin}) can be used as options when the shell is invoked. "
  10402. "In addition, there are several multi-character options that you can use. "
  10403. "These options must appear on the command line before the single-character "
  10404. "options to be recognized."
  10405. msgstr ""
  10406. "Todas las opciones de un caracter usadas con el @code{} integrado"
  10407. "(@pxref{The Set Builtin}) pueden ser usadas como opciones cuando el interprete"
  10408. "es llamado. Adicionalmente, existen varias opciones multi-caracter que puede usar. "
  10409. "Estas opciones deben aparecer en la línea de comandos antes de las opciones de un "
  10410. "caracter para ser reconocidas."
  10411. #. type: item
  10412. #: bashref.texi:6195
  10413. #, no-wrap
  10414. msgid "--debugger"
  10415. msgstr ""
  10416. #. type: table
  10417. #: bashref.texi:6200
  10418. msgid ""
  10419. "Arrange for the debugger profile to be executed before the shell starts. "
  10420. "Turns on extended debugging mode (see @ref{The Shopt Builtin} for a "
  10421. "description of the @code{extdebug} option to the @code{shopt} builtin)."
  10422. msgstr ""
  10423. "
  10424. #. type: item
  10425. #: bashref.texi:6201
  10426. #, no-wrap
  10427. msgid "--dump-po-strings"
  10428. msgstr ""
  10429. #. type: table
  10430. #: bashref.texi:6206
  10431. msgid ""
  10432. "A list of all double-quoted strings preceded by @samp{$} is printed on the "
  10433. "standard output in the @sc{gnu} @code{gettext} PO (portable object) file "
  10434. "format. Equivalent to @option{-D} except for the output format."
  10435. msgstr ""
  10436. "Muestra una lista de todas las cadenas entre comillas dobles precedidas por "
  10437. "@samp{$} en la salida estándar en el formato de archivo de @sc{gnu} @code{gettext}"
  10438. " PO (objeto portable). Equivalente a la opción @option{-D} excepto por el formato "
  10439. "de salida."
  10440. #. type: item
  10441. #: bashref.texi:6207
  10442. #, no-wrap
  10443. msgid "--dump-strings"
  10444. msgstr ""
  10445. #. type: table
  10446. #: bashref.texi:6209
  10447. msgid "Equivalent to @option{-D}."
  10448. msgstr "Equivalente a @option{-D}."
  10449. #. type: item
  10450. #: bashref.texi:6210 bashref.texi:8140
  10451. #, no-wrap
  10452. msgid "--help"
  10453. msgstr ""
  10454. #. type: table
  10455. #: bashref.texi:6212
  10456. msgid "Display a usage message on standard output and exit successfully."
  10457. msgstr "Muestra un mensaje de uso en la salida estandar y sale exitosamente."
  10458. #. type: item
  10459. #: bashref.texi:6213
  10460. #, no-wrap
  10461. msgid "--init-file @var{filename}"
  10462. msgstr ""
  10463. #. type: itemx
  10464. #: bashref.texi:6214
  10465. #, no-wrap
  10466. msgid "--rcfile @var{filename}"
  10467. msgstr ""
  10468. #. type: table
  10469. #: bashref.texi:6217
  10470. msgid ""
  10471. "Execute commands from @var{filename} (instead of @file{~/.bashrc}) in an "
  10472. "interactive shell."
  10473. msgstr ""
  10474. "Ejecuta ordenes desde @var{filename} (en lugar de @file{~/.bashrc}) en un "
  10475. "intérprete interactivo."
  10476. #. type: item
  10477. #: bashref.texi:6218
  10478. #, no-wrap
  10479. msgid "--login"
  10480. msgstr ""
  10481. #. type: table
  10482. #: bashref.texi:6220
  10483. msgid "Equivalent to @option{-l}."
  10484. msgstr "Equivalente a @option{-l}."
  10485. #. type: item
  10486. #: bashref.texi:6221
  10487. #, no-wrap
  10488. msgid "--noediting"
  10489. msgstr ""
  10490. #. type: table
  10491. #: bashref.texi:6224
  10492. msgid ""
  10493. "Do not use the @sc{gnu} Readline library (@pxref{Command Line Editing}) to "
  10494. "read command lines when the shell is interactive."
  10495. msgstr ""
  10496. "No usa la biblioteca @sc{gnu} Readline (@pxref{Command Line Editing}) para "
  10497. "leer lineas de ordenes cuando el intérprete es interactivo."
  10498. #. type: item
  10499. #: bashref.texi:6225
  10500. #, no-wrap
  10501. msgid "--noprofile"
  10502. msgstr ""
  10503. #. type: table
  10504. #: bashref.texi:6230
  10505. msgid ""
  10506. "Don't load the system-wide startup file @file{/etc/profile} or any of the "
  10507. "personal initialization files @file{~/.bash_profile}, @file{~/.bash_login}, "
  10508. "or @file{~/.profile} when Bash is invoked as a login shell."
  10509. msgstr ""
  10510. "No carga el archivo general de inicio @file{/etc/profile} o cualquiera de "
  10511. "los archivos de inicialización personales @file{~/.bash_profile},
  10512. "@file{~/.bash_login} o @file{~/.profile} cuando Bash es llamado como un
  10513. "intérprete de inicio de sesión."
  10514. #. type: item
  10515. #: bashref.texi:6231
  10516. #, no-wrap
  10517. msgid "--norc"
  10518. msgstr ""
  10519. #. type: table
  10520. #: bashref.texi:6235
  10521. msgid ""
  10522. "Don't read the @file{~/.bashrc} initialization file in an interactive "
  10523. "shell. This is on by default if the shell is invoked as @code{sh}."
  10524. msgstr ""
  10525. "No leé el archivo de inicialización @file{~/.bashrc} en un intérprete "
  10526. "interactivo. Esto está activo por defecto si el intérprete es llamado "
  10527. "como @code{sh}."
  10528. #. type: item
  10529. #: bashref.texi:6236
  10530. #, no-wrap
  10531. msgid "--posix"
  10532. msgstr ""
  10533. #. type: table
  10534. #: bashref.texi:6242
  10535. msgid ""
  10536. "Change the behavior of Bash where the default operation differs from the "
  10537. "@sc{posix} standard to match the standard. This is intended to make Bash "
  10538. "behave as a strict superset of that standard. @xref{Bash POSIX Mode}, for a "
  10539. "description of the Bash @sc{posix} mode."
  10540. msgstr ""
  10541. "Cambia el comportamiento de Bash donde su operación difiere del estandar "
  10542. "@sc{posix} para que corresponda al estandar. Esto está pensado para hacer "
  10543. "que Bash se comporte como un superconjunto de ese estandar. "
  10544. "@xref{Bash POSIX Mode}, para una descripción del modo @sc{posix} de Bash."
  10545. #. type: item
  10546. #: bashref.texi:6243
  10547. #, no-wrap
  10548. msgid "--restricted"
  10549. msgstr ""
  10550. #. type: table
  10551. #: bashref.texi:6245 bashref.texi:6284
  10552. msgid "Make the shell a restricted shell (@pxref{The Restricted Shell})."
  10553. msgstr "Hace del intérprete un intérprete restringido (@pxref{The Restricted Shell})."
  10554. #. type: item
  10555. #: bashref.texi:6246
  10556. #, no-wrap
  10557. msgid "--verbose"
  10558. msgstr ""
  10559. #. type: table
  10560. #: bashref.texi:6248
  10561. msgid "Equivalent to @option{-v}. Print shell input lines as they're read."
  10562. msgstr "Equivalente a @option{-v}. Imprime las lineas de entrada del intérprete conforme son leídas."
  10563. #. type: item
  10564. #: bashref.texi:6249 bashref.texi:8152
  10565. #, no-wrap
  10566. msgid "--version"
  10567. msgstr ""
  10568. #. type: table
  10569. #: bashref.texi:6252
  10570. msgid ""
  10571. "Show version information for this instance of Bash on the standard output "
  10572. "and exit successfully."
  10573. msgstr ""
  10574. "Muestra información de esta instancia de Bash en la salida estandar y sale "
  10575. "exitosamente."
  10576. #. type: Plain text
  10577. #: bashref.texi:6256
  10578. msgid ""
  10579. "There are several single-character options that may be supplied at "
  10580. "invocation which are not available with the @code{set} builtin."
  10581. msgstr ""
  10582. "Hay varias opciones de un caracter que pueden ser proporcionadas en "
  10583. "la llamada que no están disponibles con el @code{set} integrado."
  10584. #. type: table
  10585. #: bashref.texi:6266
  10586. msgid ""
  10587. "Read and execute commands from the first non-option argument "
  10588. "@var{command_string}, then exit. If there are arguments after the "
  10589. "@var{command_string}, the first argument is assigned to @code{$0} and any "
  10590. "remaining arguments are assigned to the positional parameters. The "
  10591. "assignment to @code{$0} sets the name of the shell, which is used in warning "
  10592. "and error messages."
  10593. msgstr ""
  10594. "Leé y ejecuta ordenes desde el primer argumento que no es opción "
  10595. "@var{command_string}, luego sale. Si hay parámetros despues de "
  10596. "@var{command_string}, el primer parámetro es asignado a @code{$0} y cualquier "
  10597. "parámetro restante es asignado a los parámetros posicionales. La asignación "
  10598. "a @code{$0} fija el nombre del intérprete, que es usado en mensajes de error "
  10599. "y de advertencia."
  10600. #. type: table
  10601. #: bashref.texi:6270
  10602. msgid ""
  10603. "Force the shell to run interactively. Interactive shells are described in "
  10604. "@ref{Interactive Shells}."
  10605. msgstr ""
  10606. "Fuerza al intérprete a correr interactivamente. Los intérpretes intercativos "
  10607. "se describen en @ref{Interactive Shells}."
  10608. #. type: table
  10609. #: bashref.texi:6281
  10610. msgid ""
  10611. "Make this shell act as if it had been directly invoked by login. When the "
  10612. "shell is interactive, this is equivalent to starting a login shell with "
  10613. "@samp{exec -l bash}. When the shell is not interactive, the login shell "
  10614. "startup files will be executed. @samp{exec bash -l} or @samp{exec bash --"
  10615. "login} will replace the current shell with a Bash login shell. @xref{Bash "
  10616. "Startup Files}, for a description of the special behavior of a login shell."
  10617. msgstr ""
  10618. "Hace actuar al intérprete como si hubiese sido llamado directamente por login. "
  10619. "Cuando el intérprete es interactivo, esto es equivalente a iniciar un intérprete "
  10620. "de início de sesión con @samp{exec -l bash}. Cuando el intérprete no es "
  10621. "interactivo, los archivos de inicio del intérprete de inicio de sesión serán "
  10622. "ejecutados. @samp{exec bash -l} o @samp{exec bash --login} reemplazarán el "
  10623. "intérprete actual con uno de inicio de sesión de Bash. @xref{Bash Startup Files},"
  10624. ", para una descripcion del comportamiento especial de un intérprete de inicio de "
  10625. "sesión."
  10626. #. type: table
  10627. #: bashref.texi:6290
  10628. msgid ""
  10629. "If this option is present, or if no arguments remain after option "
  10630. "processing, then commands are read from the standard input. This option "
  10631. "allows the positional parameters to be set when invoking an interactive "
  10632. "shell."
  10633. msgstr ""
  10634. "Si esta opción está presente, o si no hay parámetros despues del procesamiento "
  10635. "de opciones, las ordenes son leídas desde la entrada estandar. Esta opción "
  10636. "permite fijar los parámetros posicionales cuando se está llamando a un intérprete "
  10637. "interactivo."
  10638. #. type: item
  10639. #: bashref.texi:6291
  10640. #, no-wrap
  10641. msgid "-D"
  10642. msgstr ""
  10643. #. type: table
  10644. #: bashref.texi:6298
  10645. msgid ""
  10646. "A list of all double-quoted strings preceded by @samp{$} is printed on the "
  10647. "standard output. These are the strings that are subject to language "
  10648. "translation when the current locale is not @code{C} or @code{POSIX} "
  10649. "(@pxref{Locale Translation}). This implies the @option{-n} option; no "
  10650. "commands will be executed."
  10651. msgstr ""
  10652. "Muestra una lista de todas las cadenas entre comillas dobles precedidas por "
  10653. "@samp{$} en la salida estándar. Estas son las cadenas que están sujetas a la "
  10654. "traducción de lenguaje cuando el locale actual no es @code{C} o @code{POSIX} "
  10655. "(@pxref{Locale Translation}). Esto implica la opcion @option{-n}; ninguna "
  10656. "orden será ejecutada."
  10657. #. type: item
  10658. #: bashref.texi:6299
  10659. #, no-wrap
  10660. msgid "[-+]O [@var{shopt_option}]"
  10661. msgstr ""
  10662. #. type: table
  10663. #: bashref.texi:6308
  10664. msgid ""
  10665. "@var{shopt_option} is one of the shell options accepted by the @code{shopt} "
  10666. "builtin (@pxref{The Shopt Builtin}). If @var{shopt_option} is present, "
  10667. "@option{-O} sets the value of that option; @option{+O} unsets it. If "
  10668. "@var{shopt_option} is not supplied, the names and values of the shell "
  10669. "options accepted by @code{shopt} are printed on the standard output. If the "
  10670. "invocation option is @option{+O}, the output is displayed in a format that "
  10671. "may be reused as input."
  10672. msgstr ""
  10673. "@var{shopt_option} es una de las opciones del intérprete aceptadas por el "
  10674. "integrado @code{shopt} (@pxref{The Shopt Builtin}). Si @var{shopt_option} "
  10675. "está presente, @option{-O} asigna el valor de esa opción; @option{+O} lo "
  10676. "desasigna. Si @var{shopt_option} no es proporcionado, los nombres y valores "
  10677. "de las opciones del intérprete aceptadas por @code{shopt} son mostradas en la "
  10678. "salida estandar. Si las opción de llamada es @option{+O}, la salida se muetra "
  10679. "en un formato que puede ser reutilizado como entrada."
  10680. #. type: table
  10681. #: bashref.texi:6313
  10682. msgid ""
  10683. "A @code{--} signals the end of options and disables further option "
  10684. "processing. Any arguments after the @code{--} are treated as filenames and "
  10685. "arguments."
  10686. msgstr ""
  10687. "Un @code{--} señala el final de las opciones y desactiva el procesamiento de "
  10688. "opciones mas a fondo. Cualquier parámetro despues de @code{--} son tomados como "
  10689. "nombres de archivos y parámetros.
  10690. #. type: cindex
  10691. #: bashref.texi:6315
  10692. #, no-wrap
  10693. msgid "login shell"
  10694. msgstr "intérprete de inicio de sesión"
  10695. #. type: Plain text
  10696. #: bashref.texi:6318
  10697. msgid ""
  10698. "A @emph{login} shell is one whose first character of argument zero is "
  10699. "@samp{-}, or one invoked with the @option{--login} option."
  10700. msgstr ""
  10701. "Un intérprete de @emph{inicio de sesión} es aquel cuyo primer caracter de "
  10702. "argumento cero es @samp{-}, o aquel llamado con la opción @option{--login}."
  10703. #. type: cindex
  10704. #: bashref.texi:6319 bashref.texi:6458
  10705. #, no-wrap
  10706. msgid "interactive shell"
  10707. msgstr "intérprete interactivo"
  10708. #. type: Plain text
  10709. #: bashref.texi:6326
  10710. msgid ""
  10711. "An @emph{interactive} shell is one started without non-option arguments, "
  10712. "unless @option{-s} is specified, without specifying the @option{-c} option, "
  10713. "and whose input and output are both connected to terminals (as determined by "
  10714. "@code{isatty(3)}), or one started with the @option{-i} option. "
  10715. "@xref{Interactive Shells}, for more information."
  10716. msgstr ""
  10717. "Un intérprete @emph{interactivo} es aquel iniciado sin parámetros que no son "
  10718. "opciones, a menos que @option{-s} sea especificado, sin especificar la opción "
  10719. "@option{-c}, y cuya entrada y salida están conectadas a terminales (como está "
  10720. "desterminado por @code{isatty(3)}), o aquel iniciado con la opción @option{-i}."
  10721. " @xref{Interactive Shells}, para mas información."
  10722. #. type: Plain text
  10723. #: bashref.texi:6337
  10724. msgid ""
  10725. "If arguments remain after option processing, and neither the @option{-c} nor "
  10726. "the @option{-s} option has been supplied, the first argument is assumed to "
  10727. "be the name of a file containing shell commands (@pxref{Shell Scripts}). "
  10728. "When Bash is invoked in this fashion, @code{$0} is set to the name of the "
  10729. "file, and the positional parameters are set to the remaining arguments. "
  10730. "Bash reads and executes commands from this file, then exits. Bash's exit "
  10731. "status is the exit status of the last command executed in the script. If no "
  10732. "commands are executed, the exit status is 0."
  10733. msgstr ""
  10734. "Si quedan parámetros despues del procesamiento de opciones, y ni la "
  10735. "opción @option{-c} ni @option{-s} fueron proporcionadas, se asume que el "
  10736. "primer parámetro es el nombre de un archivo que contiene ordenes de intérprete "
  10737. "(@pxref{Shell Scripts}). Cuando Bash es llamado de esta manera, @code{$0} es "
  10738. "asignado al nombre del archivo, y los parámetros poscionales son asignados a los "
  10739. "parámetros restantes. Bash leé y ejecuta ordenes desde este archivo, y luego sale."
  10740. " El estado de salida de Bash es el estado de salida de la última orden ejecutada "
  10741. "en el script. Si no se ejecutaron ordenes, el estado de salida es 0."
  10742. #. type: cindex
  10743. #: bashref.texi:6340
  10744. #, no-wrap
  10745. msgid "startup files"
  10746. msgstr ""
  10747. #. type: Plain text
  10748. #: bashref.texi:6346
  10749. msgid ""
  10750. "This section describes how Bash executes its startup files. If any of the "
  10751. "files exist but cannot be read, Bash reports an error. Tildes are expanded "
  10752. "in filenames as described above under Tilde Expansion (@pxref{Tilde "
  10753. "Expansion})."
  10754. msgstr ""
  10755. #. type: Plain text
  10756. #: bashref.texi:6348
  10757. msgid "Interactive shells are described in @ref{Interactive Shells}."
  10758. msgstr ""
  10759. #. type: subsubheading
  10760. #: bashref.texi:6349
  10761. #, no-wrap
  10762. msgid "Invoked as an interactive login shell, or with @option{--login}"
  10763. msgstr ""
  10764. #. type: Plain text
  10765. #: bashref.texi:6359
  10766. msgid ""
  10767. "When Bash is invoked as an interactive login shell, or as a non-interactive "
  10768. "shell with the @option{--login} option, it first reads and executes commands "
  10769. "from the file @file{/etc/profile}, if that file exists. After reading that "
  10770. "file, it looks for @file{~/.bash_profile}, @file{~/.bash_login}, and "
  10771. "@file{~/.profile}, in that order, and reads and executes commands from the "
  10772. "first one that exists and is readable. The @option{--noprofile} option may "
  10773. "be used when the shell is started to inhibit this behavior."
  10774. msgstr ""
  10775. #. type: Plain text
  10776. #: bashref.texi:6364
  10777. msgid ""
  10778. "When an interactive login shell exits, or a non-interactive login shell "
  10779. "executes the @code{exit} builtin command, Bash reads and executes commands "
  10780. "from the file @file{~/.bash_logout}, if it exists."
  10781. msgstr ""
  10782. #. type: subsubheading
  10783. #: bashref.texi:6365
  10784. #, no-wrap
  10785. msgid "Invoked as an interactive non-login shell"
  10786. msgstr ""
  10787. #. type: Plain text
  10788. #: bashref.texi:6372
  10789. msgid ""
  10790. "When an interactive shell that is not a login shell is started, Bash reads "
  10791. "and executes commands from @file{~/.bashrc}, if that file exists. This may "
  10792. "be inhibited by using the @option{--norc} option. The @option{--rcfile "
  10793. "@var{file}} option will force Bash to read and execute commands from "
  10794. "@var{file} instead of @file{~/.bashrc}."
  10795. msgstr ""
  10796. #. type: Plain text
  10797. #: bashref.texi:6374
  10798. msgid "So, typically, your @file{~/.bash_profile} contains the line"
  10799. msgstr ""
  10800. #. type: example
  10801. #: bashref.texi:6376
  10802. #, no-wrap
  10803. msgid "@code{if [ -f ~/.bashrc ]; then . ~/.bashrc; fi}\n"
  10804. msgstr ""
  10805. #. type: Plain text
  10806. #: bashref.texi:6379
  10807. msgid "after (or before) any login-specific initializations."
  10808. msgstr ""
  10809. #. type: subsubheading
  10810. #: bashref.texi:6380
  10811. #, no-wrap
  10812. msgid "Invoked non-interactively"
  10813. msgstr ""
  10814. #. type: Plain text
  10815. #: bashref.texi:6387
  10816. msgid ""
  10817. "When Bash is started non-interactively, to run a shell script, for example, "
  10818. "it looks for the variable @env{BASH_ENV} in the environment, expands its "
  10819. "value if it appears there, and uses the expanded value as the name of a file "
  10820. "to read and execute. Bash behaves as if the following command were executed:"
  10821. msgstr ""
  10822. #. type: example
  10823. #: bashref.texi:6389
  10824. #, no-wrap
  10825. msgid "@code{if [ -n \"$BASH_ENV\" ]; then . \"$BASH_ENV\"; fi}\n"
  10826. msgstr ""
  10827. #. type: Plain text
  10828. #: bashref.texi:6393
  10829. msgid ""
  10830. "but the value of the @env{PATH} variable is not used to search for the "
  10831. "filename."
  10832. msgstr ""
  10833. #. type: Plain text
  10834. #: bashref.texi:6397
  10835. msgid ""
  10836. "As noted above, if a non-interactive shell is invoked with the @option{--"
  10837. "login} option, Bash attempts to read and execute commands from the login "
  10838. "shell startup files."
  10839. msgstr ""
  10840. #. type: subsubheading
  10841. #: bashref.texi:6398
  10842. #, no-wrap
  10843. msgid "Invoked with name @code{sh}"
  10844. msgstr ""
  10845. #. type: Plain text
  10846. #: bashref.texi:6403
  10847. msgid ""
  10848. "If Bash is invoked with the name @code{sh}, it tries to mimic the startup "
  10849. "behavior of historical versions of @code{sh} as closely as possible, while "
  10850. "conforming to the @sc{posix} standard as well."
  10851. msgstr ""
  10852. #. type: Plain text
  10853. #: bashref.texi:6417
  10854. msgid ""
  10855. "When invoked as an interactive login shell, or as a non-interactive shell "
  10856. "with the @option{--login} option, it first attempts to read and execute "
  10857. "commands from @file{/etc/profile} and @file{~/.profile}, in that order. The "
  10858. "@option{--noprofile} option may be used to inhibit this behavior. When "
  10859. "invoked as an interactive shell with the name @code{sh}, Bash looks for the "
  10860. "variable @env{ENV}, expands its value if it is defined, and uses the "
  10861. "expanded value as the name of a file to read and execute. Since a shell "
  10862. "invoked as @code{sh} does not attempt to read and execute commands from any "
  10863. "other startup files, the @option{--rcfile} option has no effect. A non-"
  10864. "interactive shell invoked with the name @code{sh} does not attempt to read "
  10865. "any other startup files."
  10866. msgstr ""
  10867. #. type: Plain text
  10868. #: bashref.texi:6420
  10869. msgid ""
  10870. "When invoked as @code{sh}, Bash enters @sc{posix} mode after the startup "
  10871. "files are read."
  10872. msgstr ""
  10873. #. type: subsubheading
  10874. #: bashref.texi:6421
  10875. #, no-wrap
  10876. msgid "Invoked in @sc{posix} mode"
  10877. msgstr ""
  10878. #. type: Plain text
  10879. #: bashref.texi:6430
  10880. msgid ""
  10881. "When Bash is started in @sc{posix} mode, as with the @option{--posix} "
  10882. "command line option, it follows the @sc{posix} standard for startup files. "
  10883. "In this mode, interactive shells expand the @env{ENV} variable and commands "
  10884. "are read and executed from the file whose name is the expanded value. No "
  10885. "other startup files are read."
  10886. msgstr ""
  10887. #. type: subsubheading
  10888. #: bashref.texi:6431
  10889. #, no-wrap
  10890. msgid "Invoked by remote shell daemon"
  10891. msgstr ""
  10892. #. type: Plain text
  10893. #: bashref.texi:6444
  10894. msgid ""
  10895. "Bash attempts to determine when it is being run with its standard input "
  10896. "connected to a network connection, as when executed by the remote shell "
  10897. "daemon, usually @code{rshd}, or the secure shell daemon @code{sshd}. If "
  10898. "Bash determines it is being run in this fashion, it reads and executes "
  10899. "commands from @file{~/.bashrc}, if that file exists and is readable. It "
  10900. "will not do this if invoked as @code{sh}. The @option{--norc} option may be "
  10901. "used to inhibit this behavior, and the @option{--rcfile} option may be used "
  10902. "to force another file to be read, but neither @code{rshd} nor @code{sshd} "
  10903. "generally invoke the shell with those options or allow them to be specified."
  10904. msgstr ""
  10905. #. type: subsubheading
  10906. #: bashref.texi:6445
  10907. #, no-wrap
  10908. msgid "Invoked with unequal effective and real @sc{uid/gid}s"
  10909. msgstr ""
  10910. #. type: Plain text
  10911. #: bashref.texi:6455
  10912. msgid ""
  10913. "If Bash is started with the effective user (group) id not equal to the real "
  10914. "user (group) id, and the @option{-p} option is not supplied, no startup "
  10915. "files are read, shell functions are not inherited from the environment, the "
  10916. "@env{SHELLOPTS}, @env{BASHOPTS}, @env{CDPATH}, and @env{GLOBIGNORE} "
  10917. "variables, if they appear in the environment, are ignored, and the effective "
  10918. "user id is set to the real user id. If the @option{-p} option is supplied "
  10919. "at invocation, the startup behavior is the same, but the effective user id "
  10920. "is not reset."
  10921. msgstr ""
  10922. #. type: cindex
  10923. #: bashref.texi:6459
  10924. #, no-wrap
  10925. msgid "shell, interactive"
  10926. msgstr ""
  10927. #. type: subsection
  10928. #: bashref.texi:6465 bashref.texi:6467 bashref.texi:6468
  10929. #, no-wrap
  10930. msgid "What is an Interactive Shell?"
  10931. msgstr ""
  10932. #. type: menuentry
  10933. #: bashref.texi:6465
  10934. msgid "What determines whether a shell is Interactive."
  10935. msgstr ""
  10936. #. type: subsection
  10937. #: bashref.texi:6465 bashref.texi:6483 bashref.texi:6484
  10938. #, no-wrap
  10939. msgid "Is this Shell Interactive?"
  10940. msgstr ""
  10941. #. type: menuentry
  10942. #: bashref.texi:6465
  10943. msgid "How to tell if a shell is interactive."
  10944. msgstr ""
  10945. #. type: subsection
  10946. #: bashref.texi:6465 bashref.texi:6510 bashref.texi:6511
  10947. #, no-wrap
  10948. msgid "Interactive Shell Behavior"
  10949. msgstr ""
  10950. #. type: menuentry
  10951. #: bashref.texi:6465
  10952. msgid "What changes in a interactive shell?"
  10953. msgstr ""
  10954. #. type: Plain text
  10955. #: bashref.texi:6476
  10956. msgid ""
  10957. "An interactive shell is one started without non-option arguments, unless "
  10958. "@option{-s} is specified, without specifying the @option{-c} option, and "
  10959. "whose input and error output are both connected to terminals (as determined "
  10960. "by @code{isatty(3)}), or one started with the @option{-i} option."
  10961. msgstr ""
  10962. #. type: Plain text
  10963. #: bashref.texi:6479
  10964. msgid ""
  10965. "An interactive shell generally reads from and writes to a user's terminal."
  10966. msgstr ""
  10967. #. type: Plain text
  10968. #: bashref.texi:6482
  10969. msgid ""
  10970. "The @option{-s} invocation option may be used to set the positional "
  10971. "parameters when an interactive shell is started."
  10972. msgstr ""
  10973. #. type: Plain text
  10974. #: bashref.texi:6490
  10975. msgid ""
  10976. "To determine within a startup script whether or not Bash is running "
  10977. "interactively, test the value of the @samp{-} special parameter. It "
  10978. "contains @code{i} when the shell is interactive. For example:"
  10979. msgstr ""
  10980. #. type: example
  10981. #: bashref.texi:6496
  10982. #, no-wrap
  10983. msgid ""
  10984. "case \"$-\" in\n"
  10985. "*i*)\techo This shell is interactive ;;\n"
  10986. "*)\techo This shell is not interactive ;;\n"
  10987. "esac\n"
  10988. msgstr ""
  10989. #. type: Plain text
  10990. #: bashref.texi:6501
  10991. msgid ""
  10992. "Alternatively, startup scripts may examine the variable @env{PS1}; it is "
  10993. "unset in non-interactive shells, and set in interactive shells. Thus:"
  10994. msgstr ""
  10995. #. type: example
  10996. #: bashref.texi:6508
  10997. #, no-wrap
  10998. msgid ""
  10999. "if [ -z \"$PS1\" ]; then\n"
  11000. " echo This shell is not interactive\n"
  11001. "else\n"
  11002. " echo This shell is interactive\n"
  11003. "fi\n"
  11004. msgstr ""
  11005. #. type: Plain text
  11006. #: bashref.texi:6515
  11007. msgid ""
  11008. "When the shell is running interactively, it changes its behavior in several "
  11009. "ways."
  11010. msgstr ""
  11011. #. type: enumerate
  11012. #: bashref.texi:6519
  11013. msgid ""
  11014. "Startup files are read and executed as described in @ref{Bash Startup Files}."
  11015. msgstr ""
  11016. #. type: enumerate
  11017. #: bashref.texi:6524
  11018. msgid ""
  11019. "Job Control (@pxref{Job Control}) is enabled by default. When job control "
  11020. "is in effect, Bash ignores the keyboard-generated job control signals "
  11021. "@code{SIGTTIN}, @code{SIGTTOU}, and @code{SIGTSTP}."
  11022. msgstr ""
  11023. #. type: enumerate
  11024. #: bashref.texi:6530
  11025. msgid ""
  11026. "Bash expands and displays @env{PS1} before reading the first line of a "
  11027. "command, and expands and displays @env{PS2} before reading the second and "
  11028. "subsequent lines of a multi-line command. Bash displays @env{PS0} after it "
  11029. "reads a command but before executing it."
  11030. msgstr ""
  11031. #. type: enumerate
  11032. #: bashref.texi:6535
  11033. msgid ""
  11034. "Bash executes the value of the @env{PROMPT_COMMAND} variable as a command "
  11035. "before printing the primary prompt, @env{$PS1} (@pxref{Bash Variables})."
  11036. msgstr ""
  11037. #. type: enumerate
  11038. #: bashref.texi:6539
  11039. msgid ""
  11040. "Readline (@pxref{Command Line Editing}) is used to read commands from the "
  11041. "user's terminal."
  11042. msgstr ""
  11043. #. type: enumerate
  11044. #: bashref.texi:6544
  11045. msgid ""
  11046. "Bash inspects the value of the @code{ignoreeof} option to @code{set -o} "
  11047. "instead of exiting immediately when it receives an @code{EOF} on its "
  11048. "standard input when reading a command (@pxref{The Set Builtin})."
  11049. msgstr ""
  11050. #. type: enumerate
  11051. #: bashref.texi:6551
  11052. msgid ""
  11053. "Command history (@pxref{Bash History Facilities}) and history expansion "
  11054. "(@pxref{History Interaction}) are enabled by default. Bash will save the "
  11055. "command history to the file named by @env{$HISTFILE} when a shell with "
  11056. "history enabled exits."
  11057. msgstr ""
  11058. #. type: enumerate
  11059. #: bashref.texi:6554
  11060. msgid "Alias expansion (@pxref{Aliases}) is performed by default."
  11061. msgstr ""
  11062. #. type: enumerate
  11063. #: bashref.texi:6558
  11064. msgid ""
  11065. "In the absence of any traps, Bash ignores @code{SIGTERM} (@pxref{Signals})."
  11066. msgstr ""
  11067. #. type: enumerate
  11068. #: bashref.texi:6563
  11069. msgid ""
  11070. "In the absence of any traps, @code{SIGINT} is caught and handled "
  11071. "((@pxref{Signals}). @code{SIGINT} will interrupt some shell builtins."
  11072. msgstr ""
  11073. #. type: enumerate
  11074. #: bashref.texi:6567
  11075. msgid ""
  11076. "An interactive login shell sends a @code{SIGHUP} to all jobs on exit if the "
  11077. "@code{huponexit} shell option has been enabled (@pxref{Signals})."
  11078. msgstr ""
  11079. #. type: enumerate
  11080. #: bashref.texi:6571
  11081. msgid ""
  11082. "The @option{-n} invocation option is ignored, and @samp{set -n} has no "
  11083. "effect (@pxref{The Set Builtin})."
  11084. msgstr ""
  11085. #. type: enumerate
  11086. #: bashref.texi:6576
  11087. msgid ""
  11088. "Bash will check for mail periodically, depending on the values of the "
  11089. "@env{MAIL}, @env{MAILPATH}, and @env{MAILCHECK} shell variables (@pxref{Bash "
  11090. "Variables})."
  11091. msgstr ""
  11092. #. type: enumerate
  11093. #: bashref.texi:6581
  11094. msgid ""
  11095. "Expansion errors due to references to unbound shell variables after "
  11096. "@samp{set -u} has been enabled will not cause the shell to exit (@pxref{The "
  11097. "Set Builtin})."
  11098. msgstr ""
  11099. #. type: enumerate
  11100. #: bashref.texi:6586
  11101. msgid ""
  11102. "The shell will not exit on expansion errors caused by @var{var} being unset "
  11103. "or null in @code{$@{@var{var}:?@var{word}@}} expansions (@pxref{Shell "
  11104. "Parameter Expansion})."
  11105. msgstr ""
  11106. #. type: enumerate
  11107. #: bashref.texi:6590
  11108. msgid ""
  11109. "Redirection errors encountered by shell builtins will not cause the shell to "
  11110. "exit."
  11111. msgstr ""
  11112. #. type: enumerate
  11113. #: bashref.texi:6594
  11114. msgid ""
  11115. "When running in @sc{posix} mode, a special builtin returning an error status "
  11116. "will not cause the shell to exit (@pxref{Bash POSIX Mode})."
  11117. msgstr ""
  11118. #. type: enumerate
  11119. #: bashref.texi:6598
  11120. msgid ""
  11121. "A failed @code{exec} will not cause the shell to exit (@pxref{Bourne Shell "
  11122. "Builtins})."
  11123. msgstr ""
  11124. #. type: enumerate
  11125. #: bashref.texi:6601
  11126. msgid "Parser syntax errors will not cause the shell to exit."
  11127. msgstr ""
  11128. #. type: enumerate
  11129. #: bashref.texi:6606
  11130. msgid ""
  11131. "Simple spelling correction for directory arguments to the @code{cd} builtin "
  11132. "is enabled by default (see the description of the @code{cdspell} option to "
  11133. "the @code{shopt} builtin in @ref{The Shopt Builtin})."
  11134. msgstr ""
  11135. #. type: enumerate
  11136. #: bashref.texi:6611
  11137. msgid ""
  11138. "The shell will check the value of the @env{TMOUT} variable and exit if a "
  11139. "command is not read within the specified number of seconds after printing "
  11140. "@env{$PS1} (@pxref{Bash Variables})."
  11141. msgstr ""
  11142. #. type: cindex
  11143. #: bashref.texi:6616
  11144. #, no-wrap
  11145. msgid "expressions, conditional"
  11146. msgstr ""
  11147. #. type: Plain text
  11148. #: bashref.texi:6620
  11149. msgid ""
  11150. "Conditional expressions are used by the @code{[[} compound command and the "
  11151. "@code{test} and @code{[} builtin commands."
  11152. msgstr ""
  11153. #. type: Plain text
  11154. #: bashref.texi:6634
  11155. msgid ""
  11156. "Expressions may be unary or binary. Unary expressions are often used to "
  11157. "examine the status of a file. There are string operators and numeric "
  11158. "comparison operators as well. Bash handles several filenames specially when "
  11159. "they are used in expressions. If the operating system on which Bash is "
  11160. "running provides these special files, Bash will use them; otherwise it will "
  11161. "emulate them internally with this behavior: If the @var{file} argument to "
  11162. "one of the primaries is of the form @file{/dev/fd/@var{N}}, then file "
  11163. "descriptor @var{N} is checked. If the @var{file} argument to one of the "
  11164. "primaries is one of @file{/dev/stdin}, @file{/dev/stdout}, or @file{/dev/"
  11165. "stderr}, file descriptor 0, 1, or 2, respectively, is checked."
  11166. msgstr ""
  11167. #. type: Plain text
  11168. #: bashref.texi:6638
  11169. msgid ""
  11170. "When used with @code{[[}, the @samp{<} and @samp{>} operators sort "
  11171. "lexicographically using the current locale. The @code{test} command uses "
  11172. "ASCII ordering."
  11173. msgstr ""
  11174. #. type: Plain text
  11175. #: bashref.texi:6641
  11176. msgid ""
  11177. "Unless otherwise specified, primaries that operate on files follow symbolic "
  11178. "links and operate on the target of the link, rather than the link itself."
  11179. msgstr ""
  11180. #. type: item
  11181. #: bashref.texi:6643
  11182. #, no-wrap
  11183. msgid "-a @var{file}"
  11184. msgstr ""
  11185. #. type: table
  11186. #: bashref.texi:6645 bashref.texi:6657
  11187. msgid "True if @var{file} exists."
  11188. msgstr ""
  11189. #. type: item
  11190. #: bashref.texi:6646
  11191. #, no-wrap
  11192. msgid "-b @var{file}"
  11193. msgstr ""
  11194. #. type: table
  11195. #: bashref.texi:6648
  11196. msgid "True if @var{file} exists and is a block special file."
  11197. msgstr ""
  11198. #. type: item
  11199. #: bashref.texi:6649
  11200. #, no-wrap
  11201. msgid "-c @var{file}"
  11202. msgstr ""
  11203. #. type: table
  11204. #: bashref.texi:6651
  11205. msgid "True if @var{file} exists and is a character special file."
  11206. msgstr ""
  11207. #. type: item
  11208. #: bashref.texi:6652
  11209. #, no-wrap
  11210. msgid "-d @var{file}"
  11211. msgstr ""
  11212. #. type: table
  11213. #: bashref.texi:6654
  11214. msgid "True if @var{file} exists and is a directory."
  11215. msgstr ""
  11216. #. type: item
  11217. #: bashref.texi:6655
  11218. #, no-wrap
  11219. msgid "-e @var{file}"
  11220. msgstr ""
  11221. #. type: item
  11222. #: bashref.texi:6658
  11223. #, no-wrap
  11224. msgid "-f @var{file}"
  11225. msgstr ""
  11226. #. type: table
  11227. #: bashref.texi:6660
  11228. msgid "True if @var{file} exists and is a regular file."
  11229. msgstr ""
  11230. #. type: item
  11231. #: bashref.texi:6661
  11232. #, no-wrap
  11233. msgid "-g @var{file}"
  11234. msgstr ""
  11235. #. type: table
  11236. #: bashref.texi:6663
  11237. msgid "True if @var{file} exists and its set-group-id bit is set."
  11238. msgstr ""
  11239. #. type: item
  11240. #: bashref.texi:6664
  11241. #, no-wrap
  11242. msgid "-h @var{file}"
  11243. msgstr ""
  11244. #. type: table
  11245. #: bashref.texi:6666 bashref.texi:6696
  11246. msgid "True if @var{file} exists and is a symbolic link."
  11247. msgstr ""
  11248. #. type: item
  11249. #: bashref.texi:6667
  11250. #, no-wrap
  11251. msgid "-k @var{file}"
  11252. msgstr ""
  11253. #. type: table
  11254. #: bashref.texi:6669
  11255. msgid "True if @var{file} exists and its \"sticky\" bit is set."
  11256. msgstr ""
  11257. #. type: item
  11258. #: bashref.texi:6670
  11259. #, no-wrap
  11260. msgid "-p @var{file}"
  11261. msgstr ""
  11262. #. type: table
  11263. #: bashref.texi:6672
  11264. msgid "True if @var{file} exists and is a named pipe (FIFO)."
  11265. msgstr ""
  11266. #. type: item
  11267. #: bashref.texi:6673
  11268. #, no-wrap
  11269. msgid "-r @var{file}"
  11270. msgstr ""
  11271. #. type: table
  11272. #: bashref.texi:6675
  11273. msgid "True if @var{file} exists and is readable."
  11274. msgstr ""
  11275. #. type: item
  11276. #: bashref.texi:6676
  11277. #, no-wrap
  11278. msgid "-s @var{file}"
  11279. msgstr ""
  11280. #. type: table
  11281. #: bashref.texi:6678
  11282. msgid "True if @var{file} exists and has a size greater than zero."
  11283. msgstr ""
  11284. #. type: item
  11285. #: bashref.texi:6679
  11286. #, no-wrap
  11287. msgid "-t @var{fd}"
  11288. msgstr ""
  11289. #. type: table
  11290. #: bashref.texi:6681
  11291. msgid "True if file descriptor @var{fd} is open and refers to a terminal."
  11292. msgstr ""
  11293. #. type: item
  11294. #: bashref.texi:6682
  11295. #, no-wrap
  11296. msgid "-u @var{file}"
  11297. msgstr ""
  11298. #. type: table
  11299. #: bashref.texi:6684
  11300. msgid "True if @var{file} exists and its set-user-id bit is set."
  11301. msgstr ""
  11302. #. type: item
  11303. #: bashref.texi:6685
  11304. #, no-wrap
  11305. msgid "-w @var{file}"
  11306. msgstr ""
  11307. #. type: table
  11308. #: bashref.texi:6687
  11309. msgid "True if @var{file} exists and is writable."
  11310. msgstr ""
  11311. #. type: item
  11312. #: bashref.texi:6688
  11313. #, no-wrap
  11314. msgid "-x @var{file}"
  11315. msgstr ""
  11316. #. type: table
  11317. #: bashref.texi:6690
  11318. msgid "True if @var{file} exists and is executable."
  11319. msgstr ""
  11320. #. type: item
  11321. #: bashref.texi:6691
  11322. #, no-wrap
  11323. msgid "-G @var{file}"
  11324. msgstr ""
  11325. #. type: table
  11326. #: bashref.texi:6693
  11327. msgid "True if @var{file} exists and is owned by the effective group id."
  11328. msgstr ""
  11329. #. type: item
  11330. #: bashref.texi:6694
  11331. #, no-wrap
  11332. msgid "-L @var{file}"
  11333. msgstr ""
  11334. #. type: item
  11335. #: bashref.texi:6697
  11336. #, no-wrap
  11337. msgid "-N @var{file}"
  11338. msgstr ""
  11339. #. type: table
  11340. #: bashref.texi:6699
  11341. msgid "True if @var{file} exists and has been modified since it was last read."
  11342. msgstr ""
  11343. #. type: item
  11344. #: bashref.texi:6700
  11345. #, no-wrap
  11346. msgid "-O @var{file}"
  11347. msgstr ""
  11348. #. type: table
  11349. #: bashref.texi:6702
  11350. msgid "True if @var{file} exists and is owned by the effective user id."
  11351. msgstr ""
  11352. #. type: item
  11353. #: bashref.texi:6703
  11354. #, no-wrap
  11355. msgid "-S @var{file}"
  11356. msgstr ""
  11357. #. type: table
  11358. #: bashref.texi:6705
  11359. msgid "True if @var{file} exists and is a socket."
  11360. msgstr ""
  11361. #. type: item
  11362. #: bashref.texi:6706
  11363. #, no-wrap
  11364. msgid "@var{file1} -ef @var{file2}"
  11365. msgstr ""
  11366. #. type: table
  11367. #: bashref.texi:6709
  11368. msgid ""
  11369. "True if @var{file1} and @var{file2} refer to the same device and inode "
  11370. "numbers."
  11371. msgstr ""
  11372. #. type: item
  11373. #: bashref.texi:6710
  11374. #, no-wrap
  11375. msgid "@var{file1} -nt @var{file2}"
  11376. msgstr ""
  11377. #. type: table
  11378. #: bashref.texi:6713
  11379. msgid ""
  11380. "True if @var{file1} is newer (according to modification date) than "
  11381. "@var{file2}, or if @var{file1} exists and @var{file2} does not."
  11382. msgstr ""
  11383. #. type: item
  11384. #: bashref.texi:6714
  11385. #, no-wrap
  11386. msgid "@var{file1} -ot @var{file2}"
  11387. msgstr ""
  11388. #. type: table
  11389. #: bashref.texi:6717
  11390. msgid ""
  11391. "True if @var{file1} is older than @var{file2}, or if @var{file2} exists and "
  11392. "@var{file1} does not."
  11393. msgstr ""
  11394. #. type: item
  11395. #: bashref.texi:6718
  11396. #, no-wrap
  11397. msgid "-o @var{optname}"
  11398. msgstr ""
  11399. #. type: table
  11400. #: bashref.texi:6722
  11401. msgid ""
  11402. "True if the shell option @var{optname} is enabled. The list of options "
  11403. "appears in the description of the @option{-o} option to the @code{set} "
  11404. "builtin (@pxref{The Set Builtin})."
  11405. msgstr ""
  11406. #. type: item
  11407. #: bashref.texi:6723
  11408. #, no-wrap
  11409. msgid "-v @var{varname}"
  11410. msgstr ""
  11411. #. type: table
  11412. #: bashref.texi:6725
  11413. msgid ""
  11414. "True if the shell variable @var{varname} is set (has been assigned a value)."
  11415. msgstr ""
  11416. #. type: item
  11417. #: bashref.texi:6726
  11418. #, no-wrap
  11419. msgid "-R @var{varname}"
  11420. msgstr ""
  11421. #. type: table
  11422. #: bashref.texi:6728
  11423. msgid ""
  11424. "True if the shell variable @var{varname} is set and is a name reference."
  11425. msgstr ""
  11426. #. type: item
  11427. #: bashref.texi:6729
  11428. #, no-wrap
  11429. msgid "-z @var{string}"
  11430. msgstr ""
  11431. #. type: table
  11432. #: bashref.texi:6731
  11433. msgid "True if the length of @var{string} is zero."
  11434. msgstr ""
  11435. #. type: item
  11436. #: bashref.texi:6732
  11437. #, no-wrap
  11438. msgid "-n @var{string}"
  11439. msgstr ""
  11440. #. type: var{#1}
  11441. #: bashref.texi:6733
  11442. #, no-wrap
  11443. msgid "string"
  11444. msgstr ""
  11445. #. type: table
  11446. #: bashref.texi:6735
  11447. msgid "True if the length of @var{string} is non-zero."
  11448. msgstr ""
  11449. #. type: item
  11450. #: bashref.texi:6736
  11451. #, no-wrap
  11452. msgid "@var{string1} == @var{string2}"
  11453. msgstr ""
  11454. #. type: itemx
  11455. #: bashref.texi:6737
  11456. #, no-wrap
  11457. msgid "@var{string1} = @var{string2}"
  11458. msgstr ""
  11459. #. type: table
  11460. #: bashref.texi:6741
  11461. msgid ""
  11462. "True if the strings are equal. When used with the @code{[[} command, this "
  11463. "performs pattern matching as described above (@pxref{Conditional "
  11464. "Constructs})."
  11465. msgstr ""
  11466. #. type: table
  11467. #: bashref.texi:6743
  11468. msgid ""
  11469. "@samp{=} should be used with the @code{test} command for @sc{posix} "
  11470. "conformance."
  11471. msgstr ""
  11472. #. type: item
  11473. #: bashref.texi:6744
  11474. #, no-wrap
  11475. msgid "@var{string1} != @var{string2}"
  11476. msgstr ""
  11477. #. type: table
  11478. #: bashref.texi:6746
  11479. msgid "True if the strings are not equal."
  11480. msgstr ""
  11481. #. type: item
  11482. #: bashref.texi:6747
  11483. #, no-wrap
  11484. msgid "@var{string1} < @var{string2}"
  11485. msgstr ""
  11486. #. type: table
  11487. #: bashref.texi:6749
  11488. msgid "True if @var{string1} sorts before @var{string2} lexicographically."
  11489. msgstr ""
  11490. #. type: item
  11491. #: bashref.texi:6750
  11492. #, no-wrap
  11493. msgid "@var{string1} > @var{string2}"
  11494. msgstr ""
  11495. #. type: table
  11496. #: bashref.texi:6752
  11497. msgid "True if @var{string1} sorts after @var{string2} lexicographically."
  11498. msgstr ""
  11499. #. type: item
  11500. #: bashref.texi:6753
  11501. #, no-wrap
  11502. msgid "@var{arg1} OP @var{arg2}"
  11503. msgstr ""
  11504. #. type: table
  11505. #: bashref.texi:6761
  11506. msgid ""
  11507. "@code{OP} is one of @samp{-eq}, @samp{-ne}, @samp{-lt}, @samp{-le}, @samp{-"
  11508. "gt}, or @samp{-ge}. These arithmetic binary operators return true if "
  11509. "@var{arg1} is equal to, not equal to, less than, less than or equal to, "
  11510. "greater than, or greater than or equal to @var{arg2}, respectively. "
  11511. "@var{Arg1} and @var{arg2} may be positive or negative integers."
  11512. msgstr ""
  11513. #. type: cindex
  11514. #: bashref.texi:6765
  11515. #, no-wrap
  11516. msgid "arithmetic, shell"
  11517. msgstr ""
  11518. #. type: cindex
  11519. #: bashref.texi:6766
  11520. #, no-wrap
  11521. msgid "shell arithmetic"
  11522. msgstr ""
  11523. #. type: cindex
  11524. #: bashref.texi:6767
  11525. #, no-wrap
  11526. msgid "expressions, arithmetic"
  11527. msgstr ""
  11528. #. type: cindex
  11529. #: bashref.texi:6768
  11530. #, no-wrap
  11531. msgid "evaluation, arithmetic"
  11532. msgstr ""
  11533. #. type: cindex
  11534. #: bashref.texi:6769
  11535. #, no-wrap
  11536. msgid "arithmetic evaluation"
  11537. msgstr ""
  11538. #. type: Plain text
  11539. #: bashref.texi:6774
  11540. msgid ""
  11541. "The shell allows arithmetic expressions to be evaluated, as one of the shell "
  11542. "expansions or by using the @code{((} compound command, the @code{let} "
  11543. "builtin, or the @option{-i} option to the @code{declare} builtin."
  11544. msgstr ""
  11545. #. type: Plain text
  11546. #: bashref.texi:6782
  11547. msgid ""
  11548. "Evaluation is done in fixed-width integers with no check for overflow, "
  11549. "though division by 0 is trapped and flagged as an error. The operators and "
  11550. "their precedence, associativity, and values are the same as in the C "
  11551. "language. The following list of operators is grouped into levels of equal-"
  11552. "precedence operators. The levels are listed in order of decreasing "
  11553. "precedence."
  11554. msgstr ""
  11555. #. type: item
  11556. #: bashref.texi:6785
  11557. #, no-wrap
  11558. msgid "@var{id}++ @var{id}--"
  11559. msgstr ""
  11560. #. type: table
  11561. #: bashref.texi:6787
  11562. msgid "variable post-increment and post-decrement"
  11563. msgstr ""
  11564. #. type: item
  11565. #: bashref.texi:6788
  11566. #, no-wrap
  11567. msgid "++@var{id} --@var{id}"
  11568. msgstr ""
  11569. #. type: table
  11570. #: bashref.texi:6790
  11571. msgid "variable pre-increment and pre-decrement"
  11572. msgstr ""
  11573. #. type: item
  11574. #: bashref.texi:6791
  11575. #, no-wrap
  11576. msgid "- +"
  11577. msgstr ""
  11578. #. type: table
  11579. #: bashref.texi:6793
  11580. msgid "unary minus and plus"
  11581. msgstr ""
  11582. #. type: item
  11583. #: bashref.texi:6794
  11584. #, no-wrap
  11585. msgid "! ~"
  11586. msgstr ""
  11587. #. type: table
  11588. #: bashref.texi:6796
  11589. msgid "logical and bitwise negation"
  11590. msgstr ""
  11591. #. type: item
  11592. #: bashref.texi:6797
  11593. #, no-wrap
  11594. msgid "**"
  11595. msgstr ""
  11596. #. type: table
  11597. #: bashref.texi:6799
  11598. msgid "exponentiation"
  11599. msgstr ""
  11600. #. type: item
  11601. #: bashref.texi:6800
  11602. #, no-wrap
  11603. msgid "* / %"
  11604. msgstr ""
  11605. #. type: table
  11606. #: bashref.texi:6802
  11607. msgid "multiplication, division, remainder"
  11608. msgstr ""
  11609. #. type: item
  11610. #: bashref.texi:6803
  11611. #, no-wrap
  11612. msgid "+ -"
  11613. msgstr ""
  11614. #. type: table
  11615. #: bashref.texi:6805
  11616. msgid "addition, subtraction"
  11617. msgstr ""
  11618. #. type: item
  11619. #: bashref.texi:6806
  11620. #, no-wrap
  11621. msgid "<< >>"
  11622. msgstr ""
  11623. #. type: table
  11624. #: bashref.texi:6808
  11625. msgid "left and right bitwise shifts"
  11626. msgstr ""
  11627. #. type: item
  11628. #: bashref.texi:6809
  11629. #, no-wrap
  11630. msgid "<= >= < >"
  11631. msgstr ""
  11632. #. type: table
  11633. #: bashref.texi:6811
  11634. msgid "comparison"
  11635. msgstr ""
  11636. #. type: item
  11637. #: bashref.texi:6812
  11638. #, no-wrap
  11639. msgid "== !="
  11640. msgstr ""
  11641. #. type: table
  11642. #: bashref.texi:6814
  11643. msgid "equality and inequality"
  11644. msgstr ""
  11645. #. type: item
  11646. #: bashref.texi:6815
  11647. #, no-wrap
  11648. msgid "&"
  11649. msgstr ""
  11650. #. type: table
  11651. #: bashref.texi:6817
  11652. msgid "bitwise AND"
  11653. msgstr ""
  11654. #. type: item
  11655. #: bashref.texi:6818
  11656. #, no-wrap
  11657. msgid "^"
  11658. msgstr ""
  11659. #. type: table
  11660. #: bashref.texi:6820
  11661. msgid "bitwise exclusive OR"
  11662. msgstr ""
  11663. #. type: item
  11664. #: bashref.texi:6821
  11665. #, no-wrap
  11666. msgid "|"
  11667. msgstr ""
  11668. #. type: table
  11669. #: bashref.texi:6823
  11670. msgid "bitwise OR"
  11671. msgstr ""
  11672. #. type: item
  11673. #: bashref.texi:6824
  11674. #, no-wrap
  11675. msgid "&&"
  11676. msgstr ""
  11677. #. type: table
  11678. #: bashref.texi:6826
  11679. msgid "logical AND"
  11680. msgstr ""
  11681. #. type: item
  11682. #: bashref.texi:6827
  11683. #, no-wrap
  11684. msgid "||"
  11685. msgstr ""
  11686. #. type: table
  11687. #: bashref.texi:6829
  11688. msgid "logical OR"
  11689. msgstr ""
  11690. #. type: item
  11691. #: bashref.texi:6830
  11692. #, no-wrap
  11693. msgid "expr ? expr : expr"
  11694. msgstr ""
  11695. #. type: table
  11696. #: bashref.texi:6832
  11697. msgid "conditional operator"
  11698. msgstr ""
  11699. #. type: item
  11700. #: bashref.texi:6833
  11701. #, no-wrap
  11702. msgid "= *= /= %= += -= <<= >>= &= ^= |="
  11703. msgstr ""
  11704. #. type: table
  11705. #: bashref.texi:6835
  11706. msgid "assignment"
  11707. msgstr ""
  11708. #. type: item
  11709. #: bashref.texi:6836
  11710. #, no-wrap
  11711. msgid "expr1 , expr2"
  11712. msgstr ""
  11713. #. type: table
  11714. #: bashref.texi:6838
  11715. msgid "comma"
  11716. msgstr ""
  11717. #. type: Plain text
  11718. #: bashref.texi:6852
  11719. msgid ""
  11720. "Shell variables are allowed as operands; parameter expansion is performed "
  11721. "before the expression is evaluated. Within an expression, shell variables "
  11722. "may also be referenced by name without using the parameter expansion "
  11723. "syntax. A shell variable that is null or unset evaluates to 0 when "
  11724. "referenced by name without using the parameter expansion syntax. The value "
  11725. "of a variable is evaluated as an arithmetic expression when it is "
  11726. "referenced, or when a variable which has been given the @var{integer} "
  11727. "attribute using @samp{declare -i} is assigned a value. A null value "
  11728. "evaluates to 0. A shell variable need not have its @var{integer} attribute "
  11729. "turned on to be used in an expression."
  11730. msgstr ""
  11731. #. type: Plain text
  11732. #: bashref.texi:6865
  11733. msgid ""
  11734. "Constants with a leading 0 are interpreted as octal numbers. A leading "
  11735. "@samp{0x} or @samp{0X} denotes hexadecimal. Otherwise, numbers take the "
  11736. "form [@var{base}@code{#}]@var{n}, where the optional @var{base} is a decimal "
  11737. "number between 2 and 64 representing the arithmetic base, and @var{n} is a "
  11738. "number in that base. If @var{base}@code{#} is omitted, then base 10 is "
  11739. "used. When specifying @var{n}, the digits greater than 9 are represented by "
  11740. "the lowercase letters, the uppercase letters, @samp{@@}, and @samp{_}, in "
  11741. "that order. If @var{base} is less than or equal to 36, lowercase and "
  11742. "uppercase letters may be used interchangeably to represent numbers between "
  11743. "10 and 35."
  11744. msgstr ""
  11745. #. type: Plain text
  11746. #: bashref.texi:6869
  11747. msgid ""
  11748. "Operators are evaluated in order of precedence. Sub-expressions in "
  11749. "parentheses are evaluated first and may override the precedence rules above."
  11750. msgstr ""
  11751. #. type: cindex
  11752. #: bashref.texi:6872
  11753. #, no-wrap
  11754. msgid "alias expansion"
  11755. msgstr ""
  11756. #. type: Plain text
  11757. #: bashref.texi:6878
  11758. msgid ""
  11759. "@var{Aliases} allow a string to be substituted for a word when it is used as "
  11760. "the first word of a simple command. The shell maintains a list of aliases "
  11761. "that may be set and unset with the @code{alias} and @code{unalias} builtin "
  11762. "commands."
  11763. msgstr ""
  11764. #. type: Plain text
  11765. #: bashref.texi:6896
  11766. msgid ""
  11767. "The first word of each simple command, if unquoted, is checked to see if it "
  11768. "has an alias. If so, that word is replaced by the text of the alias. The "
  11769. "characters @samp{/}, @samp{$}, @samp{`}, @samp{=} and any of the shell "
  11770. "metacharacters or quoting characters listed above may not appear in an alias "
  11771. "name. The replacement text may contain any valid shell input, including "
  11772. "shell metacharacters. The first word of the replacement text is tested for "
  11773. "aliases, but a word that is identical to an alias being expanded is not "
  11774. "expanded a second time. This means that one may alias @code{ls} to "
  11775. "@code{\"ls -F\"}, for instance, and Bash does not try to recursively expand "
  11776. "the replacement text. If the last character of the alias value is a "
  11777. "@var{blank}, then the next command word following the alias is also checked "
  11778. "for alias expansion."
  11779. msgstr ""
  11780. #. type: Plain text
  11781. #: bashref.texi:6899
  11782. msgid ""
  11783. "Aliases are created and listed with the @code{alias} command, and removed "
  11784. "with the @code{unalias} command."
  11785. msgstr ""
  11786. #. type: Plain text
  11787. #: bashref.texi:6904
  11788. msgid ""
  11789. "There is no mechanism for using arguments in the replacement text, as in "
  11790. "@code{csh}. If arguments are needed, a shell function should be used "
  11791. "(@pxref{Shell Functions})."
  11792. msgstr ""
  11793. #. type: Plain text
  11794. #: bashref.texi:6908
  11795. msgid ""
  11796. "Aliases are not expanded when the shell is not interactive, unless the "
  11797. "@code{expand_aliases} shell option is set using @code{shopt} (@pxref{The "
  11798. "Shopt Builtin})."
  11799. msgstr ""
  11800. #. type: Plain text
  11801. #: bashref.texi:6927
  11802. msgid ""
  11803. "The rules concerning the definition and use of aliases are somewhat "
  11804. "confusing. Bash always reads at least one complete line of input before "
  11805. "executing any of the commands on that line. Aliases are expanded when a "
  11806. "command is read, not when it is executed. Therefore, an alias definition "
  11807. "appearing on the same line as another command does not take effect until the "
  11808. "next line of input is read. The commands following the alias definition on "
  11809. "that line are not affected by the new alias. This behavior is also an issue "
  11810. "when functions are executed. Aliases are expanded when a function "
  11811. "definition is read, not when the function is executed, because a function "
  11812. "definition is itself a command. As a consequence, aliases defined in a "
  11813. "function are not available until after that function is executed. To be "
  11814. "safe, always put alias definitions on a separate line, and do not use "
  11815. "@code{alias} in compound commands."
  11816. msgstr ""
  11817. #. type: Plain text
  11818. #: bashref.texi:6929
  11819. msgid "For almost every purpose, shell functions are preferred over aliases."
  11820. msgstr ""
  11821. #. type: cindex
  11822. #: bashref.texi:6932
  11823. #, no-wrap
  11824. msgid "arrays"
  11825. msgstr ""
  11826. #. type: Plain text
  11827. #: bashref.texi:6944
  11828. msgid ""
  11829. "Bash provides one-dimensional indexed and associative array variables. Any "
  11830. "variable may be used as an indexed array; the @code{declare} builtin will "
  11831. "explicitly declare an array. There is no maximum limit on the size of an "
  11832. "array, nor any requirement that members be indexed or assigned "
  11833. "contiguously. Indexed arrays are referenced using integers (including "
  11834. "arithmetic expressions (@pxref{Shell Arithmetic})) and are zero-based; "
  11835. "associative arrays use arbitrary strings. Unless otherwise noted, indexed "
  11836. "array indices must be non-negative integers."
  11837. msgstr ""
  11838. #. type: Plain text
  11839. #: bashref.texi:6947
  11840. msgid ""
  11841. "An indexed array is created automatically if any variable is assigned to "
  11842. "using the syntax"
  11843. msgstr ""
  11844. #. type: example
  11845. #: bashref.texi:6949
  11846. #, no-wrap
  11847. msgid "@var{name}[@var{subscript}]=@var{value}\n"
  11848. msgstr ""
  11849. #. type: Plain text
  11850. #: bashref.texi:6955
  11851. msgid ""
  11852. "The @var{subscript} is treated as an arithmetic expression that must "
  11853. "evaluate to a number. To explicitly declare an array, use"
  11854. msgstr ""
  11855. #. type: example
  11856. #: bashref.texi:6957
  11857. #, no-wrap
  11858. msgid "declare -a @var{name}\n"
  11859. msgstr ""
  11860. #. type: Plain text
  11861. #: bashref.texi:6960
  11862. msgid "The syntax"
  11863. msgstr ""
  11864. #. type: example
  11865. #: bashref.texi:6962
  11866. #, no-wrap
  11867. msgid "declare -a @var{name}[@var{subscript}]\n"
  11868. msgstr ""
  11869. #. type: Plain text
  11870. #: bashref.texi:6965
  11871. msgid "is also accepted; the @var{subscript} is ignored."
  11872. msgstr ""
  11873. #. type: Plain text
  11874. #: bashref.texi:6968
  11875. msgid "Associative arrays are created using"
  11876. msgstr ""
  11877. #. type: example
  11878. #: bashref.texi:6970
  11879. #, no-wrap
  11880. msgid "declare -A @var{name}.\n"
  11881. msgstr ""
  11882. #. type: Plain text
  11883. #: bashref.texi:6976
  11884. msgid ""
  11885. "Attributes may be specified for an array variable using the @code{declare} "
  11886. "and @code{readonly} builtins. Each attribute applies to all members of an "
  11887. "array."
  11888. msgstr ""
  11889. #. type: Plain text
  11890. #: bashref.texi:6978
  11891. msgid "Arrays are assigned to using compound assignments of the form"
  11892. msgstr ""
  11893. #. type: example
  11894. #: bashref.texi:6980
  11895. #, no-wrap
  11896. msgid "@var{name}=(@var{value1} @var{value2} @dots{} )\n"
  11897. msgstr ""
  11898. #. type: Plain text
  11899. #: bashref.texi:6989
  11900. msgid ""
  11901. "where each @var{value} is of the form @code{[@var{subscript}]=}"
  11902. "@var{string}. Indexed array assignments do not require anything but "
  11903. "@var{string}. When assigning to indexed arrays, if the optional subscript "
  11904. "is supplied, that index is assigned to; otherwise the index of the element "
  11905. "assigned is the last index assigned to by the statement plus one. Indexing "
  11906. "starts at zero."
  11907. msgstr ""
  11908. #. type: Plain text
  11909. #: bashref.texi:6991
  11910. msgid "When assigning to an associative array, the subscript is required."
  11911. msgstr ""
  11912. #. type: Plain text
  11913. #: bashref.texi:6995
  11914. msgid ""
  11915. "This syntax is also accepted by the @code{declare} builtin. Individual "
  11916. "array elements may be assigned to using the @code{@var{name}"
  11917. "[@var{subscript}]=@var{value}} syntax introduced above."
  11918. msgstr ""
  11919. #. type: Plain text
  11920. #: bashref.texi:7001
  11921. msgid ""
  11922. "When assigning to an indexed array, if @var{name} is subscripted by a "
  11923. "negative number, that number is interpreted as relative to one greater than "
  11924. "the maximum index of @var{name}, so negative indices count back from the end "
  11925. "of the array, and an index of -1 references the last element."
  11926. msgstr ""
  11927. #. type: Plain text
  11928. #: bashref.texi:7031
  11929. msgid ""
  11930. "Any element of an array may be referenced using @code{$@{@var{name}"
  11931. "[@var{subscript}]@}}. The braces are required to avoid conflicts with the "
  11932. "shell's filename expansion operators. If the @var{subscript} is @samp{@@} "
  11933. "or @samp{*}, the word expands to all members of the array @var{name}. These "
  11934. "subscripts differ only when the word appears within double quotes. If the "
  11935. "word is double-quoted, @code{$@{@var{name}[*]@}} expands to a single word "
  11936. "with the value of each array member separated by the first character of the "
  11937. "@env{IFS} variable, and @code{$@{@var{name}[@@]@}} expands each element of "
  11938. "@var{name} to a separate word. When there are no array members, "
  11939. "@code{$@{@var{name}[@@]@}} expands to nothing. If the double-quoted "
  11940. "expansion occurs within a word, the expansion of the first parameter is "
  11941. "joined with the beginning part of the original word, and the expansion of "
  11942. "the last parameter is joined with the last part of the original word. This "
  11943. "is analogous to the expansion of the special parameters @samp{@@} and "
  11944. "@samp{*}. @code{$@{#@var{name}[@var{subscript}]@}} expands to the length of "
  11945. "@code{$@{@var{name}[@var{subscript}]@}}. If @var{subscript} is @samp{@@} or "
  11946. "@samp{*}, the expansion is the number of elements in the array. If the "
  11947. "@var{subscript} used to reference an element of an indexed array evaluates "
  11948. "to a number less than zero, it is interpreted as relative to one greater "
  11949. "than the maximum index of the array, so negative indices count back from the "
  11950. "end of the array, and an index of -1 refers to the last element."
  11951. msgstr ""
  11952. #. type: Plain text
  11953. #: bashref.texi:7036
  11954. msgid ""
  11955. "Referencing an array variable without a subscript is equivalent to "
  11956. "referencing with a subscript of 0. Any reference to a variable using a "
  11957. "valid subscript is legal, and @code{bash} will create an array if necessary."
  11958. msgstr ""
  11959. #. type: Plain text
  11960. #: bashref.texi:7039
  11961. msgid ""
  11962. "An array variable is considered set if a subscript has been assigned a "
  11963. "value. The null string is a valid value."
  11964. msgstr ""
  11965. #. type: Plain text
  11966. #: bashref.texi:7045
  11967. msgid ""
  11968. "It is possible to obtain the keys (indices) of an array as well as the "
  11969. "values. $@{!@var{name}[@@]@} and $@{!@var{name}[*]@} expand to the indices "
  11970. "assigned in array variable @var{name}. The treatment when in double quotes "
  11971. "is similar to the expansion of the special parameters @samp{@@} and @samp{*} "
  11972. "within double quotes."
  11973. msgstr ""
  11974. #. type: Plain text
  11975. #: bashref.texi:7055
  11976. msgid ""
  11977. "The @code{unset} builtin is used to destroy arrays. @code{unset @var{name}"
  11978. "[@var{subscript}]} destroys the array element at index @var{subscript}. "
  11979. "Negative subscripts to indexed arrays are interpreted as described above. "
  11980. "Care must be taken to avoid unwanted side effects caused by filename "
  11981. "expansion. @code{unset @var{name}}, where @var{name} is an array, removes "
  11982. "the entire array. A subscript of @samp{*} or @samp{@@} also removes the "
  11983. "entire array."
  11984. msgstr ""
  11985. #. type: Plain text
  11986. #: bashref.texi:7066
  11987. msgid ""
  11988. "The @code{declare}, @code{local}, and @code{readonly} builtins each accept a "
  11989. "@option{-a} option to specify an indexed array and a @option{-A} option to "
  11990. "specify an associative array. If both options are supplied, @option{-A} "
  11991. "takes precedence. The @code{read} builtin accepts a @option{-a} option to "
  11992. "assign a list of words read from the standard input to an array, and can "
  11993. "read values from the standard input into individual array elements. The "
  11994. "@code{set} and @code{declare} builtins display array values in a way that "
  11995. "allows them to be reused as input."
  11996. msgstr ""
  11997. #. type: cindex
  11998. #: bashref.texi:7069
  11999. #, no-wrap
  12000. msgid "directory stack"
  12001. msgstr ""
  12002. #. type: subsection
  12003. #: bashref.texi:7074 bashref.texi:7087 bashref.texi:7088
  12004. #, no-wrap
  12005. msgid "Directory Stack Builtins"
  12006. msgstr ""
  12007. #. type: menuentry
  12008. #: bashref.texi:7074
  12009. msgid "Bash builtin commands to manipulate the directory stack."
  12010. msgstr ""
  12011. #. type: Plain text
  12012. #: bashref.texi:7083
  12013. msgid ""
  12014. "The directory stack is a list of recently-visited directories. The "
  12015. "@code{pushd} builtin adds directories to the stack as it changes the current "
  12016. "directory, and the @code{popd} builtin removes specified directories from "
  12017. "the stack and changes the current directory to the directory removed. The "
  12018. "@code{dirs} builtin displays the contents of the directory stack. The "
  12019. "current directory is always the \"top\" of the directory stack."
  12020. msgstr ""
  12021. #. type: Plain text
  12022. #: bashref.texi:7086
  12023. msgid ""
  12024. "The contents of the directory stack are also visible as the value of the "
  12025. "@env{DIRSTACK} shell variable."
  12026. msgstr ""
  12027. #. type: btindex
  12028. #: bashref.texi:7092 bashref.texi:7093
  12029. #, no-wrap
  12030. msgid "dirs"
  12031. msgstr ""
  12032. #. type: example
  12033. #: bashref.texi:7096
  12034. #, no-wrap
  12035. msgid "dirs [-clpv] [+@var{N} | -@var{N}]\n"
  12036. msgstr ""
  12037. #. type: table
  12038. #: bashref.texi:7102
  12039. msgid ""
  12040. "Display the list of currently remembered directories. Directories are added "
  12041. "to the list with the @code{pushd} command; the @code{popd} command removes "
  12042. "directories from the list. The current directory is always the first "
  12043. "directory in the stack."
  12044. msgstr ""
  12045. #. type: table
  12046. #: bashref.texi:7106
  12047. msgid "Clears the directory stack by deleting all of the elements."
  12048. msgstr ""
  12049. #. type: table
  12050. #: bashref.texi:7109
  12051. msgid ""
  12052. "Produces a listing using full pathnames; the default listing format uses a "
  12053. "tilde to denote the home directory."
  12054. msgstr ""
  12055. #. type: table
  12056. #: bashref.texi:7112
  12057. msgid ""
  12058. "Causes @code{dirs} to print the directory stack with one entry per line."
  12059. msgstr ""
  12060. #. type: table
  12061. #: bashref.texi:7115
  12062. msgid ""
  12063. "Causes @code{dirs} to print the directory stack with one entry per line, "
  12064. "prefixing each entry with its index in the stack."
  12065. msgstr ""
  12066. #. type: item
  12067. #: bashref.texi:7115 bashref.texi:7141 bashref.texi:7164
  12068. #, no-wrap
  12069. msgid "+@var{N}"
  12070. msgstr ""
  12071. #. type: table
  12072. #: bashref.texi:7119
  12073. msgid ""
  12074. "Displays the @var{N}th directory (counting from the left of the list printed "
  12075. "by @code{dirs} when invoked without options), starting with zero."
  12076. msgstr ""
  12077. #. type: item
  12078. #: bashref.texi:7119 bashref.texi:7144 bashref.texi:7168
  12079. #, no-wrap
  12080. msgid "-@var{N}"
  12081. msgstr ""
  12082. #. type: table
  12083. #: bashref.texi:7123
  12084. msgid ""
  12085. "Displays the @var{N}th directory (counting from the right of the list "
  12086. "printed by @code{dirs} when invoked without options), starting with zero."
  12087. msgstr ""
  12088. #. type: btindex
  12089. #: bashref.texi:7125 bashref.texi:7126
  12090. #, no-wrap
  12091. msgid "popd"
  12092. msgstr ""
  12093. #. type: example
  12094. #: bashref.texi:7129
  12095. #, no-wrap
  12096. msgid "popd [-n] [+@var{N} | -@var{N}]\n"
  12097. msgstr ""
  12098. #. type: table
  12099. #: bashref.texi:7136
  12100. msgid ""
  12101. "When no arguments are given, @code{popd} removes the top directory from the "
  12102. "stack and performs a @code{cd} to the new top directory. The elements are "
  12103. "numbered from 0 starting at the first directory listed with @code{dirs}; "
  12104. "that is, @code{popd} is equivalent to @code{popd +0}."
  12105. msgstr ""
  12106. #. type: table
  12107. #: bashref.texi:7141
  12108. msgid ""
  12109. "Suppresses the normal change of directory when removing directories from the "
  12110. "stack, so that only the stack is manipulated."
  12111. msgstr ""
  12112. #. type: table
  12113. #: bashref.texi:7144
  12114. msgid ""
  12115. "Removes the @var{N}th directory (counting from the left of the list printed "
  12116. "by @code{dirs}), starting with zero."
  12117. msgstr ""
  12118. #. type: table
  12119. #: bashref.texi:7147
  12120. msgid ""
  12121. "Removes the @var{N}th directory (counting from the right of the list printed "
  12122. "by @code{dirs}), starting with zero."
  12123. msgstr ""
  12124. #. type: item
  12125. #: bashref.texi:7149 bashref.texi:7150
  12126. #, no-wrap
  12127. msgid "pushd"
  12128. msgstr ""
  12129. #. type: example
  12130. #: bashref.texi:7153
  12131. #, no-wrap
  12132. msgid "pushd [-n] [@var{+N} | @var{-N} | @var{dir}]\n"
  12133. msgstr ""
  12134. #. type: table
  12135. #: bashref.texi:7159
  12136. msgid ""
  12137. "Save the current directory on the top of the directory stack and then "
  12138. "@code{cd} to @var{dir}. With no arguments, @code{pushd} exchanges the top "
  12139. "two directories and makes the new top the current directory."
  12140. msgstr ""
  12141. #. type: table
  12142. #: bashref.texi:7164
  12143. msgid ""
  12144. "Suppresses the normal change of directory when rotating or adding "
  12145. "directories to the stack, so that only the stack is manipulated."
  12146. msgstr ""
  12147. #. type: table
  12148. #: bashref.texi:7168
  12149. msgid ""
  12150. "Brings the @var{N}th directory (counting from the left of the list printed "
  12151. "by @code{dirs}, starting with zero) to the top of the list by rotating the "
  12152. "stack."
  12153. msgstr ""
  12154. #. type: table
  12155. #: bashref.texi:7172
  12156. msgid ""
  12157. "Brings the @var{N}th directory (counting from the right of the list printed "
  12158. "by @code{dirs}, starting with zero) to the top of the list by rotating the "
  12159. "stack."
  12160. msgstr ""
  12161. #. type: var{#1}
  12162. #: bashref.texi:7172
  12163. #, no-wrap
  12164. msgid "dir"
  12165. msgstr ""
  12166. #. type: table
  12167. #: bashref.texi:7176
  12168. msgid ""
  12169. "Makes @var{dir} be the top of the stack, making it the new current directory "
  12170. "as if it had been supplied as an argument to the @code{cd} builtin."
  12171. msgstr ""
  12172. #. type: cindex
  12173. #: bashref.texi:7181
  12174. #, no-wrap
  12175. msgid "prompting"
  12176. msgstr ""
  12177. #. type: Plain text
  12178. #: bashref.texi:7187
  12179. msgid ""
  12180. "The value of the variable @env{PROMPT_COMMAND} is examined just before Bash "
  12181. "prints each primary prompt. If @env{PROMPT_COMMAND} is set and has a non-"
  12182. "null value, then the value is executed just as if it had been typed on the "
  12183. "command line."
  12184. msgstr ""
  12185. #. type: Plain text
  12186. #: bashref.texi:7190
  12187. msgid ""
  12188. "In addition, the following table describes the special characters which can "
  12189. "appear in the prompt variables @env{PS1} to @env{PS4}:"
  12190. msgstr ""
  12191. #. type: table
  12192. #: bashref.texi:7194
  12193. msgid "A bell character."
  12194. msgstr ""
  12195. #. type: item
  12196. #: bashref.texi:7194
  12197. #, no-wrap
  12198. msgid "\\d"
  12199. msgstr ""
  12200. #. type: table
  12201. #: bashref.texi:7196
  12202. msgid "The date, in \"Weekday Month Date\" format (e.g., \"Tue May 26\")."
  12203. msgstr ""
  12204. #. type: item
  12205. #: bashref.texi:7196
  12206. #, no-wrap
  12207. msgid "\\D@{@var{format}@}"
  12208. msgstr ""
  12209. #. type: table
  12210. #: bashref.texi:7200
  12211. msgid ""
  12212. "The @var{format} is passed to @code{strftime}(3) and the result is inserted "
  12213. "into the prompt string; an empty @var{format} results in a locale-specific "
  12214. "time representation. The braces are required."
  12215. msgstr ""
  12216. #. type: table
  12217. #: bashref.texi:7202
  12218. msgid "An escape character."
  12219. msgstr ""
  12220. #. type: item
  12221. #: bashref.texi:7202
  12222. #, no-wrap
  12223. msgid "\\h"
  12224. msgstr ""
  12225. #. type: table
  12226. #: bashref.texi:7204
  12227. msgid "The hostname, up to the first `.'."
  12228. msgstr ""
  12229. #. type: item
  12230. #: bashref.texi:7204
  12231. #, no-wrap
  12232. msgid "\\H"
  12233. msgstr ""
  12234. #. type: table
  12235. #: bashref.texi:7206
  12236. msgid "The hostname."
  12237. msgstr ""
  12238. #. type: item
  12239. #: bashref.texi:7206
  12240. #, no-wrap
  12241. msgid "\\j"
  12242. msgstr ""
  12243. #. type: table
  12244. #: bashref.texi:7208
  12245. msgid "The number of jobs currently managed by the shell."
  12246. msgstr ""
  12247. #. type: item
  12248. #: bashref.texi:7208
  12249. #, no-wrap
  12250. msgid "\\l"
  12251. msgstr ""
  12252. #. type: table
  12253. #: bashref.texi:7210
  12254. msgid "The basename of the shell's terminal device name."
  12255. msgstr ""
  12256. #. type: table
  12257. #: bashref.texi:7212
  12258. msgid "A newline."
  12259. msgstr ""
  12260. #. type: table
  12261. #: bashref.texi:7214
  12262. msgid "A carriage return."
  12263. msgstr ""
  12264. #. type: item
  12265. #: bashref.texi:7214
  12266. #, no-wrap
  12267. msgid "\\s"
  12268. msgstr ""
  12269. #. type: table
  12270. #: bashref.texi:7217
  12271. msgid ""
  12272. "The name of the shell, the basename of @code{$0} (the portion following the "
  12273. "final slash)."
  12274. msgstr ""
  12275. #. type: table
  12276. #: bashref.texi:7219
  12277. msgid "The time, in 24-hour HH:MM:SS format."
  12278. msgstr ""
  12279. #. type: item
  12280. #: bashref.texi:7219
  12281. #, no-wrap
  12282. msgid "\\T"
  12283. msgstr ""
  12284. #. type: table
  12285. #: bashref.texi:7221
  12286. msgid "The time, in 12-hour HH:MM:SS format."
  12287. msgstr ""
  12288. #. type: item
  12289. #: bashref.texi:7221
  12290. #, no-wrap
  12291. msgid "\\@@"
  12292. msgstr ""
  12293. #. type: table
  12294. #: bashref.texi:7223
  12295. msgid "The time, in 12-hour am/pm format."
  12296. msgstr ""
  12297. #. type: item
  12298. #: bashref.texi:7223
  12299. #, no-wrap
  12300. msgid "\\A"
  12301. msgstr ""
  12302. #. type: table
  12303. #: bashref.texi:7225
  12304. msgid "The time, in 24-hour HH:MM format."
  12305. msgstr ""
  12306. #. type: item
  12307. #: bashref.texi:7225
  12308. #, no-wrap
  12309. msgid "\\u"
  12310. msgstr ""
  12311. #. type: table
  12312. #: bashref.texi:7227
  12313. msgid "The username of the current user."
  12314. msgstr ""
  12315. #. type: table
  12316. #: bashref.texi:7229
  12317. msgid "The version of Bash (e.g., 2.00)"
  12318. msgstr ""
  12319. #. type: item
  12320. #: bashref.texi:7229
  12321. #, no-wrap
  12322. msgid "\\V"
  12323. msgstr ""
  12324. #. type: table
  12325. #: bashref.texi:7231
  12326. msgid "The release of Bash, version + patchlevel (e.g., 2.00.0)"
  12327. msgstr ""
  12328. #. type: item
  12329. #: bashref.texi:7231
  12330. #, no-wrap
  12331. msgid "\\w"
  12332. msgstr ""
  12333. #. type: table
  12334. #: bashref.texi:7234
  12335. msgid ""
  12336. "The current working directory, with @env{$HOME} abbreviated with a tilde "
  12337. "(uses the @env{$PROMPT_DIRTRIM} variable)."
  12338. msgstr ""
  12339. #. type: item
  12340. #: bashref.texi:7234
  12341. #, no-wrap
  12342. msgid "\\W"
  12343. msgstr ""
  12344. #. type: table
  12345. #: bashref.texi:7236
  12346. msgid "The basename of @env{$PWD}, with @env{$HOME} abbreviated with a tilde."
  12347. msgstr ""
  12348. #. type: item
  12349. #: bashref.texi:7236
  12350. #, no-wrap
  12351. msgid "\\!"
  12352. msgstr ""
  12353. #. type: table
  12354. #: bashref.texi:7238
  12355. msgid "The history number of this command."
  12356. msgstr ""
  12357. #. type: item
  12358. #: bashref.texi:7238
  12359. #, no-wrap
  12360. msgid "\\#"
  12361. msgstr ""
  12362. #. type: table
  12363. #: bashref.texi:7240
  12364. msgid "The command number of this command."
  12365. msgstr ""
  12366. #. type: item
  12367. #: bashref.texi:7240
  12368. #, no-wrap
  12369. msgid "\\$"
  12370. msgstr ""
  12371. #. type: table
  12372. #: bashref.texi:7242
  12373. msgid "If the effective uid is 0, @code{#}, otherwise @code{$}."
  12374. msgstr ""
  12375. #. type: table
  12376. #: bashref.texi:7244
  12377. msgid "The character whose ASCII code is the octal value @var{nnn}."
  12378. msgstr ""
  12379. #. type: table
  12380. #: bashref.texi:7246
  12381. msgid "A backslash."
  12382. msgstr ""
  12383. #. type: item
  12384. #: bashref.texi:7246
  12385. #, no-wrap
  12386. msgid "\\["
  12387. msgstr ""
  12388. #. type: table
  12389. #: bashref.texi:7249
  12390. msgid ""
  12391. "Begin a sequence of non-printing characters. This could be used to embed a "
  12392. "terminal control sequence into the prompt."
  12393. msgstr ""
  12394. #. type: item
  12395. #: bashref.texi:7249
  12396. #, no-wrap
  12397. msgid "\\]"
  12398. msgstr ""
  12399. #. type: table
  12400. #: bashref.texi:7251
  12401. msgid "End a sequence of non-printing characters."
  12402. msgstr ""
  12403. #. type: Plain text
  12404. #: bashref.texi:7259
  12405. msgid ""
  12406. "The command number and the history number are usually different: the history "
  12407. "number of a command is its position in the history list, which may include "
  12408. "commands restored from the history file (@pxref{Bash History Facilities}), "
  12409. "while the command number is the position in the sequence of commands "
  12410. "executed during the current shell session."
  12411. msgstr ""
  12412. #. type: Plain text
  12413. #: bashref.texi:7264
  12414. msgid ""
  12415. "After the string is decoded, it is expanded via parameter expansion, command "
  12416. "substitution, arithmetic expansion, and quote removal, subject to the value "
  12417. "of the @code{promptvars} shell option (@pxref{Bash Builtins})."
  12418. msgstr ""
  12419. #. type: cindex
  12420. #: bashref.texi:7267
  12421. #, no-wrap
  12422. msgid "restricted shell"
  12423. msgstr ""
  12424. #. type: Plain text
  12425. #: bashref.texi:7278
  12426. msgid ""
  12427. "If Bash is started with the name @code{rbash}, or the @option{--restricted} "
  12428. "or @option{-r} option is supplied at invocation, the shell becomes "
  12429. "restricted. A restricted shell is used to set up an environment more "
  12430. "controlled than the standard shell. A restricted shell behaves identically "
  12431. "to @code{bash} with the exception that the following are disallowed or not "
  12432. "performed:"
  12433. msgstr ""
  12434. #. type: itemize
  12435. #: bashref.texi:7282
  12436. msgid "Changing directories with the @code{cd} builtin."
  12437. msgstr ""
  12438. #. type: itemize
  12439. #: bashref.texi:7285
  12440. msgid ""
  12441. "Setting or unsetting the values of the @env{SHELL}, @env{PATH}, @env{ENV}, "
  12442. "or @env{BASH_ENV} variables."
  12443. msgstr ""
  12444. #. type: itemize
  12445. #: bashref.texi:7287
  12446. msgid "Specifying command names containing slashes."
  12447. msgstr ""
  12448. #. type: itemize
  12449. #: bashref.texi:7290
  12450. msgid ""
  12451. "Specifying a filename containing a slash as an argument to the @code{.} "
  12452. "builtin command."
  12453. msgstr ""
  12454. #. type: itemize
  12455. #: bashref.texi:7293
  12456. msgid ""
  12457. "Specifying a filename containing a slash as an argument to the @option{-p} "
  12458. "option to the @code{hash} builtin command."
  12459. msgstr ""
  12460. #. type: itemize
  12461. #: bashref.texi:7295
  12462. msgid "Importing function definitions from the shell environment at startup."
  12463. msgstr ""
  12464. #. type: itemize
  12465. #: bashref.texi:7297
  12466. msgid ""
  12467. "Parsing the value of @env{SHELLOPTS} from the shell environment at startup."
  12468. msgstr ""
  12469. #. type: itemize
  12470. #: bashref.texi:7300
  12471. msgid ""
  12472. "Redirecting output using the @samp{>}, @samp{>|}, @samp{<>}, @samp{>&}, "
  12473. "@samp{&>}, and @samp{>>} redirection operators."
  12474. msgstr ""
  12475. #. type: itemize
  12476. #: bashref.texi:7302
  12477. msgid ""
  12478. "Using the @code{exec} builtin to replace the shell with another command."
  12479. msgstr ""
  12480. #. type: itemize
  12481. #: bashref.texi:7305
  12482. msgid ""
  12483. "Adding or deleting builtin commands with the @option{-f} and @option{-d} "
  12484. "options to the @code{enable} builtin."
  12485. msgstr ""
  12486. #. type: itemize
  12487. #: bashref.texi:7307
  12488. msgid ""
  12489. "Using the @code{enable} builtin command to enable disabled shell builtins."
  12490. msgstr ""
  12491. #. type: itemize
  12492. #: bashref.texi:7309
  12493. msgid "Specifying the @option{-p} option to the @code{command} builtin."
  12494. msgstr ""
  12495. #. type: itemize
  12496. #: bashref.texi:7311
  12497. msgid ""
  12498. "Turning off restricted mode with @samp{set +r} or @samp{set +o restricted}."
  12499. msgstr ""
  12500. #. type: Plain text
  12501. #: bashref.texi:7314
  12502. msgid "These restrictions are enforced after any startup files are read."
  12503. msgstr ""
  12504. #. type: Plain text
  12505. #: bashref.texi:7318
  12506. msgid ""
  12507. "When a command that is found to be a shell script is executed (@pxref{Shell "
  12508. "Scripts}), @code{rbash} turns off any restrictions in the shell spawned to "
  12509. "execute the script."
  12510. msgstr ""
  12511. #. type: cindex
  12512. #: bashref.texi:7321
  12513. #, no-wrap
  12514. msgid "POSIX Mode"
  12515. msgstr ""
  12516. #. type: Plain text
  12517. #: bashref.texi:7327
  12518. msgid ""
  12519. "Starting Bash with the @option{--posix} command-line option or executing "
  12520. "@samp{set -o posix} while Bash is running will cause Bash to conform more "
  12521. "closely to the @sc{posix} standard by changing the behavior to match that "
  12522. "specified by @sc{posix} in areas where the Bash default differs."
  12523. msgstr ""
  12524. #. type: Plain text
  12525. #: bashref.texi:7330
  12526. msgid ""
  12527. "When invoked as @code{sh}, Bash enters @sc{posix} mode after reading the "
  12528. "startup files."
  12529. msgstr ""
  12530. #. type: Plain text
  12531. #: bashref.texi:7332
  12532. msgid ""
  12533. "The following list is what's changed when `@sc{posix} mode' is in effect:"
  12534. msgstr ""
  12535. #. type: enumerate
  12536. #: bashref.texi:7338
  12537. msgid ""
  12538. "When a command in the hash table no longer exists, Bash will re-search "
  12539. "@env{$PATH} to find the new location. This is also available with "
  12540. "@samp{shopt -s checkhash}."
  12541. msgstr ""
  12542. #. type: enumerate
  12543. #: bashref.texi:7342
  12544. msgid ""
  12545. "The message printed by the job control code and builtins when a job exits "
  12546. "with a non-zero status is `Done(status)'."
  12547. msgstr ""
  12548. #. type: enumerate
  12549. #: bashref.texi:7347
  12550. msgid ""
  12551. "The message printed by the job control code and builtins when a job is "
  12552. "stopped is `Stopped(@var{signame})', where @var{signame} is, for example, "
  12553. "@code{SIGTSTP}."
  12554. msgstr ""
  12555. #. type: enumerate
  12556. #: bashref.texi:7350
  12557. msgid "Alias expansion is always enabled, even in non-interactive shells."
  12558. msgstr ""
  12559. #. type: enumerate
  12560. #: bashref.texi:7354
  12561. msgid ""
  12562. "Reserved words appearing in a context where reserved words are recognized do "
  12563. "not undergo alias expansion."
  12564. msgstr ""
  12565. #. type: enumerate
  12566. #: bashref.texi:7360
  12567. msgid ""
  12568. "The @sc{posix} @env{PS1} and @env{PS2} expansions of @samp{!} to the history "
  12569. "number and @samp{!!} to @samp{!} are enabled, and parameter expansion is "
  12570. "performed on the values of @env{PS1} and @env{PS2} regardless of the setting "
  12571. "of the @code{promptvars} option."
  12572. msgstr ""
  12573. #. type: enumerate
  12574. #: bashref.texi:7364
  12575. msgid ""
  12576. "The @sc{posix} startup files are executed (@env{$ENV}) rather than the "
  12577. "normal Bash files."
  12578. msgstr ""
  12579. #. type: enumerate
  12580. #: bashref.texi:7368
  12581. msgid ""
  12582. "Tilde expansion is only performed on assignments preceding a command name, "
  12583. "rather than on all assignment statements on the line."
  12584. msgstr ""
  12585. #. type: enumerate
  12586. #: bashref.texi:7372
  12587. msgid ""
  12588. "The default history file is @file{~/.sh_history} (this is the default value "
  12589. "of @env{$HISTFILE})."
  12590. msgstr ""
  12591. #. type: enumerate
  12592. #: bashref.texi:7376
  12593. msgid ""
  12594. "Redirection operators do not perform filename expansion on the word in the "
  12595. "redirection unless the shell is interactive."
  12596. msgstr ""
  12597. #. type: enumerate
  12598. #: bashref.texi:7380
  12599. msgid ""
  12600. "Redirection operators do not perform word splitting on the word in the "
  12601. "redirection."
  12602. msgstr ""
  12603. #. type: enumerate
  12604. #: bashref.texi:7386
  12605. msgid ""
  12606. "Function names must be valid shell @code{name}s. That is, they may not "
  12607. "contain characters other than letters, digits, and underscores, and may not "
  12608. "start with a digit. Declaring a function with an invalid name causes a "
  12609. "fatal syntax error in non-interactive shells."
  12610. msgstr ""
  12611. #. type: enumerate
  12612. #: bashref.texi:7390
  12613. msgid ""
  12614. "Function names may not be the same as one of the @sc{posix} special builtins."
  12615. msgstr ""
  12616. #. type: enumerate
  12617. #: bashref.texi:7394
  12618. msgid ""
  12619. "@sc{posix} special builtins are found before shell functions during command "
  12620. "lookup."
  12621. msgstr ""
  12622. #. type: enumerate
  12623. #: bashref.texi:7398
  12624. msgid ""
  12625. "When printing shell function definitions (e.g., by @code{type}), Bash does "
  12626. "not print the @code{function} keyword."
  12627. msgstr ""
  12628. #. type: enumerate
  12629. #: bashref.texi:7403
  12630. msgid ""
  12631. "Literal tildes that appear as the first character in elements of the "
  12632. "@env{PATH} variable are not expanded as described above under @ref{Tilde "
  12633. "Expansion}."
  12634. msgstr ""
  12635. #. type: enumerate
  12636. #: bashref.texi:7409
  12637. msgid ""
  12638. "The @code{time} reserved word may be used by itself as a command. When used "
  12639. "in this way, it displays timing statistics for the shell and its completed "
  12640. "children. The @env{TIMEFORMAT} variable controls the format of the timing "
  12641. "information."
  12642. msgstr ""
  12643. #. type: enumerate
  12644. #: bashref.texi:7416
  12645. msgid ""
  12646. "When parsing and expanding a $@{@dots{}@} expansion that appears within "
  12647. "double quotes, single quotes are no longer special and cannot be used to "
  12648. "quote a closing brace or other special character, unless the operator is one "
  12649. "of those defined to perform pattern removal. In this case, they do not have "
  12650. "to appear as matched pairs."
  12651. msgstr ""
  12652. #. type: enumerate
  12653. #: bashref.texi:7420
  12654. msgid ""
  12655. "The parser does not recognize @code{time} as a reserved word if the next "
  12656. "token begins with a @samp{-}."
  12657. msgstr ""
  12658. #. type: enumerate
  12659. #: bashref.texi:7424
  12660. msgid ""
  12661. "The @samp{!} character does not introduce history expansion within a double-"
  12662. "quoted string, even if the @code{histexpand} option is enabled."
  12663. msgstr ""
  12664. #. type: enumerate
  12665. #: bashref.texi:7431
  12666. msgid ""
  12667. "If a @sc{posix} special builtin returns an error status, a non-interactive "
  12668. "shell exits. The fatal errors are those listed in the @sc{posix} standard, "
  12669. "and include things like passing incorrect options, redirection errors, "
  12670. "variable assignment errors for assignments preceding the command name, and "
  12671. "so on."
  12672. msgstr ""
  12673. #. type: enumerate
  12674. #: bashref.texi:7438
  12675. msgid ""
  12676. "A non-interactive shell exits with an error status if a variable assignment "
  12677. "error occurs when no command name follows the assignment statements. A "
  12678. "variable assignment error occurs, for example, when trying to assign a value "
  12679. "to a readonly variable."
  12680. msgstr ""
  12681. #. type: enumerate
  12682. #: bashref.texi:7443
  12683. msgid ""
  12684. "A non-interactive shell exits with an error status if a variable assignment "
  12685. "error occurs in an assignment statement preceding a special builtin, but not "
  12686. "with any other simple command."
  12687. msgstr ""
  12688. #. type: enumerate
  12689. #: bashref.texi:7448
  12690. msgid ""
  12691. "A non-interactive shell exits with an error status if the iteration variable "
  12692. "in a @code{for} statement or the selection variable in a @code{select} "
  12693. "statement is a readonly variable."
  12694. msgstr ""
  12695. #. type: enumerate
  12696. #: bashref.texi:7452
  12697. msgid ""
  12698. "Non-interactive shells exit if @var{filename} in @code{.} @var{filename} is "
  12699. "not found."
  12700. msgstr ""
  12701. #. type: enumerate
  12702. #: bashref.texi:7456
  12703. msgid ""
  12704. "Non-interactive shells exit if a syntax error in an arithmetic expansion "
  12705. "results in an invalid expression."
  12706. msgstr ""
  12707. #. type: enumerate
  12708. #: bashref.texi:7459
  12709. msgid "Non-interactive shells exit if a parameter expansion error occurs."
  12710. msgstr ""
  12711. #. type: enumerate
  12712. #: bashref.texi:7464
  12713. msgid ""
  12714. "Non-interactive shells exit if there is a syntax error in a script read with "
  12715. "the @code{.} or @code{source} builtins, or in a string processed by the "
  12716. "@code{eval} builtin."
  12717. msgstr ""
  12718. #. type: enumerate
  12719. #: bashref.texi:7467
  12720. msgid "Process substitution is not available."
  12721. msgstr ""
  12722. #. type: enumerate
  12723. #: bashref.texi:7471
  12724. msgid ""
  12725. "While variable indirection is available, it may not be applied to the "
  12726. "@samp{#} and @samp{?} special parameters."
  12727. msgstr ""
  12728. #. type: enumerate
  12729. #: bashref.texi:7476
  12730. msgid ""
  12731. "When expanding the @samp{*} special parameter in a pattern context where the "
  12732. "expansion is double-quoted does not treat the @code{$*} as if it were double-"
  12733. "quoted."
  12734. msgstr ""
  12735. #. type: enumerate
  12736. #: bashref.texi:7480
  12737. msgid ""
  12738. "Assignment statements preceding @sc{posix} special builtins persist in the "
  12739. "shell environment after the builtin completes."
  12740. msgstr ""
  12741. #. type: enumerate
  12742. #: bashref.texi:7485
  12743. msgid ""
  12744. "Assignment statements preceding shell function calls persist in the shell "
  12745. "environment after the function returns, as if a @sc{posix} special builtin "
  12746. "command had been executed."
  12747. msgstr ""
  12748. #. type: enumerate
  12749. #: bashref.texi:7491
  12750. msgid ""
  12751. "The @code{command} builtin does not prevent builtins that take assignment "
  12752. "statements as arguments from expanding them as assignment statements; when "
  12753. "not in @sc{posix} mode, assignment builtins lose their assignment statement "
  12754. "expansion properties when preceded by @code{command}."
  12755. msgstr ""
  12756. #. type: enumerate
  12757. #: bashref.texi:7496
  12758. msgid ""
  12759. "The @code{bg} builtin uses the required format to describe each job placed "
  12760. "in the background, which does not include an indication of whether the job "
  12761. "is the current or previous job."
  12762. msgstr ""
  12763. #. type: enumerate
  12764. #: bashref.texi:7500
  12765. msgid ""
  12766. "The output of @samp{kill -l} prints all the signal names on a single line, "
  12767. "separated by spaces, without the @samp{SIG} prefix."
  12768. msgstr ""
  12769. #. type: enumerate
  12770. #: bashref.texi:7504
  12771. msgid ""
  12772. "The @code{kill} builtin does not accept signal names with a @samp{SIG} "
  12773. "prefix."
  12774. msgstr ""
  12775. #. type: enumerate
  12776. #: bashref.texi:7508
  12777. msgid ""
  12778. "The @code{export} and @code{readonly} builtin commands display their output "
  12779. "in the format required by @sc{posix}."
  12780. msgstr ""
  12781. #. type: enumerate
  12782. #: bashref.texi:7512
  12783. msgid ""
  12784. "The @code{trap} builtin displays signal names without the leading @code{SIG}."
  12785. msgstr ""
  12786. #. type: enumerate
  12787. #: bashref.texi:7520
  12788. msgid ""
  12789. "The @code{trap} builtin doesn't check the first argument for a possible "
  12790. "signal specification and revert the signal handling to the original "
  12791. "disposition if it is, unless that argument consists solely of digits and is "
  12792. "a valid signal number. If users want to reset the handler for a given "
  12793. "signal to the original disposition, they should use @samp{-} as the first "
  12794. "argument."
  12795. msgstr ""
  12796. #. type: enumerate
  12797. #: bashref.texi:7524
  12798. msgid ""
  12799. "The @code{.} and @code{source} builtins do not search the current directory "
  12800. "for the filename argument if it is not found by searching @env{PATH}."
  12801. msgstr ""
  12802. #. type: enumerate
  12803. #: bashref.texi:7532
  12804. msgid ""
  12805. "Enabling @sc{posix} mode has the effect of setting the "
  12806. "@code{inherit_errexit} option, so subshells spawned to execute command "
  12807. "substitutions inherit the value of the @option{-e} option from the parent "
  12808. "shell. When the @code{inherit_errexit} option is not enabled, Bash clears "
  12809. "the @option{-e} option in such subshells."
  12810. msgstr ""
  12811. #. type: enumerate
  12812. #: bashref.texi:7537
  12813. msgid ""
  12814. "When the @code{alias} builtin displays alias definitions, it does not "
  12815. "display them with a leading @samp{alias } unless the @option{-p} option is "
  12816. "supplied."
  12817. msgstr ""
  12818. #. type: enumerate
  12819. #: bashref.texi:7541
  12820. msgid ""
  12821. "When the @code{set} builtin is invoked without options, it does not display "
  12822. "shell function names and definitions."
  12823. msgstr ""
  12824. #. type: enumerate
  12825. #: bashref.texi:7546
  12826. msgid ""
  12827. "When the @code{set} builtin is invoked without options, it displays variable "
  12828. "values without quotes, unless they contain shell metacharacters, even if the "
  12829. "result contains nonprinting characters."
  12830. msgstr ""
  12831. #. type: enumerate
  12832. #: bashref.texi:7552
  12833. msgid ""
  12834. "When the @code{cd} builtin is invoked in @var{logical} mode, and the "
  12835. "pathname constructed from @code{$PWD} and the directory name supplied as an "
  12836. "argument does not refer to an existing directory, @code{cd} will fail "
  12837. "instead of falling back to @var{physical} mode."
  12838. msgstr ""
  12839. #. type: enumerate
  12840. #: bashref.texi:7557
  12841. msgid ""
  12842. "The @code{pwd} builtin verifies that the value it prints is the same as the "
  12843. "current directory, even if it is not asked to check the file system with the "
  12844. "@option{-P} option."
  12845. msgstr ""
  12846. #. type: enumerate
  12847. #: bashref.texi:7561
  12848. msgid ""
  12849. "When listing the history, the @code{fc} builtin does not include an "
  12850. "indication of whether or not a history entry has been modified."
  12851. msgstr ""
  12852. #. type: enumerate
  12853. #: bashref.texi:7564
  12854. msgid "The default editor used by @code{fc} is @code{ed}."
  12855. msgstr ""
  12856. #. type: enumerate
  12857. #: bashref.texi:7569
  12858. msgid ""
  12859. "The @code{type} and @code{command} builtins will not report a non-executable "
  12860. "file as having been found, though the shell will attempt to execute such a "
  12861. "file if it is the only so-named file found in @code{$PATH}."
  12862. msgstr ""
  12863. #. type: enumerate
  12864. #: bashref.texi:7574
  12865. msgid ""
  12866. "The @code{vi} editing mode will invoke the @code{vi} editor directly when "
  12867. "the @samp{v} command is run, instead of checking @code{$VISUAL} and "
  12868. "@code{$EDITOR}."
  12869. msgstr ""
  12870. #. type: enumerate
  12871. #: bashref.texi:7579
  12872. msgid ""
  12873. "When the @code{xpg_echo} option is enabled, Bash does not attempt to "
  12874. "interpret any arguments to @code{echo} as options. Each argument is "
  12875. "displayed, after escape characters are converted."
  12876. msgstr ""
  12877. #. type: enumerate
  12878. #: bashref.texi:7583
  12879. msgid ""
  12880. "The @code{ulimit} builtin uses a block size of 512 bytes for the @option{-c} "
  12881. "and @option{-f} options."
  12882. msgstr ""
  12883. #. type: enumerate
  12884. #: bashref.texi:7588
  12885. msgid ""
  12886. "The arrival of @code{SIGCHLD} when a trap is set on @code{SIGCHLD} does not "
  12887. "interrupt the @code{wait} builtin and cause it to return immediately. The "
  12888. "trap command is run once for each child that exits."
  12889. msgstr ""
  12890. #. type: enumerate
  12891. #: bashref.texi:7594
  12892. msgid ""
  12893. "The @code{read} builtin may be interrupted by a signal for which a trap has "
  12894. "been set. If Bash receives a trapped signal while executing @code{read}, "
  12895. "the trap handler executes and @code{read} returns an exit status greater "
  12896. "than 128."
  12897. msgstr ""
  12898. #. type: enumerate
  12899. #: bashref.texi:7598
  12900. msgid ""
  12901. "Bash removes an exited background process's status from the list of such "
  12902. "statuses after the @code{wait} builtin is used to obtain it."
  12903. msgstr ""
  12904. #. type: Plain text
  12905. #: bashref.texi:7604
  12906. msgid ""
  12907. "There is other @sc{posix} behavior that Bash does not implement by default "
  12908. "even when in @sc{posix} mode. Specifically:"
  12909. msgstr ""
  12910. #. type: enumerate
  12911. #: bashref.texi:7611
  12912. msgid ""
  12913. "The @code{fc} builtin checks @code{$EDITOR} as a program to edit history "
  12914. "entries if @code{FCEDIT} is unset, rather than defaulting directly to "
  12915. "@code{ed}. @code{fc} uses @code{ed} if @code{EDITOR} is unset."
  12916. msgstr ""
  12917. #. type: enumerate
  12918. #: bashref.texi:7615
  12919. msgid ""
  12920. "As noted above, Bash requires the @code{xpg_echo} option to be enabled for "
  12921. "the @code{echo} builtin to be fully conformant."
  12922. msgstr ""
  12923. #. type: Plain text
  12924. #: bashref.texi:7621
  12925. msgid ""
  12926. "Bash can be configured to be @sc{posix}-conformant by default, by specifying "
  12927. "the @option{--enable-strict-posix-default} to @code{configure} when building "
  12928. "(@pxref{Optional Features})."
  12929. msgstr ""
  12930. #. type: Plain text
  12931. #: bashref.texi:7627
  12932. msgid ""
  12933. "This chapter discusses what job control is, how it works, and how Bash "
  12934. "allows you to access its facilities."
  12935. msgstr ""
  12936. #. type: section
  12937. #: bashref.texi:7634 bashref.texi:7636 bashref.texi:7637
  12938. #, no-wrap
  12939. msgid "Job Control Basics"
  12940. msgstr ""
  12941. #. type: menuentry
  12942. #: bashref.texi:7634
  12943. msgid "How job control works."
  12944. msgstr ""
  12945. #. type: section
  12946. #: bashref.texi:7634 bashref.texi:7741 bashref.texi:7742
  12947. #, no-wrap
  12948. msgid "Job Control Builtins"
  12949. msgstr ""
  12950. #. type: menuentry
  12951. #: bashref.texi:7634
  12952. msgid "Bash builtin commands used to interact with job control."
  12953. msgstr ""
  12954. #. type: section
  12955. #: bashref.texi:7634 bashref.texi:7884 bashref.texi:7885
  12956. #, no-wrap
  12957. msgid "Job Control Variables"
  12958. msgstr ""
  12959. #. type: menuentry
  12960. #: bashref.texi:7634
  12961. msgid "Variables Bash uses to customize job control."
  12962. msgstr ""
  12963. #. type: cindex
  12964. #: bashref.texi:7639
  12965. #, no-wrap
  12966. msgid "foreground"
  12967. msgstr ""
  12968. #. type: cindex
  12969. #: bashref.texi:7640
  12970. #, no-wrap
  12971. msgid "background"
  12972. msgstr ""
  12973. #. type: cindex
  12974. #: bashref.texi:7641
  12975. #, no-wrap
  12976. msgid "suspending jobs"
  12977. msgstr ""
  12978. #. type: Plain text
  12979. #: bashref.texi:7649
  12980. msgid ""
  12981. "Job control refers to the ability to selectively stop (suspend) the "
  12982. "execution of processes and continue (resume) their execution at a later "
  12983. "point. A user typically employs this facility via an interactive interface "
  12984. "supplied jointly by the operating system kernel's terminal driver and Bash."
  12985. msgstr ""
  12986. #. type: Plain text
  12987. #: bashref.texi:7655
  12988. msgid ""
  12989. "The shell associates a @var{job} with each pipeline. It keeps a table of "
  12990. "currently executing jobs, which may be listed with the @code{jobs} command. "
  12991. "When Bash starts a job asynchronously, it prints a line that looks like:"
  12992. msgstr ""
  12993. #. type: example
  12994. #: bashref.texi:7657
  12995. #, no-wrap
  12996. msgid "[1] 25647\n"
  12997. msgstr ""
  12998. #. type: Plain text
  12999. #: bashref.texi:7664
  13000. msgid ""
  13001. "indicating that this job is job number 1 and that the process @sc{id} of the "
  13002. "last process in the pipeline associated with this job is 25647. All of the "
  13003. "processes in a single pipeline are members of the same job. Bash uses the "
  13004. "@var{job} abstraction as the basis for job control."
  13005. msgstr ""
  13006. #. type: Plain text
  13007. #: bashref.texi:7680
  13008. msgid ""
  13009. "To facilitate the implementation of the user interface to job control, the "
  13010. "operating system maintains the notion of a current terminal process group "
  13011. "@sc{id}. Members of this process group (processes whose process group "
  13012. "@sc{id} is equal to the current terminal process group @sc{id}) receive "
  13013. "keyboard-generated signals such as @code{SIGINT}. These processes are said "
  13014. "to be in the foreground. Background processes are those whose process group "
  13015. "@sc{id} differs from the terminal's; such processes are immune to keyboard-"
  13016. "generated signals. Only foreground processes are allowed to read from or, "
  13017. "if the user so specifies with @code{stty tostop}, write to the terminal. "
  13018. "Background processes which attempt to read from (write to when @code{stty "
  13019. "tostop} is in effect) the terminal are sent a @code{SIGTTIN} "
  13020. "(@code{SIGTTOU}) signal by the kernel's terminal driver, which, unless "
  13021. "caught, suspends the process."
  13022. msgstr ""
  13023. #. type: Plain text
  13024. #: bashref.texi:7694
  13025. msgid ""
  13026. "If the operating system on which Bash is running supports job control, Bash "
  13027. "contains facilities to use it. Typing the @var{suspend} character "
  13028. "(typically @samp{^Z}, Control-Z) while a process is running causes that "
  13029. "process to be stopped and returns control to Bash. Typing the @var{delayed "
  13030. "suspend} character (typically @samp{^Y}, Control-Y) causes the process to be "
  13031. "stopped when it attempts to read input from the terminal, and control to be "
  13032. "returned to Bash. The user then manipulates the state of this job, using "
  13033. "the @code{bg} command to continue it in the background, the @code{fg} "
  13034. "command to continue it in the foreground, or the @code{kill} command to kill "
  13035. "it. A @samp{^Z} takes effect immediately, and has the additional side "
  13036. "effect of causing pending output and typeahead to be discarded."
  13037. msgstr ""
  13038. #. type: Plain text
  13039. #: bashref.texi:7697
  13040. msgid ""
  13041. "There are a number of ways to refer to a job in the shell. The character "
  13042. "@samp{%} introduces a job specification (@var{jobspec})."
  13043. msgstr ""
  13044. #. type: Plain text
  13045. #: bashref.texi:7710
  13046. msgid ""
  13047. "Job number @code{n} may be referred to as @samp{%n}. The symbols @samp{%%} "
  13048. "and @samp{%+} refer to the shell's notion of the current job, which is the "
  13049. "last job stopped while it was in the foreground or started in the "
  13050. "background. A single @samp{%} (with no accompanying job specification) also "
  13051. "refers to the current job. The previous job may be referenced using "
  13052. "@samp{%-}. If there is only a single job, @samp{%+} and @samp{%-} can both "
  13053. "be used to refer to that job. In output pertaining to jobs (e.g., the "
  13054. "output of the @code{jobs} command), the current job is always flagged with a "
  13055. "@samp{+}, and the previous job with a @samp{-}."
  13056. msgstr ""
  13057. #. type: Plain text
  13058. #: bashref.texi:7718
  13059. msgid ""
  13060. "A job may also be referred to using a prefix of the name used to start it, "
  13061. "or using a substring that appears in its command line. For example, "
  13062. "@samp{%ce} refers to a stopped @code{ce} job. Using @samp{%?ce}, on the "
  13063. "other hand, refers to any job containing the string @samp{ce} in its command "
  13064. "line. If the prefix or substring matches more than one job, Bash reports an "
  13065. "error."
  13066. msgstr ""
  13067. #. type: Plain text
  13068. #: bashref.texi:7723
  13069. msgid ""
  13070. "Simply naming a job can be used to bring it into the foreground: @samp{%1} "
  13071. "is a synonym for @samp{fg %1}, bringing job 1 from the background into the "
  13072. "foreground. Similarly, @samp{%1 &} resumes job 1 in the background, "
  13073. "equivalent to @samp{bg %1}"
  13074. msgstr ""
  13075. #. type: Plain text
  13076. #: bashref.texi:7732
  13077. msgid ""
  13078. "The shell learns immediately whenever a job changes state. Normally, Bash "
  13079. "waits until it is about to print a prompt before reporting changes in a "
  13080. "job's status so as to not interrupt any other output. If the @option{-b} "
  13081. "option to the @code{set} builtin is enabled, Bash reports such changes "
  13082. "immediately (@pxref{The Set Builtin}). Any trap on @code{SIGCHLD} is "
  13083. "executed for each child process that exits."
  13084. msgstr ""
  13085. #. type: Plain text
  13086. #: bashref.texi:7740
  13087. msgid ""
  13088. "If an attempt to exit Bash is made while jobs are stopped, (or running, if "
  13089. "the @code{checkjobs} option is enabled -- see @ref{The Shopt Builtin}), the "
  13090. "shell prints a warning message, and if the @code{checkjobs} option is "
  13091. "enabled, lists the jobs and their statuses. The @code{jobs} command may "
  13092. "then be used to inspect their status. If a second attempt to exit is made "
  13093. "without an intervening command, Bash does not print another warning, and any "
  13094. "stopped jobs are terminated."
  13095. msgstr ""
  13096. #. type: btindex
  13097. #: bashref.texi:7746 bashref.texi:7747
  13098. #, no-wrap
  13099. msgid "bg"
  13100. msgstr ""
  13101. #. type: example
  13102. #: bashref.texi:7750
  13103. #, no-wrap
  13104. msgid "bg [@var{jobspec} @dots{}]\n"
  13105. msgstr ""
  13106. #. type: table
  13107. #: bashref.texi:7759
  13108. msgid ""
  13109. "Resume each suspended job @var{jobspec} in the background, as if it had been "
  13110. "started with @samp{&}. If @var{jobspec} is not supplied, the current job is "
  13111. "used. The return status is zero unless it is run when job control is not "
  13112. "enabled, or, when run with job control enabled, any @var{jobspec} was not "
  13113. "found or specifies a job that was started without job control."
  13114. msgstr ""
  13115. #. type: btindex
  13116. #: bashref.texi:7760 bashref.texi:7761
  13117. #, no-wrap
  13118. msgid "fg"
  13119. msgstr ""
  13120. #. type: example
  13121. #: bashref.texi:7764
  13122. #, no-wrap
  13123. msgid "fg [@var{jobspec}]\n"
  13124. msgstr ""
  13125. #. type: table
  13126. #: bashref.texi:7772
  13127. msgid ""
  13128. "Resume the job @var{jobspec} in the foreground and make it the current job. "
  13129. "If @var{jobspec} is not supplied, the current job is used. The return "
  13130. "status is that of the command placed into the foreground, or non-zero if run "
  13131. "when job control is disabled or, when run with job control enabled, "
  13132. "@var{jobspec} does not specify a valid job or @var{jobspec} specifies a job "
  13133. "that was started without job control."
  13134. msgstr ""
  13135. #. type: btindex
  13136. #: bashref.texi:7773 bashref.texi:7774
  13137. #, no-wrap
  13138. msgid "jobs"
  13139. msgstr ""
  13140. #. type: example
  13141. #: bashref.texi:7778
  13142. #, no-wrap
  13143. msgid ""
  13144. "jobs [-lnprs] [@var{jobspec}]\n"
  13145. "jobs -x @var{command} [@var{arguments}]\n"
  13146. msgstr ""
  13147. #. type: table
  13148. #: bashref.texi:7782
  13149. msgid ""
  13150. "The first form lists the active jobs. The options have the following "
  13151. "meanings:"
  13152. msgstr ""
  13153. #. type: table
  13154. #: bashref.texi:7786
  13155. msgid "List process @sc{id}s in addition to the normal information."
  13156. msgstr ""
  13157. #. type: table
  13158. #: bashref.texi:7790
  13159. msgid ""
  13160. "Display information only about jobs that have changed status since the user "
  13161. "was last notified of their status."
  13162. msgstr ""
  13163. #. type: table
  13164. #: bashref.texi:7793
  13165. msgid "List only the process @sc{id} of the job's process group leader."
  13166. msgstr ""
  13167. #. type: table
  13168. #: bashref.texi:7796
  13169. msgid "Display only running jobs."
  13170. msgstr ""
  13171. #. type: table
  13172. #: bashref.texi:7799
  13173. msgid "Display only stopped jobs."
  13174. msgstr ""
  13175. #. type: table
  13176. #: bashref.texi:7805
  13177. msgid ""
  13178. "If @var{jobspec} is given, output is restricted to information about that "
  13179. "job. If @var{jobspec} is not supplied, the status of all jobs is listed."
  13180. msgstr ""
  13181. #. type: table
  13182. #: bashref.texi:7810
  13183. msgid ""
  13184. "If the @option{-x} option is supplied, @code{jobs} replaces any "
  13185. "@var{jobspec} found in @var{command} or @var{arguments} with the "
  13186. "corresponding process group @sc{id}, and executes @var{command}, passing it "
  13187. "@var{argument}s, returning its exit status."
  13188. msgstr ""
  13189. #. type: btindex
  13190. #: bashref.texi:7811 bashref.texi:7812
  13191. #, no-wrap
  13192. msgid "kill"
  13193. msgstr ""
  13194. #. type: example
  13195. #: bashref.texi:7816
  13196. #, no-wrap
  13197. msgid ""
  13198. "kill [-s @var{sigspec}] [-n @var{signum}] [-@var{sigspec}] @var{jobspec} or @var{pid}\n"
  13199. "kill -l|-L [@var{exit_status}]\n"
  13200. msgstr ""
  13201. #. type: table
  13202. #: bashref.texi:7833
  13203. msgid ""
  13204. "Send a signal specified by @var{sigspec} or @var{signum} to the process "
  13205. "named by job specification @var{jobspec} or process @sc{id} @var{pid}. "
  13206. "@var{sigspec} is either a case-insensitive signal name such as @code{SIGINT} "
  13207. "(with or without the @code{SIG} prefix) or a signal number; @var{signum} is "
  13208. "a signal number. If @var{sigspec} and @var{signum} are not present, "
  13209. "@code{SIGTERM} is used. The @option{-l} option lists the signal names. If "
  13210. "any arguments are supplied when @option{-l} is given, the names of the "
  13211. "signals corresponding to the arguments are listed, and the return status is "
  13212. "zero. @var{exit_status} is a number specifying a signal number or the exit "
  13213. "status of a process terminated by a signal. The @option{-L} option is "
  13214. "equivalent to @option{-l}. The return status is zero if at least one signal "
  13215. "was successfully sent, or non-zero if an error occurs or an invalid option "
  13216. "is encountered."
  13217. msgstr ""
  13218. #. type: btindex
  13219. #: bashref.texi:7834 bashref.texi:7835
  13220. #, no-wrap
  13221. msgid "wait"
  13222. msgstr ""
  13223. #. type: example
  13224. #: bashref.texi:7838
  13225. #, no-wrap
  13226. msgid "wait [-n] [@var{jobspec} or @var{pid} @dots{}]\n"
  13227. msgstr ""
  13228. #. type: table
  13229. #: bashref.texi:7850
  13230. msgid ""
  13231. "Wait until the child process specified by each process @sc{id} @var{pid} or "
  13232. "job specification @var{jobspec} exits and return the exit status of the last "
  13233. "command waited for. If a job spec is given, all processes in the job are "
  13234. "waited for. If no arguments are given, all currently active child processes "
  13235. "are waited for, and the return status is zero. If the @option{-n} option is "
  13236. "supplied, @code{wait} waits for any job to terminate and returns its exit "
  13237. "status. If neither @var{jobspec} nor @var{pid} specifies an active child "
  13238. "process of the shell, the return status is 127."
  13239. msgstr ""
  13240. #. type: btindex
  13241. #: bashref.texi:7851 bashref.texi:7852
  13242. #, no-wrap
  13243. msgid "disown"
  13244. msgstr ""
  13245. #. type: example
  13246. #: bashref.texi:7855
  13247. #, no-wrap
  13248. msgid "disown [-ar] [-h] [@var{jobspec} @dots{} | @var{pid} @dots{} ]\n"
  13249. msgstr ""
  13250. #. type: table
  13251. #: bashref.texi:7867
  13252. msgid ""
  13253. "Without options, remove each @var{jobspec} from the table of active jobs. "
  13254. "If the @option{-h} option is given, the job is not removed from the table, "
  13255. "but is marked so that @code{SIGHUP} is not sent to the job if the shell "
  13256. "receives a @code{SIGHUP}. If @var{jobspec} is not present, and neither the "
  13257. "@option{-a} nor the @option{-r} option is supplied, the current job is "
  13258. "used. If no @var{jobspec} is supplied, the @option{-a} option means to "
  13259. "remove or mark all jobs; the @option{-r} option without a @var{jobspec} "
  13260. "argument restricts operation to running jobs."
  13261. msgstr ""
  13262. #. type: btindex
  13263. #: bashref.texi:7868 bashref.texi:7869
  13264. #, no-wrap
  13265. msgid "suspend"
  13266. msgstr ""
  13267. #. type: example
  13268. #: bashref.texi:7872
  13269. #, no-wrap
  13270. msgid "suspend [-f]\n"
  13271. msgstr ""
  13272. #. type: table
  13273. #: bashref.texi:7878
  13274. msgid ""
  13275. "Suspend the execution of this shell until it receives a @code{SIGCONT} "
  13276. "signal. A login shell cannot be suspended; the @option{-f} option can be "
  13277. "used to override this and force the suspension."
  13278. msgstr ""
  13279. #. type: Plain text
  13280. #: bashref.texi:7883
  13281. msgid ""
  13282. "When job control is not active, the @code{kill} and @code{wait} builtins do "
  13283. "not accept @var{jobspec} arguments. They must be supplied process @sc{id}s."
  13284. msgstr ""
  13285. #. type: item
  13286. #: bashref.texi:7889
  13287. #, no-wrap
  13288. msgid "auto_resume"
  13289. msgstr ""
  13290. #. type: Plain text
  13291. #: bashref.texi:7906
  13292. msgid ""
  13293. "This variable controls how the shell interacts with the user and job "
  13294. "control. If this variable exists then single word simple commands without "
  13295. "redirections are treated as candidates for resumption of an existing job. "
  13296. "There is no ambiguity allowed; if there is more than one job beginning with "
  13297. "the string typed, then the most recently accessed job will be selected. The "
  13298. "name of a stopped job, in this context, is the command line used to start "
  13299. "it. If this variable is set to the value @samp{exact}, the string supplied "
  13300. "must match the name of a stopped job exactly; if set to @samp{substring}, "
  13301. "the string supplied needs to match a substring of the name of a stopped "
  13302. "job. The @samp{substring} value provides functionality analogous to the "
  13303. "@samp{%?} job @sc{id} (@pxref{Job Control Basics}). If set to any other "
  13304. "value, the supplied string must be a prefix of a stopped job's name; this "
  13305. "provides functionality analogous to the @samp{%} job @sc{id}."
  13306. msgstr ""
  13307. #. type: cindex
  13308. #: bashref.texi:7911
  13309. #, no-wrap
  13310. msgid "Readline, how to use"
  13311. msgstr ""
  13312. #. type: include
  13313. #: bashref.texi:7912
  13314. #, no-wrap
  13315. msgid "rluser.texi"
  13316. msgstr ""
  13317. #. type: cindex
  13318. #: bashref.texi:7913
  13319. #, no-wrap
  13320. msgid "History, how to use"
  13321. msgstr ""
  13322. #. type: include
  13323. #: bashref.texi:7914
  13324. #, no-wrap
  13325. msgid "hsuser.texi"
  13326. msgstr ""
  13327. #. type: Plain text
  13328. #: bashref.texi:7927
  13329. msgid ""
  13330. "This chapter provides basic instructions for installing Bash on the various "
  13331. "supported platforms. The distribution supports the @sc{gnu} operating "
  13332. "systems, nearly every version of Unix, and several non-Unix systems such as "
  13333. "BeOS and Interix. Other independent ports exist for @sc{ms-dos}, @sc{os/2}, "
  13334. "and Windows platforms."
  13335. msgstr ""
  13336. #. type: section
  13337. #: bashref.texi:7942 bashref.texi:7944 bashref.texi:7945
  13338. #, no-wrap
  13339. msgid "Basic Installation"
  13340. msgstr ""
  13341. #. type: menuentry
  13342. #: bashref.texi:7942
  13343. msgid "Installation instructions."
  13344. msgstr ""
  13345. #. type: section
  13346. #: bashref.texi:7942 bashref.texi:8024 bashref.texi:8025
  13347. #, no-wrap
  13348. msgid "Compilers and Options"
  13349. msgstr ""
  13350. #. type: menuentry
  13351. #: bashref.texi:7942
  13352. msgid "How to set special options for various systems."
  13353. msgstr ""
  13354. #. type: section
  13355. #: bashref.texi:7942 bashref.texi:8046 bashref.texi:8047
  13356. #, no-wrap
  13357. msgid "Compiling For Multiple Architectures"
  13358. msgstr ""
  13359. #. type: menuentry
  13360. #: bashref.texi:7942
  13361. msgid ""
  13362. "How to compile Bash for more than one kind of system from the same source "
  13363. "tree."
  13364. msgstr ""
  13365. #. type: section
  13366. #: bashref.texi:7942 bashref.texi:8081 bashref.texi:8082
  13367. #, no-wrap
  13368. msgid "Installation Names"
  13369. msgstr ""
  13370. #. type: menuentry
  13371. #: bashref.texi:7942
  13372. msgid "How to set the various paths used by the installation."
  13373. msgstr ""
  13374. #. type: section
  13375. #: bashref.texi:7942 bashref.texi:8098 bashref.texi:8099
  13376. #, no-wrap
  13377. msgid "Specifying the System Type"
  13378. msgstr ""
  13379. #. type: menuentry
  13380. #: bashref.texi:7942
  13381. msgid "How to configure Bash for a particular system."
  13382. msgstr ""
  13383. #. type: section
  13384. #: bashref.texi:7942 bashref.texi:8113 bashref.texi:8114
  13385. #, no-wrap
  13386. msgid "Sharing Defaults"
  13387. msgstr ""
  13388. #. type: menuentry
  13389. #: bashref.texi:7942
  13390. msgid "How to share default configuration values among GNU programs."
  13391. msgstr ""
  13392. #. type: section
  13393. #: bashref.texi:7942 bashref.texi:8126 bashref.texi:8127
  13394. #, no-wrap
  13395. msgid "Operation Controls"
  13396. msgstr ""
  13397. #. type: menuentry
  13398. #: bashref.texi:7942
  13399. msgid "Options recognized by the configuration program."
  13400. msgstr ""
  13401. #. type: section
  13402. #: bashref.texi:7942 bashref.texi:8160 bashref.texi:8161
  13403. #, no-wrap
  13404. msgid "Optional Features"
  13405. msgstr ""
  13406. #. type: menuentry
  13407. #: bashref.texi:7942
  13408. msgid "How to enable and disable optional features when building Bash."
  13409. msgstr ""
  13410. #. type: cindex
  13411. #: bashref.texi:7946
  13412. #, no-wrap
  13413. msgid "installation"
  13414. msgstr ""
  13415. #. type: cindex
  13416. #: bashref.texi:7947
  13417. #, no-wrap
  13418. msgid "configuration"
  13419. msgstr ""
  13420. #. type: cindex
  13421. #: bashref.texi:7948
  13422. #, no-wrap
  13423. msgid "Bash installation"
  13424. msgstr ""
  13425. #. type: cindex
  13426. #: bashref.texi:7949
  13427. #, no-wrap
  13428. msgid "Bash configuration"
  13429. msgstr ""
  13430. #. type: Plain text
  13431. #: bashref.texi:7952
  13432. msgid "These are installation instructions for Bash."
  13433. msgstr ""
  13434. #. type: Plain text
  13435. #: bashref.texi:7954
  13436. msgid "The simplest way to compile Bash is:"
  13437. msgstr ""
  13438. #. type: enumerate
  13439. #: bashref.texi:7962
  13440. msgid ""
  13441. "@code{cd} to the directory containing the source code and type @samp{./"
  13442. "configure} to configure Bash for your system. If you're using @code{csh} on "
  13443. "an old version of System V, you might need to type @samp{sh ./configure} "
  13444. "instead to prevent @code{csh} from trying to execute @code{configure} itself."
  13445. msgstr ""
  13446. #. type: enumerate
  13447. #: bashref.texi:7966
  13448. msgid ""
  13449. "Running @code{configure} takes some time. While running, it prints messages "
  13450. "telling which features it is checking for."
  13451. msgstr ""
  13452. #. type: enumerate
  13453. #: bashref.texi:7970
  13454. msgid ""
  13455. "Type @samp{make} to compile Bash and build the @code{bashbug} bug reporting "
  13456. "script."
  13457. msgstr ""
  13458. #. type: enumerate
  13459. #: bashref.texi:7973
  13460. msgid "Optionally, type @samp{make tests} to run the Bash test suite."
  13461. msgstr ""
  13462. #. type: enumerate
  13463. #: bashref.texi:7977
  13464. msgid ""
  13465. "Type @samp{make install} to install @code{bash} and @code{bashbug}. This "
  13466. "will also install the manual pages and Info file."
  13467. msgstr ""
  13468. #. type: Plain text
  13469. #: bashref.texi:7995
  13470. msgid ""
  13471. "The @code{configure} shell script attempts to guess correct values for "
  13472. "various system-dependent variables used during compilation. It uses those "
  13473. "values to create a @file{Makefile} in each directory of the package (the top "
  13474. "directory, the @file{builtins}, @file{doc}, and @file{support} directories, "
  13475. "each directory under @file{lib}, and several others). It also creates a "
  13476. "@file{config.h} file containing system-dependent definitions. Finally, it "
  13477. "creates a shell script named @code{config.status} that you can run in the "
  13478. "future to recreate the current configuration, a file @file{config.cache} "
  13479. "that saves the results of its tests to speed up reconfiguring, and a file "
  13480. "@file{config.log} containing compiler output (useful mainly for debugging "
  13481. "@code{configure}). If at some point @file{config.cache} contains results "
  13482. "you don't want to keep, you may remove or edit it."
  13483. msgstr ""
  13484. #. type: Plain text
  13485. #: bashref.texi:7998
  13486. msgid ""
  13487. "To find out more about the options and arguments that the @code{configure} "
  13488. "script understands, type"
  13489. msgstr ""
  13490. #. type: example
  13491. #: bashref.texi:8001
  13492. #, no-wrap
  13493. msgid "bash-2.04$ ./configure --help\n"
  13494. msgstr ""
  13495. #. type: Plain text
  13496. #: bashref.texi:8005
  13497. msgid "at the Bash prompt in your Bash source directory."
  13498. msgstr ""
  13499. #. type: Plain text
  13500. #: bashref.texi:8011
  13501. msgid ""
  13502. "If you need to do unusual things to compile Bash, please try to figure out "
  13503. "how @code{configure} could check whether or not to do them, and mail diffs "
  13504. "or instructions to @email{bash-maintainers@@gnu.org} so they can be "
  13505. "considered for the next release."
  13506. msgstr ""
  13507. #. type: Plain text
  13508. #: bashref.texi:8018
  13509. msgid ""
  13510. "The file @file{configure.ac} is used to create @code{configure} by a program "
  13511. "called Autoconf. You only need @file{configure.ac} if you want to change it "
  13512. "or regenerate @code{configure} using a newer version of Autoconf. If you do "
  13513. "this, make sure you are using Autoconf version 2.50 or newer."
  13514. msgstr ""
  13515. #. type: Plain text
  13516. #: bashref.texi:8023
  13517. msgid ""
  13518. "You can remove the program binaries and object files from the source code "
  13519. "directory by typing @samp{make clean}. To also remove the files that "
  13520. "@code{configure} created (so you can compile Bash for a different kind of "
  13521. "computer), type @samp{make distclean}."
  13522. msgstr ""
  13523. #. type: Plain text
  13524. #: bashref.texi:8032
  13525. msgid ""
  13526. "Some systems require unusual options for compilation or linking that the "
  13527. "@code{configure} script does not know about. You can give @code{configure} "
  13528. "initial values for variables by setting them in the environment. Using a "
  13529. "Bourne-compatible shell, you can do that on the command line like this:"
  13530. msgstr ""
  13531. #. type: example
  13532. #: bashref.texi:8035
  13533. #, no-wrap
  13534. msgid "CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure\n"
  13535. msgstr ""
  13536. #. type: Plain text
  13537. #: bashref.texi:8038
  13538. msgid "On systems that have the @code{env} program, you can do it like this:"
  13539. msgstr ""
  13540. #. type: example
  13541. #: bashref.texi:8041
  13542. #, no-wrap
  13543. msgid "env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure\n"
  13544. msgstr ""
  13545. #. type: Plain text
  13546. #: bashref.texi:8045
  13547. msgid "The configuration process uses GCC to build Bash if it is available."
  13548. msgstr ""
  13549. #. type: Plain text
  13550. #: bashref.texi:8059
  13551. msgid ""
  13552. "You can compile Bash for more than one kind of computer at the same time, by "
  13553. "placing the object files for each architecture in their own directory. To "
  13554. "do this, you must use a version of @code{make} that supports the "
  13555. "@code{VPATH} variable, such as GNU @code{make}. @code{cd} to the directory "
  13556. "where you want the object files and executables to go and run the "
  13557. "@code{configure} script from the source directory. You may need to supply "
  13558. "the @option{--srcdir=PATH} argument to tell @code{configure} where the "
  13559. "source files are. @code{configure} automatically checks for the source code "
  13560. "in the directory that @code{configure} is in and in `..'."
  13561. msgstr ""
  13562. #. type: Plain text
  13563. #: bashref.texi:8065
  13564. msgid ""
  13565. "If you have to use a @code{make} that does not supports the @code{VPATH} "
  13566. "variable, you can compile Bash for one architecture at a time in the source "
  13567. "code directory. After you have installed Bash for one architecture, use "
  13568. "@samp{make distclean} before reconfiguring for another architecture."
  13569. msgstr ""
  13570. #. type: Plain text
  13571. #: bashref.texi:8071
  13572. msgid ""
  13573. "Alternatively, if your system supports symbolic links, you can use the "
  13574. "@file{support/mkclone} script to create a build tree which has symbolic "
  13575. "links back to each file in the source directory. Here's an example that "
  13576. "creates a build directory in the current directory from a source directory "
  13577. "@file{/usr/gnu/src/bash-2.0}:"
  13578. msgstr ""
  13579. #. type: example
  13580. #: bashref.texi:8074
  13581. #, no-wrap
  13582. msgid "bash /usr/gnu/src/bash-2.0/support/mkclone -s /usr/gnu/src/bash-2.0 .\n"
  13583. msgstr ""
  13584. #. type: Plain text
  13585. #: bashref.texi:8080
  13586. msgid ""
  13587. "The @code{mkclone} script requires Bash, so you must have already built Bash "
  13588. "for at least one architecture before you can create build directories for "
  13589. "other architectures."
  13590. msgstr ""
  13591. #. type: Plain text
  13592. #: bashref.texi:8090
  13593. msgid ""
  13594. "By default, @samp{make install} will install into @file{/usr/local/bin}, "
  13595. "@file{/usr/local/man}, etc. You can specify an installation prefix other "
  13596. "than @file{/usr/local} by giving @code{configure} the option @option{--"
  13597. "prefix=@var{PATH}}, or by specifying a value for the @code{DESTDIR} "
  13598. "@samp{make} variable when running @samp{make install}."
  13599. msgstr ""
  13600. #. type: Plain text
  13601. #: bashref.texi:8097
  13602. msgid ""
  13603. "You can specify separate installation prefixes for architecture-specific "
  13604. "files and architecture-independent files. If you give @code{configure} the "
  13605. "option @option{--exec-prefix=@var{PATH}}, @samp{make install} will use "
  13606. "@var{PATH} as the prefix for installing programs and libraries. "
  13607. "Documentation and other data files will still use the regular prefix."
  13608. msgstr ""
  13609. #. type: Plain text
  13610. #: bashref.texi:8109
  13611. msgid ""
  13612. "There may be some features @code{configure} can not figure out "
  13613. "automatically, but need to determine by the type of host Bash will run on. "
  13614. "Usually @code{configure} can figure that out, but if it prints a message "
  13615. "saying it can not guess the host type, give it the @option{--host=TYPE} "
  13616. "option. @samp{TYPE} can either be a short name for the system type, such as "
  13617. "@samp{sun4}, or a canonical name with three fields: @samp{CPU-COMPANY-"
  13618. "SYSTEM} (e.g., @samp{i386-unknown-freebsd4.2})."
  13619. msgstr ""
  13620. #. type: Plain text
  13621. #: bashref.texi:8112
  13622. msgid ""
  13623. "See the file @file{support/config.sub} for the possible values of each field."
  13624. msgstr ""
  13625. #. type: Plain text
  13626. #: bashref.texi:8125
  13627. msgid ""
  13628. "If you want to set default values for @code{configure} scripts to share, you "
  13629. "can create a site shell script called @code{config.site} that gives default "
  13630. "values for variables like @code{CC}, @code{cache_file}, and @code{prefix}. "
  13631. "@code{configure} looks for @file{PREFIX/share/config.site} if it exists, "
  13632. "then @file{PREFIX/etc/config.site} if it exists. Or, you can set the "
  13633. "@code{CONFIG_SITE} environment variable to the location of the site script. "
  13634. "A warning: the Bash @code{configure} looks for a site script, but not all "
  13635. "@code{configure} scripts do."
  13636. msgstr ""
  13637. #. type: Plain text
  13638. #: bashref.texi:8131
  13639. msgid ""
  13640. "@code{configure} recognizes the following options to control how it operates."
  13641. msgstr ""
  13642. #. type: item
  13643. #: bashref.texi:8134
  13644. #, no-wrap
  13645. msgid "--cache-file=@var{file}"
  13646. msgstr ""
  13647. #. type: table
  13648. #: bashref.texi:8139
  13649. msgid ""
  13650. "Use and save the results of the tests in @var{file} instead of @file{./"
  13651. "config.cache}. Set @var{file} to @file{/dev/null} to disable caching, for "
  13652. "debugging @code{configure}."
  13653. msgstr ""
  13654. #. type: table
  13655. #: bashref.texi:8142
  13656. msgid "Print a summary of the options to @code{configure}, and exit."
  13657. msgstr ""
  13658. #. type: item
  13659. #: bashref.texi:8143
  13660. #, no-wrap
  13661. msgid "--quiet"
  13662. msgstr ""
  13663. #. type: itemx
  13664. #: bashref.texi:8144
  13665. #, no-wrap
  13666. msgid "--silent"
  13667. msgstr ""
  13668. #. type: table
  13669. #: bashref.texi:8147
  13670. msgid "Do not print messages saying which checks are being made."
  13671. msgstr ""
  13672. #. type: item
  13673. #: bashref.texi:8148
  13674. #, no-wrap
  13675. msgid "--srcdir=@var{dir}"
  13676. msgstr ""
  13677. #. type: table
  13678. #: bashref.texi:8151
  13679. msgid ""
  13680. "Look for the Bash source code in directory @var{dir}. Usually "
  13681. "@code{configure} can determine that directory automatically."
  13682. msgstr ""
  13683. #. type: table
  13684. #: bashref.texi:8155
  13685. msgid ""
  13686. "Print the version of Autoconf used to generate the @code{configure} script, "
  13687. "and exit."
  13688. msgstr ""
  13689. #. type: Plain text
  13690. #: bashref.texi:8159
  13691. msgid ""
  13692. "@code{configure} also accepts some other, not widely used, boilerplate "
  13693. "options. @samp{configure --help} prints the complete list."
  13694. msgstr ""
  13695. #. type: Plain text
  13696. #: bashref.texi:8170
  13697. msgid ""
  13698. "The Bash @code{configure} has a number of @option{--enable-@var{feature}} "
  13699. "options, where @var{feature} indicates an optional part of Bash. There are "
  13700. "also several @option{--with-@var{package}} options, where @var{package} is "
  13701. "something like @samp{bash-malloc} or @samp{purify}. To turn off the default "
  13702. "use of a package, use @option{--without-@var{package}}. To configure Bash "
  13703. "without a feature that is enabled by default, use @option{--disable-"
  13704. "@var{feature}}."
  13705. msgstr ""
  13706. #. type: Plain text
  13707. #: bashref.texi:8173
  13708. msgid ""
  13709. "Here is a complete list of the @option{--enable-} and @option{--with-} "
  13710. "options that the Bash @code{configure} recognizes."
  13711. msgstr ""
  13712. #. type: item
  13713. #: bashref.texi:8175
  13714. #, no-wrap
  13715. msgid "--with-afs"
  13716. msgstr ""
  13717. #. type: table
  13718. #: bashref.texi:8177
  13719. msgid "Define if you are using the Andrew File System from Transarc."
  13720. msgstr ""
  13721. #. type: item
  13722. #: bashref.texi:8178
  13723. #, no-wrap
  13724. msgid "--with-bash-malloc"
  13725. msgstr ""
  13726. #. type: table
  13727. #: bashref.texi:8188
  13728. msgid ""
  13729. "Use the Bash version of @code{malloc} in the directory @file{lib/malloc}. "
  13730. "This is not the same @code{malloc} that appears in @sc{gnu} libc, but an "
  13731. "older version originally derived from the 4.2 @sc{bsd} @code{malloc}. This "
  13732. "@code{malloc} is very fast, but wastes some space on each allocation. This "
  13733. "option is enabled by default. The @file{NOTES} file contains a list of "
  13734. "systems for which this should be turned off, and @code{configure} disables "
  13735. "this option automatically for a number of systems."
  13736. msgstr ""
  13737. #. type: item
  13738. #: bashref.texi:8189
  13739. #, no-wrap
  13740. msgid "--with-curses"
  13741. msgstr ""
  13742. #. type: table
  13743. #: bashref.texi:8193
  13744. msgid ""
  13745. "Use the curses library instead of the termcap library. This should be "
  13746. "supplied if your system has an inadequate or incomplete termcap database."
  13747. msgstr ""
  13748. #. type: item
  13749. #: bashref.texi:8194
  13750. #, no-wrap
  13751. msgid "--with-gnu-malloc"
  13752. msgstr ""
  13753. #. type: table
  13754. #: bashref.texi:8196
  13755. msgid "A synonym for @code{--with-bash-malloc}."
  13756. msgstr ""
  13757. #. type: item
  13758. #: bashref.texi:8197
  13759. #, no-wrap
  13760. msgid "--with-installed-readline[=@var{PREFIX}]"
  13761. msgstr ""
  13762. #. type: table
  13763. #: bashref.texi:8212
  13764. msgid ""
  13765. "Define this to make Bash link with a locally-installed version of Readline "
  13766. "rather than the version in @file{lib/readline}. This works only with "
  13767. "Readline 5.0 and later versions. If @var{PREFIX} is @code{yes} or not "
  13768. "supplied, @code{configure} uses the values of the make variables "
  13769. "@code{includedir} and @code{libdir}, which are subdirectories of "
  13770. "@code{prefix} by default, to find the installed version of Readline if it is "
  13771. "not in the standard system include and library directories. If @var{PREFIX} "
  13772. "is @code{no}, Bash links with the version in @file{lib/readline}. If "
  13773. "@var{PREFIX} is set to any other value, @code{configure} treats it as a "
  13774. "directory pathname and looks for the installed version of Readline in "
  13775. "subdirectories of that directory (include files in @var{PREFIX}/"
  13776. "@code{include} and the library in @var{PREFIX}/@code{lib})."
  13777. msgstr ""
  13778. #. type: item
  13779. #: bashref.texi:8213
  13780. #, no-wrap
  13781. msgid "--with-purify"
  13782. msgstr ""
  13783. #. type: table
  13784. #: bashref.texi:8216
  13785. msgid ""
  13786. "Define this to use the Purify memory allocation checker from Rational "
  13787. "Software."
  13788. msgstr ""
  13789. #. type: item
  13790. #: bashref.texi:8217
  13791. #, no-wrap
  13792. msgid "--enable-minimal-config"
  13793. msgstr ""
  13794. #. type: table
  13795. #: bashref.texi:8220
  13796. msgid ""
  13797. "This produces a shell with minimal features, close to the historical Bourne "
  13798. "shell."
  13799. msgstr ""
  13800. #. type: Plain text
  13801. #: bashref.texi:8224
  13802. msgid ""
  13803. "There are several @option{--enable-} options that alter how Bash is compiled "
  13804. "and linked, rather than changing run-time features."
  13805. msgstr ""
  13806. #. type: item
  13807. #: bashref.texi:8226
  13808. #, no-wrap
  13809. msgid "--enable-largefile"
  13810. msgstr ""
  13811. #. type: table
  13812. #: bashref.texi:8231
  13813. msgid ""
  13814. "Enable support for @uref{http://www.sas.com/standards/large_file/"
  13815. "x_open.20Mar96.html, large files} if the operating system requires special "
  13816. "compiler options to build programs which can access large files. This is "
  13817. "enabled by default, if the operating system provides large file support."
  13818. msgstr ""
  13819. #. type: item
  13820. #: bashref.texi:8232
  13821. #, no-wrap
  13822. msgid "--enable-profiling"
  13823. msgstr ""
  13824. #. type: table
  13825. #: bashref.texi:8235
  13826. msgid ""
  13827. "This builds a Bash binary that produces profiling information to be "
  13828. "processed by @code{gprof} each time it is executed."
  13829. msgstr ""
  13830. #. type: item
  13831. #: bashref.texi:8236
  13832. #, no-wrap
  13833. msgid "--enable-static-link"
  13834. msgstr ""
  13835. #. type: table
  13836. #: bashref.texi:8239
  13837. msgid ""
  13838. "This causes Bash to be linked statically, if @code{gcc} is being used. This "
  13839. "could be used to build a version to use as root's shell."
  13840. msgstr ""
  13841. #. type: Plain text
  13842. #: bashref.texi:8244
  13843. msgid ""
  13844. "The @samp{minimal-config} option can be used to disable all of the following "
  13845. "options, but it is processed first, so individual options may be enabled "
  13846. "using @samp{enable-@var{feature}}."
  13847. msgstr ""
  13848. #. type: Plain text
  13849. #: bashref.texi:8250
  13850. msgid ""
  13851. "All of the following options except for @samp{disabled-builtins}, "
  13852. "@samp{direxpand-default}, and @samp{xpg-echo-default} are enabled by "
  13853. "default, unless the operating system does not provide the necessary support."
  13854. msgstr ""
  13855. #. type: item
  13856. #: bashref.texi:8252
  13857. #, no-wrap
  13858. msgid "--enable-alias"
  13859. msgstr ""
  13860. #. type: table
  13861. #: bashref.texi:8255
  13862. msgid ""
  13863. "Allow alias expansion and include the @code{alias} and @code{unalias} "
  13864. "builtins (@pxref{Aliases})."
  13865. msgstr ""
  13866. #. type: item
  13867. #: bashref.texi:8256
  13868. #, no-wrap
  13869. msgid "--enable-arith-for-command"
  13870. msgstr ""
  13871. #. type: table
  13872. #: bashref.texi:8260
  13873. msgid ""
  13874. "Include support for the alternate form of the @code{for} command that "
  13875. "behaves like the C language @code{for} statement (@pxref{Looping "
  13876. "Constructs})."
  13877. msgstr ""
  13878. #. type: item
  13879. #: bashref.texi:8261
  13880. #, no-wrap
  13881. msgid "--enable-array-variables"
  13882. msgstr ""
  13883. #. type: table
  13884. #: bashref.texi:8264
  13885. msgid ""
  13886. "Include support for one-dimensional array shell variables (@pxref{Arrays})."
  13887. msgstr ""
  13888. #. type: item
  13889. #: bashref.texi:8265
  13890. #, no-wrap
  13891. msgid "--enable-bang-history"
  13892. msgstr ""
  13893. #. type: table
  13894. #: bashref.texi:8268
  13895. msgid ""
  13896. "Include support for @code{csh}-like history substitution (@pxref{History "
  13897. "Interaction})."
  13898. msgstr ""
  13899. #. type: item
  13900. #: bashref.texi:8269
  13901. #, no-wrap
  13902. msgid "--enable-brace-expansion"
  13903. msgstr ""
  13904. #. type: table
  13905. #: bashref.texi:8273
  13906. msgid ""
  13907. "Include @code{csh}-like brace expansion ( @code{b@{a,b@}c} @expansion{} "
  13908. "@code{bac bbc} ). See @ref{Brace Expansion}, for a complete description."
  13909. msgstr ""
  13910. #. type: item
  13911. #: bashref.texi:8274
  13912. #, no-wrap
  13913. msgid "--enable-casemod-attributes"
  13914. msgstr ""
  13915. #. type: table
  13916. #: bashref.texi:8278
  13917. msgid ""
  13918. "Include support for case-modifying attributes in the @code{declare} builtin "
  13919. "and assignment statements. Variables with the @var{uppercase} attribute, "
  13920. "for example, will have their values converted to uppercase upon assignment."
  13921. msgstr ""
  13922. #. type: item
  13923. #: bashref.texi:8279
  13924. #, no-wrap
  13925. msgid "--enable-casemod-expansion"
  13926. msgstr ""
  13927. #. type: table
  13928. #: bashref.texi:8281
  13929. msgid "Include support for case-modifying word expansions."
  13930. msgstr ""
  13931. #. type: item
  13932. #: bashref.texi:8282
  13933. #, no-wrap
  13934. msgid "--enable-command-timing"
  13935. msgstr ""
  13936. #. type: table
  13937. #: bashref.texi:8287
  13938. msgid ""
  13939. "Include support for recognizing @code{time} as a reserved word and for "
  13940. "displaying timing statistics for the pipeline following @code{time} "
  13941. "(@pxref{Pipelines}). This allows pipelines as well as shell builtins and "
  13942. "functions to be timed."
  13943. msgstr ""
  13944. #. type: item
  13945. #: bashref.texi:8288
  13946. #, no-wrap
  13947. msgid "--enable-cond-command"
  13948. msgstr ""
  13949. #. type: table
  13950. #: bashref.texi:8291
  13951. msgid ""
  13952. "Include support for the @code{[[} conditional command. (@pxref{Conditional "
  13953. "Constructs})."
  13954. msgstr ""
  13955. #. type: item
  13956. #: bashref.texi:8292
  13957. #, no-wrap
  13958. msgid "--enable-cond-regexp"
  13959. msgstr ""
  13960. #. type: table
  13961. #: bashref.texi:8296
  13962. msgid ""
  13963. "Include support for matching @sc{posix} regular expressions using the "
  13964. "@samp{=~} binary operator in the @code{[[} conditional command. "
  13965. "(@pxref{Conditional Constructs})."
  13966. msgstr ""
  13967. #. type: item
  13968. #: bashref.texi:8297
  13969. #, no-wrap
  13970. msgid "--enable-coprocesses"
  13971. msgstr ""
  13972. #. type: table
  13973. #: bashref.texi:8300
  13974. msgid ""
  13975. "Include support for coprocesses and the @code{coproc} reserved word "
  13976. "(@pxref{Pipelines})."
  13977. msgstr ""
  13978. #. type: item
  13979. #: bashref.texi:8301
  13980. #, no-wrap
  13981. msgid "--enable-debugger"
  13982. msgstr ""
  13983. #. type: table
  13984. #: bashref.texi:8303
  13985. msgid "Include support for the bash debugger (distributed separately)."
  13986. msgstr ""
  13987. #. type: item
  13988. #: bashref.texi:8304
  13989. #, no-wrap
  13990. msgid "--enable-direxpand-default"
  13991. msgstr ""
  13992. #. type: table
  13993. #: bashref.texi:8308
  13994. msgid ""
  13995. "Cause the @code{direxpand} shell option (@pxref{The Shopt Builtin}) to be "
  13996. "enabled by default when the shell starts. It is normally disabled by "
  13997. "default."
  13998. msgstr ""
  13999. #. type: item
  14000. #: bashref.texi:8309
  14001. #, no-wrap
  14002. msgid "--enable-directory-stack"
  14003. msgstr ""
  14004. #. type: table
  14005. #: bashref.texi:8313
  14006. msgid ""
  14007. "Include support for a @code{csh}-like directory stack and the @code{pushd}, "
  14008. "@code{popd}, and @code{dirs} builtins (@pxref{The Directory Stack})."
  14009. msgstr ""
  14010. #. type: item
  14011. #: bashref.texi:8314
  14012. #, no-wrap
  14013. msgid "--enable-disabled-builtins"
  14014. msgstr ""
  14015. #. type: table
  14016. #: bashref.texi:8319
  14017. msgid ""
  14018. "Allow builtin commands to be invoked via @samp{builtin xxx} even after "
  14019. "@code{xxx} has been disabled using @samp{enable -n xxx}. See @ref{Bash "
  14020. "Builtins}, for details of the @code{builtin} and @code{enable} builtin "
  14021. "commands."
  14022. msgstr ""
  14023. #. type: item
  14024. #: bashref.texi:8320
  14025. #, no-wrap
  14026. msgid "--enable-dparen-arithmetic"
  14027. msgstr ""
  14028. #. type: table
  14029. #: bashref.texi:8323
  14030. msgid ""
  14031. "Include support for the @code{((@dots{}))} command (@pxref{Conditional "
  14032. "Constructs})."
  14033. msgstr ""
  14034. #. type: item
  14035. #: bashref.texi:8324
  14036. #, no-wrap
  14037. msgid "--enable-extended-glob"
  14038. msgstr ""
  14039. #. type: table
  14040. #: bashref.texi:8327
  14041. msgid ""
  14042. "Include support for the extended pattern matching features described above "
  14043. "under @ref{Pattern Matching}."
  14044. msgstr ""
  14045. #. type: item
  14046. #: bashref.texi:8328
  14047. #, no-wrap
  14048. msgid "--enable-extended-glob-default"
  14049. msgstr ""
  14050. #. type: table
  14051. #: bashref.texi:8331
  14052. msgid ""
  14053. "Set the default value of the @var{extglob} shell option described above "
  14054. "under @ref{The Shopt Builtin} to be enabled."
  14055. msgstr ""
  14056. #. type: item
  14057. #: bashref.texi:8332
  14058. #, no-wrap
  14059. msgid "--enable-function-import"
  14060. msgstr ""
  14061. #. type: table
  14062. #: bashref.texi:8336
  14063. msgid ""
  14064. "Include support for importing function definitions exported by another "
  14065. "instance of the shell from the environment. This option is enabled by "
  14066. "default."
  14067. msgstr ""
  14068. #. type: item
  14069. #: bashref.texi:8337
  14070. #, no-wrap
  14071. msgid "--enable-glob-asciirange-default"
  14072. msgstr ""
  14073. #. type: table
  14074. #: bashref.texi:8342
  14075. msgid ""
  14076. "Set the default value of the @var{globasciiranges} shell option described "
  14077. "above under @ref{The Shopt Builtin} to be enabled. This controls the "
  14078. "behavior of character ranges when used in pattern matching bracket "
  14079. "expressions."
  14080. msgstr ""
  14081. #. type: item
  14082. #: bashref.texi:8343
  14083. #, no-wrap
  14084. msgid "--enable-help-builtin"
  14085. msgstr ""
  14086. #. type: table
  14087. #: bashref.texi:8346
  14088. msgid ""
  14089. "Include the @code{help} builtin, which displays help on shell builtins and "
  14090. "variables (@pxref{Bash Builtins})."
  14091. msgstr ""
  14092. #. type: item
  14093. #: bashref.texi:8347
  14094. #, no-wrap
  14095. msgid "--enable-history"
  14096. msgstr ""
  14097. #. type: table
  14098. #: bashref.texi:8350
  14099. msgid ""
  14100. "Include command history and the @code{fc} and @code{history} builtin "
  14101. "commands (@pxref{Bash History Facilities})."
  14102. msgstr ""
  14103. #. type: item
  14104. #: bashref.texi:8351
  14105. #, no-wrap
  14106. msgid "--enable-job-control"
  14107. msgstr ""
  14108. #. type: table
  14109. #: bashref.texi:8354
  14110. msgid ""
  14111. "This enables the job control features (@pxref{Job Control}), if the "
  14112. "operating system supports them."
  14113. msgstr ""
  14114. #. type: item
  14115. #: bashref.texi:8355
  14116. #, no-wrap
  14117. msgid "--enable-multibyte"
  14118. msgstr ""
  14119. #. type: table
  14120. #: bashref.texi:8358
  14121. msgid ""
  14122. "This enables support for multibyte characters if the operating system "
  14123. "provides the necessary support."
  14124. msgstr ""
  14125. #. type: item
  14126. #: bashref.texi:8359
  14127. #, no-wrap
  14128. msgid "--enable-net-redirections"
  14129. msgstr ""
  14130. #. type: table
  14131. #: bashref.texi:8364
  14132. msgid ""
  14133. "This enables the special handling of filenames of the form @code{/dev/tcp/"
  14134. "@var{host}/@var{port}} and @code{/dev/udp/@var{host}/@var{port}} when used "
  14135. "in redirections (@pxref{Redirections})."
  14136. msgstr ""
  14137. #. type: item
  14138. #: bashref.texi:8365
  14139. #, no-wrap
  14140. msgid "--enable-process-substitution"
  14141. msgstr ""
  14142. #. type: table
  14143. #: bashref.texi:8368
  14144. msgid ""
  14145. "This enables process substitution (@pxref{Process Substitution}) if the "
  14146. "operating system provides the necessary support."
  14147. msgstr ""
  14148. #. type: item
  14149. #: bashref.texi:8369
  14150. #, no-wrap
  14151. msgid "--enable-progcomp"
  14152. msgstr ""
  14153. #. type: table
  14154. #: bashref.texi:8373
  14155. msgid ""
  14156. "Enable the programmable completion facilities (@pxref{Programmable "
  14157. "Completion}). If Readline is not enabled, this option has no effect."
  14158. msgstr ""
  14159. #. type: item
  14160. #: bashref.texi:8374
  14161. #, no-wrap
  14162. msgid "--enable-prompt-string-decoding"
  14163. msgstr ""
  14164. #. type: table
  14165. #: bashref.texi:8379
  14166. msgid ""
  14167. "Turn on the interpretation of a number of backslash-escaped characters in "
  14168. "the @env{$PS1}, @env{$PS2}, @env{$PS3}, and @env{$PS4} prompt strings. See "
  14169. "@ref{Controlling the Prompt}, for a complete list of prompt string escape "
  14170. "sequences."
  14171. msgstr ""
  14172. #. type: item
  14173. #: bashref.texi:8380
  14174. #, no-wrap
  14175. msgid "--enable-readline"
  14176. msgstr ""
  14177. #. type: table
  14178. #: bashref.texi:8383
  14179. msgid ""
  14180. "Include support for command-line editing and history with the Bash version "
  14181. "of the Readline library (@pxref{Command Line Editing})."
  14182. msgstr ""
  14183. #. type: item
  14184. #: bashref.texi:8384
  14185. #, no-wrap
  14186. msgid "--enable-restricted"
  14187. msgstr ""
  14188. #. type: table
  14189. #: bashref.texi:8388
  14190. msgid ""
  14191. "Include support for a @dfn{restricted shell}. If this is enabled, Bash, "
  14192. "when called as @code{rbash}, enters a restricted mode. See @ref{The "
  14193. "Restricted Shell}, for a description of restricted mode."
  14194. msgstr ""
  14195. #. type: item
  14196. #: bashref.texi:8389
  14197. #, no-wrap
  14198. msgid "--enable-select"
  14199. msgstr ""
  14200. #. type: table
  14201. #: bashref.texi:8392
  14202. msgid ""
  14203. "Include the @code{select} compound command, which allows the generation of "
  14204. "simple menus (@pxref{Conditional Constructs})."
  14205. msgstr ""
  14206. #. type: item
  14207. #: bashref.texi:8393
  14208. #, no-wrap
  14209. msgid "--enable-separate-helpfiles"
  14210. msgstr ""
  14211. #. type: table
  14212. #: bashref.texi:8396
  14213. msgid ""
  14214. "Use external files for the documentation displayed by the @code{help} "
  14215. "builtin instead of storing the text internally."
  14216. msgstr ""
  14217. #. type: item
  14218. #: bashref.texi:8397
  14219. #, no-wrap
  14220. msgid "--enable-single-help-strings"
  14221. msgstr ""
  14222. #. type: table
  14223. #: bashref.texi:8402
  14224. msgid ""
  14225. "Store the text displayed by the @code{help} builtin as a single string for "
  14226. "each help topic. This aids in translating the text to different languages. "
  14227. "You may need to disable this if your compiler cannot handle very long string "
  14228. "literals."
  14229. msgstr ""
  14230. #. type: item
  14231. #: bashref.texi:8403
  14232. #, no-wrap
  14233. msgid "--enable-strict-posix-default"
  14234. msgstr ""
  14235. #. type: table
  14236. #: bashref.texi:8405
  14237. msgid "Make Bash @sc{posix}-conformant by default (@pxref{Bash POSIX Mode})."
  14238. msgstr ""
  14239. #. type: item
  14240. #: bashref.texi:8406
  14241. #, no-wrap
  14242. msgid "--enable-usg-echo-default"
  14243. msgstr ""
  14244. #. type: table
  14245. #: bashref.texi:8408
  14246. msgid "A synonym for @code{--enable-xpg-echo-default}."
  14247. msgstr ""
  14248. #. type: item
  14249. #: bashref.texi:8409
  14250. #, no-wrap
  14251. msgid "--enable-xpg-echo-default"
  14252. msgstr ""
  14253. #. type: table
  14254. #: bashref.texi:8417
  14255. msgid ""
  14256. "Make the @code{echo} builtin expand backslash-escaped characters by default, "
  14257. "without requiring the @option{-e} option. This sets the default value of "
  14258. "the @code{xpg_echo} shell option to @code{on}, which makes the Bash "
  14259. "@code{echo} behave more like the version specified in the Single Unix "
  14260. "Specification, version 3. @xref{Bash Builtins}, for a description of the "
  14261. "escape sequences that @code{echo} recognizes."
  14262. msgstr ""
  14263. #. type: Plain text
  14264. #: bashref.texi:8426
  14265. msgid ""
  14266. "The file @file{config-top.h} contains C Preprocessor @samp{#define} "
  14267. "statements for options which are not settable from @code{configure}. Some "
  14268. "of these are not meant to be changed; beware of the consequences if you do. "
  14269. "Read the comments associated with each definition for more information about "
  14270. "its effect."
  14271. msgstr ""
  14272. #. type: Plain text
  14273. #: bashref.texi:8436
  14274. msgid ""
  14275. "Please report all bugs you find in Bash. But first, you should make sure "
  14276. "that it really is a bug, and that it appears in the latest version of Bash. "
  14277. "The latest version of Bash is always available for FTP from @uref{ftp://ftp."
  14278. "gnu.org/pub/gnu/bash/}."
  14279. msgstr ""
  14280. #. type: Plain text
  14281. #: bashref.texi:8443
  14282. msgid ""
  14283. "Once you have determined that a bug actually exists, use the @code{bashbug} "
  14284. "command to submit a bug report. If you have a fix, you are encouraged to "
  14285. "mail that as well! Suggestions and `philosophical' bug reports may be mailed "
  14286. "to @email{bug-bash@@gnu.org} or posted to the Usenet newsgroup @code{gnu."
  14287. "bash.bug}."
  14288. msgstr ""
  14289. #. type: Plain text
  14290. #: bashref.texi:8445
  14291. msgid "All bug reports should include:"
  14292. msgstr ""
  14293. #. type: itemize
  14294. #: bashref.texi:8448
  14295. msgid "The version number of Bash."
  14296. msgstr ""
  14297. #. type: itemize
  14298. #: bashref.texi:8450
  14299. msgid "The hardware and operating system."
  14300. msgstr ""
  14301. #. type: itemize
  14302. #: bashref.texi:8452
  14303. msgid "The compiler used to compile Bash."
  14304. msgstr ""
  14305. #. type: itemize
  14306. #: bashref.texi:8454
  14307. msgid "A description of the bug behaviour."
  14308. msgstr ""
  14309. #. type: itemize
  14310. #: bashref.texi:8457
  14311. msgid ""
  14312. "A short script or `recipe' which exercises the bug and may be used to "
  14313. "reproduce it."
  14314. msgstr ""
  14315. #. type: Plain text
  14316. #: bashref.texi:8462
  14317. msgid ""
  14318. "@code{bashbug} inserts the first three items automatically into the template "
  14319. "it provides for filing a bug report."
  14320. msgstr ""
  14321. #. type: Plain text
  14322. #: bashref.texi:8465
  14323. msgid ""
  14324. "Please send all reports concerning this manual to @email{bug-bash@@gnu.org}."
  14325. msgstr ""
  14326. #. type: Plain text
  14327. #: bashref.texi:8479
  14328. msgid ""
  14329. "Bash implements essentially the same grammar, parameter and variable "
  14330. "expansion, redirection, and quoting as the Bourne Shell. Bash uses the "
  14331. "@sc{posix} standard as the specification of how these features are to be "
  14332. "implemented. There are some differences between the traditional Bourne "
  14333. "shell and Bash; this section quickly details the differences of "
  14334. "significance. A number of these differences are explained in greater depth "
  14335. "in previous sections. This section uses the version of @code{sh} included "
  14336. "in SVR4.2 (the last version of the historical Bourne shell) as the baseline "
  14337. "reference."
  14338. msgstr ""
  14339. #. type: itemize
  14340. #: bashref.texi:8485
  14341. msgid ""
  14342. "Bash is @sc{posix}-conformant, even where the @sc{posix} specification "
  14343. "differs from traditional @code{sh} behavior (@pxref{Bash POSIX Mode})."
  14344. msgstr ""
  14345. #. type: itemize
  14346. #: bashref.texi:8488
  14347. msgid "Bash has multi-character invocation options (@pxref{Invoking Bash})."
  14348. msgstr ""
  14349. #. type: itemize
  14350. #: bashref.texi:8492
  14351. msgid ""
  14352. "Bash has command-line editing (@pxref{Command Line Editing}) and the "
  14353. "@code{bind} builtin."
  14354. msgstr ""
  14355. #. type: itemize
  14356. #: bashref.texi:8498
  14357. msgid ""
  14358. "Bash provides a programmable word completion mechanism (@pxref{Programmable "
  14359. "Completion}), and builtin commands @code{complete}, @code{compgen}, and "
  14360. "@code{compopt}, to manipulate it."
  14361. msgstr ""
  14362. #. type: itemize
  14363. #: bashref.texi:8504
  14364. msgid ""
  14365. "Bash has command history (@pxref{Bash History Facilities}) and the "
  14366. "@code{history} and @code{fc} builtins to manipulate it. The Bash history "
  14367. "list maintains timestamp information and uses the value of the "
  14368. "@code{HISTTIMEFORMAT} variable to display it."
  14369. msgstr ""
  14370. #. type: itemize
  14371. #: bashref.texi:8508
  14372. msgid ""
  14373. "Bash implements @code{csh}-like history expansion (@pxref{History "
  14374. "Interaction})."
  14375. msgstr ""
  14376. #. type: itemize
  14377. #: bashref.texi:8514
  14378. msgid ""
  14379. "Bash has one-dimensional array variables (@pxref{Arrays}), and the "
  14380. "appropriate variable expansions and assignment syntax to use them. Several "
  14381. "of the Bash builtins take options to act on arrays. Bash provides a number "
  14382. "of built-in array variables."
  14383. msgstr ""
  14384. #. type: itemize
  14385. #: bashref.texi:8519
  14386. msgid ""
  14387. "The @code{$'@dots{}'} quoting syntax, which expands ANSI-C backslash-escaped "
  14388. "characters in the text between the single quotes, is supported (@pxref{ANSI-"
  14389. "C Quoting})."
  14390. msgstr ""
  14391. #. type: itemize
  14392. #: bashref.texi:8526
  14393. msgid ""
  14394. "Bash supports the @code{$\"@dots{}\"} quoting syntax to do locale-specific "
  14395. "translation of the characters between the double quotes. The @option{-D}, "
  14396. "@option{--dump-strings}, and @option{--dump-po-strings} invocation options "
  14397. "list the translatable strings found in a script (@pxref{Locale Translation})."
  14398. msgstr ""
  14399. #. type: itemize
  14400. #: bashref.texi:8533
  14401. msgid ""
  14402. "Bash implements the @code{!} keyword to negate the return value of a "
  14403. "pipeline (@pxref{Pipelines}). Very useful when an @code{if} statement needs "
  14404. "to act only if a test fails. The Bash @samp{-o pipefail} option to "
  14405. "@code{set} will cause a pipeline to return a failure status if any command "
  14406. "fails."
  14407. msgstr ""
  14408. #. type: itemize
  14409. #: bashref.texi:8538
  14410. msgid ""
  14411. "Bash has the @code{time} reserved word and command timing "
  14412. "(@pxref{Pipelines}). The display of the timing statistics may be controlled "
  14413. "with the @env{TIMEFORMAT} variable."
  14414. msgstr ""
  14415. #. type: itemize
  14416. #: bashref.texi:8542
  14417. msgid ""
  14418. "Bash implements the @code{for (( @var{expr1} ; @var{expr2} ; @var{expr3} ))} "
  14419. "arithmetic for command, similar to the C language (@pxref{Looping "
  14420. "Constructs})."
  14421. msgstr ""
  14422. #. type: itemize
  14423. #: bashref.texi:8546
  14424. msgid ""
  14425. "Bash includes the @code{select} compound command, which allows the "
  14426. "generation of simple menus (@pxref{Conditional Constructs})."
  14427. msgstr ""
  14428. #. type: itemize
  14429. #: bashref.texi:8551
  14430. msgid ""
  14431. "Bash includes the @code{[[} compound command, which makes conditional "
  14432. "testing part of the shell grammar (@pxref{Conditional Constructs}), "
  14433. "including optional regular expression matching."
  14434. msgstr ""
  14435. #. type: itemize
  14436. #: bashref.texi:8555
  14437. msgid ""
  14438. "Bash provides optional case-insensitive matching for the @code{case} and "
  14439. "@code{[[} constructs."
  14440. msgstr ""
  14441. #. type: itemize
  14442. #: bashref.texi:8559
  14443. msgid ""
  14444. "Bash includes brace expansion (@pxref{Brace Expansion}) and tilde expansion "
  14445. "(@pxref{Tilde Expansion})."
  14446. msgstr ""
  14447. #. type: itemize
  14448. #: bashref.texi:8563
  14449. msgid ""
  14450. "Bash implements command aliases and the @code{alias} and @code{unalias} "
  14451. "builtins (@pxref{Aliases})."
  14452. msgstr ""
  14453. #. type: itemize
  14454. #: bashref.texi:8568
  14455. msgid ""
  14456. "Bash provides shell arithmetic, the @code{((} compound command "
  14457. "(@pxref{Conditional Constructs}), and arithmetic expansion (@pxref{Shell "
  14458. "Arithmetic})."
  14459. msgstr ""
  14460. #. type: itemize
  14461. #: bashref.texi:8574
  14462. msgid ""
  14463. "Variables present in the shell's initial environment are automatically "
  14464. "exported to child processes. The Bourne shell does not normally do this "
  14465. "unless the variables are explicitly marked using the @code{export} command."
  14466. msgstr ""
  14467. #. type: itemize
  14468. #: bashref.texi:8578
  14469. msgid ""
  14470. "Bash supports the @samp{+=} assignment operator, which appends to the value "
  14471. "of the variable named on the left hand side."
  14472. msgstr ""
  14473. #. type: itemize
  14474. #: bashref.texi:8583
  14475. msgid ""
  14476. "Bash includes the @sc{posix} pattern removal @samp{%}, @samp{#}, @samp{%%} "
  14477. "and @samp{##} expansions to remove leading or trailing substrings from "
  14478. "variable values (@pxref{Shell Parameter Expansion})."
  14479. msgstr ""
  14480. #. type: itemize
  14481. #: bashref.texi:8587
  14482. msgid ""
  14483. "The expansion @code{$@{#xx@}}, which returns the length of @code{$@{xx@}}, "
  14484. "is supported (@pxref{Shell Parameter Expansion})."
  14485. msgstr ""
  14486. #. type: itemize
  14487. #: bashref.texi:8593
  14488. msgid ""
  14489. "The expansion @code{$@{var:}@var{offset}@code{[:}@var{length}@code{]@}}, "
  14490. "which expands to the substring of @code{var}'s value of length @var{length}, "
  14491. "beginning at @var{offset}, is present (@pxref{Shell Parameter Expansion})."
  14492. msgstr ""
  14493. #. type: itemize
  14494. #: bashref.texi:8599
  14495. msgid ""
  14496. "The expansion @code{$@{var/[/]}@var{pattern}@code{[/}@var{replacement}"
  14497. "@code{]@}}, which matches @var{pattern} and replaces it with "
  14498. "@var{replacement} in the value of @code{var}, is available (@pxref{Shell "
  14499. "Parameter Expansion})."
  14500. msgstr ""
  14501. #. type: itemize
  14502. #: bashref.texi:8604
  14503. msgid ""
  14504. "The expansion @code{$@{!@var{prefix}*@}} expansion, which expands to the "
  14505. "names of all shell variables whose names begin with @var{prefix}, is "
  14506. "available (@pxref{Shell Parameter Expansion})."
  14507. msgstr ""
  14508. #. type: itemize
  14509. #: bashref.texi:8608
  14510. msgid ""
  14511. "Bash has @var{indirect} variable expansion using @code{$@{!word@}} "
  14512. "(@pxref{Shell Parameter Expansion})."
  14513. msgstr ""
  14514. #. type: itemize
  14515. #: bashref.texi:8612
  14516. msgid ""
  14517. "Bash can expand positional parameters beyond @code{$9} using "
  14518. "@code{$@{@var{num}@}}."
  14519. msgstr ""
  14520. #. type: itemize
  14521. #: bashref.texi:8618
  14522. msgid ""
  14523. "The @sc{posix} @code{$()} form of command substitution is implemented "
  14524. "(@pxref{Command Substitution}), and preferred to the Bourne shell's "
  14525. "@code{``} (which is also implemented for backwards compatibility)."
  14526. msgstr ""
  14527. #. type: itemize
  14528. #: bashref.texi:8621
  14529. msgid "Bash has process substitution (@pxref{Process Substitution})."
  14530. msgstr ""
  14531. #. type: itemize
  14532. #: bashref.texi:8629
  14533. msgid ""
  14534. "Bash automatically assigns variables that provide information about the "
  14535. "current user (@env{UID}, @env{EUID}, and @env{GROUPS}), the current host "
  14536. "(@env{HOSTTYPE}, @env{OSTYPE}, @env{MACHTYPE}, and @env{HOSTNAME}), and the "
  14537. "instance of Bash that is running (@env{BASH}, @env{BASH_VERSION}, and "
  14538. "@env{BASH_VERSINFO}). @xref{Bash Variables}, for details."
  14539. msgstr ""
  14540. #. type: itemize
  14541. #: bashref.texi:8634
  14542. msgid ""
  14543. "The @env{IFS} variable is used to split only the results of expansion, not "
  14544. "all words (@pxref{Word Splitting}). This closes a longstanding shell "
  14545. "security hole."
  14546. msgstr ""
  14547. #. type: itemize
  14548. #: bashref.texi:8639
  14549. msgid ""
  14550. "The filename expansion bracket expression code uses @samp{!} and @samp{^} to "
  14551. "negate the set of characters between the brackets. The Bourne shell uses "
  14552. "only @samp{!}."
  14553. msgstr ""
  14554. #. type: itemize
  14555. #: bashref.texi:8644
  14556. msgid ""
  14557. "Bash implements the full set of @sc{posix} filename expansion operators, "
  14558. "including @var{character classes}, @var{equivalence classes}, and "
  14559. "@var{collating symbols} (@pxref{Filename Expansion})."
  14560. msgstr ""
  14561. #. type: itemize
  14562. #: bashref.texi:8648
  14563. msgid ""
  14564. "Bash implements extended pattern matching features when the @code{extglob} "
  14565. "shell option is enabled (@pxref{Pattern Matching})."
  14566. msgstr ""
  14567. #. type: itemize
  14568. #: bashref.texi:8652
  14569. msgid ""
  14570. "It is possible to have a variable and a function with the same name; "
  14571. "@code{sh} does not separate the two name spaces."
  14572. msgstr ""
  14573. #. type: itemize
  14574. #: bashref.texi:8657
  14575. msgid ""
  14576. "Bash functions are permitted to have local variables using the @code{local} "
  14577. "builtin, and thus useful recursive functions may be written (@pxref{Bash "
  14578. "Builtins})."
  14579. msgstr ""
  14580. #. type: itemize
  14581. #: bashref.texi:8664
  14582. msgid ""
  14583. "Variable assignments preceding commands affect only that command, even "
  14584. "builtins and functions (@pxref{Environment}). In @code{sh}, all variable "
  14585. "assignments preceding commands are global unless the command is executed "
  14586. "from the file system."
  14587. msgstr ""
  14588. #. type: itemize
  14589. #: bashref.texi:8668
  14590. msgid ""
  14591. "Bash performs filename expansion on filenames specified as operands to input "
  14592. "and output redirection operators (@pxref{Redirections})."
  14593. msgstr ""
  14594. #. type: itemize
  14595. #: bashref.texi:8674
  14596. msgid ""
  14597. "Bash contains the @samp{<>} redirection operator, allowing a file to be "
  14598. "opened for both reading and writing, and the @samp{&>} redirection operator, "
  14599. "for directing standard output and standard error to the same file "
  14600. "(@pxref{Redirections})."
  14601. msgstr ""
  14602. #. type: itemize
  14603. #: bashref.texi:8678
  14604. msgid ""
  14605. "Bash includes the @samp{<<<} redirection operator, allowing a string to be "
  14606. "used as the standard input to a command."
  14607. msgstr ""
  14608. #. type: itemize
  14609. #: bashref.texi:8682
  14610. msgid ""
  14611. "Bash implements the @samp{[n]<&@var{word}} and @samp{[n]>&@var{word}} "
  14612. "redirection operators, which move one file descriptor to another."
  14613. msgstr ""
  14614. #. type: itemize
  14615. #: bashref.texi:8686
  14616. msgid ""
  14617. "Bash treats a number of filenames specially when they are used in "
  14618. "redirection operators (@pxref{Redirections})."
  14619. msgstr ""
  14620. #. type: itemize
  14621. #: bashref.texi:8690
  14622. msgid ""
  14623. "Bash can open network connections to arbitrary machines and services with "
  14624. "the redirection operators (@pxref{Redirections})."
  14625. msgstr ""
  14626. #. type: itemize
  14627. #: bashref.texi:8695
  14628. msgid ""
  14629. "The @code{noclobber} option is available to avoid overwriting existing files "
  14630. "with output redirection (@pxref{The Set Builtin}). The @samp{>|} "
  14631. "redirection operator may be used to override @code{noclobber}."
  14632. msgstr ""
  14633. #. type: itemize
  14634. #: bashref.texi:8700
  14635. msgid ""
  14636. "The Bash @code{cd} and @code{pwd} builtins (@pxref{Bourne Shell Builtins}) "
  14637. "each take @option{-L} and @option{-P} options to switch between logical and "
  14638. "physical modes."
  14639. msgstr ""
  14640. #. type: itemize
  14641. #: bashref.texi:8705
  14642. msgid ""
  14643. "Bash allows a function to override a builtin with the same name, and "
  14644. "provides access to that builtin's functionality within the function via the "
  14645. "@code{builtin} and @code{command} builtins (@pxref{Bash Builtins})."
  14646. msgstr ""
  14647. #. type: itemize
  14648. #: bashref.texi:8709
  14649. msgid ""
  14650. "The @code{command} builtin allows selective disabling of functions when "
  14651. "command lookup is performed (@pxref{Bash Builtins})."
  14652. msgstr ""
  14653. #. type: itemize
  14654. #: bashref.texi:8713
  14655. msgid ""
  14656. "Individual builtins may be enabled or disabled using the @code{enable} "
  14657. "builtin (@pxref{Bash Builtins})."
  14658. msgstr ""
  14659. #. type: itemize
  14660. #: bashref.texi:8719
  14661. msgid ""
  14662. "The Bash @code{exec} builtin takes additional options that allow users to "
  14663. "control the contents of the environment passed to the executed command, and "
  14664. "what the zeroth argument to the command is to be (@pxref{Bourne Shell "
  14665. "Builtins})."
  14666. msgstr ""
  14667. #. type: itemize
  14668. #: bashref.texi:8723
  14669. msgid ""
  14670. "Shell functions may be exported to children via the environment using "
  14671. "@code{export -f} (@pxref{Shell Functions})."
  14672. msgstr ""
  14673. #. type: itemize
  14674. #: bashref.texi:8731
  14675. msgid ""
  14676. "The Bash @code{export}, @code{readonly}, and @code{declare} builtins can "
  14677. "take a @option{-f} option to act on shell functions, a @option{-p} option to "
  14678. "display variables with various attributes set in a format that can be used "
  14679. "as shell input, a @option{-n} option to remove various variable attributes, "
  14680. "and @samp{name=value} arguments to set variable attributes and values "
  14681. "simultaneously."
  14682. msgstr ""
  14683. #. type: itemize
  14684. #: bashref.texi:8737
  14685. msgid ""
  14686. "The Bash @code{hash} builtin allows a name to be associated with an "
  14687. "arbitrary filename, even when that filename cannot be found by searching the "
  14688. "@env{$PATH}, using @samp{hash -p} (@pxref{Bourne Shell Builtins})."
  14689. msgstr ""
  14690. #. type: itemize
  14691. #: bashref.texi:8741
  14692. msgid ""
  14693. "Bash includes a @code{help} builtin for quick reference to shell facilities "
  14694. "(@pxref{Bash Builtins})."
  14695. msgstr ""
  14696. #. type: itemize
  14697. #: bashref.texi:8745
  14698. msgid ""
  14699. "The @code{printf} builtin is available to display formatted output "
  14700. "(@pxref{Bash Builtins})."
  14701. msgstr ""
  14702. #. type: itemize
  14703. #: bashref.texi:8761
  14704. msgid ""
  14705. "The Bash @code{read} builtin (@pxref{Bash Builtins}) will read a line "
  14706. "ending in @samp{\\} with the @option{-r} option, and will use the "
  14707. "@env{REPLY} variable as a default if no non-option arguments are supplied. "
  14708. "The Bash @code{read} builtin also accepts a prompt string with the @option{-"
  14709. "p} option and will use Readline to obtain the line when given the @option{-"
  14710. "e} option. The @code{read} builtin also has additional options to control "
  14711. "input: the @option{-s} option will turn off echoing of input characters as "
  14712. "they are read, the @option{-t} option will allow @code{read} to time out if "
  14713. "input does not arrive within a specified number of seconds, the @option{-n} "
  14714. "option will allow reading only a specified number of characters rather than "
  14715. "a full line, and the @option{-d} option will read until a particular "
  14716. "character rather than newline."
  14717. msgstr ""
  14718. #. type: itemize
  14719. #: bashref.texi:8766
  14720. msgid ""
  14721. "The @code{return} builtin may be used to abort execution of scripts executed "
  14722. "with the @code{.} or @code{source} builtins (@pxref{Bourne Shell Builtins})."
  14723. msgstr ""
  14724. #. type: itemize
  14725. #: bashref.texi:8771
  14726. msgid ""
  14727. "Bash includes the @code{shopt} builtin, for finer control of shell optional "
  14728. "capabilities (@pxref{The Shopt Builtin}), and allows these options to be set "
  14729. "and unset at shell invocation (@pxref{Invoking Bash})."
  14730. msgstr ""
  14731. #. type: itemize
  14732. #: bashref.texi:8775
  14733. msgid ""
  14734. "Bash has much more optional behavior controllable with the @code{set} "
  14735. "builtin (@pxref{The Set Builtin})."
  14736. msgstr ""
  14737. #. type: itemize
  14738. #: bashref.texi:8780
  14739. msgid ""
  14740. "The @samp{-x} (@option{xtrace}) option displays commands other than simple "
  14741. "commands when performing an execution trace (@pxref{The Set Builtin})."
  14742. msgstr ""
  14743. #. type: itemize
  14744. #: bashref.texi:8785
  14745. msgid ""
  14746. "The @code{test} builtin (@pxref{Bourne Shell Builtins}) is slightly "
  14747. "different, as it implements the @sc{posix} algorithm, which specifies the "
  14748. "behavior based on the number of arguments."
  14749. msgstr ""
  14750. #. type: itemize
  14751. #: bashref.texi:8791
  14752. msgid ""
  14753. "Bash includes the @code{caller} builtin, which displays the context of any "
  14754. "active subroutine call (a shell function or a script executed with the "
  14755. "@code{.} or @code{source} builtins). This supports the bash debugger."
  14756. msgstr ""
  14757. #. type: itemize
  14758. #: bashref.texi:8804
  14759. msgid ""
  14760. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows a "
  14761. "@code{DEBUG} pseudo-signal specification, similar to @code{EXIT}. Commands "
  14762. "specified with a @code{DEBUG} trap are executed before every simple command, "
  14763. "@code{for} command, @code{case} command, @code{select} command, every "
  14764. "arithmetic @code{for} command, and before the first command executes in a "
  14765. "shell function. The @code{DEBUG} trap is not inherited by shell functions "
  14766. "unless the function has been given the @code{trace} attribute or the "
  14767. "@code{functrace} option has been enabled using the @code{shopt} builtin. "
  14768. "The @code{extdebug} shell option has additional effects on the @code{DEBUG} "
  14769. "trap."
  14770. msgstr ""
  14771. #. type: itemize
  14772. #: bashref.texi:8811
  14773. msgid ""
  14774. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows an @code{ERR} "
  14775. "pseudo-signal specification, similar to @code{EXIT} and @code{DEBUG}. "
  14776. "Commands specified with an @code{ERR} trap are executed after a simple "
  14777. "command fails, with a few exceptions. The @code{ERR} trap is not inherited "
  14778. "by shell functions unless the @code{-o errtrace} option to the @code{set} "
  14779. "builtin is enabled."
  14780. msgstr ""
  14781. #. type: itemize
  14782. #: bashref.texi:8821
  14783. msgid ""
  14784. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows a "
  14785. "@code{RETURN} pseudo-signal specification, similar to @code{EXIT} and "
  14786. "@code{DEBUG}. Commands specified with an @code{RETURN} trap are executed "
  14787. "before execution resumes after a shell function or a shell script executed "
  14788. "with @code{.} or @code{source} returns. The @code{RETURN} trap is not "
  14789. "inherited by shell functions unless the function has been given the "
  14790. "@code{trace} attribute or the @code{functrace} option has been enabled using "
  14791. "the @code{shopt} builtin."
  14792. msgstr ""
  14793. #. type: itemize
  14794. #: bashref.texi:8825
  14795. msgid ""
  14796. "The Bash @code{type} builtin is more extensive and gives more information "
  14797. "about the names it finds (@pxref{Bash Builtins})."
  14798. msgstr ""
  14799. #. type: itemize
  14800. #: bashref.texi:8830
  14801. msgid ""
  14802. "The Bash @code{umask} builtin permits a @option{-p} option to cause the "
  14803. "output to be displayed in the form of a @code{umask} command that may be "
  14804. "reused as input (@pxref{Bourne Shell Builtins})."
  14805. msgstr ""
  14806. #. type: itemize
  14807. #: bashref.texi:8837
  14808. msgid ""
  14809. "Bash implements a @code{csh}-like directory stack, and provides the "
  14810. "@code{pushd}, @code{popd}, and @code{dirs} builtins to manipulate it "
  14811. "(@pxref{The Directory Stack}). Bash also makes the directory stack visible "
  14812. "as the value of the @env{DIRSTACK} shell variable."
  14813. msgstr ""
  14814. #. type: itemize
  14815. #: bashref.texi:8841
  14816. msgid ""
  14817. "Bash interprets special backslash-escaped characters in the prompt strings "
  14818. "when interactive (@pxref{Controlling the Prompt})."
  14819. msgstr ""
  14820. #. type: itemize
  14821. #: bashref.texi:8845
  14822. msgid ""
  14823. "The Bash restricted mode is more useful (@pxref{The Restricted Shell}); the "
  14824. "SVR4.2 shell restricted mode is too limited."
  14825. msgstr ""
  14826. #. type: itemize
  14827. #: bashref.texi:8851
  14828. msgid ""
  14829. "The @code{disown} builtin can remove a job from the internal shell job table "
  14830. "(@pxref{Job Control Builtins}) or suppress the sending of @code{SIGHUP} to a "
  14831. "job when the shell exits as the result of a @code{SIGHUP}."
  14832. msgstr ""
  14833. #. type: itemize
  14834. #: bashref.texi:8855
  14835. msgid ""
  14836. "Bash includes a number of features to support a separate debugger for shell "
  14837. "scripts."
  14838. msgstr ""
  14839. #. type: itemize
  14840. #: bashref.texi:8859
  14841. msgid ""
  14842. "The SVR4.2 shell has two privilege-related builtins (@code{mldmode} and "
  14843. "@code{priv}) not present in Bash."
  14844. msgstr ""
  14845. #. type: itemize
  14846. #: bashref.texi:8862
  14847. msgid "Bash does not have the @code{stop} or @code{newgrp} builtins."
  14848. msgstr ""
  14849. #. type: itemize
  14850. #: bashref.texi:8865
  14851. msgid ""
  14852. "Bash does not use the @env{SHACCT} variable or perform shell accounting."
  14853. msgstr ""
  14854. #. type: itemize
  14855. #: bashref.texi:8869
  14856. msgid ""
  14857. "The SVR4.2 @code{sh} uses a @env{TIMEOUT} variable like Bash uses "
  14858. "@env{TMOUT}."
  14859. msgstr ""
  14860. #. type: Plain text
  14861. #: bashref.texi:8874
  14862. msgid "More features unique to Bash may be found in @ref{Bash Features}."
  14863. msgstr ""
  14864. #. type: appendixsec
  14865. #: bashref.texi:8876
  14866. #, no-wrap
  14867. msgid "Implementation Differences From The SVR4.2 Shell"
  14868. msgstr ""
  14869. #. type: Plain text
  14870. #: bashref.texi:8880
  14871. msgid ""
  14872. "Since Bash is a completely new implementation, it does not suffer from many "
  14873. "of the limitations of the SVR4.2 shell. For instance:"
  14874. msgstr ""
  14875. #. type: itemize
  14876. #: bashref.texi:8887
  14877. msgid ""
  14878. "Bash does not fork a subshell when redirecting into or out of a shell "
  14879. "control structure such as an @code{if} or @code{while} statement."
  14880. msgstr ""
  14881. #. type: itemize
  14882. #: bashref.texi:8892
  14883. msgid ""
  14884. "Bash does not allow unbalanced quotes. The SVR4.2 shell will silently "
  14885. "insert a needed closing quote at @code{EOF} under certain circumstances. "
  14886. "This can be the cause of some hard-to-find errors."
  14887. msgstr ""
  14888. #. type: itemize
  14889. #: bashref.texi:8898
  14890. msgid ""
  14891. "The SVR4.2 shell uses a baroque memory management scheme based on trapping "
  14892. "@code{SIGSEGV}. If the shell is started from a process with @code{SIGSEGV} "
  14893. "blocked (e.g., by using the @code{system()} C library function call), it "
  14894. "misbehaves badly."
  14895. msgstr ""
  14896. #. type: itemize
  14897. #: bashref.texi:8905
  14898. msgid ""
  14899. "In a questionable attempt at security, the SVR4.2 shell, when invoked "
  14900. "without the @option{-p} option, will alter its real and effective @sc{uid} "
  14901. "and @sc{gid} if they are less than some magic threshold value, commonly "
  14902. "100. This can lead to unexpected results."
  14903. msgstr ""
  14904. #. type: itemize
  14905. #: bashref.texi:8909
  14906. msgid ""
  14907. "The SVR4.2 shell does not allow users to trap @code{SIGSEGV}, "
  14908. "@code{SIGALRM}, or @code{SIGCHLD}."
  14909. msgstr ""
  14910. #. type: itemize
  14911. #: bashref.texi:8913
  14912. msgid ""
  14913. "The SVR4.2 shell does not allow the @env{IFS}, @env{MAILCHECK}, @env{PATH}, "
  14914. "@env{PS1}, or @env{PS2} variables to be unset."
  14915. msgstr ""
  14916. #. type: itemize
  14917. #: bashref.texi:8917
  14918. msgid ""
  14919. "The SVR4.2 shell treats @samp{^} as the undocumented equivalent of @samp{|}."
  14920. msgstr ""
  14921. #. type: itemize
  14922. #: bashref.texi:8923
  14923. msgid ""
  14924. "Bash allows multiple option arguments when it is invoked (@code{-x -v}); the "
  14925. "SVR4.2 shell allows only one option argument (@code{-xv}). In fact, some "
  14926. "versions of the shell dump core if the second argument begins with a "
  14927. "@samp{-}."
  14928. msgstr ""
  14929. #. type: itemize
  14930. #: bashref.texi:8928
  14931. msgid ""
  14932. "The SVR4.2 shell exits a script if any builtin fails; Bash exits a script "
  14933. "only if one of the @sc{posix} special builtins fails, and only for certain "
  14934. "failures, as enumerated in the @sc{posix} standard."
  14935. msgstr ""
  14936. #. type: itemize
  14937. #: bashref.texi:8932
  14938. msgid ""
  14939. "The SVR4.2 shell behaves differently when invoked as @code{jsh} (it turns on "
  14940. "job control)."
  14941. msgstr ""
  14942. #. type: include
  14943. #: bashref.texi:8937
  14944. #, no-wrap
  14945. msgid "fdl.texi"
  14946. msgstr ""
  14947. #. type: node
  14948. #: bashref.texi:8950 bashref.texi:8952
  14949. #, no-wrap
  14950. msgid "Builtin Index"
  14951. msgstr ""
  14952. #. type: menuentry
  14953. #: bashref.texi:8950
  14954. msgid "Index of Bash builtin commands."
  14955. msgstr ""
  14956. #. type: node
  14957. #: bashref.texi:8950 bashref.texi:8956
  14958. #, no-wrap
  14959. msgid "Reserved Word Index"
  14960. msgstr ""
  14961. #. type: menuentry
  14962. #: bashref.texi:8950
  14963. msgid "Index of Bash reserved words."
  14964. msgstr ""
  14965. #. type: node
  14966. #: bashref.texi:8950 bashref.texi:8960
  14967. #, no-wrap
  14968. msgid "Variable Index"
  14969. msgstr ""
  14970. #. type: menuentry
  14971. #: bashref.texi:8950
  14972. msgid "Quick reference helps you find the variable you want."
  14973. msgstr ""
  14974. #. type: appendixsec
  14975. #: bashref.texi:8950 bashref.texi:8964 bashref.texi:8965
  14976. #, no-wrap
  14977. msgid "Function Index"
  14978. msgstr ""
  14979. #. type: menuentry
  14980. #: bashref.texi:8950
  14981. msgid "Index of bindable Readline functions."
  14982. msgstr ""
  14983. #. type: appendixsec
  14984. #: bashref.texi:8950 bashref.texi:8968 bashref.texi:8969
  14985. #, no-wrap
  14986. msgid "Concept Index"
  14987. msgstr ""
  14988. #. type: menuentry
  14989. #: bashref.texi:8950
  14990. msgid "General index for concepts described in this manual."
  14991. msgstr ""
  14992. #. type: appendixsec
  14993. #: bashref.texi:8953
  14994. #, no-wrap
  14995. msgid "Index of Shell Builtin Commands"
  14996. msgstr ""
  14997. #. type: appendixsec
  14998. #: bashref.texi:8957
  14999. #, no-wrap
  15000. msgid "Index of Shell Reserved Words"
  15001. msgstr ""
  15002. #. type: appendixsec
  15003. #: bashref.texi:8961
  15004. #, no-wrap
  15005. msgid "Parameter and Variable Index"
  15006. msgstr ""