bashref.pot 482 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) YEAR Free Software Foundation, Inc.
  3. # This file is distributed under the same license as the PACKAGE package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: PACKAGE VERSION\n"
  10. "POT-Creation-Date: 2019-01-08 01:14+0100\n"
  11. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13. "Language-Team: LANGUAGE <LL@li.org>\n"
  14. "Language: \n"
  15. "MIME-Version: 1.0\n"
  16. "Content-Type: text/plain; charset=CHARSET\n"
  17. "Content-Transfer-Encoding: 8bit\n"
  18. #. type: title
  19. #: ./bashref.texi:4 ./bashref.texi:41
  20. #, no-wrap
  21. msgid "Bash Reference Manual"
  22. msgstr ""
  23. #. type: include
  24. #: ./bashref.texi:6
  25. #, no-wrap
  26. msgid "version.texi"
  27. msgstr ""
  28. #. type: copying
  29. #: ./bashref.texi:12
  30. msgid ""
  31. "This text is a brief description of the features that are present in the "
  32. "Bash shell (version @value{VERSION}, @value{UPDATED})."
  33. msgstr ""
  34. #. type: ifnottex
  35. #: ./bashref.texi:16 ./bashref.texi:67
  36. msgid ""
  37. "This is Edition @value{EDITION}, last updated @value{UPDATED}, of @cite{The "
  38. "GNU Bash Reference Manual}, for @code{Bash}, Version @value{VERSION}."
  39. msgstr ""
  40. #. type: copying
  41. #: ./bashref.texi:18
  42. msgid "Copyright @copyright{} 1988--2018 Free Software Foundation, Inc."
  43. msgstr ""
  44. #. type: quotation
  45. #: ./bashref.texi:26
  46. msgid ""
  47. "Permission is granted to copy, distribute and/or modify this document under "
  48. "the terms of the GNU Free Documentation License, Version 1.3 or any later "
  49. "version published by the Free Software Foundation; with no Invariant "
  50. "Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the "
  51. "license is included in the section entitled ``GNU Free Documentation "
  52. "License''."
  53. msgstr ""
  54. #. type: dircategory
  55. #: ./bashref.texi:33
  56. #, no-wrap
  57. msgid "Basics"
  58. msgstr ""
  59. #. type: menuentry
  60. #: ./bashref.texi:36
  61. msgid "Bash: (bash)"
  62. msgstr ""
  63. #. type: menuentry
  64. #: ./bashref.texi:36
  65. msgid "The GNU Bourne-Again SHell."
  66. msgstr ""
  67. #. type: subtitle
  68. #: ./bashref.texi:42
  69. #, no-wrap
  70. msgid "Reference Documentation for Bash"
  71. msgstr ""
  72. #. type: subtitle
  73. #: ./bashref.texi:43
  74. #, no-wrap
  75. msgid "Edition @value{EDITION}, for @code{Bash} Version @value{VERSION}."
  76. msgstr ""
  77. #. type: subtitle
  78. #: ./bashref.texi:44
  79. #, no-wrap
  80. msgid "@value{UPDATED-MONTH}"
  81. msgstr ""
  82. #. type: author
  83. #: ./bashref.texi:45
  84. #, no-wrap
  85. msgid "Chet Ramey, Case Western Reserve University"
  86. msgstr ""
  87. #. type: author
  88. #: ./bashref.texi:46
  89. #, no-wrap
  90. msgid "Brian Fox, Free Software Foundation"
  91. msgstr ""
  92. #. type: node
  93. #: ./bashref.texi:57
  94. #, no-wrap
  95. msgid "Top"
  96. msgstr ""
  97. #. type: chapter
  98. #: ./bashref.texi:57 ./bashref.texi:100 ./bashref.texi:103 ./bashref.texi:104
  99. #, no-wrap
  100. msgid "Introduction"
  101. msgstr ""
  102. #. type: node
  103. #: ./bashref.texi:57 ./bashref.texi:57
  104. #, no-wrap
  105. msgid "(dir)"
  106. msgstr ""
  107. #. type: chapter
  108. #: ./bashref.texi:58 ./bashref.texi:100 ./bashref.texi:6364 ./bashref.texi:6365
  109. #, no-wrap
  110. msgid "Bash Features"
  111. msgstr ""
  112. #. type: ifnottex
  113. #: ./bashref.texi:63
  114. msgid ""
  115. "This text is a brief description of the features that are present in the "
  116. "Bash shell (version @value{VERSION}, @value{UPDATED}). The Bash home page "
  117. "is @url{http://www.gnu.org/software/bash/}."
  118. msgstr ""
  119. #. type: ifnottex
  120. #: ./bashref.texi:75
  121. msgid ""
  122. "Bash contains features that appear in other popular shells, and some "
  123. "features that only appear in Bash. Some of the shells that Bash has "
  124. "borrowed concepts from are the Bourne Shell (@file{sh}), the Korn Shell "
  125. "(@file{ksh}), and the C-shell (@file{csh} and its successor, @file{tcsh}). "
  126. "The following menu breaks the features up into categories, noting which "
  127. "features were inspired by other shells and which are specific to Bash."
  128. msgstr ""
  129. #. type: ifnottex
  130. #: ./bashref.texi:79
  131. msgid ""
  132. "This manual is meant as a brief introduction to features found in Bash. The "
  133. "Bash manual page should be used as the definitive reference on shell "
  134. "behavior."
  135. msgstr ""
  136. #. type: menuentry
  137. #: ./bashref.texi:100
  138. msgid "An introduction to the shell."
  139. msgstr ""
  140. #. type: chapter
  141. #: ./bashref.texi:100 ./bashref.texi:191 ./bashref.texi:192
  142. #, no-wrap
  143. msgid "Definitions"
  144. msgstr ""
  145. #. type: menuentry
  146. #: ./bashref.texi:100
  147. msgid "Some definitions used in the rest of this manual."
  148. msgstr ""
  149. #. type: chapter
  150. #: ./bashref.texi:100 ./bashref.texi:305 ./bashref.texi:306
  151. #, no-wrap
  152. msgid "Basic Shell Features"
  153. msgstr ""
  154. #. type: menuentry
  155. #: ./bashref.texi:100
  156. msgid "The shell \"building blocks\"."
  157. msgstr ""
  158. #. type: chapter
  159. #: ./bashref.texi:100 ./bashref.texi:3343 ./bashref.texi:3344
  160. #, no-wrap
  161. msgid "Shell Builtin Commands"
  162. msgstr ""
  163. #. type: menuentry
  164. #: ./bashref.texi:100
  165. msgid "Commands that are a part of the shell."
  166. msgstr ""
  167. #. type: chapter
  168. #: ./bashref.texi:100 ./bashref.texi:5537 ./bashref.texi:5538
  169. #, no-wrap
  170. msgid "Shell Variables"
  171. msgstr ""
  172. #. type: menuentry
  173. #: ./bashref.texi:100
  174. msgid "Variables used or set by Bash."
  175. msgstr ""
  176. #. type: menuentry
  177. #: ./bashref.texi:100
  178. msgid "Features found only in Bash."
  179. msgstr ""
  180. #. type: chapter
  181. #: ./bashref.texi:100 ./bashref.texi:7864 ./bashref.texi:7865
  182. #, no-wrap
  183. msgid "Job Control"
  184. msgstr ""
  185. #. type: menuentry
  186. #: ./bashref.texi:100
  187. msgid "What job control is and how Bash allows you to use it."
  188. msgstr ""
  189. #. type: menuentry
  190. #: ./bashref.texi:100
  191. msgid "Command Line Editing"
  192. msgstr ""
  193. #. type: menuentry
  194. #: ./bashref.texi:100
  195. msgid "Chapter describing the command line editing features."
  196. msgstr ""
  197. #. type: menuentry
  198. #: ./bashref.texi:100
  199. msgid "Using History Interactively"
  200. msgstr ""
  201. #. type: menuentry
  202. #: ./bashref.texi:100
  203. msgid "Command History Expansion"
  204. msgstr ""
  205. #. type: chapter
  206. #: ./bashref.texi:100 ./bashref.texi:8168 ./bashref.texi:8169
  207. #, no-wrap
  208. msgid "Installing Bash"
  209. msgstr ""
  210. #. type: menuentry
  211. #: ./bashref.texi:100
  212. msgid "How to build and install Bash on your system."
  213. msgstr ""
  214. #. type: appendix
  215. #: ./bashref.texi:100 ./bashref.texi:8701 ./bashref.texi:8702
  216. #, no-wrap
  217. msgid "Reporting Bugs"
  218. msgstr ""
  219. #. type: menuentry
  220. #: ./bashref.texi:100
  221. msgid "How to report bugs in Bash."
  222. msgstr ""
  223. #. type: appendix
  224. #: ./bashref.texi:100 ./bashref.texi:8740 ./bashref.texi:8741
  225. #, no-wrap
  226. msgid "Major Differences From The Bourne Shell"
  227. msgstr ""
  228. #. type: menuentry
  229. #: ./bashref.texi:100
  230. msgid ""
  231. "A terse list of the differences between Bash and historical versions of "
  232. "/bin/sh."
  233. msgstr ""
  234. #. type: appendix
  235. #: ./bashref.texi:100 ./bashref.texi:9208 ./bashref.texi:9209
  236. #, no-wrap
  237. msgid "GNU Free Documentation License"
  238. msgstr ""
  239. #. type: menuentry
  240. #: ./bashref.texi:100
  241. msgid "Copying and sharing this documentation."
  242. msgstr ""
  243. #. type: appendix
  244. #: ./bashref.texi:100 ./bashref.texi:9213 ./bashref.texi:9214
  245. #, no-wrap
  246. msgid "Indexes"
  247. msgstr ""
  248. #. type: menuentry
  249. #: ./bashref.texi:100
  250. msgid "Various indexes for this manual."
  251. msgstr ""
  252. #. type: section
  253. #: ./bashref.texi:108 ./bashref.texi:110 ./bashref.texi:111
  254. #, no-wrap
  255. msgid "What is Bash?"
  256. msgstr ""
  257. #. type: menuentry
  258. #: ./bashref.texi:108
  259. msgid "A short description of Bash."
  260. msgstr ""
  261. #. type: section
  262. #: ./bashref.texi:108 ./bashref.texi:136 ./bashref.texi:137
  263. #, no-wrap
  264. msgid "What is a shell?"
  265. msgstr ""
  266. #. type: menuentry
  267. #: ./bashref.texi:108
  268. msgid "A brief introduction to shells."
  269. msgstr ""
  270. #. type: Plain text
  271. #: ./bashref.texi:120
  272. msgid ""
  273. "Bash is the shell, or command language interpreter, for the @sc{gnu} "
  274. "operating system. The name is an acronym for the @samp{Bourne-Again SHell}, "
  275. "a pun on Stephen Bourne, the author of the direct ancestor of the current "
  276. "Unix shell @code{sh}, which appeared in the Seventh Edition Bell Labs "
  277. "Research version of Unix."
  278. msgstr ""
  279. #. type: Plain text
  280. #: ./bashref.texi:128
  281. msgid ""
  282. "Bash is largely compatible with @code{sh} and incorporates useful features "
  283. "from the Korn shell @code{ksh} and the C shell @code{csh}. It is intended "
  284. "to be a conformant implementation of the @sc{ieee} @sc{posix} Shell and "
  285. "Tools portion of the @sc{ieee} @sc{posix} specification (@sc{ieee} Standard "
  286. "1003.1). It offers functional improvements over @code{sh} for both "
  287. "interactive and programming use."
  288. msgstr ""
  289. #. type: Plain text
  290. #: ./bashref.texi:135
  291. msgid ""
  292. "While the @sc{gnu} operating system provides other shells, including a "
  293. "version of @code{csh}, Bash is the default shell. Like other @sc{gnu} "
  294. "software, Bash is quite portable. It currently runs on nearly every version "
  295. "of Unix and a few other operating systems @minus{} independently-supported "
  296. "ports exist for @sc{ms-dos}, @sc{os/2}, and Windows platforms."
  297. msgstr ""
  298. #. type: Plain text
  299. #: ./bashref.texi:142
  300. msgid ""
  301. "At its base, a shell is simply a macro processor that executes commands. "
  302. "The term macro processor means functionality where text and symbols are "
  303. "expanded to create larger expressions."
  304. msgstr ""
  305. #. type: Plain text
  306. #: ./bashref.texi:152
  307. msgid ""
  308. "A Unix shell is both a command interpreter and a programming language. As a "
  309. "command interpreter, the shell provides the user interface to the rich set "
  310. "of @sc{gnu} utilities. The programming language features allow these "
  311. "utilities to be combined. Files containing commands can be created, and "
  312. "become commands themselves. These new commands have the same status as "
  313. "system commands in directories such as @file{/bin}, allowing users or groups "
  314. "to establish custom environments to automate their common tasks."
  315. msgstr ""
  316. #. type: Plain text
  317. #: ./bashref.texi:157
  318. msgid ""
  319. "Shells may be used interactively or non-interactively. In interactive mode, "
  320. "they accept input typed from the keyboard. When executing "
  321. "non-interactively, shells execute commands read from a file."
  322. msgstr ""
  323. #. type: Plain text
  324. #: ./bashref.texi:167
  325. msgid ""
  326. "A shell allows execution of @sc{gnu} commands, both synchronously and "
  327. "asynchronously. The shell waits for synchronous commands to complete before "
  328. "accepting more input; asynchronous commands continue to execute in parallel "
  329. "with the shell while it reads and executes additional commands. The "
  330. "@dfn{redirection} constructs permit fine-grained control of the input and "
  331. "output of those commands. Moreover, the shell allows control over the "
  332. "contents of commands' environments."
  333. msgstr ""
  334. #. type: Plain text
  335. #: ./bashref.texi:179
  336. msgid ""
  337. "Shells also provide a small set of built-in commands (@dfn{builtins}) "
  338. "implementing functionality impossible or inconvenient to obtain via separate "
  339. "utilities. For example, @code{cd}, @code{break}, @code{continue}, and "
  340. "@code{exec} cannot be implemented outside of the shell because they directly "
  341. "manipulate the shell itself. The @code{history}, @code{getopts}, "
  342. "@code{kill}, or @code{pwd} builtins, among others, could be implemented in "
  343. "separate utilities, but they are more convenient to use as builtin "
  344. "commands. All of the shell builtins are described in subsequent sections."
  345. msgstr ""
  346. #. type: Plain text
  347. #: ./bashref.texi:184
  348. msgid ""
  349. "While executing commands is essential, most of the power (and complexity) of "
  350. "shells is due to their embedded programming languages. Like any high-level "
  351. "language, the shell provides variables, flow control constructs, quoting, "
  352. "and functions."
  353. msgstr ""
  354. #. type: Plain text
  355. #: ./bashref.texi:190
  356. msgid ""
  357. "Shells offer features geared specifically for interactive use rather than to "
  358. "augment the programming language. These interactive features include job "
  359. "control, command line editing, command history and aliases. Each of these "
  360. "features is described in this manual."
  361. msgstr ""
  362. #. type: Plain text
  363. #: ./bashref.texi:194
  364. msgid "These definitions are used throughout the remainder of this manual."
  365. msgstr ""
  366. #. type: cindex
  367. #: ./bashref.texi:197 ./bashref.texi:198
  368. #, no-wrap
  369. msgid "POSIX"
  370. msgstr ""
  371. #. type: table
  372. #: ./bashref.texi:202
  373. msgid ""
  374. "A family of open system standards based on Unix. Bash is primarily "
  375. "concerned with the Shell and Utilities portion of the @sc{posix} 1003.1 "
  376. "standard."
  377. msgstr ""
  378. #. type: item
  379. #: ./bashref.texi:203
  380. #, no-wrap
  381. msgid "blank"
  382. msgstr ""
  383. #. type: table
  384. #: ./bashref.texi:205
  385. msgid "A space or tab character."
  386. msgstr ""
  387. #. type: btindex
  388. #: ./bashref.texi:206 ./bashref.texi:207 ./bashref.texi:4065 ./bashref.texi:4066
  389. #, no-wrap
  390. msgid "builtin"
  391. msgstr ""
  392. #. type: table
  393. #: ./bashref.texi:210
  394. msgid ""
  395. "A command that is implemented internally by the shell itself, rather than by "
  396. "an executable program somewhere in the file system."
  397. msgstr ""
  398. #. type: cindex
  399. #: ./bashref.texi:211 ./bashref.texi:212
  400. #, no-wrap
  401. msgid "control operator"
  402. msgstr ""
  403. #. type: table
  404. #: ./bashref.texi:217
  405. msgid ""
  406. "A @code{token} that performs a control function. It is a @code{newline} or "
  407. "one of the following: @samp{||}, @samp{&&}, @samp{&}, @samp{;}, @samp{;;}, "
  408. "@samp{;&}, @samp{;;&}, @samp{|}, @samp{|&}, @samp{(}, or @samp{)}."
  409. msgstr ""
  410. #. type: cindex
  411. #: ./bashref.texi:218 ./bashref.texi:219 ./bashref.texi:3200
  412. #, no-wrap
  413. msgid "exit status"
  414. msgstr ""
  415. #. type: table
  416. #: ./bashref.texi:222
  417. msgid ""
  418. "The value returned by a command to its caller. The value is restricted to "
  419. "eight bits, so the maximum value is 255."
  420. msgstr ""
  421. #. type: cindex
  422. #: ./bashref.texi:223 ./bashref.texi:224
  423. #, no-wrap
  424. msgid "field"
  425. msgstr ""
  426. #. type: table
  427. #: ./bashref.texi:228
  428. msgid ""
  429. "A unit of text that is the result of one of the shell expansions. After "
  430. "expansion, when executing a command, the resulting fields are used as the "
  431. "command name and arguments."
  432. msgstr ""
  433. #. type: cindex
  434. #: ./bashref.texi:229 ./bashref.texi:230
  435. #, no-wrap
  436. msgid "filename"
  437. msgstr ""
  438. #. type: table
  439. #: ./bashref.texi:232
  440. msgid "A string of characters used to identify a file."
  441. msgstr ""
  442. #. type: cindex
  443. #: ./bashref.texi:233 ./bashref.texi:234
  444. #, no-wrap
  445. msgid "job"
  446. msgstr ""
  447. #. type: table
  448. #: ./bashref.texi:237
  449. msgid ""
  450. "A set of processes comprising a pipeline, and any processes descended from "
  451. "it, that are all in the same process group."
  452. msgstr ""
  453. #. type: cindex
  454. #: ./bashref.texi:238 ./bashref.texi:239 ./bashref.texi:7880
  455. #, no-wrap
  456. msgid "job control"
  457. msgstr ""
  458. #. type: table
  459. #: ./bashref.texi:242
  460. msgid ""
  461. "A mechanism by which users can selectively stop (suspend) and restart "
  462. "(resume) execution of processes."
  463. msgstr ""
  464. #. type: cindex
  465. #: ./bashref.texi:243 ./bashref.texi:244
  466. #, no-wrap
  467. msgid "metacharacter"
  468. msgstr ""
  469. #. type: table
  470. #: ./bashref.texi:249
  471. msgid ""
  472. "A character that, when unquoted, separates words. A metacharacter is a "
  473. "@code{space}, @code{tab}, @code{newline}, or one of the following "
  474. "characters: @samp{|}, @samp{&}, @samp{;}, @samp{(}, @samp{)}, @samp{<}, or "
  475. "@samp{>}."
  476. msgstr ""
  477. #. type: cindex
  478. #: ./bashref.texi:250 ./bashref.texi:251
  479. #, no-wrap
  480. msgid "name"
  481. msgstr ""
  482. #. type: cindex
  483. #: ./bashref.texi:252
  484. #, no-wrap
  485. msgid "identifier"
  486. msgstr ""
  487. #. type: table
  488. #: ./bashref.texi:257
  489. msgid ""
  490. "A @code{word} consisting solely of letters, numbers, and underscores, and "
  491. "beginning with a letter or underscore. @code{Name}s are used as shell "
  492. "variable and function names. Also referred to as an @code{identifier}."
  493. msgstr ""
  494. #. type: item
  495. #: ./bashref.texi:258
  496. #, no-wrap
  497. msgid "operator"
  498. msgstr ""
  499. #. type: cindex
  500. #: ./bashref.texi:259
  501. #, no-wrap
  502. msgid "operator, shell"
  503. msgstr ""
  504. #. type: table
  505. #: ./bashref.texi:263
  506. msgid ""
  507. "A @code{control operator} or a @code{redirection operator}. "
  508. "@xref{Redirections}, for a list of redirection operators. Operators contain "
  509. "at least one unquoted @code{metacharacter}."
  510. msgstr ""
  511. #. type: cindex
  512. #: ./bashref.texi:264 ./bashref.texi:265
  513. #, no-wrap
  514. msgid "process group"
  515. msgstr ""
  516. #. type: table
  517. #: ./bashref.texi:268
  518. msgid ""
  519. "A collection of related processes each having the same process group "
  520. "@sc{id}."
  521. msgstr ""
  522. #. type: cindex
  523. #: ./bashref.texi:269 ./bashref.texi:270
  524. #, no-wrap
  525. msgid "process group ID"
  526. msgstr ""
  527. #. type: table
  528. #: ./bashref.texi:273
  529. msgid ""
  530. "A unique identifier that represents a @code{process group} during its "
  531. "lifetime."
  532. msgstr ""
  533. #. type: cindex
  534. #: ./bashref.texi:274 ./bashref.texi:275
  535. #, no-wrap
  536. msgid "reserved word"
  537. msgstr ""
  538. #. type: table
  539. #: ./bashref.texi:279
  540. msgid ""
  541. "A @code{word} that has a special meaning to the shell. Most reserved words "
  542. "introduce shell flow control constructs, such as @code{for} and "
  543. "@code{while}."
  544. msgstr ""
  545. #. type: cindex
  546. #: ./bashref.texi:280 ./bashref.texi:281
  547. #, no-wrap
  548. msgid "return status"
  549. msgstr ""
  550. #. type: table
  551. #: ./bashref.texi:283
  552. msgid "A synonym for @code{exit status}."
  553. msgstr ""
  554. #. type: cindex
  555. #: ./bashref.texi:284 ./bashref.texi:285
  556. #, no-wrap
  557. msgid "signal"
  558. msgstr ""
  559. #. type: table
  560. #: ./bashref.texi:288
  561. msgid ""
  562. "A mechanism by which a process may be notified by the kernel of an event "
  563. "occurring in the system."
  564. msgstr ""
  565. #. type: cindex
  566. #: ./bashref.texi:289 ./bashref.texi:290 ./bashref.texi:5508
  567. #, no-wrap
  568. msgid "special builtin"
  569. msgstr ""
  570. #. type: table
  571. #: ./bashref.texi:293
  572. msgid ""
  573. "A shell builtin command that has been classified as special by the "
  574. "@sc{posix} standard."
  575. msgstr ""
  576. #. type: cindex
  577. #: ./bashref.texi:294 ./bashref.texi:295
  578. #, no-wrap
  579. msgid "token"
  580. msgstr ""
  581. #. type: table
  582. #: ./bashref.texi:298
  583. msgid ""
  584. "A sequence of characters considered a single unit by the shell. It is "
  585. "either a @code{word} or an @code{operator}."
  586. msgstr ""
  587. #. type: cindex
  588. #: ./bashref.texi:299 ./bashref.texi:300
  589. #, no-wrap
  590. msgid "word"
  591. msgstr ""
  592. #. type: table
  593. #: ./bashref.texi:303
  594. msgid ""
  595. "A sequence of characters treated as a unit by the shell. Words may not "
  596. "include unquoted @code{metacharacters}."
  597. msgstr ""
  598. #. type: cindex
  599. #: ./bashref.texi:307
  600. #, no-wrap
  601. msgid "Bourne shell"
  602. msgstr ""
  603. #. type: Plain text
  604. #: ./bashref.texi:315
  605. msgid ""
  606. "Bash is an acronym for @samp{Bourne-Again SHell}. The Bourne shell is the "
  607. "traditional Unix shell originally written by Stephen Bourne. All of the "
  608. "Bourne shell builtin commands are available in Bash, The rules for "
  609. "evaluation and quoting are taken from the @sc{posix} specification for the "
  610. "`standard' Unix shell."
  611. msgstr ""
  612. #. type: Plain text
  613. #: ./bashref.texi:321
  614. msgid ""
  615. "This chapter briefly summarizes the shell's `building blocks': commands, "
  616. "control structures, shell functions, shell @i{parameters}, shell expansions, "
  617. "@i{redirections}, which are a way to direct input and output from and to "
  618. "named files, and how the shell executes commands."
  619. msgstr ""
  620. #. type: section
  621. #: ./bashref.texi:332 ./bashref.texi:334 ./bashref.texi:335
  622. #, no-wrap
  623. msgid "Shell Syntax"
  624. msgstr ""
  625. #. type: menuentry
  626. #: ./bashref.texi:332
  627. msgid "What your input means to the shell."
  628. msgstr ""
  629. #. type: section
  630. #: ./bashref.texi:332 ./bashref.texi:570 ./bashref.texi:571
  631. #, no-wrap
  632. msgid "Shell Commands"
  633. msgstr ""
  634. #. type: menuentry
  635. #: ./bashref.texi:332
  636. msgid "The types of commands you can use."
  637. msgstr ""
  638. #. type: section
  639. #: ./bashref.texi:332 ./bashref.texi:1348 ./bashref.texi:1349
  640. #, no-wrap
  641. msgid "Shell Functions"
  642. msgstr ""
  643. #. type: menuentry
  644. #: ./bashref.texi:332
  645. msgid "Grouping commands by name."
  646. msgstr ""
  647. #. type: section
  648. #: ./bashref.texi:332 ./bashref.texi:1530 ./bashref.texi:1531
  649. #, no-wrap
  650. msgid "Shell Parameters"
  651. msgstr ""
  652. #. type: menuentry
  653. #: ./bashref.texi:332
  654. msgid "How the shell stores values."
  655. msgstr ""
  656. #. type: section
  657. #: ./bashref.texi:332 ./bashref.texi:1749 ./bashref.texi:1750
  658. #, no-wrap
  659. msgid "Shell Expansions"
  660. msgstr ""
  661. #. type: menuentry
  662. #: ./bashref.texi:332
  663. msgid "How Bash expands parameters and the various expansions available."
  664. msgstr ""
  665. #. type: section
  666. #: ./bashref.texi:332 ./bashref.texi:2653 ./bashref.texi:2654
  667. #, no-wrap
  668. msgid "Redirections"
  669. msgstr ""
  670. #. type: menuentry
  671. #: ./bashref.texi:332
  672. msgid "A way to control where input and output go."
  673. msgstr ""
  674. #. type: section
  675. #: ./bashref.texi:332 ./bashref.texi:2945 ./bashref.texi:2946
  676. #, no-wrap
  677. msgid "Executing Commands"
  678. msgstr ""
  679. #. type: menuentry
  680. #: ./bashref.texi:332
  681. msgid "What happens when you run a command."
  682. msgstr ""
  683. #. type: section
  684. #: ./bashref.texi:332 ./bashref.texi:3282 ./bashref.texi:3283
  685. #, no-wrap
  686. msgid "Shell Scripts"
  687. msgstr ""
  688. #. type: menuentry
  689. #: ./bashref.texi:332
  690. msgid "Executing files of shell commands."
  691. msgstr ""
  692. #. type: subsection
  693. #: ./bashref.texi:340 ./bashref.texi:357 ./bashref.texi:358
  694. #, no-wrap
  695. msgid "Shell Operation"
  696. msgstr ""
  697. #. type: menuentry
  698. #: ./bashref.texi:340
  699. msgid "The basic operation of the shell."
  700. msgstr ""
  701. #. type: subsection
  702. #: ./bashref.texi:340 ./bashref.texi:398 ./bashref.texi:399
  703. #, no-wrap
  704. msgid "Quoting"
  705. msgstr ""
  706. #. type: menuentry
  707. #: ./bashref.texi:340
  708. msgid "How to remove the special meaning from characters."
  709. msgstr ""
  710. #. type: subsection
  711. #: ./bashref.texi:340 ./bashref.texi:555 ./bashref.texi:556
  712. #, no-wrap
  713. msgid "Comments"
  714. msgstr ""
  715. #. type: menuentry
  716. #: ./bashref.texi:340
  717. msgid "How to specify comments."
  718. msgstr ""
  719. #. type: Plain text
  720. #: ./bashref.texi:346
  721. msgid ""
  722. "When the shell reads input, it proceeds through a sequence of operations. "
  723. "If the input indicates the beginning of a comment, the shell ignores the "
  724. "comment symbol (@samp{#}), and the rest of that line."
  725. msgstr ""
  726. #. type: Plain text
  727. #: ./bashref.texi:350
  728. msgid ""
  729. "Otherwise, roughly speaking, the shell reads its input and divides the input "
  730. "into words and operators, employing the quoting rules to select which "
  731. "meanings to assign various words and characters."
  732. msgstr ""
  733. #. type: Plain text
  734. #: ./bashref.texi:356
  735. msgid ""
  736. "The shell then parses these tokens into commands and other constructs, "
  737. "removes the special meaning of certain words or characters, expands others, "
  738. "redirects input and output as needed, executes the specified command, waits "
  739. "for the command's exit status, and makes that exit status available for "
  740. "further inspection or processing."
  741. msgstr ""
  742. #. type: Plain text
  743. #: ./bashref.texi:363
  744. msgid ""
  745. "The following is a brief description of the shell's operation when it reads "
  746. "and executes a command. Basically, the shell does the following:"
  747. msgstr ""
  748. #. type: enumerate
  749. #: ./bashref.texi:369
  750. msgid ""
  751. "Reads its input from a file (@pxref{Shell Scripts}), from a string supplied "
  752. "as an argument to the @option{-c} invocation option (@pxref{Invoking Bash}), "
  753. "or from the user's terminal."
  754. msgstr ""
  755. #. type: enumerate
  756. #: ./bashref.texi:375
  757. msgid ""
  758. "Breaks the input into words and operators, obeying the quoting rules "
  759. "described in @ref{Quoting}. These tokens are separated by "
  760. "@code{metacharacters}. Alias expansion is performed by this step "
  761. "(@pxref{Aliases})."
  762. msgstr ""
  763. #. type: enumerate
  764. #: ./bashref.texi:379
  765. msgid ""
  766. "Parses the tokens into simple and compound commands (@pxref{Shell "
  767. "Commands})."
  768. msgstr ""
  769. #. type: enumerate
  770. #: ./bashref.texi:384
  771. msgid ""
  772. "Performs the various shell expansions (@pxref{Shell Expansions}), breaking "
  773. "the expanded tokens into lists of filenames (@pxref{Filename Expansion}) "
  774. "and commands and arguments."
  775. msgstr ""
  776. #. type: enumerate
  777. #: ./bashref.texi:388
  778. msgid ""
  779. "Performs any necessary redirections (@pxref{Redirections}) and removes the "
  780. "redirection operators and their operands from the argument list."
  781. msgstr ""
  782. #. type: enumerate
  783. #: ./bashref.texi:391
  784. msgid "Executes the command (@pxref{Executing Commands})."
  785. msgstr ""
  786. #. type: enumerate
  787. #: ./bashref.texi:395
  788. msgid ""
  789. "Optionally waits for the command to complete and collects its exit status "
  790. "(@pxref{Exit Status})."
  791. msgstr ""
  792. #. type: cindex
  793. #: ./bashref.texi:400
  794. #, no-wrap
  795. msgid "quoting"
  796. msgstr ""
  797. #. type: subsubsection
  798. #: ./bashref.texi:410 ./bashref.texi:430 ./bashref.texi:431
  799. #, no-wrap
  800. msgid "Escape Character"
  801. msgstr ""
  802. #. type: menuentry
  803. #: ./bashref.texi:410
  804. msgid "How to remove the special meaning from a single character."
  805. msgstr ""
  806. #. type: subsubsection
  807. #: ./bashref.texi:410 ./bashref.texi:439 ./bashref.texi:440
  808. #, no-wrap
  809. msgid "Single Quotes"
  810. msgstr ""
  811. #. type: menuentry
  812. #: ./bashref.texi:410
  813. msgid "How to inhibit all interpretation of a sequence of characters."
  814. msgstr ""
  815. #. type: subsubsection
  816. #: ./bashref.texi:410 ./bashref.texi:446 ./bashref.texi:447
  817. #, no-wrap
  818. msgid "Double Quotes"
  819. msgstr ""
  820. #. type: menuentry
  821. #: ./bashref.texi:410
  822. msgid "How to suppress most of the interpretation of a sequence of characters."
  823. msgstr ""
  824. #. type: subsubsection
  825. #: ./bashref.texi:410 ./bashref.texi:474 ./bashref.texi:475
  826. #, no-wrap
  827. msgid "ANSI-C Quoting"
  828. msgstr ""
  829. #. type: menuentry
  830. #: ./bashref.texi:410
  831. msgid "How to expand ANSI-C sequences in quoted strings."
  832. msgstr ""
  833. #. type: node
  834. #: ./bashref.texi:410 ./bashref.texi:529
  835. #, no-wrap
  836. msgid "Locale Translation"
  837. msgstr ""
  838. #. type: menuentry
  839. #: ./bashref.texi:410
  840. msgid "How to translate strings into different languages."
  841. msgstr ""
  842. #. type: Plain text
  843. #: ./bashref.texi:417
  844. msgid ""
  845. "Quoting is used to remove the special meaning of certain characters or words "
  846. "to the shell. Quoting can be used to disable special treatment for special "
  847. "characters, to prevent reserved words from being recognized as such, and to "
  848. "prevent parameter expansion."
  849. msgstr ""
  850. #. type: Plain text
  851. #: ./bashref.texi:426
  852. msgid ""
  853. "Each of the shell metacharacters (@pxref{Definitions}) has special meaning "
  854. "to the shell and must be quoted if it is to represent itself. When the "
  855. "command history expansion facilities are being used (@pxref{History "
  856. "Interaction}), the @var{history expansion} character, usually @samp{!}, must "
  857. "be quoted to prevent history expansion. @xref{Bash History Facilities}, for "
  858. "more details concerning history expansion."
  859. msgstr ""
  860. #. type: Plain text
  861. #: ./bashref.texi:429
  862. msgid ""
  863. "There are three quoting mechanisms: the @var{escape character}, single "
  864. "quotes, and double quotes."
  865. msgstr ""
  866. #. type: Plain text
  867. #: ./bashref.texi:438
  868. msgid ""
  869. "A non-quoted backslash @samp{\\} is the Bash escape character. It preserves "
  870. "the literal value of the next character that follows, with the exception of "
  871. "@code{newline}. If a @code{\\newline} pair appears, and the backslash "
  872. "itself is not quoted, the @code{\\newline} is treated as a line continuation "
  873. "(that is, it is removed from the input stream and effectively ignored)."
  874. msgstr ""
  875. #. type: Plain text
  876. #: ./bashref.texi:445
  877. msgid ""
  878. "Enclosing characters in single quotes (@samp{'}) preserves the literal value "
  879. "of each character within the quotes. A single quote may not occur between "
  880. "single quotes, even when preceded by a backslash."
  881. msgstr ""
  882. #. type: Plain text
  883. #: ./bashref.texi:470
  884. msgid ""
  885. "Enclosing characters in double quotes (@samp{\"}) preserves the literal "
  886. "value of all characters within the quotes, with the exception of @samp{$}, "
  887. "@samp{`}, @samp{\\}, and, when history expansion is enabled, @samp{!}. When "
  888. "the shell is in @sc{posix} mode (@pxref{Bash POSIX Mode}), the @samp{!} has "
  889. "no special meaning within double quotes, even when history expansion is "
  890. "enabled. The characters @samp{$} and @samp{`} retain their special meaning "
  891. "within double quotes (@pxref{Shell Expansions}). The backslash retains its "
  892. "special meaning only when followed by one of the following characters: "
  893. "@samp{$}, @samp{`}, @samp{\"}, @samp{\\}, or @code{newline}. Within double "
  894. "quotes, backslashes that are followed by one of these characters are "
  895. "removed. Backslashes preceding characters without a special meaning are "
  896. "left unmodified. A double quote may be quoted within double quotes by "
  897. "preceding it with a backslash. If enabled, history expansion will be "
  898. "performed unless an @samp{!} appearing in double quotes is escaped using a "
  899. "backslash. The backslash preceding the @samp{!} is not removed."
  900. msgstr ""
  901. #. type: Plain text
  902. #: ./bashref.texi:473
  903. msgid ""
  904. "The special parameters @samp{*} and @samp{@@} have special meaning when in "
  905. "double quotes (@pxref{Shell Parameter Expansion})."
  906. msgstr ""
  907. #. type: cindex
  908. #: ./bashref.texi:476
  909. #, no-wrap
  910. msgid "quoting, ANSI"
  911. msgstr ""
  912. #. type: Plain text
  913. #: ./bashref.texi:482
  914. msgid ""
  915. "Words of the form @code{$'@var{string}'} are treated specially. The word "
  916. "expands to @var{string}, with backslash-escaped characters replaced as "
  917. "specified by the ANSI C standard. Backslash escape sequences, if present, "
  918. "are decoded as follows:"
  919. msgstr ""
  920. #. type: item
  921. #: ./bashref.texi:484 ./bashref.texi:4254 ./bashref.texi:7418
  922. #, no-wrap
  923. msgid "\\a"
  924. msgstr ""
  925. #. type: table
  926. #: ./bashref.texi:486 ./bashref.texi:4256
  927. msgid "alert (bell)"
  928. msgstr ""
  929. #. type: item
  930. #: ./bashref.texi:486 ./bashref.texi:4256
  931. #, no-wrap
  932. msgid "\\b"
  933. msgstr ""
  934. #. type: table
  935. #: ./bashref.texi:488 ./bashref.texi:4258
  936. msgid "backspace"
  937. msgstr ""
  938. #. type: item
  939. #: ./bashref.texi:488 ./bashref.texi:4260 ./bashref.texi:7426
  940. #, no-wrap
  941. msgid "\\e"
  942. msgstr ""
  943. #. type: itemx
  944. #: ./bashref.texi:489 ./bashref.texi:4261
  945. #, no-wrap
  946. msgid "\\E"
  947. msgstr ""
  948. #. type: table
  949. #: ./bashref.texi:491
  950. msgid "an escape character (not ANSI C)"
  951. msgstr ""
  952. #. type: item
  953. #: ./bashref.texi:491 ./bashref.texi:4263
  954. #, no-wrap
  955. msgid "\\f"
  956. msgstr ""
  957. #. type: table
  958. #: ./bashref.texi:493 ./bashref.texi:4265
  959. msgid "form feed"
  960. msgstr ""
  961. #. type: item
  962. #: ./bashref.texi:493 ./bashref.texi:4265 ./bashref.texi:7436
  963. #, no-wrap
  964. msgid "\\n"
  965. msgstr ""
  966. #. type: table
  967. #: ./bashref.texi:495
  968. msgid "newline"
  969. msgstr ""
  970. #. type: item
  971. #: ./bashref.texi:495 ./bashref.texi:4267 ./bashref.texi:7438
  972. #, no-wrap
  973. msgid "\\r"
  974. msgstr ""
  975. #. type: table
  976. #: ./bashref.texi:497 ./bashref.texi:4269
  977. msgid "carriage return"
  978. msgstr ""
  979. #. type: item
  980. #: ./bashref.texi:497 ./bashref.texi:4269 ./bashref.texi:7443
  981. #, no-wrap
  982. msgid "\\t"
  983. msgstr ""
  984. #. type: table
  985. #: ./bashref.texi:499 ./bashref.texi:4271
  986. msgid "horizontal tab"
  987. msgstr ""
  988. #. type: item
  989. #: ./bashref.texi:499 ./bashref.texi:4271 ./bashref.texi:7453
  990. #, no-wrap
  991. msgid "\\v"
  992. msgstr ""
  993. #. type: table
  994. #: ./bashref.texi:501 ./bashref.texi:4273
  995. msgid "vertical tab"
  996. msgstr ""
  997. #. type: item
  998. #: ./bashref.texi:501 ./bashref.texi:4273 ./bashref.texi:7470
  999. #, no-wrap
  1000. msgid "\\\\"
  1001. msgstr ""
  1002. #. type: table
  1003. #: ./bashref.texi:503 ./bashref.texi:4275
  1004. msgid "backslash"
  1005. msgstr ""
  1006. #. type: item
  1007. #: ./bashref.texi:503
  1008. #, no-wrap
  1009. msgid "\\'"
  1010. msgstr ""
  1011. #. type: table
  1012. #: ./bashref.texi:505
  1013. msgid "single quote"
  1014. msgstr ""
  1015. #. type: item
  1016. #: ./bashref.texi:505
  1017. #, no-wrap
  1018. msgid "\\\""
  1019. msgstr ""
  1020. #. type: table
  1021. #: ./bashref.texi:507
  1022. msgid "double quote"
  1023. msgstr ""
  1024. #. type: item
  1025. #: ./bashref.texi:507
  1026. #, no-wrap
  1027. msgid "\\?"
  1028. msgstr ""
  1029. #. type: table
  1030. #: ./bashref.texi:509
  1031. msgid "question mark"
  1032. msgstr ""
  1033. #. type: item
  1034. #: ./bashref.texi:509 ./bashref.texi:7468
  1035. #, no-wrap
  1036. msgid "\\@var{nnn}"
  1037. msgstr ""
  1038. #. type: table
  1039. #: ./bashref.texi:512
  1040. msgid ""
  1041. "the eight-bit character whose value is the octal value @var{nnn} (one to "
  1042. "three octal digits)"
  1043. msgstr ""
  1044. #. type: item
  1045. #: ./bashref.texi:512 ./bashref.texi:4278
  1046. #, no-wrap
  1047. msgid "\\x@var{HH}"
  1048. msgstr ""
  1049. #. type: table
  1050. #: ./bashref.texi:515 ./bashref.texi:4281
  1051. msgid ""
  1052. "the eight-bit character whose value is the hexadecimal value @var{HH} (one "
  1053. "or two hex digits)"
  1054. msgstr ""
  1055. #. type: item
  1056. #: ./bashref.texi:515 ./bashref.texi:4281
  1057. #, no-wrap
  1058. msgid "\\u@var{HHHH}"
  1059. msgstr ""
  1060. #. type: table
  1061. #: ./bashref.texi:518 ./bashref.texi:4284
  1062. msgid ""
  1063. "the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value "
  1064. "@var{HHHH} (one to four hex digits)"
  1065. msgstr ""
  1066. #. type: item
  1067. #: ./bashref.texi:518 ./bashref.texi:4284
  1068. #, no-wrap
  1069. msgid "\\U@var{HHHHHHHH}"
  1070. msgstr ""
  1071. #. type: table
  1072. #: ./bashref.texi:521 ./bashref.texi:4287
  1073. msgid ""
  1074. "the Unicode (ISO/IEC 10646) character whose value is the hexadecimal value "
  1075. "@var{HHHHHHHH} (one to eight hex digits)"
  1076. msgstr ""
  1077. #. type: item
  1078. #: ./bashref.texi:521
  1079. #, no-wrap
  1080. msgid "\\c@var{x}"
  1081. msgstr ""
  1082. #. type: table
  1083. #: ./bashref.texi:523
  1084. msgid "a control-@var{x} character"
  1085. msgstr ""
  1086. #. type: Plain text
  1087. #: ./bashref.texi:528
  1088. msgid ""
  1089. "The expanded result is single-quoted, as if the dollar sign had not been "
  1090. "present."
  1091. msgstr ""
  1092. #. type: subsubsection
  1093. #: ./bashref.texi:530
  1094. #, no-wrap
  1095. msgid "Locale-Specific Translation"
  1096. msgstr ""
  1097. #. type: cindex
  1098. #: ./bashref.texi:531
  1099. #, no-wrap
  1100. msgid "localization"
  1101. msgstr ""
  1102. #. type: cindex
  1103. #: ./bashref.texi:532
  1104. #, no-wrap
  1105. msgid "internationalization"
  1106. msgstr ""
  1107. #. type: cindex
  1108. #: ./bashref.texi:533
  1109. #, no-wrap
  1110. msgid "native languages"
  1111. msgstr ""
  1112. #. type: cindex
  1113. #: ./bashref.texi:534
  1114. #, no-wrap
  1115. msgid "translation, native languages"
  1116. msgstr ""
  1117. #. type: Plain text
  1118. #: ./bashref.texi:542
  1119. msgid ""
  1120. "A double-quoted string preceded by a dollar sign (@samp{$}) will cause the "
  1121. "string to be translated according to the current locale. If the current "
  1122. "locale is @code{C} or @code{POSIX}, the dollar sign is ignored. If the "
  1123. "string is translated and replaced, the replacement is double-quoted."
  1124. msgstr ""
  1125. #. type: item
  1126. #: ./bashref.texi:543 ./bashref.texi:6151
  1127. #, no-wrap
  1128. msgid "LC_MESSAGES"
  1129. msgstr ""
  1130. #. type: vindex
  1131. #: ./bashref.texi:544
  1132. #, no-wrap
  1133. msgid "TEXTDOMAIN"
  1134. msgstr ""
  1135. #. type: vindex
  1136. #: ./bashref.texi:545
  1137. #, no-wrap
  1138. msgid "TEXTDOMAINDIR"
  1139. msgstr ""
  1140. #. type: Plain text
  1141. #: ./bashref.texi:554
  1142. msgid ""
  1143. "Some systems use the message catalog selected by the @env{LC_MESSAGES} shell "
  1144. "variable. Others create the name of the message catalog from the value of "
  1145. "the @env{TEXTDOMAIN} shell variable, possibly adding a suffix of "
  1146. "@samp{.mo}. If you use the @env{TEXTDOMAIN} variable, you may need to set "
  1147. "the @env{TEXTDOMAINDIR} variable to the location of the message catalog "
  1148. "files. Still others use both variables in this fashion: "
  1149. "@env{TEXTDOMAINDIR}/@env{LC_MESSAGES}/LC_MESSAGES/@env{TEXTDOMAIN}.mo."
  1150. msgstr ""
  1151. #. type: cindex
  1152. #: ./bashref.texi:557
  1153. #, no-wrap
  1154. msgid "comments, shell"
  1155. msgstr ""
  1156. #. type: Plain text
  1157. #: ./bashref.texi:569
  1158. msgid ""
  1159. "In a non-interactive shell, or an interactive shell in which the "
  1160. "@code{interactive_comments} option to the @code{shopt} builtin is enabled "
  1161. "(@pxref{The Shopt Builtin}), a word beginning with @samp{#} causes that word "
  1162. "and all remaining characters on that line to be ignored. An interactive "
  1163. "shell without the @code{interactive_comments} option enabled does not allow "
  1164. "comments. The @code{interactive_comments} option is on by default in "
  1165. "interactive shells. @xref{Interactive Shells}, for a description of what "
  1166. "makes a shell interactive."
  1167. msgstr ""
  1168. #. type: cindex
  1169. #: ./bashref.texi:572
  1170. #, no-wrap
  1171. msgid "commands, shell"
  1172. msgstr ""
  1173. #. type: Plain text
  1174. #: ./bashref.texi:576
  1175. msgid ""
  1176. "A simple shell command such as @code{echo a b c} consists of the command "
  1177. "itself followed by arguments, separated by spaces."
  1178. msgstr ""
  1179. #. type: Plain text
  1180. #: ./bashref.texi:581
  1181. msgid ""
  1182. "More complex shell commands are composed of simple commands arranged "
  1183. "together in a variety of ways: in a pipeline in which the output of one "
  1184. "command becomes the input of a second, in a loop or conditional construct, "
  1185. "or in some other grouping."
  1186. msgstr ""
  1187. #. type: subsection
  1188. #: ./bashref.texi:590 ./bashref.texi:592 ./bashref.texi:593
  1189. #, no-wrap
  1190. msgid "Simple Commands"
  1191. msgstr ""
  1192. #. type: menuentry
  1193. #: ./bashref.texi:590
  1194. msgid "The most common type of command."
  1195. msgstr ""
  1196. #. type: subsection
  1197. #: ./bashref.texi:590 ./bashref.texi:607 ./bashref.texi:608
  1198. #, no-wrap
  1199. msgid "Pipelines"
  1200. msgstr ""
  1201. #. type: menuentry
  1202. #: ./bashref.texi:590
  1203. msgid "Connecting the input and output of several commands."
  1204. msgstr ""
  1205. #. type: node
  1206. #: ./bashref.texi:590 ./bashref.texi:681
  1207. #, no-wrap
  1208. msgid "Lists"
  1209. msgstr ""
  1210. #. type: menuentry
  1211. #: ./bashref.texi:590
  1212. msgid "How to execute commands sequentially."
  1213. msgstr ""
  1214. #. type: subsection
  1215. #: ./bashref.texi:590 ./bashref.texi:738 ./bashref.texi:739
  1216. #, no-wrap
  1217. msgid "Compound Commands"
  1218. msgstr ""
  1219. #. type: menuentry
  1220. #: ./bashref.texi:590
  1221. msgid "Shell commands for control flow."
  1222. msgstr ""
  1223. #. type: subsection
  1224. #: ./bashref.texi:590 ./bashref.texi:1180 ./bashref.texi:1181
  1225. #, no-wrap
  1226. msgid "Coprocesses"
  1227. msgstr ""
  1228. #. type: menuentry
  1229. #: ./bashref.texi:590
  1230. msgid "Two-way communication between commands."
  1231. msgstr ""
  1232. #. type: subsection
  1233. #: ./bashref.texi:590 ./bashref.texi:1227 ./bashref.texi:1228
  1234. #, no-wrap
  1235. msgid "GNU Parallel"
  1236. msgstr ""
  1237. #. type: menuentry
  1238. #: ./bashref.texi:590
  1239. msgid "Running commands in parallel."
  1240. msgstr ""
  1241. #. type: cindex
  1242. #: ./bashref.texi:594
  1243. #, no-wrap
  1244. msgid "commands, simple"
  1245. msgstr ""
  1246. #. type: Plain text
  1247. #: ./bashref.texi:601
  1248. msgid ""
  1249. "A simple command is the kind of command encountered most often. It's just a "
  1250. "sequence of words separated by @code{blank}s, terminated by one of the "
  1251. "shell's control operators (@pxref{Definitions}). The first word generally "
  1252. "specifies a command to be executed, with the rest of the words being that "
  1253. "command's arguments."
  1254. msgstr ""
  1255. #. type: Plain text
  1256. #: ./bashref.texi:606
  1257. msgid ""
  1258. "The return status (@pxref{Exit Status}) of a simple command is its exit "
  1259. "status as provided by the @sc{posix} 1003.1 @code{waitpid} function, or "
  1260. "128+@var{n} if the command was terminated by signal @var{n}."
  1261. msgstr ""
  1262. #. type: cindex
  1263. #: ./bashref.texi:609
  1264. #, no-wrap
  1265. msgid "pipeline"
  1266. msgstr ""
  1267. #. type: cindex
  1268. #: ./bashref.texi:610
  1269. #, no-wrap
  1270. msgid "commands, pipelines"
  1271. msgstr ""
  1272. #. type: Plain text
  1273. #: ./bashref.texi:614
  1274. msgid ""
  1275. "A @code{pipeline} is a sequence of one or more commands separated by one of "
  1276. "the control operators @samp{|} or @samp{|&}."
  1277. msgstr ""
  1278. #. type: rwindex
  1279. #: ./bashref.texi:615
  1280. #, no-wrap
  1281. msgid "time"
  1282. msgstr ""
  1283. #. type: item
  1284. #: ./bashref.texi:616 ./bashref.texi:1720
  1285. #, no-wrap
  1286. msgid "!"
  1287. msgstr ""
  1288. #. type: cindex
  1289. #: ./bashref.texi:617
  1290. #, no-wrap
  1291. msgid "command timing"
  1292. msgstr ""
  1293. #. type: Plain text
  1294. #: ./bashref.texi:619
  1295. msgid "The format for a pipeline is"
  1296. msgstr ""
  1297. #. type: example
  1298. #: ./bashref.texi:621
  1299. #, no-wrap
  1300. msgid "[time [-p]] [!] @var{command1} [ | or |& @var{command2} ] @dots{}\n"
  1301. msgstr ""
  1302. #. type: Plain text
  1303. #: ./bashref.texi:629
  1304. msgid ""
  1305. "The output of each command in the pipeline is connected via a pipe to the "
  1306. "input of the next command. That is, each command reads the previous "
  1307. "command's output. This connection is performed before any redirections "
  1308. "specified by the command."
  1309. msgstr ""
  1310. #. type: Plain text
  1311. #: ./bashref.texi:636
  1312. msgid ""
  1313. "If @samp{|&} is used, @var{command1}'s standard error, in addition to its "
  1314. "standard output, is connected to @var{command2}'s standard input through the "
  1315. "pipe; it is shorthand for @code{2>&1 |}. This implicit redirection of the "
  1316. "standard error to the standard output is performed after any redirections "
  1317. "specified by the command."
  1318. msgstr ""
  1319. #. type: Plain text
  1320. #: ./bashref.texi:652
  1321. msgid ""
  1322. "The reserved word @code{time} causes timing statistics to be printed for the "
  1323. "pipeline once it finishes. The statistics currently consist of elapsed "
  1324. "(wall-clock) time and user and system time consumed by the command's "
  1325. "execution. The @option{-p} option changes the output format to that "
  1326. "specified by @sc{posix}. When the shell is in @sc{posix} mode (@pxref{Bash "
  1327. "POSIX Mode}), it does not recognize @code{time} as a reserved word if the "
  1328. "next token begins with a @samp{-}. The @env{TIMEFORMAT} variable may be set "
  1329. "to a format string that specifies how the timing information should be "
  1330. "displayed. @xref{Bash Variables}, for a description of the available "
  1331. "formats. The use of @code{time} as a reserved word permits the timing of "
  1332. "shell builtins, shell functions, and pipelines. An external @code{time} "
  1333. "command cannot time these easily."
  1334. msgstr ""
  1335. #. type: Plain text
  1336. #: ./bashref.texi:658
  1337. msgid ""
  1338. "When the shell is in @sc{posix} mode (@pxref{Bash POSIX Mode}), @code{time} "
  1339. "may be followed by a newline. In this case, the shell displays the total "
  1340. "user and system time consumed by the shell and its children. The "
  1341. "@env{TIMEFORMAT} variable may be used to specify the format of the time "
  1342. "information."
  1343. msgstr ""
  1344. #. type: Plain text
  1345. #: ./bashref.texi:661
  1346. msgid ""
  1347. "If the pipeline is not executed asynchronously (@pxref{Lists}), the shell "
  1348. "waits for all commands in the pipeline to complete."
  1349. msgstr ""
  1350. #. type: Plain text
  1351. #: ./bashref.texi:667
  1352. msgid ""
  1353. "Each command in a pipeline is executed in its own subshell, which is a "
  1354. "separate process (@pxref{Command Execution Environment}). If the "
  1355. "@code{lastpipe} option is enabled using the @code{shopt} builtin (@pxref{The "
  1356. "Shopt Builtin}), the last element of a pipeline may be run by the shell "
  1357. "process."
  1358. msgstr ""
  1359. #. type: Plain text
  1360. #: ./bashref.texi:680
  1361. msgid ""
  1362. "The exit status of a pipeline is the exit status of the last command in the "
  1363. "pipeline, unless the @code{pipefail} option is enabled (@pxref{The Set "
  1364. "Builtin}). If @code{pipefail} is enabled, the pipeline's return status is "
  1365. "the value of the last (rightmost) command to exit with a non-zero status, or "
  1366. "zero if all commands exit successfully. If the reserved word @samp{!} "
  1367. "precedes the pipeline, the exit status is the logical negation of the exit "
  1368. "status as described above. The shell waits for all commands in the pipeline "
  1369. "to terminate before returning a value."
  1370. msgstr ""
  1371. #. type: subsection
  1372. #: ./bashref.texi:682
  1373. #, no-wrap
  1374. msgid "Lists of Commands"
  1375. msgstr ""
  1376. #. type: cindex
  1377. #: ./bashref.texi:683
  1378. #, no-wrap
  1379. msgid "commands, lists"
  1380. msgstr ""
  1381. #. type: Plain text
  1382. #: ./bashref.texi:689
  1383. msgid ""
  1384. "A @code{list} is a sequence of one or more pipelines separated by one of the "
  1385. "operators @samp{;}, @samp{&}, @samp{&&}, or @samp{||}, and optionally "
  1386. "terminated by one of @samp{;}, @samp{&}, or a @code{newline}."
  1387. msgstr ""
  1388. #. type: Plain text
  1389. #: ./bashref.texi:693
  1390. msgid ""
  1391. "Of these list operators, @samp{&&} and @samp{||} have equal precedence, "
  1392. "followed by @samp{;} and @samp{&}, which have equal precedence."
  1393. msgstr ""
  1394. #. type: Plain text
  1395. #: ./bashref.texi:696
  1396. msgid ""
  1397. "A sequence of one or more newlines may appear in a @code{list} to delimit "
  1398. "commands, equivalent to a semicolon."
  1399. msgstr ""
  1400. #. type: Plain text
  1401. #: ./bashref.texi:706
  1402. msgid ""
  1403. "If a command is terminated by the control operator @samp{&}, the shell "
  1404. "executes the command asynchronously in a subshell. This is known as "
  1405. "executing the command in the @var{background}, and these are referred to as "
  1406. "@var{asynchronous} commands. The shell does not wait for the command to "
  1407. "finish, and the return status is 0 (true). When job control is not active "
  1408. "(@pxref{Job Control}), the standard input for asynchronous commands, in the "
  1409. "absence of any explicit redirections, is redirected from @code{/dev/null}."
  1410. msgstr ""
  1411. #. type: Plain text
  1412. #: ./bashref.texi:710
  1413. msgid ""
  1414. "Commands separated by a @samp{;} are executed sequentially; the shell waits "
  1415. "for each command to terminate in turn. The return status is the exit status "
  1416. "of the last command executed."
  1417. msgstr ""
  1418. #. type: Plain text
  1419. #: ./bashref.texi:715
  1420. msgid ""
  1421. "@sc{and} and @sc{or} lists are sequences of one or more pipelines separated "
  1422. "by the control operators @samp{&&} and @samp{||}, respectively. @sc{and} "
  1423. "and @sc{or} lists are executed with left associativity."
  1424. msgstr ""
  1425. #. type: Plain text
  1426. #: ./bashref.texi:717
  1427. msgid "An @sc{and} list has the form"
  1428. msgstr ""
  1429. #. type: example
  1430. #: ./bashref.texi:719
  1431. #, no-wrap
  1432. msgid "@var{command1} && @var{command2}\n"
  1433. msgstr ""
  1434. #. type: Plain text
  1435. #: ./bashref.texi:724
  1436. msgid ""
  1437. "@var{command2} is executed if, and only if, @var{command1} returns an exit "
  1438. "status of zero (success)."
  1439. msgstr ""
  1440. #. type: Plain text
  1441. #: ./bashref.texi:726
  1442. msgid "An @sc{or} list has the form"
  1443. msgstr ""
  1444. #. type: example
  1445. #: ./bashref.texi:728
  1446. #, no-wrap
  1447. msgid "@var{command1} || @var{command2}\n"
  1448. msgstr ""
  1449. #. type: Plain text
  1450. #: ./bashref.texi:733
  1451. msgid ""
  1452. "@var{command2} is executed if, and only if, @var{command1} returns a "
  1453. "non-zero exit status."
  1454. msgstr ""
  1455. #. type: Plain text
  1456. #: ./bashref.texi:737
  1457. msgid ""
  1458. "The return status of @sc{and} and @sc{or} lists is the exit status of the "
  1459. "last command executed in the list."
  1460. msgstr ""
  1461. #. type: cindex
  1462. #: ./bashref.texi:740
  1463. #, no-wrap
  1464. msgid "commands, compound"
  1465. msgstr ""
  1466. #. type: subsubsection
  1467. #: ./bashref.texi:746 ./bashref.texi:761 ./bashref.texi:762
  1468. #, no-wrap
  1469. msgid "Looping Constructs"
  1470. msgstr ""
  1471. #. type: menuentry
  1472. #: ./bashref.texi:746
  1473. msgid "Shell commands for iterative action."
  1474. msgstr ""
  1475. #. type: subsubsection
  1476. #: ./bashref.texi:746 ./bashref.texi:839 ./bashref.texi:840
  1477. #, no-wrap
  1478. msgid "Conditional Constructs"
  1479. msgstr ""
  1480. #. type: menuentry
  1481. #: ./bashref.texi:746
  1482. msgid "Shell commands for conditional execution."
  1483. msgstr ""
  1484. #. type: node
  1485. #: ./bashref.texi:746 ./bashref.texi:1136
  1486. #, no-wrap
  1487. msgid "Command Grouping"
  1488. msgstr ""
  1489. #. type: menuentry
  1490. #: ./bashref.texi:746
  1491. msgid "Ways to group commands."
  1492. msgstr ""
  1493. #. type: Plain text
  1494. #: ./bashref.texi:753
  1495. msgid ""
  1496. "Compound commands are the shell programming language constructs. Each "
  1497. "construct begins with a reserved word or control operator and is terminated "
  1498. "by a corresponding reserved word or operator. Any redirections "
  1499. "(@pxref{Redirections}) associated with a compound command apply to all "
  1500. "commands within that compound command unless explicitly overridden."
  1501. msgstr ""
  1502. #. type: Plain text
  1503. #: ./bashref.texi:757
  1504. msgid ""
  1505. "In most cases a list of commands in a compound command's description may be "
  1506. "separated from the rest of the command by one or more newlines, and may be "
  1507. "followed by a newline in place of a semicolon."
  1508. msgstr ""
  1509. #. type: Plain text
  1510. #: ./bashref.texi:760
  1511. msgid ""
  1512. "Bash provides looping constructs, conditional commands, and mechanisms to "
  1513. "group commands and execute them as a unit."
  1514. msgstr ""
  1515. #. type: cindex
  1516. #: ./bashref.texi:763
  1517. #, no-wrap
  1518. msgid "commands, looping"
  1519. msgstr ""
  1520. #. type: Plain text
  1521. #: ./bashref.texi:766
  1522. msgid "Bash supports the following looping constructs."
  1523. msgstr ""
  1524. #. type: Plain text
  1525. #: ./bashref.texi:769
  1526. msgid ""
  1527. "Note that wherever a @samp{;} appears in the description of a command's "
  1528. "syntax, it may be replaced with one or more newlines."
  1529. msgstr ""
  1530. #. type: rwindex
  1531. #: ./bashref.texi:771 ./bashref.texi:772
  1532. #, no-wrap
  1533. msgid "until"
  1534. msgstr ""
  1535. #. type: rwindex
  1536. #: ./bashref.texi:773
  1537. #, no-wrap
  1538. msgid "do"
  1539. msgstr ""
  1540. #. type: rwindex
  1541. #: ./bashref.texi:774
  1542. #, no-wrap
  1543. msgid "done"
  1544. msgstr ""
  1545. #. type: table
  1546. #: ./bashref.texi:776
  1547. msgid "The syntax of the @code{until} command is:"
  1548. msgstr ""
  1549. #. type: example
  1550. #: ./bashref.texi:779
  1551. #, no-wrap
  1552. msgid "until @var{test-commands}; do @var{consequent-commands}; done\n"
  1553. msgstr ""
  1554. #. type: table
  1555. #: ./bashref.texi:785
  1556. msgid ""
  1557. "Execute @var{consequent-commands} as long as @var{test-commands} has an exit "
  1558. "status which is not zero. The return status is the exit status of the last "
  1559. "command executed in @var{consequent-commands}, or zero if none was executed."
  1560. msgstr ""
  1561. #. type: rwindex
  1562. #: ./bashref.texi:786 ./bashref.texi:787
  1563. #, no-wrap
  1564. msgid "while"
  1565. msgstr ""
  1566. #. type: table
  1567. #: ./bashref.texi:789
  1568. msgid "The syntax of the @code{while} command is:"
  1569. msgstr ""
  1570. #. type: example
  1571. #: ./bashref.texi:792
  1572. #, no-wrap
  1573. msgid "while @var{test-commands}; do @var{consequent-commands}; done\n"
  1574. msgstr ""
  1575. #. type: table
  1576. #: ./bashref.texi:798
  1577. msgid ""
  1578. "Execute @var{consequent-commands} as long as @var{test-commands} has an exit "
  1579. "status of zero. The return status is the exit status of the last command "
  1580. "executed in @var{consequent-commands}, or zero if none was executed."
  1581. msgstr ""
  1582. #. type: rwindex
  1583. #: ./bashref.texi:799 ./bashref.texi:800
  1584. #, no-wrap
  1585. msgid "for"
  1586. msgstr ""
  1587. #. type: table
  1588. #: ./bashref.texi:802
  1589. msgid "The syntax of the @code{for} command is:"
  1590. msgstr ""
  1591. #. type: example
  1592. #: ./bashref.texi:805
  1593. #, no-wrap
  1594. msgid "for @var{name} [ [in [@var{words} @dots{}] ] ; ] do @var{commands}; done\n"
  1595. msgstr ""
  1596. #. type: table
  1597. #: ./bashref.texi:814
  1598. msgid ""
  1599. "Expand @var{words} (@pxref{Shell Expansions}), and execute @var{commands} "
  1600. "once for each member in the resultant list, with @var{name} bound to the "
  1601. "current member. If @samp{in @var{words}} is not present, the @code{for} "
  1602. "command executes the @var{commands} once for each positional parameter that "
  1603. "is set, as if @samp{in \"$@@\"} had been specified (@pxref{Special "
  1604. "Parameters})."
  1605. msgstr ""
  1606. #. type: table
  1607. #: ./bashref.texi:818
  1608. msgid ""
  1609. "The return status is the exit status of the last command that executes. If "
  1610. "there are no items in the expansion of @var{words}, no commands are "
  1611. "executed, and the return status is zero."
  1612. msgstr ""
  1613. #. type: table
  1614. #: ./bashref.texi:820
  1615. msgid "An alternate form of the @code{for} command is also supported:"
  1616. msgstr ""
  1617. #. type: example
  1618. #: ./bashref.texi:823
  1619. #, no-wrap
  1620. msgid ""
  1621. "for (( @var{expr1} ; @var{expr2} ; @var{expr3} )) ; do @var{commands} ; "
  1622. "done\n"
  1623. msgstr ""
  1624. #. type: table
  1625. #: ./bashref.texi:834
  1626. msgid ""
  1627. "First, the arithmetic expression @var{expr1} is evaluated according to the "
  1628. "rules described below (@pxref{Shell Arithmetic}). The arithmetic expression "
  1629. "@var{expr2} is then evaluated repeatedly until it evaluates to zero. Each "
  1630. "time @var{expr2} evaluates to a non-zero value, @var{commands} are executed "
  1631. "and the arithmetic expression @var{expr3} is evaluated. If any expression "
  1632. "is omitted, it behaves as if it evaluates to 1. The return value is the "
  1633. "exit status of the last command in @var{commands} that is executed, or false "
  1634. "if any of the expressions is invalid."
  1635. msgstr ""
  1636. #. type: Plain text
  1637. #: ./bashref.texi:838
  1638. msgid ""
  1639. "The @code{break} and @code{continue} builtins (@pxref{Bourne Shell "
  1640. "Builtins}) may be used to control loop execution."
  1641. msgstr ""
  1642. #. type: cindex
  1643. #: ./bashref.texi:841
  1644. #, no-wrap
  1645. msgid "commands, conditional"
  1646. msgstr ""
  1647. #. type: rwindex
  1648. #: ./bashref.texi:844 ./bashref.texi:845
  1649. #, no-wrap
  1650. msgid "if"
  1651. msgstr ""
  1652. #. type: rwindex
  1653. #: ./bashref.texi:846
  1654. #, no-wrap
  1655. msgid "then"
  1656. msgstr ""
  1657. #. type: rwindex
  1658. #: ./bashref.texi:847
  1659. #, no-wrap
  1660. msgid "else"
  1661. msgstr ""
  1662. #. type: rwindex
  1663. #: ./bashref.texi:848
  1664. #, no-wrap
  1665. msgid "elif"
  1666. msgstr ""
  1667. #. type: rwindex
  1668. #: ./bashref.texi:849
  1669. #, no-wrap
  1670. msgid "fi"
  1671. msgstr ""
  1672. #. type: table
  1673. #: ./bashref.texi:851
  1674. msgid "The syntax of the @code{if} command is:"
  1675. msgstr ""
  1676. #. type: example
  1677. #: ./bashref.texi:859
  1678. #, no-wrap
  1679. msgid ""
  1680. "if @var{test-commands}; then\n"
  1681. " @var{consequent-commands};\n"
  1682. "[elif @var{more-test-commands}; then\n"
  1683. " @var{more-consequents};]\n"
  1684. "[else @var{alternate-consequents};]\n"
  1685. "fi\n"
  1686. msgstr ""
  1687. #. type: table
  1688. #: ./bashref.texi:872
  1689. msgid ""
  1690. "The @var{test-commands} list is executed, and if its return status is zero, "
  1691. "the @var{consequent-commands} list is executed. If @var{test-commands} "
  1692. "returns a non-zero status, each @code{elif} list is executed in turn, and if "
  1693. "its exit status is zero, the corresponding @var{more-consequents} is "
  1694. "executed and the command completes. If @samp{else "
  1695. "@var{alternate-consequents}} is present, and the final command in the final "
  1696. "@code{if} or @code{elif} clause has a non-zero exit status, then "
  1697. "@var{alternate-consequents} is executed. The return status is the exit "
  1698. "status of the last command executed, or zero if no condition tested true."
  1699. msgstr ""
  1700. #. type: rwindex
  1701. #: ./bashref.texi:873 ./bashref.texi:874
  1702. #, no-wrap
  1703. msgid "case"
  1704. msgstr ""
  1705. #. type: rwindex
  1706. #: ./bashref.texi:875
  1707. #, no-wrap
  1708. msgid "in"
  1709. msgstr ""
  1710. #. type: rwindex
  1711. #: ./bashref.texi:876
  1712. #, no-wrap
  1713. msgid "esac"
  1714. msgstr ""
  1715. #. type: table
  1716. #: ./bashref.texi:878
  1717. msgid "The syntax of the @code{case} command is:"
  1718. msgstr ""
  1719. #. type: example
  1720. #: ./bashref.texi:883
  1721. #, no-wrap
  1722. msgid ""
  1723. "case @var{word} in\n"
  1724. " [ [(] @var{pattern} [| @var{pattern}]@dots{}) @var{command-list} "
  1725. ";;]@dots{}\n"
  1726. "esac\n"
  1727. msgstr ""
  1728. #. type: table
  1729. #: ./bashref.texi:897
  1730. msgid ""
  1731. "@code{case} will selectively execute the @var{command-list} corresponding to "
  1732. "the first @var{pattern} that matches @var{word}. The match is performed "
  1733. "according to the rules described below in @ref{Pattern Matching}. If the "
  1734. "@code{nocasematch} shell option (see the description of @code{shopt} in "
  1735. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  1736. "to the case of alphabetic characters. The @samp{|} is used to separate "
  1737. "multiple patterns, and the @samp{)} operator terminates a pattern list. A "
  1738. "list of patterns and an associated command-list is known as a @var{clause}."
  1739. msgstr ""
  1740. #. type: table
  1741. #: ./bashref.texi:905
  1742. msgid ""
  1743. "Each clause must be terminated with @samp{;;}, @samp{;&}, or @samp{;;&}. "
  1744. "The @var{word} undergoes tilde expansion, parameter expansion, command "
  1745. "substitution, arithmetic expansion, and quote removal (@pxref{Shell "
  1746. "Parameter Expansion}) before matching is attempted. Each @var{pattern} "
  1747. "undergoes tilde expansion, parameter expansion, command substitution, and "
  1748. "arithmetic expansion."
  1749. msgstr ""
  1750. #. type: table
  1751. #: ./bashref.texi:912
  1752. msgid ""
  1753. "There may be an arbitrary number of @code{case} clauses, each terminated by "
  1754. "a @samp{;;}, @samp{;&}, or @samp{;;&}. The first pattern that matches "
  1755. "determines the command-list that is executed. It's a common idiom to use "
  1756. "@samp{*} as the final pattern to define the default case, since that pattern "
  1757. "will always match."
  1758. msgstr ""
  1759. #. type: table
  1760. #: ./bashref.texi:915
  1761. msgid ""
  1762. "Here is an example using @code{case} in a script that could be used to "
  1763. "describe one interesting feature of an animal:"
  1764. msgstr ""
  1765. #. type: example
  1766. #: ./bashref.texi:926
  1767. #, no-wrap
  1768. msgid ""
  1769. "echo -n \"Enter the name of an animal: \"\n"
  1770. "read ANIMAL\n"
  1771. "echo -n \"The $ANIMAL has \"\n"
  1772. "case $ANIMAL in\n"
  1773. " horse | dog | cat) echo -n \"four\";;\n"
  1774. " man | kangaroo ) echo -n \"two\";;\n"
  1775. " *) echo -n \"an unknown number of\";;\n"
  1776. "esac\n"
  1777. "echo \" legs.\"\n"
  1778. msgstr ""
  1779. #. type: table
  1780. #: ./bashref.texi:937
  1781. msgid ""
  1782. "If the @samp{;;} operator is used, no subsequent matches are attempted after "
  1783. "the first pattern match. Using @samp{;&} in place of @samp{;;} causes "
  1784. "execution to continue with the @var{command-list} associated with the next "
  1785. "clause, if any. Using @samp{;;&} in place of @samp{;;} causes the shell to "
  1786. "test the patterns in the next clause, if any, and execute any associated "
  1787. "@var{command-list} on a successful match."
  1788. msgstr ""
  1789. #. type: table
  1790. #: ./bashref.texi:940
  1791. msgid ""
  1792. "The return status is zero if no @var{pattern} is matched. Otherwise, the "
  1793. "return status is the exit status of the @var{command-list} executed."
  1794. msgstr ""
  1795. #. type: rwindex
  1796. #: ./bashref.texi:941 ./bashref.texi:942
  1797. #, no-wrap
  1798. msgid "select"
  1799. msgstr ""
  1800. #. type: table
  1801. #: ./bashref.texi:946
  1802. msgid ""
  1803. "The @code{select} construct allows the easy generation of menus. It has "
  1804. "almost the same syntax as the @code{for} command:"
  1805. msgstr ""
  1806. #. type: example
  1807. #: ./bashref.texi:949
  1808. #, no-wrap
  1809. msgid "select @var{name} [in @var{words} @dots{}]; do @var{commands}; done\n"
  1810. msgstr ""
  1811. #. type: table
  1812. #: ./bashref.texi:964
  1813. msgid ""
  1814. "The list of words following @code{in} is expanded, generating a list of "
  1815. "items. The set of expanded words is printed on the standard error output "
  1816. "stream, each preceded by a number. If the @samp{in @var{words}} is omitted, "
  1817. "the positional parameters are printed, as if @samp{in \"$@@\"} had been "
  1818. "specified. The @env{PS3} prompt is then displayed and a line is read from "
  1819. "the standard input. If the line consists of a number corresponding to one "
  1820. "of the displayed words, then the value of @var{name} is set to that word. "
  1821. "If the line is empty, the words and prompt are displayed again. If "
  1822. "@code{EOF} is read, the @code{select} command completes. Any other value "
  1823. "read causes @var{name} to be set to null. The line read is saved in the "
  1824. "variable @env{REPLY}."
  1825. msgstr ""
  1826. #. type: table
  1827. #: ./bashref.texi:968
  1828. msgid ""
  1829. "The @var{commands} are executed after each selection until a @code{break} "
  1830. "command is executed, at which point the @code{select} command completes."
  1831. msgstr ""
  1832. #. type: table
  1833. #: ./bashref.texi:972
  1834. msgid ""
  1835. "Here is an example that allows the user to pick a filename from the current "
  1836. "directory, and displays the name and index of the file selected."
  1837. msgstr ""
  1838. #. type: example
  1839. #: ./bashref.texi:979
  1840. #, no-wrap
  1841. msgid ""
  1842. "select fname in *;\n"
  1843. "do\n"
  1844. "\techo you picked $fname \\($REPLY\\)\n"
  1845. "\tbreak;\n"
  1846. "done\n"
  1847. msgstr ""
  1848. #. type: item
  1849. #: ./bashref.texi:981
  1850. #, no-wrap
  1851. msgid "((@dots{}))"
  1852. msgstr ""
  1853. #. type: example
  1854. #: ./bashref.texi:984
  1855. #, no-wrap
  1856. msgid "(( @var{expression} ))\n"
  1857. msgstr ""
  1858. #. type: table
  1859. #: ./bashref.texi:990
  1860. msgid ""
  1861. "The arithmetic @var{expression} is evaluated according to the rules "
  1862. "described below (@pxref{Shell Arithmetic}). If the value of the expression "
  1863. "is non-zero, the return status is 0; otherwise the return status is 1. This "
  1864. "is exactly equivalent to"
  1865. msgstr ""
  1866. #. type: example
  1867. #: ./bashref.texi:992
  1868. #, no-wrap
  1869. msgid "let \"@var{expression}\"\n"
  1870. msgstr ""
  1871. #. type: table
  1872. #: ./bashref.texi:995
  1873. msgid "@xref{Bash Builtins}, for a full description of the @code{let} builtin."
  1874. msgstr ""
  1875. #. type: item
  1876. #: ./bashref.texi:996
  1877. #, no-wrap
  1878. msgid "[[@dots{}]]"
  1879. msgstr ""
  1880. #. type: rwindex
  1881. #: ./bashref.texi:997
  1882. #, no-wrap
  1883. msgid "[["
  1884. msgstr ""
  1885. #. type: rwindex
  1886. #: ./bashref.texi:998
  1887. #, no-wrap
  1888. msgid "]]"
  1889. msgstr ""
  1890. #. type: example
  1891. #: ./bashref.texi:1001
  1892. #, no-wrap
  1893. msgid "[[ @var{expression} ]]\n"
  1894. msgstr ""
  1895. #. type: table
  1896. #: ./bashref.texi:1013
  1897. msgid ""
  1898. "Return a status of 0 or 1 depending on the evaluation of the conditional "
  1899. "expression @var{expression}. Expressions are composed of the primaries "
  1900. "described below in @ref{Bash Conditional Expressions}. Word splitting and "
  1901. "filename expansion are not performed on the words between the @code{[[} and "
  1902. "@code{]]}; tilde expansion, parameter and variable expansion, arithmetic "
  1903. "expansion, command substitution, process substitution, and quote removal are "
  1904. "performed. Conditional operators such as @samp{-f} must be unquoted to be "
  1905. "recognized as primaries."
  1906. msgstr ""
  1907. #. type: table
  1908. #: ./bashref.texi:1016
  1909. msgid ""
  1910. "When used with @code{[[}, the @samp{<} and @samp{>} operators sort "
  1911. "lexicographically using the current locale."
  1912. msgstr ""
  1913. #. type: table
  1914. #: ./bashref.texi:1030
  1915. msgid ""
  1916. "When the @samp{==} and @samp{!=} operators are used, the string to the right "
  1917. "of the operator is considered a pattern and matched according to the rules "
  1918. "described below in @ref{Pattern Matching}, as if the @code{extglob} shell "
  1919. "option were enabled. The @samp{=} operator is identical to @samp{==}. If "
  1920. "the @code{nocasematch} shell option (see the description of @code{shopt} in "
  1921. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  1922. "to the case of alphabetic characters. The return value is 0 if the string "
  1923. "matches (@samp{==}) or does not match (@samp{!=}) the pattern, and 1 "
  1924. "otherwise. Any part of the pattern may be quoted to force the quoted "
  1925. "portion to be matched as a string."
  1926. msgstr ""
  1927. #. type: table
  1928. #: ./bashref.texi:1056
  1929. msgid ""
  1930. "An additional binary operator, @samp{=~}, is available, with the same "
  1931. "precedence as @samp{==} and @samp{!=}. When it is used, the string to the "
  1932. "right of the operator is considered a @sc{POSIX} extended regular expression "
  1933. "and matched accordingly (as in @i{regex}3)). The return value is 0 if the "
  1934. "string matches the pattern, and 1 otherwise. If the regular expression is "
  1935. "syntactically incorrect, the conditional expression's return value is 2. If "
  1936. "the @code{nocasematch} shell option (see the description of @code{shopt} in "
  1937. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  1938. "to the case of alphabetic characters. Any part of the pattern may be quoted "
  1939. "to force the quoted portion to be matched as a string. Bracket expressions "
  1940. "in regular expressions must be treated carefully, since normal quoting "
  1941. "characters lose their meanings between brackets. If the pattern is stored "
  1942. "in a shell variable, quoting the variable expansion forces the entire "
  1943. "pattern to be matched as a string. Substrings matched by parenthesized "
  1944. "subexpressions within the regular expression are saved in the array variable "
  1945. "@code{BASH_REMATCH}. The element of @code{BASH_REMATCH} with index 0 is the "
  1946. "portion of the string matching the entire regular expression. The element "
  1947. "of @code{BASH_REMATCH} with index @var{n} is the portion of the string "
  1948. "matching the @var{n}th parenthesized subexpression."
  1949. msgstr ""
  1950. #. type: table
  1951. #: ./bashref.texi:1062
  1952. msgid ""
  1953. "For example, the following will match a line (stored in the shell variable "
  1954. "@var{line}) if there is a sequence of characters in the value consisting of "
  1955. "any number, including zero, of space characters, zero or one instances of "
  1956. "@samp{a}, then a @samp{b}:"
  1957. msgstr ""
  1958. #. type: example
  1959. #: ./bashref.texi:1064
  1960. #, no-wrap
  1961. msgid "[[ $line =~ [[:space:]]*?(a)b ]]\n"
  1962. msgstr ""
  1963. #. type: table
  1964. #: ./bashref.texi:1069
  1965. msgid ""
  1966. "That means values like @samp{aab} and @samp{ aaaaaab} will match, as will a "
  1967. "line containing a @samp{b} anywhere in its value."
  1968. msgstr ""
  1969. #. type: table
  1970. #: ./bashref.texi:1078
  1971. msgid ""
  1972. "Storing the regular expression in a shell variable is often a useful way to "
  1973. "avoid problems with quoting characters that are special to the shell. It is "
  1974. "sometimes difficult to specify a regular expression literally without using "
  1975. "quotes, or to keep track of the quoting used by regular expressions while "
  1976. "paying attention to the shell's quote removal. Using a shell variable to "
  1977. "store the pattern decreases these problems. For example, the following is "
  1978. "equivalent to the above:"
  1979. msgstr ""
  1980. #. type: example
  1981. #: ./bashref.texi:1081
  1982. #, no-wrap
  1983. msgid ""
  1984. "pattern='[[:space:]]*?(a)b'\n"
  1985. "[[ $line =~ $pattern ]]\n"
  1986. msgstr ""
  1987. #. type: table
  1988. #: ./bashref.texi:1093
  1989. msgid ""
  1990. "If you want to match a character that's special to the regular expression "
  1991. "grammar, it has to be quoted to remove its special meaning. This means that "
  1992. "in the pattern @samp{xxx.txt}, the @samp{.} matches any character in the "
  1993. "string (its usual regular expression meaning), but in the pattern "
  1994. "@samp{\"xxx.txt\"} it can only match a literal @samp{.}. Shell programmers "
  1995. "should take special care with backslashes, since backslashes are used both "
  1996. "by the shell and regular expressions to remove the special meaning from the "
  1997. "following character. The following two sets of commands are @emph{not} "
  1998. "equivalent:"
  1999. msgstr ""
  2000. #. type: example
  2001. #: ./bashref.texi:1095
  2002. #, no-wrap
  2003. msgid ""
  2004. "pattern='\\.'\n"
  2005. "\n"
  2006. msgstr ""
  2007. #. type: example
  2008. #: ./bashref.texi:1098
  2009. #, no-wrap
  2010. msgid ""
  2011. "[[ . =~ $pattern ]]\n"
  2012. "[[ . =~ \\. ]]\n"
  2013. "\n"
  2014. msgstr ""
  2015. #. type: example
  2016. #: ./bashref.texi:1101
  2017. #, no-wrap
  2018. msgid ""
  2019. "[[ . =~ \"$pattern\" ]]\n"
  2020. "[[ . =~ '\\.' ]]\n"
  2021. msgstr ""
  2022. #. type: table
  2023. #: ./bashref.texi:1111
  2024. msgid ""
  2025. "The first two matches will succeed, but the second two will not, because in "
  2026. "the second two the backslash will be part of the pattern to be matched. In "
  2027. "the first two examples, the backslash removes the special meaning from "
  2028. "@samp{.}, so the literal @samp{.} matches. If the string in the first "
  2029. "examples were anything other than @samp{.}, say @samp{a}, the pattern would "
  2030. "not match, because the quoted @samp{.} in the pattern loses its special "
  2031. "meaning of matching any single character."
  2032. msgstr ""
  2033. #. type: table
  2034. #: ./bashref.texi:1114
  2035. msgid ""
  2036. "Expressions may be combined using the following operators, listed in "
  2037. "decreasing order of precedence:"
  2038. msgstr ""
  2039. #. type: item
  2040. #: ./bashref.texi:1116
  2041. #, no-wrap
  2042. msgid "( @var{expression} )"
  2043. msgstr ""
  2044. #. type: table
  2045. #: ./bashref.texi:1119
  2046. msgid ""
  2047. "Returns the value of @var{expression}. This may be used to override the "
  2048. "normal precedence of operators."
  2049. msgstr ""
  2050. #. type: item
  2051. #: ./bashref.texi:1120
  2052. #, no-wrap
  2053. msgid "! @var{expression}"
  2054. msgstr ""
  2055. #. type: table
  2056. #: ./bashref.texi:1122
  2057. msgid "True if @var{expression} is false."
  2058. msgstr ""
  2059. #. type: item
  2060. #: ./bashref.texi:1123
  2061. #, no-wrap
  2062. msgid "@var{expression1} && @var{expression2}"
  2063. msgstr ""
  2064. #. type: table
  2065. #: ./bashref.texi:1125
  2066. msgid "True if both @var{expression1} and @var{expression2} are true."
  2067. msgstr ""
  2068. #. type: item
  2069. #: ./bashref.texi:1126
  2070. #, no-wrap
  2071. msgid "@var{expression1} || @var{expression2}"
  2072. msgstr ""
  2073. #. type: table
  2074. #: ./bashref.texi:1128
  2075. msgid "True if either @var{expression1} or @var{expression2} is true."
  2076. msgstr ""
  2077. #. type: table
  2078. #: ./bashref.texi:1134
  2079. msgid ""
  2080. "The @code{&&} and @code{||} operators do not evaluate @var{expression2} if "
  2081. "the value of @var{expression1} is sufficient to determine the return value "
  2082. "of the entire conditional expression."
  2083. msgstr ""
  2084. #. type: subsubsection
  2085. #: ./bashref.texi:1137
  2086. #, no-wrap
  2087. msgid "Grouping Commands"
  2088. msgstr ""
  2089. #. type: cindex
  2090. #: ./bashref.texi:1138
  2091. #, no-wrap
  2092. msgid "commands, grouping"
  2093. msgstr ""
  2094. #. type: Plain text
  2095. #: ./bashref.texi:1144
  2096. msgid ""
  2097. "Bash provides two ways to group a list of commands to be executed as a "
  2098. "unit. When commands are grouped, redirections may be applied to the entire "
  2099. "command list. For example, the output of all the commands in the list may "
  2100. "be redirected to a single stream."
  2101. msgstr ""
  2102. #. type: item
  2103. #: ./bashref.texi:1146
  2104. #, no-wrap
  2105. msgid "()"
  2106. msgstr ""
  2107. #. type: example
  2108. #: ./bashref.texi:1149
  2109. #, no-wrap
  2110. msgid "( @var{list} )\n"
  2111. msgstr ""
  2112. #. type: table
  2113. #: ./bashref.texi:1156
  2114. msgid ""
  2115. "Placing a list of commands between parentheses causes a subshell environment "
  2116. "to be created (@pxref{Command Execution Environment}), and each of the "
  2117. "commands in @var{list} to be executed in that subshell. Since the "
  2118. "@var{list} is executed in a subshell, variable assignments do not remain in "
  2119. "effect after the subshell completes."
  2120. msgstr ""
  2121. #. type: item
  2122. #: ./bashref.texi:1157
  2123. #, no-wrap
  2124. msgid "@{@}"
  2125. msgstr ""
  2126. #. type: rwindex
  2127. #: ./bashref.texi:1158
  2128. #, no-wrap
  2129. msgid "@{"
  2130. msgstr ""
  2131. #. type: rwindex
  2132. #: ./bashref.texi:1159
  2133. #, no-wrap
  2134. msgid "@}"
  2135. msgstr ""
  2136. #. type: example
  2137. #: ./bashref.texi:1162
  2138. #, no-wrap
  2139. msgid "@{ @var{list}; @}\n"
  2140. msgstr ""
  2141. #. type: table
  2142. #: ./bashref.texi:1167
  2143. msgid ""
  2144. "Placing a list of commands between curly braces causes the list to be "
  2145. "executed in the current shell context. No subshell is created. The "
  2146. "semicolon (or newline) following @var{list} is required."
  2147. msgstr ""
  2148. #. type: Plain text
  2149. #: ./bashref.texi:1176
  2150. msgid ""
  2151. "In addition to the creation of a subshell, there is a subtle difference "
  2152. "between these two constructs due to historical reasons. The braces are "
  2153. "@code{reserved words}, so they must be separated from the @var{list} by "
  2154. "@code{blank}s or other shell metacharacters. The parentheses are "
  2155. "@code{operators}, and are recognized as separate tokens by the shell even if "
  2156. "they are not separated from the @var{list} by whitespace."
  2157. msgstr ""
  2158. #. type: Plain text
  2159. #: ./bashref.texi:1179
  2160. msgid ""
  2161. "The exit status of both of these constructs is the exit status of "
  2162. "@var{list}."
  2163. msgstr ""
  2164. #. type: cindex
  2165. #: ./bashref.texi:1182
  2166. #, no-wrap
  2167. msgid "coprocess"
  2168. msgstr ""
  2169. #. type: Plain text
  2170. #: ./bashref.texi:1189
  2171. msgid ""
  2172. "A @code{coprocess} is a shell command preceded by the @code{coproc} reserved "
  2173. "word. A coprocess is executed asynchronously in a subshell, as if the "
  2174. "command had been terminated with the @samp{&} control operator, with a "
  2175. "two-way pipe established between the executing shell and the coprocess."
  2176. msgstr ""
  2177. #. type: Plain text
  2178. #: ./bashref.texi:1191
  2179. msgid "The format for a coprocess is:"
  2180. msgstr ""
  2181. #. type: example
  2182. #: ./bashref.texi:1193
  2183. #, no-wrap
  2184. msgid "coproc [@var{NAME}] @var{command} [@var{redirections}]\n"
  2185. msgstr ""
  2186. #. type: Plain text
  2187. #: ./bashref.texi:1201
  2188. msgid ""
  2189. "This creates a coprocess named @var{NAME}. If @var{NAME} is not supplied, "
  2190. "the default name is @var{COPROC}. @var{NAME} must not be supplied if "
  2191. "@var{command} is a simple command (@pxref{Simple Commands}); otherwise, it "
  2192. "is interpreted as the first word of the simple command."
  2193. msgstr ""
  2194. #. type: Plain text
  2195. #: ./bashref.texi:1217
  2196. msgid ""
  2197. "When the coprocess is executed, the shell creates an array variable "
  2198. "(@pxref{Arrays}) named @env{NAME} in the context of the executing shell. "
  2199. "The standard output of @var{command} is connected via a pipe to a file "
  2200. "descriptor in the executing shell, and that file descriptor is assigned to "
  2201. "@env{NAME}[0]. The standard input of @var{command} is connected via a pipe "
  2202. "to a file descriptor in the executing shell, and that file descriptor is "
  2203. "assigned to @env{NAME}[1]. This pipe is established before any redirections "
  2204. "specified by the command (@pxref{Redirections}). The file descriptors can "
  2205. "be utilized as arguments to shell commands and redirections using standard "
  2206. "word expansions. Other than those created to execute command and process "
  2207. "substitutions, the file descriptors are not available in subshells."
  2208. msgstr ""
  2209. #. type: Plain text
  2210. #: ./bashref.texi:1222
  2211. msgid ""
  2212. "The process ID of the shell spawned to execute the coprocess is available as "
  2213. "the value of the variable @env{NAME}_PID. The @code{wait} builtin command "
  2214. "may be used to wait for the coprocess to terminate."
  2215. msgstr ""
  2216. #. type: Plain text
  2217. #: ./bashref.texi:1226
  2218. msgid ""
  2219. "Since the coprocess is created as an asynchronous command, the @code{coproc} "
  2220. "command always returns success. The return status of a coprocess is the "
  2221. "exit status of @var{command}."
  2222. msgstr ""
  2223. #. type: Plain text
  2224. #: ./bashref.texi:1232
  2225. msgid ""
  2226. "There are ways to run commands in parallel that are not built into Bash. "
  2227. "GNU Parallel is a tool to do just that."
  2228. msgstr ""
  2229. #. type: Plain text
  2230. #: ./bashref.texi:1240
  2231. msgid ""
  2232. "GNU Parallel, as its name suggests, can be used to build and run commands in "
  2233. "parallel. You may run the same command with different arguments, whether "
  2234. "they are filenames, usernames, hostnames, or lines read from files. GNU "
  2235. "Parallel provides shorthand references to many of the most common operations "
  2236. "(input lines, various portions of the input line, different ways to specify "
  2237. "the input source, and so on). Parallel can replace @code{xargs} or feed "
  2238. "commands from its input sources to several different instances of Bash."
  2239. msgstr ""
  2240. #. type: Plain text
  2241. #: ./bashref.texi:1243
  2242. msgid ""
  2243. "For a complete description, refer to the GNU Parallel documentation. A few "
  2244. "examples should provide a brief introduction to its use."
  2245. msgstr ""
  2246. #. type: Plain text
  2247. #: ./bashref.texi:1246
  2248. msgid ""
  2249. "For example, it is easy to replace @code{xargs} to gzip all html files in "
  2250. "the current directory and its subdirectories:"
  2251. msgstr ""
  2252. #. type: example
  2253. #: ./bashref.texi:1248
  2254. #, no-wrap
  2255. msgid "find . -type f -name '*.html' -print | parallel gzip\n"
  2256. msgstr ""
  2257. #. type: Plain text
  2258. #: ./bashref.texi:1252
  2259. msgid ""
  2260. "If you need to protect special characters such as newlines in file names, "
  2261. "use find's @option{-print0} option and parallel's @option{-0} option."
  2262. msgstr ""
  2263. #. type: Plain text
  2264. #: ./bashref.texi:1255
  2265. msgid ""
  2266. "You can use Parallel to move files from the current directory when the "
  2267. "number of files is too large to process with one @code{mv} invocation:"
  2268. msgstr ""
  2269. #. type: example
  2270. #: ./bashref.texi:1257
  2271. #, no-wrap
  2272. msgid "ls | parallel mv @{@} destdir\n"
  2273. msgstr ""
  2274. #. type: Plain text
  2275. #: ./bashref.texi:1263
  2276. msgid ""
  2277. "As you can see, the @{@} is replaced with each line read from standard "
  2278. "input. While using @code{ls} will work in most instances, it is not "
  2279. "sufficient to deal with all filenames. If you need to accommodate special "
  2280. "characters in filenames, you can use"
  2281. msgstr ""
  2282. #. type: example
  2283. #: ./bashref.texi:1266
  2284. #, no-wrap
  2285. msgid "find . -depth 1 \\! -name '.*' -print0 | parallel -0 mv @{@} destdir\n"
  2286. msgstr ""
  2287. #. type: Plain text
  2288. #: ./bashref.texi:1270
  2289. msgid "as alluded to above."
  2290. msgstr ""
  2291. #. type: Plain text
  2292. #: ./bashref.texi:1274
  2293. msgid ""
  2294. "This will run as many @code{mv} commands as there are files in the current "
  2295. "directory. You can emulate a parallel @code{xargs} by adding the "
  2296. "@option{-X} option:"
  2297. msgstr ""
  2298. #. type: example
  2299. #: ./bashref.texi:1276
  2300. #, no-wrap
  2301. msgid "find . -depth 1 \\! -name '.*' -print0 | parallel -0 -X mv @{@} destdir\n"
  2302. msgstr ""
  2303. #. type: Plain text
  2304. #: ./bashref.texi:1280
  2305. msgid ""
  2306. "GNU Parallel can replace certain common idioms that operate on lines read "
  2307. "from a file (in this case, filenames listed one per line):"
  2308. msgstr ""
  2309. #. type: example
  2310. #: ./bashref.texi:1285
  2311. #, no-wrap
  2312. msgid ""
  2313. "\twhile IFS= read -r x; do\n"
  2314. "\t\tdo-something1 \"$x\" \"config-$x\"\n"
  2315. "\t\tdo-something2 < \"$x\"\n"
  2316. "\tdone < file | process-output\n"
  2317. msgstr ""
  2318. #. type: Plain text
  2319. #: ./bashref.texi:1289
  2320. msgid "with a more compact syntax reminiscent of lambdas:"
  2321. msgstr ""
  2322. #. type: example
  2323. #: ./bashref.texi:1292
  2324. #, no-wrap
  2325. msgid ""
  2326. "cat list | parallel \"do-something1 @{@} config-@{@} ; do-something2 < "
  2327. "@{@}\" |\n"
  2328. " process-output\n"
  2329. msgstr ""
  2330. #. type: Plain text
  2331. #: ./bashref.texi:1296
  2332. msgid ""
  2333. "Parallel provides a built-in mechanism to remove filename extensions, which "
  2334. "lends itself to batch file transformations or renaming:"
  2335. msgstr ""
  2336. #. type: example
  2337. #: ./bashref.texi:1298
  2338. #, no-wrap
  2339. msgid "ls *.gz | parallel -j+0 \"zcat @{@} | bzip2 >@{.@}.bz2 && rm @{@}\"\n"
  2340. msgstr ""
  2341. #. type: Plain text
  2342. #: ./bashref.texi:1306
  2343. msgid ""
  2344. "This will recompress all files in the current directory with names ending in "
  2345. ".gz using bzip2, running one job per CPU (-j+0) in parallel. (We use "
  2346. "@code{ls} for brevity here; using @code{find} as above is more robust in the "
  2347. "face of filenames containing unexpected characters.) Parallel can take "
  2348. "arguments from the command line; the above can also be written as"
  2349. msgstr ""
  2350. #. type: example
  2351. #: ./bashref.texi:1309
  2352. #, no-wrap
  2353. msgid "parallel \"zcat @{@} | bzip2 >@{.@}.bz2 && rm @{@}\" ::: *.gz\n"
  2354. msgstr ""
  2355. #. type: Plain text
  2356. #: ./bashref.texi:1313
  2357. msgid ""
  2358. "If a command generates output, you may want to preserve the input order in "
  2359. "the output. For instance, the following command"
  2360. msgstr ""
  2361. #. type: example
  2362. #: ./bashref.texi:1319
  2363. #, no-wrap
  2364. msgid ""
  2365. "@{\n"
  2366. " echo foss.org.my ;\n"
  2367. " echo debian.org ;\n"
  2368. " echo freenetproject.org ;\n"
  2369. "@} | parallel traceroute\n"
  2370. msgstr ""
  2371. #. type: Plain text
  2372. #: ./bashref.texi:1323
  2373. msgid ""
  2374. "will display as output the traceroute invocation that finishes first. "
  2375. "Adding the @option{-k} option"
  2376. msgstr ""
  2377. #. type: example
  2378. #: ./bashref.texi:1329
  2379. #, no-wrap
  2380. msgid ""
  2381. "@{\n"
  2382. " echo foss.org.my ;\n"
  2383. " echo debian.org ;\n"
  2384. " echo freenetproject.org ;\n"
  2385. "@} | parallel -k traceroute\n"
  2386. msgstr ""
  2387. #. type: Plain text
  2388. #: ./bashref.texi:1332
  2389. msgid ""
  2390. "will ensure that the output of @code{traceroute foss.org.my} is displayed "
  2391. "first."
  2392. msgstr ""
  2393. #. type: Plain text
  2394. #: ./bashref.texi:1339
  2395. msgid ""
  2396. "Finally, Parallel can be used to run a sequence of shell commands in "
  2397. "parallel, similar to @samp{cat file | bash}. It is not uncommon to take a "
  2398. "list of filenames, create a series of shell commands to operate on them, and "
  2399. "feed that list of commands to a shell. Parallel can speed this up. "
  2400. "Assuming that @file{file} contains a list of shell commands, one per line,"
  2401. msgstr ""
  2402. #. type: example
  2403. #: ./bashref.texi:1342
  2404. #, no-wrap
  2405. msgid "parallel -j 10 < file\n"
  2406. msgstr ""
  2407. #. type: Plain text
  2408. #: ./bashref.texi:1347
  2409. msgid ""
  2410. "will evaluate the commands using the shell (since no explicit command is "
  2411. "supplied as an argument), in blocks of ten shell jobs at a time."
  2412. msgstr ""
  2413. #. type: cindex
  2414. #: ./bashref.texi:1350
  2415. #, no-wrap
  2416. msgid "shell function"
  2417. msgstr ""
  2418. #. type: cindex
  2419. #: ./bashref.texi:1351
  2420. #, no-wrap
  2421. msgid "functions, shell"
  2422. msgstr ""
  2423. #. type: Plain text
  2424. #: ./bashref.texi:1360
  2425. msgid ""
  2426. "Shell functions are a way to group commands for later execution using a "
  2427. "single name for the group. They are executed just like a \"regular\" "
  2428. "command. When the name of a shell function is used as a simple command "
  2429. "name, the list of commands associated with that function name is executed. "
  2430. "Shell functions are executed in the current shell context; no new process is "
  2431. "created to interpret them."
  2432. msgstr ""
  2433. #. type: Plain text
  2434. #: ./bashref.texi:1362
  2435. msgid "Functions are declared using this syntax:"
  2436. msgstr ""
  2437. #. type: rwindex
  2438. #: ./bashref.texi:1362
  2439. #, no-wrap
  2440. msgid "function"
  2441. msgstr ""
  2442. #. type: example
  2443. #: ./bashref.texi:1365
  2444. #, no-wrap
  2445. msgid "@var{name} () @var{compound-command} [ @var{redirections} ]\n"
  2446. msgstr ""
  2447. #. type: Plain text
  2448. #: ./bashref.texi:1368 ./bashref.texi:1876 ./bashref.texi:2352 ./bashref.texi:2415
  2449. msgid "or"
  2450. msgstr ""
  2451. #. type: example
  2452. #: ./bashref.texi:1371
  2453. #, no-wrap
  2454. msgid "function @var{name} [()] @var{compound-command} [ @var{redirections} ]\n"
  2455. msgstr ""
  2456. #. type: Plain text
  2457. #: ./bashref.texi:1390
  2458. msgid ""
  2459. "This defines a shell function named @var{name}. The reserved word "
  2460. "@code{function} is optional. If the @code{function} reserved word is "
  2461. "supplied, the parentheses are optional. The @var{body} of the function is "
  2462. "the compound command @var{compound-command} (@pxref{Compound Commands}). "
  2463. "That command is usually a @var{list} enclosed between @{ and @}, but may be "
  2464. "any compound command listed above, with one exception: If the "
  2465. "@code{function} reserved word is used, but the parentheses are not supplied, "
  2466. "the braces are required. @var{compound-command} is executed whenever "
  2467. "@var{name} is specified as the name of a command. When the shell is in "
  2468. "@sc{posix} mode (@pxref{Bash POSIX Mode}), @var{name} may not be the same as "
  2469. "one of the special builtins (@pxref{Special Builtins}). Any redirections "
  2470. "(@pxref{Redirections}) associated with the shell function are performed when "
  2471. "the function is executed."
  2472. msgstr ""
  2473. #. type: Plain text
  2474. #: ./bashref.texi:1393
  2475. msgid ""
  2476. "A function definition may be deleted using the @option{-f} option to the "
  2477. "@code{unset} builtin (@pxref{Bourne Shell Builtins})."
  2478. msgstr ""
  2479. #. type: Plain text
  2480. #: ./bashref.texi:1398
  2481. msgid ""
  2482. "The exit status of a function definition is zero unless a syntax error "
  2483. "occurs or a readonly function with the same name already exists. When "
  2484. "executed, the exit status of a function is the exit status of the last "
  2485. "command executed in the body."
  2486. msgstr ""
  2487. #. type: Plain text
  2488. #: ./bashref.texi:1407
  2489. msgid ""
  2490. "Note that for historical reasons, in the most common usage the curly braces "
  2491. "that surround the body of the function must be separated from the body by "
  2492. "@code{blank}s or newlines. This is because the braces are reserved words "
  2493. "and are only recognized as such when they are separated from the command "
  2494. "list by whitespace or another shell metacharacter. Also, when using the "
  2495. "braces, the @var{list} must be terminated by a semicolon, a @samp{&}, or a "
  2496. "newline."
  2497. msgstr ""
  2498. #. type: Plain text
  2499. #: ./bashref.texi:1416
  2500. msgid ""
  2501. "When a function is executed, the arguments to the function become the "
  2502. "positional parameters during its execution (@pxref{Positional Parameters}). "
  2503. "The special parameter @samp{#} that expands to the number of positional "
  2504. "parameters is updated to reflect the change. Special parameter @code{0} is "
  2505. "unchanged. The first element of the @env{FUNCNAME} variable is set to the "
  2506. "name of the function while the function is executing."
  2507. msgstr ""
  2508. #. type: Plain text
  2509. #: ./bashref.texi:1430
  2510. msgid ""
  2511. "All other aspects of the shell execution environment are identical between a "
  2512. "function and its caller with these exceptions: the @env{DEBUG} and "
  2513. "@env{RETURN} traps are not inherited unless the function has been given the "
  2514. "@code{trace} attribute using the @code{declare} builtin or the @code{-o "
  2515. "functrace} option has been enabled with the @code{set} builtin, (in which "
  2516. "case all functions inherit the @env{DEBUG} and @env{RETURN} traps), and the "
  2517. "@env{ERR} trap is not inherited unless the @code{-o errtrace} shell option "
  2518. "has been enabled. @xref{Bourne Shell Builtins}, for the description of the "
  2519. "@code{trap} builtin."
  2520. msgstr ""
  2521. #. type: Plain text
  2522. #: ./bashref.texi:1435
  2523. msgid ""
  2524. "The @env{FUNCNEST} variable, if set to a numeric value greater than 0, "
  2525. "defines a maximum function nesting level. Function invocations that exceed "
  2526. "the limit cause the entire command to abort."
  2527. msgstr ""
  2528. #. type: Plain text
  2529. #: ./bashref.texi:1449
  2530. msgid ""
  2531. "If the builtin command @code{return} is executed in a function, the function "
  2532. "completes and execution resumes with the next command after the function "
  2533. "call. Any command associated with the @code{RETURN} trap is executed before "
  2534. "execution resumes. When a function completes, the values of the positional "
  2535. "parameters and the special parameter @samp{#} are restored to the values "
  2536. "they had prior to the function's execution. If a numeric argument is given "
  2537. "to @code{return}, that is the function's return status; otherwise the "
  2538. "function's return status is the exit status of the last command executed "
  2539. "before the @code{return}."
  2540. msgstr ""
  2541. #. type: Plain text
  2542. #: ./bashref.texi:1454
  2543. msgid ""
  2544. "Variables local to the function may be declared with the @code{local} "
  2545. "builtin. These variables are visible only to the function and the commands "
  2546. "it invokes. This is particularly important when a shell function calls "
  2547. "other functions."
  2548. msgstr ""
  2549. #. type: Plain text
  2550. #: ./bashref.texi:1460
  2551. msgid ""
  2552. "Local variables \"shadow\" variables with the same name declared at previous "
  2553. "scopes. For instance, a local variable declared in a function hides a "
  2554. "global variable of the same name: references and assignments refer to the "
  2555. "local variable, leaving the global variable unmodified. When the function "
  2556. "returns, the global variable is once again visible."
  2557. msgstr ""
  2558. #. type: Plain text
  2559. #: ./bashref.texi:1472
  2560. msgid ""
  2561. "The shell uses @var{dynamic scoping} to control a variable's visibility "
  2562. "within functions. With dynamic scoping, visible variables and their values "
  2563. "are a result of the sequence of function calls that caused execution to "
  2564. "reach the current function. The value of a variable that a function sees "
  2565. "depends on its value within its caller, if any, whether that caller is the "
  2566. "\"global\" scope or another shell function. This is also the value that a "
  2567. "local variable declaration \"shadows\", and the value that is restored when "
  2568. "the function returns."
  2569. msgstr ""
  2570. #. type: Plain text
  2571. #: ./bashref.texi:1478
  2572. msgid ""
  2573. "For example, if a variable @var{var} is declared as local in function "
  2574. "@var{func1}, and @var{func1} calls another function @var{func2}, references "
  2575. "to @var{var} made from within @var{func2} will resolve to the local variable "
  2576. "@var{var} from @var{func1}, shadowing any global variable named @var{var}."
  2577. msgstr ""
  2578. #. type: Plain text
  2579. #: ./bashref.texi:1481
  2580. msgid ""
  2581. "The following script demonstrates this behavior. When executed, the script "
  2582. "displays"
  2583. msgstr ""
  2584. #. type: example
  2585. #: ./bashref.texi:1484
  2586. #, no-wrap
  2587. msgid "In func2, var = func1 local\n"
  2588. msgstr ""
  2589. #. type: example
  2590. #: ./bashref.texi:1492
  2591. #, no-wrap
  2592. msgid ""
  2593. "func1()\n"
  2594. "@{\n"
  2595. " local var='func1 local'\n"
  2596. " func2\n"
  2597. "@}\n"
  2598. "\n"
  2599. msgstr ""
  2600. #. type: example
  2601. #: ./bashref.texi:1497
  2602. #, no-wrap
  2603. msgid ""
  2604. "func2()\n"
  2605. "@{\n"
  2606. " echo \"In func2, var = $var\"\n"
  2607. "@}\n"
  2608. "\n"
  2609. msgstr ""
  2610. #. type: example
  2611. #: ./bashref.texi:1500
  2612. #, no-wrap
  2613. msgid ""
  2614. "var=global\n"
  2615. "func1\n"
  2616. msgstr ""
  2617. #. type: Plain text
  2618. #: ./bashref.texi:1512
  2619. msgid ""
  2620. "The @code{unset} builtin also acts using the same dynamic scope: if a "
  2621. "variable is local to the current scope, @code{unset} will unset it; "
  2622. "otherwise the unset will refer to the variable found in any calling scope as "
  2623. "described above. If a variable at the current local scope is unset, it will "
  2624. "remain so until it is reset in that scope or until the function returns. "
  2625. "Once the function returns, any instance of the variable at a previous scope "
  2626. "will become visible. If the unset acts on a variable at a previous scope, "
  2627. "any instance of a variable with that name that had been shadowed will become "
  2628. "visible."
  2629. msgstr ""
  2630. #. type: Plain text
  2631. #: ./bashref.texi:1524
  2632. msgid ""
  2633. "Function names and definitions may be listed with the @option{-f} option to "
  2634. "the @code{declare} (@code{typeset}) builtin command (@pxref{Bash "
  2635. "Builtins}). The @option{-F} option to @code{declare} or @code{typeset} will "
  2636. "list the function names only (and optionally the source file and line "
  2637. "number, if the @code{extdebug} shell option is enabled). Functions may be "
  2638. "exported so that subshells automatically have them defined with the "
  2639. "@option{-f} option to the @code{export} builtin (@pxref{Bourne Shell "
  2640. "Builtins})."
  2641. msgstr ""
  2642. #. type: Plain text
  2643. #: ./bashref.texi:1529
  2644. msgid ""
  2645. "Functions may be recursive. The @code{FUNCNEST} variable may be used to "
  2646. "limit the depth of the function call stack and restrict the number of "
  2647. "function invocations. By default, no limit is placed on the number of "
  2648. "recursive calls."
  2649. msgstr ""
  2650. #. type: cindex
  2651. #: ./bashref.texi:1532
  2652. #, no-wrap
  2653. msgid "parameters"
  2654. msgstr ""
  2655. #. type: cindex
  2656. #: ./bashref.texi:1533
  2657. #, no-wrap
  2658. msgid "variable, shell"
  2659. msgstr ""
  2660. #. type: cindex
  2661. #: ./bashref.texi:1534
  2662. #, no-wrap
  2663. msgid "shell variable"
  2664. msgstr ""
  2665. #. type: subsection
  2666. #: ./bashref.texi:1539 ./bashref.texi:1631 ./bashref.texi:1632
  2667. #, no-wrap
  2668. msgid "Positional Parameters"
  2669. msgstr ""
  2670. #. type: menuentry
  2671. #: ./bashref.texi:1539
  2672. msgid "The shell's command-line arguments."
  2673. msgstr ""
  2674. #. type: subsection
  2675. #: ./bashref.texi:1539 ./bashref.texi:1651 ./bashref.texi:1652
  2676. #, no-wrap
  2677. msgid "Special Parameters"
  2678. msgstr ""
  2679. #. type: menuentry
  2680. #: ./bashref.texi:1539
  2681. msgid "Parameters denoted by special characters."
  2682. msgstr ""
  2683. #. type: Plain text
  2684. #: ./bashref.texi:1548
  2685. msgid ""
  2686. "A @var{parameter} is an entity that stores values. It can be a @code{name}, "
  2687. "a number, or one of the special characters listed below. A @var{variable} "
  2688. "is a parameter denoted by a @code{name}. A variable has a @var{value} and "
  2689. "zero or more @var{attributes}. Attributes are assigned using the "
  2690. "@code{declare} builtin command (see the description of the @code{declare} "
  2691. "builtin in @ref{Bash Builtins})."
  2692. msgstr ""
  2693. #. type: Plain text
  2694. #: ./bashref.texi:1552
  2695. msgid ""
  2696. "A parameter is set if it has been assigned a value. The null string is a "
  2697. "valid value. Once a variable is set, it may be unset only by using the "
  2698. "@code{unset} builtin command."
  2699. msgstr ""
  2700. #. type: Plain text
  2701. #: ./bashref.texi:1554
  2702. msgid "A variable may be assigned to by a statement of the form"
  2703. msgstr ""
  2704. #. type: example
  2705. #: ./bashref.texi:1556
  2706. #, no-wrap
  2707. msgid "@var{name}=[@var{value}]\n"
  2708. msgstr ""
  2709. #. type: Plain text
  2710. #: ./bashref.texi:1576
  2711. msgid ""
  2712. "If @var{value} is not given, the variable is assigned the null string. All "
  2713. "@var{value}s undergo tilde expansion, parameter and variable expansion, "
  2714. "command substitution, arithmetic expansion, and quote removal (detailed "
  2715. "below). If the variable has its @code{integer} attribute set, then "
  2716. "@var{value} is evaluated as an arithmetic expression even if the "
  2717. "@code{$((@dots{}))} expansion is not used (@pxref{Arithmetic Expansion}). "
  2718. "Word splitting is not performed, with the exception of @code{\"$@@\"} as "
  2719. "explained below. Filename expansion is not performed. Assignment "
  2720. "statements may also appear as arguments to the @code{alias}, @code{declare}, "
  2721. "@code{typeset}, @code{export}, @code{readonly}, and @code{local} builtin "
  2722. "commands (@var{declaration} commands). When in @sc{posix} mode (@pxref{Bash "
  2723. "POSIX Mode}), these builtins may appear in a command after one or more "
  2724. "instances of the @code{command} builtin and retain these assignment "
  2725. "statement properties."
  2726. msgstr ""
  2727. #. type: Plain text
  2728. #: ./bashref.texi:1594
  2729. msgid ""
  2730. "In the context where an assignment statement is assigning a value to a shell "
  2731. "variable or array index (@pxref{Arrays}), the @samp{+=} operator can be used "
  2732. "to append to or add to the variable's previous value. This includes "
  2733. "arguments to builtin commands such as @code{declare} that accept assignment "
  2734. "statements (@var{declaration} commands). When @samp{+=} is applied to a "
  2735. "variable for which the @var{integer} attribute has been set, @var{value} is "
  2736. "evaluated as an arithmetic expression and added to the variable's current "
  2737. "value, which is also evaluated. When @samp{+=} is applied to an array "
  2738. "variable using compound assignment (@pxref{Arrays}), the variable's value is "
  2739. "not unset (as it is when using @samp{=}), and new values are appended to the "
  2740. "array beginning at one greater than the array's maximum index (for indexed "
  2741. "arrays), or added as additional key-value pairs in an associative array. "
  2742. "When applied to a string-valued variable, @var{value} is expanded and "
  2743. "appended to the variable's value."
  2744. msgstr ""
  2745. #. type: Plain text
  2746. #: ./bashref.texi:1609
  2747. msgid ""
  2748. "A variable can be assigned the @var{nameref} attribute using the @option{-n} "
  2749. "option to the @code{declare} or @code{local} builtin commands (@pxref{Bash "
  2750. "Builtins}) to create a @var{nameref}, or a reference to another variable. "
  2751. "This allows variables to be manipulated indirectly. Whenever the nameref "
  2752. "variable is referenced, assigned to, unset, or has its attributes modified "
  2753. "(other than using or changing the nameref attribute itself), the operation "
  2754. "is actually performed on the variable specified by the nameref variable's "
  2755. "value. A nameref is commonly used within shell functions to refer to a "
  2756. "variable whose name is passed as an argument to the function. For instance, "
  2757. "if a variable name is passed to a shell function as its first argument, "
  2758. "running"
  2759. msgstr ""
  2760. #. type: example
  2761. #: ./bashref.texi:1611
  2762. #, no-wrap
  2763. msgid "declare -n ref=$1\n"
  2764. msgstr ""
  2765. #. type: Plain text
  2766. #: ./bashref.texi:1618
  2767. msgid ""
  2768. "inside the function creates a nameref variable @var{ref} whose value is the "
  2769. "variable name passed as the first argument. References and assignments to "
  2770. "@var{ref}, and changes to its attributes, are treated as references, "
  2771. "assignments, and attribute modifications to the variable whose name was "
  2772. "passed as @code{$1}."
  2773. msgstr ""
  2774. #. type: Plain text
  2775. #: ./bashref.texi:1630
  2776. msgid ""
  2777. "If the control variable in a @code{for} loop has the nameref attribute, the "
  2778. "list of words can be a list of shell variables, and a name reference will be "
  2779. "established for each word in the list, in turn, when the loop is executed. "
  2780. "Array variables cannot be given the nameref attribute. However, nameref "
  2781. "variables can reference array variables and subscripted array variables. "
  2782. "Namerefs can be unset using the @option{-n} option to the @code{unset} "
  2783. "builtin (@pxref{Bourne Shell Builtins}). Otherwise, if @code{unset} is "
  2784. "executed with the name of a nameref variable as an argument, the variable "
  2785. "referenced by the nameref variable will be unset."
  2786. msgstr ""
  2787. #. type: cindex
  2788. #: ./bashref.texi:1633
  2789. #, no-wrap
  2790. msgid "parameters, positional"
  2791. msgstr ""
  2792. #. type: Plain text
  2793. #: ./bashref.texi:1647
  2794. msgid ""
  2795. "A @var{positional parameter} is a parameter denoted by one or more digits, "
  2796. "other than the single digit @code{0}. Positional parameters are assigned "
  2797. "from the shell's arguments when it is invoked, and may be reassigned using "
  2798. "the @code{set} builtin command. Positional parameter @code{N} may be "
  2799. "referenced as @code{$@{N@}}, or as @code{$N} when @code{N} consists of a "
  2800. "single digit. Positional parameters may not be assigned to with assignment "
  2801. "statements. The @code{set} and @code{shift} builtins are used to set and "
  2802. "unset them (@pxref{Shell Builtin Commands}). The positional parameters are "
  2803. "temporarily replaced when a shell function is executed (@pxref{Shell "
  2804. "Functions})."
  2805. msgstr ""
  2806. #. type: Plain text
  2807. #: ./bashref.texi:1650
  2808. msgid ""
  2809. "When a positional parameter consisting of more than a single digit is "
  2810. "expanded, it must be enclosed in braces."
  2811. msgstr ""
  2812. #. type: cindex
  2813. #: ./bashref.texi:1653
  2814. #, no-wrap
  2815. msgid "parameters, special"
  2816. msgstr ""
  2817. #. type: Plain text
  2818. #: ./bashref.texi:1657
  2819. msgid ""
  2820. "The shell treats several parameters specially. These parameters may only be "
  2821. "referenced; assignment to them is not allowed."
  2822. msgstr ""
  2823. #. type: Plain text
  2824. #: ./bashref.texi:1659 ./bashref.texi:5556 ./bashref.texi:5623 ./bashref.texi:8138
  2825. msgid "@vtable @code"
  2826. msgstr ""
  2827. #. type: item
  2828. #: ./bashref.texi:1660 ./bashref.texi:2560
  2829. #, no-wrap
  2830. msgid "*"
  2831. msgstr ""
  2832. #. type: vindex
  2833. #: ./bashref.texi:1661
  2834. #, no-wrap
  2835. msgid "$*"
  2836. msgstr ""
  2837. #. type: Plain text
  2838. #: ./bashref.texi:1676
  2839. msgid ""
  2840. "($*) Expands to the positional parameters, starting from one. When the "
  2841. "expansion is not within double quotes, each positional parameter expands to "
  2842. "a separate word. In contexts where it is performed, those words are subject "
  2843. "to further word splitting and pathname expansion. When the expansion occurs "
  2844. "within double quotes, it expands to a single word with the value of each "
  2845. "parameter separated by the first character of the @env{IFS} special "
  2846. "variable. That is, @code{\"$*\"} is equivalent to "
  2847. "@code{\"$1@var{c}$2@var{c}@dots{}\"}, where @var{c} is the first character "
  2848. "of the value of the @code{IFS} variable. If @env{IFS} is unset, the "
  2849. "parameters are separated by spaces. If @env{IFS} is null, the parameters "
  2850. "are joined without intervening separators."
  2851. msgstr ""
  2852. #. type: item
  2853. #: ./bashref.texi:1677
  2854. #, no-wrap
  2855. msgid "@@"
  2856. msgstr ""
  2857. #. type: vindex
  2858. #: ./bashref.texi:1678
  2859. #, no-wrap
  2860. msgid "$@@"
  2861. msgstr ""
  2862. #. type: Plain text
  2863. #: ./bashref.texi:1698
  2864. msgid ""
  2865. "($@@) Expands to the positional parameters, starting from one. In contexts "
  2866. "where word splitting is performed, this expands each positional parameter to "
  2867. "a separate word; if not within double quotes, these words are subject to "
  2868. "word splitting. In contexts where word splitting is not performed, this "
  2869. "expands to a single word with each positional parameter separated by a "
  2870. "space. When the expansion occurs within double quotes, and word splitting "
  2871. "is performed, each parameter expands to a separate word. That is, "
  2872. "@code{\"$@@\"} is equivalent to @code{\"$1\" \"$2\" @dots{}}. If the "
  2873. "double-quoted expansion occurs within a word, the expansion of the first "
  2874. "parameter is joined with the beginning part of the original word, and the "
  2875. "expansion of the last parameter is joined with the last part of the original "
  2876. "word. When there are no positional parameters, @code{\"$@@\"} and "
  2877. "@code{$@@} expand to nothing (i.e., they are removed)."
  2878. msgstr ""
  2879. #. type: item
  2880. #: ./bashref.texi:1699
  2881. #, no-wrap
  2882. msgid "#"
  2883. msgstr ""
  2884. #. type: vindex
  2885. #: ./bashref.texi:1700
  2886. #, no-wrap
  2887. msgid "$#"
  2888. msgstr ""
  2889. #. type: Plain text
  2890. #: ./bashref.texi:1702
  2891. msgid "($#) Expands to the number of positional parameters in decimal."
  2892. msgstr ""
  2893. #. type: item
  2894. #: ./bashref.texi:1703 ./bashref.texi:2568
  2895. #, no-wrap
  2896. msgid "?"
  2897. msgstr ""
  2898. #. type: vindex
  2899. #: ./bashref.texi:1704
  2900. #, no-wrap
  2901. msgid "$?"
  2902. msgstr ""
  2903. #. type: Plain text
  2904. #: ./bashref.texi:1707
  2905. msgid ""
  2906. "($?) Expands to the exit status of the most recently executed foreground "
  2907. "pipeline."
  2908. msgstr ""
  2909. #. type: item
  2910. #: ./bashref.texi:1708 ./bashref.texi:5065
  2911. #, no-wrap
  2912. msgid "-"
  2913. msgstr ""
  2914. #. type: vindex
  2915. #: ./bashref.texi:1709
  2916. #, no-wrap
  2917. msgid "$-"
  2918. msgstr ""
  2919. #. type: Plain text
  2920. #: ./bashref.texi:1714
  2921. msgid ""
  2922. "($-, a hyphen.) Expands to the current option flags as specified upon "
  2923. "invocation, by the @code{set} builtin command, or those set by the shell "
  2924. "itself (such as the @option{-i} option)."
  2925. msgstr ""
  2926. #. type: item
  2927. #: ./bashref.texi:1715
  2928. #, no-wrap
  2929. msgid "$"
  2930. msgstr ""
  2931. #. type: vindex
  2932. #: ./bashref.texi:1716
  2933. #, no-wrap
  2934. msgid "$$"
  2935. msgstr ""
  2936. #. type: Plain text
  2937. #: ./bashref.texi:1719
  2938. msgid ""
  2939. "($$) Expands to the process @sc{id} of the shell. In a @code{()} subshell, "
  2940. "it expands to the process @sc{id} of the invoking shell, not the subshell."
  2941. msgstr ""
  2942. #. type: vindex
  2943. #: ./bashref.texi:1721
  2944. #, no-wrap
  2945. msgid "$!"
  2946. msgstr ""
  2947. #. type: Plain text
  2948. #: ./bashref.texi:1725
  2949. msgid ""
  2950. "($!) Expands to the process @sc{id} of the job most recently placed into the "
  2951. "background, whether executed as an asynchronous command or using the "
  2952. "@code{bg} builtin (@pxref{Job Control Builtins})."
  2953. msgstr ""
  2954. #. type: item
  2955. #: ./bashref.texi:1726
  2956. #, no-wrap
  2957. msgid "0"
  2958. msgstr ""
  2959. #. type: vindex
  2960. #: ./bashref.texi:1727
  2961. #, no-wrap
  2962. msgid "$0"
  2963. msgstr ""
  2964. #. type: Plain text
  2965. #: ./bashref.texi:1735
  2966. msgid ""
  2967. "($0) Expands to the name of the shell or shell script. This is set at shell "
  2968. "initialization. If Bash is invoked with a file of commands (@pxref{Shell "
  2969. "Scripts}), @code{$0} is set to the name of that file. If Bash is started "
  2970. "with the @option{-c} option (@pxref{Invoking Bash}), then @code{$0} is set "
  2971. "to the first argument after the string to be executed, if one is present. "
  2972. "Otherwise, it is set to the filename used to invoke Bash, as given by "
  2973. "argument zero."
  2974. msgstr ""
  2975. #. type: item
  2976. #: ./bashref.texi:1736
  2977. #, no-wrap
  2978. msgid "_"
  2979. msgstr ""
  2980. #. type: vindex
  2981. #: ./bashref.texi:1737
  2982. #, no-wrap
  2983. msgid "$_"
  2984. msgstr ""
  2985. #. type: Plain text
  2986. #: ./bashref.texi:1747
  2987. msgid ""
  2988. "($_, an underscore.) At shell startup, set to the absolute pathname used to "
  2989. "invoke the shell or shell script being executed as passed in the environment "
  2990. "or argument list. Subsequently, expands to the last argument to the "
  2991. "previous simple command executed in the foreground, after expansion. Also "
  2992. "set to the full pathname used to invoke each command executed and placed in "
  2993. "the environment exported to that command. When checking mail, this "
  2994. "parameter holds the name of the mail file."
  2995. msgstr ""
  2996. #. type: cindex
  2997. #: ./bashref.texi:1751
  2998. #, no-wrap
  2999. msgid "expansion"
  3000. msgstr ""
  3001. #. type: Plain text
  3002. #: ./bashref.texi:1755
  3003. msgid ""
  3004. "Expansion is performed on the command line after it has been split into "
  3005. "@code{token}s. There are seven kinds of expansion performed:"
  3006. msgstr ""
  3007. #. type: cindex
  3008. #: ./bashref.texi:1757 ./bashref.texi:1811
  3009. #, no-wrap
  3010. msgid "brace expansion"
  3011. msgstr ""
  3012. #. type: cindex
  3013. #: ./bashref.texi:1758 ./bashref.texi:1882
  3014. #, no-wrap
  3015. msgid "tilde expansion"
  3016. msgstr ""
  3017. #. type: item
  3018. #: ./bashref.texi:1759
  3019. #, no-wrap
  3020. msgid "parameter and variable expansion"
  3021. msgstr ""
  3022. #. type: cindex
  3023. #: ./bashref.texi:1760 ./bashref.texi:2342
  3024. #, no-wrap
  3025. msgid "command substitution"
  3026. msgstr ""
  3027. #. type: cindex
  3028. #: ./bashref.texi:1761 ./bashref.texi:2382
  3029. #, no-wrap
  3030. msgid "arithmetic expansion"
  3031. msgstr ""
  3032. #. type: cindex
  3033. #: ./bashref.texi:1762 ./bashref.texi:2440
  3034. #, no-wrap
  3035. msgid "word splitting"
  3036. msgstr ""
  3037. #. type: cindex
  3038. #: ./bashref.texi:1763 ./bashref.texi:2489
  3039. #, no-wrap
  3040. msgid "filename expansion"
  3041. msgstr ""
  3042. #. type: subsection
  3043. #: ./bashref.texi:1779 ./bashref.texi:1809 ./bashref.texi:1810
  3044. #, no-wrap
  3045. msgid "Brace Expansion"
  3046. msgstr ""
  3047. #. type: menuentry
  3048. #: ./bashref.texi:1779
  3049. msgid "Expansion of expressions within braces."
  3050. msgstr ""
  3051. #. type: subsection
  3052. #: ./bashref.texi:1779 ./bashref.texi:1880 ./bashref.texi:1881
  3053. #, no-wrap
  3054. msgid "Tilde Expansion"
  3055. msgstr ""
  3056. #. type: menuentry
  3057. #: ./bashref.texi:1779
  3058. msgid "Expansion of the ~ character."
  3059. msgstr ""
  3060. #. type: subsection
  3061. #: ./bashref.texi:1779 ./bashref.texi:1956 ./bashref.texi:1957
  3062. #, no-wrap
  3063. msgid "Shell Parameter Expansion"
  3064. msgstr ""
  3065. #. type: menuentry
  3066. #: ./bashref.texi:1779
  3067. msgid "How Bash expands variables to their values."
  3068. msgstr ""
  3069. #. type: subsection
  3070. #: ./bashref.texi:1779 ./bashref.texi:2340 ./bashref.texi:2341
  3071. #, no-wrap
  3072. msgid "Command Substitution"
  3073. msgstr ""
  3074. #. type: menuentry
  3075. #: ./bashref.texi:1779
  3076. msgid "Using the output of a command as an argument."
  3077. msgstr ""
  3078. #. type: subsection
  3079. #: ./bashref.texi:1779 ./bashref.texi:2379 ./bashref.texi:2380
  3080. #, no-wrap
  3081. msgid "Arithmetic Expansion"
  3082. msgstr ""
  3083. #. type: menuentry
  3084. #: ./bashref.texi:1779
  3085. msgid "How to use arithmetic in shell expansions."
  3086. msgstr ""
  3087. #. type: subsection
  3088. #: ./bashref.texi:1779 ./bashref.texi:2403 ./bashref.texi:2404
  3089. #, no-wrap
  3090. msgid "Process Substitution"
  3091. msgstr ""
  3092. #. type: menuentry
  3093. #: ./bashref.texi:1779
  3094. msgid "A way to write and read to and from a command."
  3095. msgstr ""
  3096. #. type: subsection
  3097. #: ./bashref.texi:1779 ./bashref.texi:2438 ./bashref.texi:2439
  3098. #, no-wrap
  3099. msgid "Word Splitting"
  3100. msgstr ""
  3101. #. type: menuentry
  3102. #: ./bashref.texi:1779
  3103. msgid "How the results of expansion are split into separate arguments."
  3104. msgstr ""
  3105. #. type: subsection
  3106. #: ./bashref.texi:1779 ./bashref.texi:2482 ./bashref.texi:2483
  3107. #, no-wrap
  3108. msgid "Filename Expansion"
  3109. msgstr ""
  3110. #. type: menuentry
  3111. #: ./bashref.texi:1779
  3112. msgid "A shorthand for specifying filenames matching patterns."
  3113. msgstr ""
  3114. #. type: subsection
  3115. #: ./bashref.texi:1779 ./bashref.texi:2646 ./bashref.texi:2647
  3116. #, no-wrap
  3117. msgid "Quote Removal"
  3118. msgstr ""
  3119. #. type: menuentry
  3120. #: ./bashref.texi:1779
  3121. msgid "How and when quote characters are removed from words."
  3122. msgstr ""
  3123. #. type: Plain text
  3124. #: ./bashref.texi:1787
  3125. msgid ""
  3126. "The order of expansions is: brace expansion; tilde expansion, parameter and "
  3127. "variable expansion, arithmetic expansion, and command substitution (done in "
  3128. "a left-to-right fashion); word splitting; and filename expansion."
  3129. msgstr ""
  3130. #. type: Plain text
  3131. #: ./bashref.texi:1793
  3132. msgid ""
  3133. "On systems that can support it, there is an additional expansion available: "
  3134. "@var{process substitution}. This is performed at the same time as tilde, "
  3135. "parameter, variable, and arithmetic expansion and command substitution."
  3136. msgstr ""
  3137. #. type: Plain text
  3138. #: ./bashref.texi:1797
  3139. msgid ""
  3140. "After these expansions are performed, quote characters present in the "
  3141. "original word are removed unless they have been quoted themselves "
  3142. "(@var{quote removal})."
  3143. msgstr ""
  3144. #. type: Plain text
  3145. #: ./bashref.texi:1805
  3146. msgid ""
  3147. "Only brace expansion, word splitting, and filename expansion can increase "
  3148. "the number of words of the expansion; other expansions expand a single word "
  3149. "to a single word. The only exceptions to this are the expansions of "
  3150. "@code{\"$@@\"} and @code{$*} (@pxref{Special Parameters}), and "
  3151. "@code{\"$@{@var{name}[@@]@}\"} and @code{$@{@var{name}[*]@}} "
  3152. "(@pxref{Arrays})."
  3153. msgstr ""
  3154. #. type: Plain text
  3155. #: ./bashref.texi:1808
  3156. msgid ""
  3157. "After all expansions, @code{quote removal} (@pxref{Quote Removal}) is "
  3158. "performed."
  3159. msgstr ""
  3160. #. type: cindex
  3161. #: ./bashref.texi:1812
  3162. #, no-wrap
  3163. msgid "expansion, brace"
  3164. msgstr ""
  3165. #. type: Plain text
  3166. #: ./bashref.texi:1825
  3167. msgid ""
  3168. "Brace expansion is a mechanism by which arbitrary strings may be generated. "
  3169. "This mechanism is similar to @var{filename expansion} (@pxref{Filename "
  3170. "Expansion}), but the filenames generated need not exist. Patterns to be "
  3171. "brace expanded take the form of an optional @var{preamble}, followed by "
  3172. "either a series of comma-separated strings or a sequence expression between "
  3173. "a pair of braces, followed by an optional @var{postscript}. The preamble is "
  3174. "prefixed to each string contained within the braces, and the postscript is "
  3175. "then appended to each resulting string, expanding left to right."
  3176. msgstr ""
  3177. #. type: Plain text
  3178. #: ./bashref.texi:1830
  3179. msgid ""
  3180. "Brace expansions may be nested. The results of each expanded string are not "
  3181. "sorted; left to right order is preserved. For example,"
  3182. msgstr ""
  3183. #. type: example
  3184. #: ./bashref.texi:1833
  3185. #, no-wrap
  3186. msgid ""
  3187. "bash$ echo a@{d,c,b@}e\n"
  3188. "ade ace abe\n"
  3189. msgstr ""
  3190. #. type: Plain text
  3191. #: ./bashref.texi:1851
  3192. msgid ""
  3193. "A sequence expression takes the form "
  3194. "@code{@{@var{x}..@var{y}[..@var{incr}]@}}, where @var{x} and @var{y} are "
  3195. "either integers or single characters, and @var{incr}, an optional increment, "
  3196. "is an integer. When integers are supplied, the expression expands to each "
  3197. "number between @var{x} and @var{y}, inclusive. Supplied integers may be "
  3198. "prefixed with @samp{0} to force each term to have the same width. When "
  3199. "either @var{x} or @var{y} begins with a zero, the shell attempts to force "
  3200. "all generated terms to contain the same number of digits, zero-padding where "
  3201. "necessary. When characters are supplied, the expression expands to each "
  3202. "character lexicographically between @var{x} and @var{y}, inclusive, using "
  3203. "the default C locale. Note that both @var{x} and @var{y} must be of the "
  3204. "same type. When the increment is supplied, it is used as the difference "
  3205. "between each term. The default increment is 1 or -1 as appropriate."
  3206. msgstr ""
  3207. #. type: Plain text
  3208. #: ./bashref.texi:1857
  3209. msgid ""
  3210. "Brace expansion is performed before any other expansions, and any characters "
  3211. "special to other expansions are preserved in the result. It is strictly "
  3212. "textual. Bash does not apply any syntactic interpretation to the context of "
  3213. "the expansion or the text between the braces."
  3214. msgstr ""
  3215. #. type: Plain text
  3216. #: ./bashref.texi:1862
  3217. msgid ""
  3218. "A correctly-formed brace expansion must contain unquoted opening and closing "
  3219. "braces, and at least one unquoted comma or a valid sequence expression. Any "
  3220. "incorrectly formed brace expansion is left unchanged."
  3221. msgstr ""
  3222. #. type: Plain text
  3223. #: ./bashref.texi:1868
  3224. msgid ""
  3225. "A @{ or @samp{,} may be quoted with a backslash to prevent its being "
  3226. "considered part of a brace expression. To avoid conflicts with parameter "
  3227. "expansion, the string @samp{$@{} is not considered eligible for brace "
  3228. "expansion, and inhibits brace expansion until the closing @samp{@}}.."
  3229. msgstr ""
  3230. #. type: Plain text
  3231. #: ./bashref.texi:1872
  3232. msgid ""
  3233. "This construct is typically used as shorthand when the common prefix of the "
  3234. "strings to be generated is longer than in the above example:"
  3235. msgstr ""
  3236. #. type: example
  3237. #: ./bashref.texi:1874
  3238. #, no-wrap
  3239. msgid "mkdir /usr/local/src/bash/@{old,new,dist,bugs@}\n"
  3240. msgstr ""
  3241. #. type: example
  3242. #: ./bashref.texi:1878
  3243. #, no-wrap
  3244. msgid "chown root /usr/@{ucb/@{ex,edit@},lib/@{ex?.?*,how_ex@}@}\n"
  3245. msgstr ""
  3246. #. type: cindex
  3247. #: ./bashref.texi:1883
  3248. #, no-wrap
  3249. msgid "expansion, tilde"
  3250. msgstr ""
  3251. #. type: Plain text
  3252. #: ./bashref.texi:1897
  3253. msgid ""
  3254. "If a word begins with an unquoted tilde character (@samp{~}), all of the "
  3255. "characters up to the first unquoted slash (or all characters, if there is no "
  3256. "unquoted slash) are considered a @var{tilde-prefix}. If none of the "
  3257. "characters in the tilde-prefix are quoted, the characters in the "
  3258. "tilde-prefix following the tilde are treated as a possible @var{login "
  3259. "name}. If this login name is the null string, the tilde is replaced with "
  3260. "the value of the @env{HOME} shell variable. If @env{HOME} is unset, the "
  3261. "home directory of the user executing the shell is substituted instead. "
  3262. "Otherwise, the tilde-prefix is replaced with the home directory associated "
  3263. "with the specified login name."
  3264. msgstr ""
  3265. #. type: Plain text
  3266. #: ./bashref.texi:1902
  3267. msgid ""
  3268. "If the tilde-prefix is @samp{~+}, the value of the shell variable @env{PWD} "
  3269. "replaces the tilde-prefix. If the tilde-prefix is @samp{~-}, the value of "
  3270. "the shell variable @env{OLDPWD}, if it is set, is substituted."
  3271. msgstr ""
  3272. #. type: Plain text
  3273. #: ./bashref.texi:1911
  3274. msgid ""
  3275. "If the characters following the tilde in the tilde-prefix consist of a "
  3276. "number @var{N}, optionally prefixed by a @samp{+} or a @samp{-}, the "
  3277. "tilde-prefix is replaced with the corresponding element from the directory "
  3278. "stack, as it would be displayed by the @code{dirs} builtin invoked with the "
  3279. "characters following tilde in the tilde-prefix as an argument (@pxref{The "
  3280. "Directory Stack}). If the tilde-prefix, sans the tilde, consists of a "
  3281. "number without a leading @samp{+} or @samp{-}, @samp{+} is assumed."
  3282. msgstr ""
  3283. #. type: Plain text
  3284. #: ./bashref.texi:1914
  3285. msgid ""
  3286. "If the login name is invalid, or the tilde expansion fails, the word is left "
  3287. "unchanged."
  3288. msgstr ""
  3289. #. type: Plain text
  3290. #: ./bashref.texi:1921
  3291. msgid ""
  3292. "Each variable assignment is checked for unquoted tilde-prefixes immediately "
  3293. "following a @samp{:} or the first @samp{=}. In these cases, tilde expansion "
  3294. "is also performed. Consequently, one may use filenames with tildes in "
  3295. "assignments to @env{PATH}, @env{MAILPATH}, and @env{CDPATH}, and the shell "
  3296. "assigns the expanded value."
  3297. msgstr ""
  3298. #. type: Plain text
  3299. #: ./bashref.texi:1923
  3300. msgid "The following table shows how Bash treats unquoted tilde-prefixes:"
  3301. msgstr ""
  3302. #. type: item
  3303. #: ./bashref.texi:1925
  3304. #, no-wrap
  3305. msgid "~"
  3306. msgstr ""
  3307. #. type: table
  3308. #: ./bashref.texi:1927
  3309. msgid "The value of @code{$HOME}"
  3310. msgstr ""
  3311. #. type: item
  3312. #: ./bashref.texi:1927
  3313. #, no-wrap
  3314. msgid "~/foo"
  3315. msgstr ""
  3316. #. type: file{#1}
  3317. #: ./bashref.texi:1929
  3318. msgid "$HOME/foo"
  3319. msgstr ""
  3320. #. type: item
  3321. #: ./bashref.texi:1930
  3322. #, no-wrap
  3323. msgid "~fred/foo"
  3324. msgstr ""
  3325. #. type: table
  3326. #: ./bashref.texi:1933
  3327. msgid "The subdirectory @code{foo} of the home directory of the user @code{fred}"
  3328. msgstr ""
  3329. #. type: item
  3330. #: ./bashref.texi:1934
  3331. #, no-wrap
  3332. msgid "~+/foo"
  3333. msgstr ""
  3334. #. type: file{#1}
  3335. #: ./bashref.texi:1936
  3336. msgid "$PWD/foo"
  3337. msgstr ""
  3338. #. type: item
  3339. #: ./bashref.texi:1937
  3340. #, no-wrap
  3341. msgid "~-/foo"
  3342. msgstr ""
  3343. #. type: file{#1}
  3344. #: ./bashref.texi:1939
  3345. msgid "$@{OLDPWD-'~-'@}/foo"
  3346. msgstr ""
  3347. #. type: item
  3348. #: ./bashref.texi:1940
  3349. #, no-wrap
  3350. msgid "~@var{N}"
  3351. msgstr ""
  3352. #. type: table
  3353. #: ./bashref.texi:1942 ./bashref.texi:1945
  3354. msgid "The string that would be displayed by @samp{dirs +@var{N}}"
  3355. msgstr ""
  3356. #. type: item
  3357. #: ./bashref.texi:1943
  3358. #, no-wrap
  3359. msgid "~+@var{N}"
  3360. msgstr ""
  3361. #. type: item
  3362. #: ./bashref.texi:1946
  3363. #, no-wrap
  3364. msgid "~-@var{N}"
  3365. msgstr ""
  3366. #. type: table
  3367. #: ./bashref.texi:1948
  3368. msgid "The string that would be displayed by @samp{dirs -@var{N}}"
  3369. msgstr ""
  3370. #. type: Plain text
  3371. #: ./bashref.texi:1955
  3372. msgid ""
  3373. "Bash also performs tilde expansion on words satisfying the conditions of "
  3374. "variable assignments (@pxref{Shell Parameters}) when they appear as "
  3375. "arguments to simple commands. Bash does not do this, except for the "
  3376. "@var{declaration} commands listed above, when in @sc{posix} mode."
  3377. msgstr ""
  3378. #. type: cindex
  3379. #: ./bashref.texi:1958
  3380. #, no-wrap
  3381. msgid "parameter expansion"
  3382. msgstr ""
  3383. #. type: cindex
  3384. #: ./bashref.texi:1959
  3385. #, no-wrap
  3386. msgid "expansion, parameter"
  3387. msgstr ""
  3388. #. type: Plain text
  3389. #: ./bashref.texi:1967
  3390. msgid ""
  3391. "The @samp{$} character introduces parameter expansion, command substitution, "
  3392. "or arithmetic expansion. The parameter name or symbol to be expanded may be "
  3393. "enclosed in braces, which are optional but serve to protect the variable to "
  3394. "be expanded from characters immediately following it which could be "
  3395. "interpreted as part of the name."
  3396. msgstr ""
  3397. #. type: Plain text
  3398. #: ./bashref.texi:1972
  3399. msgid ""
  3400. "When braces are used, the matching ending brace is the first @samp{@}} not "
  3401. "escaped by a backslash or within a quoted string, and not within an embedded "
  3402. "arithmetic expansion, command substitution, or parameter expansion."
  3403. msgstr ""
  3404. #. type: Plain text
  3405. #: ./bashref.texi:1981
  3406. msgid ""
  3407. "The basic form of parameter expansion is $@{@var{parameter}@}. The value of "
  3408. "@var{parameter} is substituted. The @var{parameter} is a shell parameter as "
  3409. "described above (@pxref{Shell Parameters}) or an array reference "
  3410. "(@pxref{Arrays}). The braces are required when @var{parameter} is a "
  3411. "positional parameter with more than one digit, or when @var{parameter} is "
  3412. "followed by a character that is not to be interpreted as part of its name."
  3413. msgstr ""
  3414. #. type: Plain text
  3415. #: ./bashref.texi:2000
  3416. msgid ""
  3417. "If the first character of @var{parameter} is an exclamation point (!), and "
  3418. "@var{parameter} is not a @var{nameref}, it introduces a level of "
  3419. "indirection. Bash uses the value formed by expanding the rest of "
  3420. "@var{parameter} as the new @var{parameter}; this is then expanded and that "
  3421. "value is used in the rest of the expansion, rather than the expansion of the "
  3422. "original @var{parameter}. This is known as @code{indirect expansion}. The "
  3423. "value is subject to tilde expansion, parameter expansion, command "
  3424. "substitution, and arithmetic expansion. If @var{parameter} is a nameref, "
  3425. "this expands to the name of the variable referenced by @var{parameter} "
  3426. "instead of performing the complete indirect expansion. The exceptions to "
  3427. "this are the expansions of $@{!@var{prefix}*@} and $@{!@var{name}[@@]@} "
  3428. "described below. The exclamation point must immediately follow the left "
  3429. "brace in order to introduce indirection."
  3430. msgstr ""
  3431. #. type: Plain text
  3432. #: ./bashref.texi:2003
  3433. msgid ""
  3434. "In each of the cases below, @var{word} is subject to tilde expansion, "
  3435. "parameter expansion, command substitution, and arithmetic expansion."
  3436. msgstr ""
  3437. #. type: Plain text
  3438. #: ./bashref.texi:2010
  3439. msgid ""
  3440. "When not performing substring expansion, using the form described below "
  3441. "(e.g., @samp{:-}), Bash tests for a parameter that is unset or null. "
  3442. "Omitting the colon results in a test only for a parameter that is unset. "
  3443. "Put another way, if the colon is included, the operator tests for both "
  3444. "@var{parameter}'s existence and that its value is not null; if the colon is "
  3445. "omitted, the operator tests only for existence."
  3446. msgstr ""
  3447. #. type: item
  3448. #: ./bashref.texi:2013
  3449. #, no-wrap
  3450. msgid "$@{@var{parameter}:@minus{}@var{word}@}"
  3451. msgstr ""
  3452. #. type: table
  3453. #: ./bashref.texi:2017
  3454. msgid ""
  3455. "If @var{parameter} is unset or null, the expansion of @var{word} is "
  3456. "substituted. Otherwise, the value of @var{parameter} is substituted."
  3457. msgstr ""
  3458. #. type: item
  3459. #: ./bashref.texi:2018
  3460. #, no-wrap
  3461. msgid "$@{@var{parameter}:=@var{word}@}"
  3462. msgstr ""
  3463. #. type: table
  3464. #: ./bashref.texi:2025
  3465. msgid ""
  3466. "If @var{parameter} is unset or null, the expansion of @var{word} is assigned "
  3467. "to @var{parameter}. The value of @var{parameter} is then substituted. "
  3468. "Positional parameters and special parameters may not be assigned to in this "
  3469. "way."
  3470. msgstr ""
  3471. #. type: item
  3472. #: ./bashref.texi:2026
  3473. #, no-wrap
  3474. msgid "$@{@var{parameter}:?@var{word}@}"
  3475. msgstr ""
  3476. #. type: table
  3477. #: ./bashref.texi:2033
  3478. msgid ""
  3479. "If @var{parameter} is null or unset, the expansion of @var{word} (or a "
  3480. "message to that effect if @var{word} is not present) is written to the "
  3481. "standard error and the shell, if it is not interactive, exits. Otherwise, "
  3482. "the value of @var{parameter} is substituted."
  3483. msgstr ""
  3484. #. type: item
  3485. #: ./bashref.texi:2034
  3486. #, no-wrap
  3487. msgid "$@{@var{parameter}:+@var{word}@}"
  3488. msgstr ""
  3489. #. type: table
  3490. #: ./bashref.texi:2038
  3491. msgid ""
  3492. "If @var{parameter} is null or unset, nothing is substituted, otherwise the "
  3493. "expansion of @var{word} is substituted."
  3494. msgstr ""
  3495. #. type: item
  3496. #: ./bashref.texi:2039
  3497. #, no-wrap
  3498. msgid "$@{@var{parameter}:@var{offset}@}"
  3499. msgstr ""
  3500. #. type: itemx
  3501. #: ./bashref.texi:2040
  3502. #, no-wrap
  3503. msgid "$@{@var{parameter}:@var{offset}:@var{length}@}"
  3504. msgstr ""
  3505. #. type: table
  3506. #: ./bashref.texi:2052
  3507. msgid ""
  3508. "This is referred to as Substring Expansion. It expands to up to "
  3509. "@var{length} characters of the value of @var{parameter} starting at the "
  3510. "character specified by @var{offset}. If @var{parameter} is @samp{@@}, an "
  3511. "indexed array subscripted by @samp{@@} or @samp{*}, or an associative array "
  3512. "name, the results differ as described below. If @var{length} is omitted, it "
  3513. "expands to the substring of the value of @var{parameter} starting at the "
  3514. "character specified by @var{offset} and extending to the end of the value. "
  3515. "@var{length} and @var{offset} are arithmetic expressions (@pxref{Shell "
  3516. "Arithmetic})."
  3517. msgstr ""
  3518. #. type: table
  3519. #: ./bashref.texi:2063
  3520. msgid ""
  3521. "If @var{offset} evaluates to a number less than zero, the value is used as "
  3522. "an offset in characters from the end of the value of @var{parameter}. If "
  3523. "@var{length} evaluates to a number less than zero, it is interpreted as an "
  3524. "offset in characters from the end of the value of @var{parameter} rather "
  3525. "than a number of characters, and the expansion is the characters between "
  3526. "@var{offset} and that result. Note that a negative offset must be separated "
  3527. "from the colon by at least one space to avoid being confused with the "
  3528. "@samp{:-} expansion."
  3529. msgstr ""
  3530. #. type: table
  3531. #: ./bashref.texi:2066
  3532. msgid ""
  3533. "Here are some examples illustrating substring expansion on parameters and "
  3534. "subscripted arrays:"
  3535. msgstr ""
  3536. #. type: verbatim
  3537. #: ./bashref.texi:2072
  3538. #, no-wrap
  3539. msgid ""
  3540. "$ string=01234567890abcdefgh\n"
  3541. "$ echo ${string:7}\n"
  3542. "7890abcdefgh\n"
  3543. "$ echo ${string:7:0}\n"
  3544. "\n"
  3545. msgstr ""
  3546. #. type: verbatim
  3547. #: ./bashref.texi:2080
  3548. #, no-wrap
  3549. msgid ""
  3550. "$ echo ${string:7:2}\n"
  3551. "78\n"
  3552. "$ echo ${string:7:-2}\n"
  3553. "7890abcdef\n"
  3554. "$ echo ${string: -7}\n"
  3555. "bcdefgh\n"
  3556. "$ echo ${string: -7:0}\n"
  3557. "\n"
  3558. msgstr ""
  3559. #. type: verbatim
  3560. #: ./bashref.texi:2089
  3561. #, no-wrap
  3562. msgid ""
  3563. "$ echo ${string: -7:2}\n"
  3564. "bc\n"
  3565. "$ echo ${string: -7:-2}\n"
  3566. "bcdef\n"
  3567. "$ set -- 01234567890abcdefgh\n"
  3568. "$ echo ${1:7}\n"
  3569. "7890abcdefgh\n"
  3570. "$ echo ${1:7:0}\n"
  3571. "\n"
  3572. msgstr ""
  3573. #. type: verbatim
  3574. #: ./bashref.texi:2097
  3575. #, no-wrap
  3576. msgid ""
  3577. "$ echo ${1:7:2}\n"
  3578. "78\n"
  3579. "$ echo ${1:7:-2}\n"
  3580. "7890abcdef\n"
  3581. "$ echo ${1: -7}\n"
  3582. "bcdefgh\n"
  3583. "$ echo ${1: -7:0}\n"
  3584. "\n"
  3585. msgstr ""
  3586. #. type: verbatim
  3587. #: ./bashref.texi:2106
  3588. #, no-wrap
  3589. msgid ""
  3590. "$ echo ${1: -7:2}\n"
  3591. "bc\n"
  3592. "$ echo ${1: -7:-2}\n"
  3593. "bcdef\n"
  3594. "$ array[0]=01234567890abcdefgh\n"
  3595. "$ echo ${array[0]:7}\n"
  3596. "7890abcdefgh\n"
  3597. "$ echo ${array[0]:7:0}\n"
  3598. "\n"
  3599. msgstr ""
  3600. #. type: verbatim
  3601. #: ./bashref.texi:2114
  3602. #, no-wrap
  3603. msgid ""
  3604. "$ echo ${array[0]:7:2}\n"
  3605. "78\n"
  3606. "$ echo ${array[0]:7:-2}\n"
  3607. "7890abcdef\n"
  3608. "$ echo ${array[0]: -7}\n"
  3609. "bcdefgh\n"
  3610. "$ echo ${array[0]: -7:0}\n"
  3611. "\n"
  3612. msgstr ""
  3613. #. type: verbatim
  3614. #: ./bashref.texi:2119
  3615. #, no-wrap
  3616. msgid ""
  3617. "$ echo ${array[0]: -7:2}\n"
  3618. "bc\n"
  3619. "$ echo ${array[0]: -7:-2}\n"
  3620. "bcdef\n"
  3621. msgstr ""
  3622. #. type: table
  3623. #: ./bashref.texi:2127
  3624. msgid ""
  3625. "If @var{parameter} is @samp{@@}, the result is @var{length} positional "
  3626. "parameters beginning at @var{offset}. A negative @var{offset} is taken "
  3627. "relative to one greater than the greatest positional parameter, so an offset "
  3628. "of -1 evaluates to the last positional parameter. It is an expansion error "
  3629. "if @var{length} evaluates to a number less than zero."
  3630. msgstr ""
  3631. #. type: table
  3632. #: ./bashref.texi:2130
  3633. msgid ""
  3634. "The following examples illustrate substring expansion using positional "
  3635. "parameters:"
  3636. msgstr ""
  3637. #. type: verbatim
  3638. #: ./bashref.texi:2136
  3639. #, no-wrap
  3640. msgid ""
  3641. "$ set -- 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3642. "$ echo ${@:7}\n"
  3643. "7 8 9 0 a b c d e f g h\n"
  3644. "$ echo ${@:7:0}\n"
  3645. "\n"
  3646. msgstr ""
  3647. #. type: verbatim
  3648. #: ./bashref.texi:2148
  3649. #, no-wrap
  3650. msgid ""
  3651. "$ echo ${@:7:2}\n"
  3652. "7 8\n"
  3653. "$ echo ${@:7:-2}\n"
  3654. "bash: -2: substring expression < 0\n"
  3655. "$ echo ${@: -7:2}\n"
  3656. "b c\n"
  3657. "$ echo ${@:0}\n"
  3658. "./bash 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3659. "$ echo ${@:0:2}\n"
  3660. "./bash 1\n"
  3661. "$ echo ${@: -7:0}\n"
  3662. "\n"
  3663. msgstr ""
  3664. #. type: table
  3665. #: ./bashref.texi:2157
  3666. msgid ""
  3667. "If @var{parameter} is an indexed array name subscripted by @samp{@@} or "
  3668. "@samp{*}, the result is the @var{length} members of the array beginning with "
  3669. "@code{$@{@var{parameter}[@var{offset}]@}}. A negative @var{offset} is taken "
  3670. "relative to one greater than the maximum index of the specified array. It "
  3671. "is an expansion error if @var{length} evaluates to a number less than zero."
  3672. msgstr ""
  3673. #. type: table
  3674. #: ./bashref.texi:2160
  3675. msgid "These examples show how you can use substring expansion with indexed arrays:"
  3676. msgstr ""
  3677. #. type: verbatim
  3678. #: ./bashref.texi:2176
  3679. #, no-wrap
  3680. msgid ""
  3681. "$ array=(0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h)\n"
  3682. "$ echo ${array[@]:7}\n"
  3683. "7 8 9 0 a b c d e f g h\n"
  3684. "$ echo ${array[@]:7:2}\n"
  3685. "7 8\n"
  3686. "$ echo ${array[@]: -7:2}\n"
  3687. "b c\n"
  3688. "$ echo ${array[@]: -7:-2}\n"
  3689. "bash: -2: substring expression < 0\n"
  3690. "$ echo ${array[@]:0}\n"
  3691. "0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3692. "$ echo ${array[@]:0:2}\n"
  3693. "0 1\n"
  3694. "$ echo ${array[@]: -7:0}\n"
  3695. "\n"
  3696. msgstr ""
  3697. #. type: table
  3698. #: ./bashref.texi:2181
  3699. msgid ""
  3700. "Substring expansion applied to an associative array produces undefined "
  3701. "results."
  3702. msgstr ""
  3703. #. type: table
  3704. #: ./bashref.texi:2186
  3705. msgid ""
  3706. "Substring indexing is zero-based unless the positional parameters are used, "
  3707. "in which case the indexing starts at 1 by default. If @var{offset} is 0, "
  3708. "and the positional parameters are used, @code{$@@} is prefixed to the list."
  3709. msgstr ""
  3710. #. type: item
  3711. #: ./bashref.texi:2187
  3712. #, no-wrap
  3713. msgid "$@{!@var{prefix}*@}"
  3714. msgstr ""
  3715. #. type: itemx
  3716. #: ./bashref.texi:2188
  3717. #, no-wrap
  3718. msgid "$@{!@var{prefix}@@@}"
  3719. msgstr ""
  3720. #. type: table
  3721. #: ./bashref.texi:2193
  3722. msgid ""
  3723. "Expands to the names of variables whose names begin with @var{prefix}, "
  3724. "separated by the first character of the @env{IFS} special variable. When "
  3725. "@samp{@@} is used and the expansion appears within double quotes, each "
  3726. "variable name expands to a separate word."
  3727. msgstr ""
  3728. #. type: item
  3729. #: ./bashref.texi:2194
  3730. #, no-wrap
  3731. msgid "$@{!@var{name}[@@]@}"
  3732. msgstr ""
  3733. #. type: itemx
  3734. #: ./bashref.texi:2195
  3735. #, no-wrap
  3736. msgid "$@{!@var{name}[*]@}"
  3737. msgstr ""
  3738. #. type: table
  3739. #: ./bashref.texi:2202
  3740. msgid ""
  3741. "If @var{name} is an array variable, expands to the list of array indices "
  3742. "(keys) assigned in @var{name}. If @var{name} is not an array, expands to 0 "
  3743. "if @var{name} is set and null otherwise. When @samp{@@} is used and the "
  3744. "expansion appears within double quotes, each key expands to a separate word."
  3745. msgstr ""
  3746. #. type: item
  3747. #: ./bashref.texi:2203
  3748. #, no-wrap
  3749. msgid "$@{#@var{parameter}@}"
  3750. msgstr ""
  3751. #. type: table
  3752. #: ./bashref.texi:2215
  3753. msgid ""
  3754. "The length in characters of the expanded value of @var{parameter} is "
  3755. "substituted. If @var{parameter} is @samp{*} or @samp{@@}, the value "
  3756. "substituted is the number of positional parameters. If @var{parameter} is "
  3757. "an array name subscripted by @samp{*} or @samp{@@}, the value substituted is "
  3758. "the number of elements in the array. If @var{parameter} is an indexed array "
  3759. "name subscripted by a negative number, that number is interpreted as "
  3760. "relative to one greater than the maximum index of @var{parameter}, so "
  3761. "negative indices count back from the end of the array, and an index of -1 "
  3762. "references the last element."
  3763. msgstr ""
  3764. #. type: item
  3765. #: ./bashref.texi:2216
  3766. #, no-wrap
  3767. msgid "$@{@var{parameter}#@var{word}@}"
  3768. msgstr ""
  3769. #. type: itemx
  3770. #: ./bashref.texi:2217
  3771. #, no-wrap
  3772. msgid "$@{@var{parameter}##@var{word}@}"
  3773. msgstr ""
  3774. #. type: table
  3775. #: ./bashref.texi:2232
  3776. msgid ""
  3777. "The @var{word} is expanded to produce a pattern and matched according to the "
  3778. "rules described below (@pxref{Pattern Matching}). If the pattern matches "
  3779. "the beginning of the expanded value of @var{parameter}, then the result of "
  3780. "the expansion is the expanded value of @var{parameter} with the shortest "
  3781. "matching pattern (the @samp{#} case) or the longest matching pattern (the "
  3782. "@samp{##} case) deleted. If @var{parameter} is @samp{@@} or @samp{*}, the "
  3783. "pattern removal operation is applied to each positional parameter in turn, "
  3784. "and the expansion is the resultant list. If @var{parameter} is an array "
  3785. "variable subscripted with @samp{@@} or @samp{*}, the pattern removal "
  3786. "operation is applied to each member of the array in turn, and the expansion "
  3787. "is the resultant list."
  3788. msgstr ""
  3789. #. type: item
  3790. #: ./bashref.texi:2233
  3791. #, no-wrap
  3792. msgid "$@{@var{parameter}%@var{word}@}"
  3793. msgstr ""
  3794. #. type: itemx
  3795. #: ./bashref.texi:2234
  3796. #, no-wrap
  3797. msgid "$@{@var{parameter}%%@var{word}@}"
  3798. msgstr ""
  3799. #. type: table
  3800. #: ./bashref.texi:2249
  3801. msgid ""
  3802. "The @var{word} is expanded to produce a pattern and matched according to the "
  3803. "rules described below (@pxref{Pattern Matching}). If the pattern matches If "
  3804. "the pattern matches a trailing portion of the expanded value of "
  3805. "@var{parameter}, then the result of the expansion is the value of "
  3806. "@var{parameter} with the shortest matching pattern (the @samp{%} case) or "
  3807. "the longest matching pattern (the @samp{%%} case) deleted. If "
  3808. "@var{parameter} is @samp{@@} or @samp{*}, the pattern removal operation is "
  3809. "applied to each positional parameter in turn, and the expansion is the "
  3810. "resultant list. If @var{parameter} is an array variable subscripted with "
  3811. "@samp{@@} or @samp{*}, the pattern removal operation is applied to each "
  3812. "member of the array in turn, and the expansion is the resultant list."
  3813. msgstr ""
  3814. #. type: item
  3815. #: ./bashref.texi:2250
  3816. #, no-wrap
  3817. msgid "$@{@var{parameter}/@var{pattern}/@var{string}@}"
  3818. msgstr ""
  3819. #. type: table
  3820. #: ./bashref.texi:2277
  3821. msgid ""
  3822. "The @var{pattern} is expanded to produce a pattern just as in filename "
  3823. "expansion. @var{Parameter} is expanded and the longest match of "
  3824. "@var{pattern} against its value is replaced with @var{string}. The match is "
  3825. "performed according to the rules described below (@pxref{Pattern "
  3826. "Matching}). If @var{pattern} begins with @samp{/}, all matches of "
  3827. "@var{pattern} are replaced with @var{string}. Normally only the first match "
  3828. "is replaced. If @var{pattern} begins with @samp{#}, it must match at the "
  3829. "beginning of the expanded value of @var{parameter}. If @var{pattern} begins "
  3830. "with @samp{%}, it must match at the end of the expanded value of "
  3831. "@var{parameter}. If @var{string} is null, matches of @var{pattern} are "
  3832. "deleted and the @code{/} following @var{pattern} may be omitted. If the "
  3833. "@code{nocasematch} shell option (see the description of @code{shopt} in "
  3834. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  3835. "to the case of alphabetic characters. If @var{parameter} is @samp{@@} or "
  3836. "@samp{*}, the substitution operation is applied to each positional parameter "
  3837. "in turn, and the expansion is the resultant list. If @var{parameter} is an "
  3838. "array variable subscripted with @samp{@@} or @samp{*}, the substitution "
  3839. "operation is applied to each member of the array in turn, and the expansion "
  3840. "is the resultant list."
  3841. msgstr ""
  3842. #. type: item
  3843. #: ./bashref.texi:2278
  3844. #, no-wrap
  3845. msgid "$@{@var{parameter}^@var{pattern}@}"
  3846. msgstr ""
  3847. #. type: itemx
  3848. #: ./bashref.texi:2279
  3849. #, no-wrap
  3850. msgid "$@{@var{parameter}^^@var{pattern}@}"
  3851. msgstr ""
  3852. #. type: itemx
  3853. #: ./bashref.texi:2280
  3854. #, no-wrap
  3855. msgid "$@{@var{parameter},@var{pattern}@}"
  3856. msgstr ""
  3857. #. type: itemx
  3858. #: ./bashref.texi:2281
  3859. #, no-wrap
  3860. msgid "$@{@var{parameter},,@var{pattern}@}"
  3861. msgstr ""
  3862. #. type: table
  3863. #: ./bashref.texi:2303
  3864. msgid ""
  3865. "This expansion modifies the case of alphabetic characters in "
  3866. "@var{parameter}. The @var{pattern} is expanded to produce a pattern just as "
  3867. "in filename expansion. Each character in the expanded value of "
  3868. "@var{parameter} is tested against @var{pattern}, and, if it matches the "
  3869. "pattern, its case is converted. The pattern should not attempt to match "
  3870. "more than one character. The @samp{^} operator converts lowercase letters "
  3871. "matching @var{pattern} to uppercase; the @samp{,} operator converts matching "
  3872. "uppercase letters to lowercase. The @samp{^^} and @samp{,,} expansions "
  3873. "convert each matched character in the expanded value; the @samp{^} and "
  3874. "@samp{,} expansions match and convert only the first character in the "
  3875. "expanded value. If @var{pattern} is omitted, it is treated like a @samp{?}, "
  3876. "which matches every character. If @var{parameter} is @samp{@@} or @samp{*}, "
  3877. "the case modification operation is applied to each positional parameter in "
  3878. "turn, and the expansion is the resultant list. If @var{parameter} is an "
  3879. "array variable subscripted with @samp{@@} or @samp{*}, the case modification "
  3880. "operation is applied to each member of the array in turn, and the expansion "
  3881. "is the resultant list."
  3882. msgstr ""
  3883. #. type: item
  3884. #: ./bashref.texi:2304
  3885. #, no-wrap
  3886. msgid "$@{@var{parameter}@@@var{operator}@}"
  3887. msgstr ""
  3888. #. type: table
  3889. #: ./bashref.texi:2308
  3890. msgid ""
  3891. "The expansion is either a transformation of the value of @var{parameter} or "
  3892. "information about @var{parameter} itself, depending on the value of "
  3893. "@var{operator}. Each @var{operator} is a single letter:"
  3894. msgstr ""
  3895. #. type: item
  3896. #: ./bashref.texi:2310
  3897. #, no-wrap
  3898. msgid "Q"
  3899. msgstr ""
  3900. #. type: table
  3901. #: ./bashref.texi:2313
  3902. msgid ""
  3903. "The expansion is a string that is the value of @var{parameter} quoted in a "
  3904. "format that can be reused as input."
  3905. msgstr ""
  3906. #. type: item
  3907. #: ./bashref.texi:2313
  3908. #, no-wrap
  3909. msgid "E"
  3910. msgstr ""
  3911. #. type: table
  3912. #: ./bashref.texi:2316
  3913. msgid ""
  3914. "The expansion is a string that is the value of @var{parameter} with "
  3915. "backslash escape sequences expanded as with the @code{$'@dots{}'} quoting "
  3916. "mechanism."
  3917. msgstr ""
  3918. #. type: item
  3919. #: ./bashref.texi:2316
  3920. #, no-wrap
  3921. msgid "P"
  3922. msgstr ""
  3923. #. type: table
  3924. #: ./bashref.texi:2319
  3925. msgid ""
  3926. "The expansion is a string that is the result of expanding the value of "
  3927. "@var{parameter} as if it were a prompt string (@pxref{Controlling the "
  3928. "Prompt})."
  3929. msgstr ""
  3930. #. type: item
  3931. #: ./bashref.texi:2319
  3932. #, no-wrap
  3933. msgid "A"
  3934. msgstr ""
  3935. #. type: table
  3936. #: ./bashref.texi:2323
  3937. msgid ""
  3938. "The expansion is a string in the form of an assignment statement or "
  3939. "@code{declare} command that, if evaluated, will recreate @var{parameter} "
  3940. "with its attributes and value."
  3941. msgstr ""
  3942. #. type: item
  3943. #: ./bashref.texi:2323
  3944. #, no-wrap
  3945. msgid "a"
  3946. msgstr ""
  3947. #. type: table
  3948. #: ./bashref.texi:2326
  3949. msgid ""
  3950. "The expansion is a string consisting of flag values representing "
  3951. "@var{parameter}'s attributes."
  3952. msgstr ""
  3953. #. type: table
  3954. #: ./bashref.texi:2335
  3955. msgid ""
  3956. "If @var{parameter} is @samp{@@} or @samp{*}, the operation is applied to "
  3957. "each positional parameter in turn, and the expansion is the resultant list. "
  3958. "If @var{parameter} is an array variable subscripted with @samp{@@} or "
  3959. "@samp{*}, the operation is applied to each member of the array in turn, and "
  3960. "the expansion is the resultant list."
  3961. msgstr ""
  3962. #. type: table
  3963. #: ./bashref.texi:2338
  3964. msgid ""
  3965. "The result of the expansion is subject to word splitting and pathname "
  3966. "expansion as described below."
  3967. msgstr ""
  3968. #. type: Plain text
  3969. #: ./bashref.texi:2347
  3970. msgid ""
  3971. "Command substitution allows the output of a command to replace the command "
  3972. "itself. Command substitution occurs when a command is enclosed as follows:"
  3973. msgstr ""
  3974. #. type: example
  3975. #: ./bashref.texi:2349
  3976. #, no-wrap
  3977. msgid "$(@var{command})\n"
  3978. msgstr ""
  3979. #. type: example
  3980. #: ./bashref.texi:2354
  3981. #, no-wrap
  3982. msgid "`@var{command}`\n"
  3983. msgstr ""
  3984. #. type: Plain text
  3985. #: ./bashref.texi:2364
  3986. msgid ""
  3987. "Bash performs the expansion by executing @var{command} in a subshell "
  3988. "environment and replacing the command substitution with the standard output "
  3989. "of the command, with any trailing newlines deleted. Embedded newlines are "
  3990. "not deleted, but they may be removed during word splitting. The command "
  3991. "substitution @code{$(cat @var{file})} can be replaced by the equivalent but "
  3992. "faster @code{$(< @var{file})}."
  3993. msgstr ""
  3994. #. type: Plain text
  3995. #: ./bashref.texi:2372
  3996. msgid ""
  3997. "When the old-style backquote form of substitution is used, backslash retains "
  3998. "its literal meaning except when followed by @samp{$}, @samp{`}, or "
  3999. "@samp{\\}. The first backquote not preceded by a backslash terminates the "
  4000. "command substitution. When using the @code{$(@var{command})} form, all "
  4001. "characters between the parentheses make up the command; none are treated "
  4002. "specially."
  4003. msgstr ""
  4004. #. type: Plain text
  4005. #: ./bashref.texi:2375
  4006. msgid ""
  4007. "Command substitutions may be nested. To nest when using the backquoted "
  4008. "form, escape the inner backquotes with backslashes."
  4009. msgstr ""
  4010. #. type: Plain text
  4011. #: ./bashref.texi:2378
  4012. msgid ""
  4013. "If the substitution appears within double quotes, word splitting and "
  4014. "filename expansion are not performed on the results."
  4015. msgstr ""
  4016. #. type: cindex
  4017. #: ./bashref.texi:2381
  4018. #, no-wrap
  4019. msgid "expansion, arithmetic"
  4020. msgstr ""
  4021. #. type: Plain text
  4022. #: ./bashref.texi:2386
  4023. msgid ""
  4024. "Arithmetic expansion allows the evaluation of an arithmetic expression and "
  4025. "the substitution of the result. The format for arithmetic expansion is:"
  4026. msgstr ""
  4027. #. type: example
  4028. #: ./bashref.texi:2389
  4029. #, no-wrap
  4030. msgid "$(( @var{expression} ))\n"
  4031. msgstr ""
  4032. #. type: Plain text
  4033. #: ./bashref.texi:2397
  4034. msgid ""
  4035. "The expression is treated as if it were within double quotes, but a double "
  4036. "quote inside the parentheses is not treated specially. All tokens in the "
  4037. "expression undergo parameter and variable expansion, command substitution, "
  4038. "and quote removal. The result is treated as the arithmetic expression to be "
  4039. "evaluated. Arithmetic expansions may be nested."
  4040. msgstr ""
  4041. #. type: Plain text
  4042. #: ./bashref.texi:2402
  4043. msgid ""
  4044. "The evaluation is performed according to the rules listed below "
  4045. "(@pxref{Shell Arithmetic}). If the expression is invalid, Bash prints a "
  4046. "message indicating failure to the standard error and no substitution occurs."
  4047. msgstr ""
  4048. #. type: cindex
  4049. #: ./bashref.texi:2405
  4050. #, no-wrap
  4051. msgid "process substitution"
  4052. msgstr ""
  4053. #. type: Plain text
  4054. #: ./bashref.texi:2410
  4055. msgid ""
  4056. "Process substitution allows a process's input or output to be referred to "
  4057. "using a filename. It takes the form of"
  4058. msgstr ""
  4059. #. type: example
  4060. #: ./bashref.texi:2412
  4061. #, no-wrap
  4062. msgid "<(@var{list})\n"
  4063. msgstr ""
  4064. #. type: example
  4065. #: ./bashref.texi:2417
  4066. #, no-wrap
  4067. msgid ">(@var{list})\n"
  4068. msgstr ""
  4069. #. type: Plain text
  4070. #: ./bashref.texi:2433
  4071. msgid ""
  4072. "The process @var{list} is run asynchronously, and its input or output "
  4073. "appears as a filename. This filename is passed as an argument to the "
  4074. "current command as the result of the expansion. If the @code{>(@var{list})} "
  4075. "form is used, writing to the file will provide input for @var{list}. If the "
  4076. "@code{<(@var{list})} form is used, the file passed as an argument should be "
  4077. "read to obtain the output of @var{list}. Note that no space may appear "
  4078. "between the @code{<} or @code{>} and the left parenthesis, otherwise the "
  4079. "construct would be interpreted as a redirection. Process substitution is "
  4080. "supported on systems that support named pipes (@sc{fifo}s) or the "
  4081. "@file{/dev/fd} method of naming open files."
  4082. msgstr ""
  4083. #. type: Plain text
  4084. #: ./bashref.texi:2437
  4085. msgid ""
  4086. "When available, process substitution is performed simultaneously with "
  4087. "parameter and variable expansion, command substitution, and arithmetic "
  4088. "expansion."
  4089. msgstr ""
  4090. #. type: Plain text
  4091. #: ./bashref.texi:2445
  4092. msgid ""
  4093. "The shell scans the results of parameter expansion, command substitution, "
  4094. "and arithmetic expansion that did not occur within double quotes for word "
  4095. "splitting."
  4096. msgstr ""
  4097. #. type: Plain text
  4098. #: ./bashref.texi:2465
  4099. msgid ""
  4100. "The shell treats each character of @env{$IFS} as a delimiter, and splits the "
  4101. "results of the other expansions into words using these characters as field "
  4102. "terminators. If @env{IFS} is unset, or its value is exactly "
  4103. "@code{<space><tab><newline>}, the default, then sequences of @code{ "
  4104. "<space>}, @code{<tab>}, and @code{<newline>} at the beginning and end of the "
  4105. "results of the previous expansions are ignored, and any sequence of "
  4106. "@env{IFS} characters not at the beginning or end serves to delimit words. "
  4107. "If @env{IFS} has a value other than the default, then sequences of the "
  4108. "whitespace characters @code{space}, @code{tab}, and @code{newline} are "
  4109. "ignored at the beginning and end of the word, as long as the whitespace "
  4110. "character is in the value of @env{IFS} (an @env{IFS} whitespace character). "
  4111. "Any character in @env{IFS} that is not @env{IFS} whitespace, along with any "
  4112. "adjacent @env{IFS} whitespace characters, delimits a field. A sequence of "
  4113. "@env{IFS} whitespace characters is also treated as a delimiter. If the "
  4114. "value of @env{IFS} is null, no word splitting occurs."
  4115. msgstr ""
  4116. #. type: Plain text
  4117. #: ./bashref.texi:2478
  4118. msgid ""
  4119. "Explicit null arguments (@code{\"\"} or @code{''}) are retained and passed "
  4120. "to commands as empty strings. Unquoted implicit null arguments, resulting "
  4121. "from the expansion of parameters that have no values, are removed. If a "
  4122. "parameter with no value is expanded within double quotes, a null argument "
  4123. "results and is retained and passed to a command as an empty string. When a "
  4124. "quoted null argument appears as part of a word whose expansion is non-null, "
  4125. "the null argument is removed. That is, the word @code{-d''} becomes "
  4126. "@code{-d} after word splitting and null argument removal."
  4127. msgstr ""
  4128. #. type: Plain text
  4129. #: ./bashref.texi:2481
  4130. msgid "Note that if no expansion occurs, no splitting is performed."
  4131. msgstr ""
  4132. #. type: subsubsection
  4133. #: ./bashref.texi:2486 ./bashref.texi:2545 ./bashref.texi:2546
  4134. #, no-wrap
  4135. msgid "Pattern Matching"
  4136. msgstr ""
  4137. #. type: menuentry
  4138. #: ./bashref.texi:2486
  4139. msgid "How the shell matches patterns."
  4140. msgstr ""
  4141. #. type: cindex
  4142. #: ./bashref.texi:2487
  4143. #, no-wrap
  4144. msgid "expansion, filename"
  4145. msgstr ""
  4146. #. type: cindex
  4147. #: ./bashref.texi:2488
  4148. #, no-wrap
  4149. msgid "expansion, pathname"
  4150. msgstr ""
  4151. #. type: cindex
  4152. #: ./bashref.texi:2490
  4153. #, no-wrap
  4154. msgid "pathname expansion"
  4155. msgstr ""
  4156. #. type: Plain text
  4157. #: ./bashref.texi:2508
  4158. msgid ""
  4159. "After word splitting, unless the @option{-f} option has been set (@pxref{The "
  4160. "Set Builtin}), Bash scans each word for the characters @samp{*}, @samp{?}, "
  4161. "and @samp{[}. If one of these characters appears, then the word is regarded "
  4162. "as a @var{pattern}, and replaced with an alphabetically sorted list of "
  4163. "filenames matching the pattern (@pxref{Pattern Matching}). If no matching "
  4164. "filenames are found, and the shell option @code{nullglob} is disabled, the "
  4165. "word is left unchanged. If the @code{nullglob} option is set, and no "
  4166. "matches are found, the word is removed. If the @code{failglob} shell option "
  4167. "is set, and no matches are found, an error message is printed and the "
  4168. "command is not executed. If the shell option @code{nocaseglob} is enabled, "
  4169. "the match is performed without regard to the case of alphabetic characters."
  4170. msgstr ""
  4171. #. type: Plain text
  4172. #: ./bashref.texi:2515
  4173. msgid ""
  4174. "When a pattern is used for filename expansion, the character @samp{.} at the "
  4175. "start of a filename or immediately following a slash must be matched "
  4176. "explicitly, unless the shell option @code{dotglob} is set. The filenames "
  4177. "@samp{.} and @samp{..} must always be matched explicitly, even if "
  4178. "@code{dotglob} is set. In other cases, the @samp{.} character is not "
  4179. "treated specially."
  4180. msgstr ""
  4181. #. type: Plain text
  4182. #: ./bashref.texi:2520
  4183. msgid ""
  4184. "When matching a filename, the slash character must always be matched "
  4185. "explicitly by a slash in the pattern, but in other matching contexts it can "
  4186. "be matched by a special pattern character as described below (@pxref{Pattern "
  4187. "Matching})."
  4188. msgstr ""
  4189. #. type: Plain text
  4190. #: ./bashref.texi:2524
  4191. msgid ""
  4192. "See the description of @code{shopt} in @ref{The Shopt Builtin}, for a "
  4193. "description of the @code{nocaseglob}, @code{nullglob}, @code{failglob}, and "
  4194. "@code{dotglob} options."
  4195. msgstr ""
  4196. #. type: Plain text
  4197. #: ./bashref.texi:2544
  4198. msgid ""
  4199. "The @env{GLOBIGNORE} shell variable may be used to restrict the set of file "
  4200. "names matching a pattern. If @env{GLOBIGNORE} is set, each matching file "
  4201. "name that also matches one of the patterns in @env{GLOBIGNORE} is removed "
  4202. "from the list of matches. If the @code{nocaseglob} option is set, the "
  4203. "matching against the patterns in @env{GLOBIGNORE} is performed without "
  4204. "regard to case. The filenames @file{.} and @file{..} are always ignored "
  4205. "when @env{GLOBIGNORE} is set and not null. However, setting "
  4206. "@env{GLOBIGNORE} to a non-null value has the effect of enabling the "
  4207. "@code{dotglob} shell option, so all other filenames beginning with a "
  4208. "@samp{.} will match. To get the old behavior of ignoring filenames "
  4209. "beginning with a @samp{.}, make @samp{.*} one of the patterns in "
  4210. "@env{GLOBIGNORE}. The @code{dotglob} option is disabled when "
  4211. "@env{GLOBIGNORE} is unset."
  4212. msgstr ""
  4213. #. type: cindex
  4214. #: ./bashref.texi:2547
  4215. #, no-wrap
  4216. msgid "pattern matching"
  4217. msgstr ""
  4218. #. type: cindex
  4219. #: ./bashref.texi:2548
  4220. #, no-wrap
  4221. msgid "matching, pattern"
  4222. msgstr ""
  4223. #. type: Plain text
  4224. #: ./bashref.texi:2557
  4225. msgid ""
  4226. "Any character that appears in a pattern, other than the special pattern "
  4227. "characters described below, matches itself. The @sc{nul} character may not "
  4228. "occur in a pattern. A backslash escapes the following character; the "
  4229. "escaping backslash is discarded when matching. The special pattern "
  4230. "characters must be quoted if they are to be matched literally."
  4231. msgstr ""
  4232. #. type: Plain text
  4233. #: ./bashref.texi:2559
  4234. msgid "The special pattern characters have the following meanings:"
  4235. msgstr ""
  4236. #. type: table
  4237. #: ./bashref.texi:2568
  4238. msgid ""
  4239. "Matches any string, including the null string. When the @code{globstar} "
  4240. "shell option is enabled, and @samp{*} is used in a filename expansion "
  4241. "context, two adjacent @samp{*}s used as a single pattern will match all "
  4242. "files and zero or more directories and subdirectories. If followed by a "
  4243. "@samp{/}, two adjacent @samp{*}s will match only directories and "
  4244. "subdirectories."
  4245. msgstr ""
  4246. #. type: table
  4247. #: ./bashref.texi:2570
  4248. msgid "Matches any single character."
  4249. msgstr ""
  4250. #. type: item
  4251. #: ./bashref.texi:2570
  4252. #, no-wrap
  4253. msgid "[@dots{}]"
  4254. msgstr ""
  4255. #. type: table
  4256. #: ./bashref.texi:2584
  4257. msgid ""
  4258. "Matches any one of the enclosed characters. A pair of characters separated "
  4259. "by a hyphen denotes a @var{range expression}; any character that falls "
  4260. "between those two characters, inclusive, using the current locale's "
  4261. "collating sequence and character set, is matched. If the first character "
  4262. "following the @samp{[} is a @samp{!} or a @samp{^} then any character not "
  4263. "enclosed is matched. A @samp{@minus{}} may be matched by including it as "
  4264. "the first or last character in the set. A @samp{]} may be matched by "
  4265. "including it as the first character in the set. The sorting order of "
  4266. "characters in range expressions is determined by the current locale and the "
  4267. "values of the @env{LC_COLLATE} and @env{LC_ALL} shell variables, if set."
  4268. msgstr ""
  4269. #. type: table
  4270. #: ./bashref.texi:2593
  4271. msgid ""
  4272. "For example, in the default C locale, @samp{[a-dx-z]} is equivalent to "
  4273. "@samp{[abcdxyz]}. Many locales sort characters in dictionary order, and in "
  4274. "these locales @samp{[a-dx-z]} is typically not equivalent to "
  4275. "@samp{[abcdxyz]}; it might be equivalent to @samp{[aBbCcDdxXyYz]}, for "
  4276. "example. To obtain the traditional interpretation of ranges in bracket "
  4277. "expressions, you can force the use of the C locale by setting the "
  4278. "@env{LC_COLLATE} or @env{LC_ALL} environment variable to the value @samp{C}, "
  4279. "or enable the @code{globasciiranges} shell option."
  4280. msgstr ""
  4281. #. type: table
  4282. #: ./bashref.texi:2598
  4283. msgid ""
  4284. "Within @samp{[} and @samp{]}, @var{character classes} can be specified using "
  4285. "the syntax @code{[:}@var{class}@code{:]}, where @var{class} is one of the "
  4286. "following classes defined in the @sc{posix} standard:"
  4287. msgstr ""
  4288. #. type: example
  4289. #: ./bashref.texi:2601
  4290. #, no-wrap
  4291. msgid ""
  4292. "alnum alpha ascii blank cntrl digit graph lower\n"
  4293. "print punct space upper word xdigit\n"
  4294. msgstr ""
  4295. #. type: table
  4296. #: ./bashref.texi:2606
  4297. msgid ""
  4298. "A character class matches any character belonging to that class. The "
  4299. "@code{word} character class matches letters, digits, and the character "
  4300. "@samp{_}."
  4301. msgstr ""
  4302. #. type: table
  4303. #: ./bashref.texi:2611
  4304. msgid ""
  4305. "Within @samp{[} and @samp{]}, an @var{equivalence class} can be specified "
  4306. "using the syntax @code{[=}@var{c}@code{=]}, which matches all characters "
  4307. "with the same collation weight (as defined by the current locale) as the "
  4308. "character @var{c}."
  4309. msgstr ""
  4310. #. type: table
  4311. #: ./bashref.texi:2614
  4312. msgid ""
  4313. "Within @samp{[} and @samp{]}, the syntax @code{[.}@var{symbol}@code{.]} "
  4314. "matches the collating symbol @var{symbol}."
  4315. msgstr ""
  4316. #. type: Plain text
  4317. #: ./bashref.texi:2622
  4318. msgid ""
  4319. "If the @code{extglob} shell option is enabled using the @code{shopt} "
  4320. "builtin, several extended pattern matching operators are recognized. In the "
  4321. "following description, a @var{pattern-list} is a list of one or more "
  4322. "patterns separated by a @samp{|}. Composite patterns may be formed using "
  4323. "one or more of the following sub-patterns:"
  4324. msgstr ""
  4325. #. type: item
  4326. #: ./bashref.texi:2624
  4327. #, no-wrap
  4328. msgid "?(@var{pattern-list})"
  4329. msgstr ""
  4330. #. type: table
  4331. #: ./bashref.texi:2626
  4332. msgid "Matches zero or one occurrence of the given patterns."
  4333. msgstr ""
  4334. #. type: item
  4335. #: ./bashref.texi:2627
  4336. #, no-wrap
  4337. msgid "*(@var{pattern-list})"
  4338. msgstr ""
  4339. #. type: table
  4340. #: ./bashref.texi:2629
  4341. msgid "Matches zero or more occurrences of the given patterns."
  4342. msgstr ""
  4343. #. type: item
  4344. #: ./bashref.texi:2630
  4345. #, no-wrap
  4346. msgid "+(@var{pattern-list})"
  4347. msgstr ""
  4348. #. type: table
  4349. #: ./bashref.texi:2632
  4350. msgid "Matches one or more occurrences of the given patterns."
  4351. msgstr ""
  4352. #. type: item
  4353. #: ./bashref.texi:2633
  4354. #, no-wrap
  4355. msgid "@@(@var{pattern-list})"
  4356. msgstr ""
  4357. #. type: table
  4358. #: ./bashref.texi:2635
  4359. msgid "Matches one of the given patterns."
  4360. msgstr ""
  4361. #. type: item
  4362. #: ./bashref.texi:2636
  4363. #, no-wrap
  4364. msgid "!(@var{pattern-list})"
  4365. msgstr ""
  4366. #. type: table
  4367. #: ./bashref.texi:2638
  4368. msgid "Matches anything except one of the given patterns."
  4369. msgstr ""
  4370. #. type: Plain text
  4371. #: ./bashref.texi:2645
  4372. msgid ""
  4373. "Complicated extended pattern matching against long strings is slow, "
  4374. "especially when the patterns contain alternations and the strings contain "
  4375. "multiple matches. Using separate matches against shorter strings, or using "
  4376. "arrays of strings instead of a single long string, may be faster."
  4377. msgstr ""
  4378. #. type: Plain text
  4379. #: ./bashref.texi:2652
  4380. msgid ""
  4381. "After the preceding expansions, all unquoted occurrences of the characters "
  4382. "@samp{\\}, @samp{'}, and @samp{\"} that did not result from one of the above "
  4383. "expansions are removed."
  4384. msgstr ""
  4385. #. type: cindex
  4386. #: ./bashref.texi:2655
  4387. #, no-wrap
  4388. msgid "redirection"
  4389. msgstr ""
  4390. #. type: Plain text
  4391. #: ./bashref.texi:2670
  4392. msgid ""
  4393. "Before a command is executed, its input and output may be @var{redirected} "
  4394. "using a special notation interpreted by the shell. Redirection allows "
  4395. "commands' file handles to be duplicated, opened, closed, made to refer to "
  4396. "different files, and can change the files the command reads from and writes "
  4397. "to. Redirection may also be used to modify file handles in the current "
  4398. "shell execution environment. The following redirection operators may "
  4399. "precede or appear anywhere within a simple command or may follow a command. "
  4400. "Redirections are processed in the order they appear, from left to right."
  4401. msgstr ""
  4402. #. type: Plain text
  4403. #: ./bashref.texi:2681
  4404. msgid ""
  4405. "Each redirection that may be preceded by a file descriptor number may "
  4406. "instead be preceded by a word of the form @{@var{varname}@}. In this case, "
  4407. "for each redirection operator except >&- and <&-, the shell will allocate a "
  4408. "file descriptor greater than 10 and assign it to @{@var{varname}@}. If >&- "
  4409. "or <&- is preceded by @{@var{varname}@}, the value of @var{varname} defines "
  4410. "the file descriptor to close. If @{@var{varname}@} is supplied, the "
  4411. "redirection persists beyond the scope of the command, allowing the shell "
  4412. "programmer to manage the file descriptor himself."
  4413. msgstr ""
  4414. #. type: Plain text
  4415. #: ./bashref.texi:2688
  4416. msgid ""
  4417. "In the following descriptions, if the file descriptor number is omitted, and "
  4418. "the first character of the redirection operator is @samp{<}, the redirection "
  4419. "refers to the standard input (file descriptor 0). If the first character of "
  4420. "the redirection operator is @samp{>}, the redirection refers to the standard "
  4421. "output (file descriptor 1)."
  4422. msgstr ""
  4423. #. type: Plain text
  4424. #: ./bashref.texi:2694
  4425. msgid ""
  4426. "The word following the redirection operator in the following descriptions, "
  4427. "unless otherwise noted, is subjected to brace expansion, tilde expansion, "
  4428. "parameter expansion, command substitution, arithmetic expansion, quote "
  4429. "removal, filename expansion, and word splitting. If it expands to more than "
  4430. "one word, Bash reports an error."
  4431. msgstr ""
  4432. #. type: Plain text
  4433. #: ./bashref.texi:2697
  4434. msgid ""
  4435. "Note that the order of redirections is significant. For example, the "
  4436. "command"
  4437. msgstr ""
  4438. #. type: example
  4439. #: ./bashref.texi:2699
  4440. #, no-wrap
  4441. msgid "ls > @var{dirlist} 2>&1\n"
  4442. msgstr ""
  4443. #. type: Plain text
  4444. #: ./bashref.texi:2703
  4445. msgid ""
  4446. "directs both standard output (file descriptor 1) and standard error (file "
  4447. "descriptor 2) to the file @var{dirlist}, while the command"
  4448. msgstr ""
  4449. #. type: example
  4450. #: ./bashref.texi:2705
  4451. #, no-wrap
  4452. msgid "ls 2>&1 > @var{dirlist}\n"
  4453. msgstr ""
  4454. #. type: Plain text
  4455. #: ./bashref.texi:2710
  4456. msgid ""
  4457. "directs only the standard output to file @var{dirlist}, because the standard "
  4458. "error was made a copy of the standard output before the standard output was "
  4459. "redirected to @var{dirlist}."
  4460. msgstr ""
  4461. #. type: Plain text
  4462. #: ./bashref.texi:2716
  4463. msgid ""
  4464. "Bash handles several filenames specially when they are used in redirections, "
  4465. "as described in the following table. If the operating system on which Bash "
  4466. "is running provides these special files, bash will use them; otherwise it "
  4467. "will emulate them internally with the behavior described below."
  4468. msgstr ""
  4469. #. type: item
  4470. #: ./bashref.texi:2718
  4471. #, no-wrap
  4472. msgid "/dev/fd/@var{fd}"
  4473. msgstr ""
  4474. #. type: table
  4475. #: ./bashref.texi:2720
  4476. msgid "If @var{fd} is a valid integer, file descriptor @var{fd} is duplicated."
  4477. msgstr ""
  4478. #. type: item
  4479. #: ./bashref.texi:2721
  4480. #, no-wrap
  4481. msgid "/dev/stdin"
  4482. msgstr ""
  4483. #. type: table
  4484. #: ./bashref.texi:2723
  4485. msgid "File descriptor 0 is duplicated."
  4486. msgstr ""
  4487. #. type: item
  4488. #: ./bashref.texi:2724
  4489. #, no-wrap
  4490. msgid "/dev/stdout"
  4491. msgstr ""
  4492. #. type: table
  4493. #: ./bashref.texi:2726
  4494. msgid "File descriptor 1 is duplicated."
  4495. msgstr ""
  4496. #. type: item
  4497. #: ./bashref.texi:2727
  4498. #, no-wrap
  4499. msgid "/dev/stderr"
  4500. msgstr ""
  4501. #. type: table
  4502. #: ./bashref.texi:2729
  4503. msgid "File descriptor 2 is duplicated."
  4504. msgstr ""
  4505. #. type: item
  4506. #: ./bashref.texi:2730
  4507. #, no-wrap
  4508. msgid "/dev/tcp/@var{host}/@var{port}"
  4509. msgstr ""
  4510. #. type: table
  4511. #: ./bashref.texi:2734
  4512. msgid ""
  4513. "If @var{host} is a valid hostname or Internet address, and @var{port} is an "
  4514. "integer port number or service name, Bash attempts to open the corresponding "
  4515. "TCP socket."
  4516. msgstr ""
  4517. #. type: item
  4518. #: ./bashref.texi:2735
  4519. #, no-wrap
  4520. msgid "/dev/udp/@var{host}/@var{port}"
  4521. msgstr ""
  4522. #. type: table
  4523. #: ./bashref.texi:2739
  4524. msgid ""
  4525. "If @var{host} is a valid hostname or Internet address, and @var{port} is an "
  4526. "integer port number or service name, Bash attempts to open the corresponding "
  4527. "UDP socket."
  4528. msgstr ""
  4529. #. type: Plain text
  4530. #: ./bashref.texi:2742
  4531. msgid "A failure to open or create a file causes the redirection to fail."
  4532. msgstr ""
  4533. #. type: Plain text
  4534. #: ./bashref.texi:2746
  4535. msgid ""
  4536. "Redirections using file descriptors greater than 9 should be used with care, "
  4537. "as they may conflict with file descriptors the shell uses internally."
  4538. msgstr ""
  4539. #. type: subsection
  4540. #: ./bashref.texi:2747
  4541. #, no-wrap
  4542. msgid "Redirecting Input"
  4543. msgstr ""
  4544. #. type: Plain text
  4545. #: ./bashref.texi:2753
  4546. msgid ""
  4547. "Redirection of input causes the file whose name results from the expansion "
  4548. "of @var{word} to be opened for reading on file descriptor @code{n}, or the "
  4549. "standard input (file descriptor 0) if @code{n} is not specified."
  4550. msgstr ""
  4551. #. type: Plain text
  4552. #: ./bashref.texi:2755
  4553. msgid "The general format for redirecting input is:"
  4554. msgstr ""
  4555. #. type: example
  4556. #: ./bashref.texi:2757
  4557. #, no-wrap
  4558. msgid "[@var{n}]<@var{word}\n"
  4559. msgstr ""
  4560. #. type: subsection
  4561. #: ./bashref.texi:2759
  4562. #, no-wrap
  4563. msgid "Redirecting Output"
  4564. msgstr ""
  4565. #. type: Plain text
  4566. #: ./bashref.texi:2766
  4567. msgid ""
  4568. "Redirection of output causes the file whose name results from the expansion "
  4569. "of @var{word} to be opened for writing on file descriptor @var{n}, or the "
  4570. "standard output (file descriptor 1) if @var{n} is not specified. If the "
  4571. "file does not exist it is created; if it does exist it is truncated to zero "
  4572. "size."
  4573. msgstr ""
  4574. #. type: Plain text
  4575. #: ./bashref.texi:2768
  4576. msgid "The general format for redirecting output is:"
  4577. msgstr ""
  4578. #. type: example
  4579. #: ./bashref.texi:2770
  4580. #, no-wrap
  4581. msgid "[@var{n}]>[|]@var{word}\n"
  4582. msgstr ""
  4583. #. type: Plain text
  4584. #: ./bashref.texi:2779
  4585. msgid ""
  4586. "If the redirection operator is @samp{>}, and the @code{noclobber} option to "
  4587. "the @code{set} builtin has been enabled, the redirection will fail if the "
  4588. "file whose name results from the expansion of @var{word} exists and is a "
  4589. "regular file. If the redirection operator is @samp{>|}, or the redirection "
  4590. "operator is @samp{>} and the @code{noclobber} option is not enabled, the "
  4591. "redirection is attempted even if the file named by @var{word} exists."
  4592. msgstr ""
  4593. #. type: subsection
  4594. #: ./bashref.texi:2780
  4595. #, no-wrap
  4596. msgid "Appending Redirected Output"
  4597. msgstr ""
  4598. #. type: Plain text
  4599. #: ./bashref.texi:2787
  4600. msgid ""
  4601. "Redirection of output in this fashion causes the file whose name results "
  4602. "from the expansion of @var{word} to be opened for appending on file "
  4603. "descriptor @var{n}, or the standard output (file descriptor 1) if @var{n} is "
  4604. "not specified. If the file does not exist it is created."
  4605. msgstr ""
  4606. #. type: Plain text
  4607. #: ./bashref.texi:2789
  4608. msgid "The general format for appending output is:"
  4609. msgstr ""
  4610. #. type: example
  4611. #: ./bashref.texi:2791
  4612. #, no-wrap
  4613. msgid "[@var{n}]>>@var{word}\n"
  4614. msgstr ""
  4615. #. type: subsection
  4616. #: ./bashref.texi:2793
  4617. #, no-wrap
  4618. msgid "Redirecting Standard Output and Standard Error"
  4619. msgstr ""
  4620. #. type: Plain text
  4621. #: ./bashref.texi:2799
  4622. msgid ""
  4623. "This construct allows both the standard output (file descriptor 1) and the "
  4624. "standard error output (file descriptor 2) to be redirected to the file "
  4625. "whose name is the expansion of @var{word}."
  4626. msgstr ""
  4627. #. type: Plain text
  4628. #: ./bashref.texi:2802
  4629. msgid "There are two formats for redirecting standard output and standard error:"
  4630. msgstr ""
  4631. #. type: example
  4632. #: ./bashref.texi:2804
  4633. #, no-wrap
  4634. msgid "&>@var{word}\n"
  4635. msgstr ""
  4636. #. type: Plain text
  4637. #: ./bashref.texi:2807
  4638. msgid "and"
  4639. msgstr ""
  4640. #. type: example
  4641. #: ./bashref.texi:2809
  4642. #, no-wrap
  4643. msgid ">&@var{word}\n"
  4644. msgstr ""
  4645. #. type: Plain text
  4646. #: ./bashref.texi:2813
  4647. msgid ""
  4648. "Of the two forms, the first is preferred. This is semantically equivalent "
  4649. "to"
  4650. msgstr ""
  4651. #. type: example
  4652. #: ./bashref.texi:2815
  4653. #, no-wrap
  4654. msgid ">@var{word} 2>&1\n"
  4655. msgstr ""
  4656. #. type: Plain text
  4657. #: ./bashref.texi:2819
  4658. msgid ""
  4659. "When using the second form, @var{word} may not expand to a number or "
  4660. "@samp{-}. If it does, other redirection operators apply (see Duplicating "
  4661. "File Descriptors below) for compatibility reasons."
  4662. msgstr ""
  4663. #. type: subsection
  4664. #: ./bashref.texi:2820
  4665. #, no-wrap
  4666. msgid "Appending Standard Output and Standard Error"
  4667. msgstr ""
  4668. #. type: Plain text
  4669. #: ./bashref.texi:2826
  4670. msgid ""
  4671. "This construct allows both the standard output (file descriptor 1) and the "
  4672. "standard error output (file descriptor 2) to be appended to the file whose "
  4673. "name is the expansion of @var{word}."
  4674. msgstr ""
  4675. #. type: Plain text
  4676. #: ./bashref.texi:2828
  4677. msgid "The format for appending standard output and standard error is:"
  4678. msgstr ""
  4679. #. type: example
  4680. #: ./bashref.texi:2830
  4681. #, no-wrap
  4682. msgid "&>>@var{word}\n"
  4683. msgstr ""
  4684. #. type: Plain text
  4685. #: ./bashref.texi:2833
  4686. msgid "This is semantically equivalent to"
  4687. msgstr ""
  4688. #. type: example
  4689. #: ./bashref.texi:2835
  4690. #, no-wrap
  4691. msgid ">>@var{word} 2>&1\n"
  4692. msgstr ""
  4693. #. type: Plain text
  4694. #: ./bashref.texi:2837
  4695. msgid "(see Duplicating File Descriptors below)."
  4696. msgstr ""
  4697. #. type: subsection
  4698. #: ./bashref.texi:2838
  4699. #, no-wrap
  4700. msgid "Here Documents"
  4701. msgstr ""
  4702. #. type: Plain text
  4703. #: ./bashref.texi:2844
  4704. msgid ""
  4705. "This type of redirection instructs the shell to read input from the current "
  4706. "source until a line containing only @var{word} (with no trailing blanks) is "
  4707. "seen. All of the lines read up to that point are then used as the standard "
  4708. "input (or file descriptor @var{n} if @var{n} is specified) for a command."
  4709. msgstr ""
  4710. #. type: Plain text
  4711. #: ./bashref.texi:2846
  4712. msgid "The format of here-documents is:"
  4713. msgstr ""
  4714. #. type: example
  4715. #: ./bashref.texi:2850
  4716. #, no-wrap
  4717. msgid ""
  4718. "[@var{n}]<<[@minus{}]@var{word}\n"
  4719. " @var{here-document}\n"
  4720. "@var{delimiter}\n"
  4721. msgstr ""
  4722. #. type: Plain text
  4723. #: ./bashref.texi:2863
  4724. msgid ""
  4725. "No parameter and variable expansion, command substitution, arithmetic "
  4726. "expansion, or filename expansion is performed on @var{word}. If any part of "
  4727. "@var{word} is quoted, the @var{delimiter} is the result of quote removal on "
  4728. "@var{word}, and the lines in the here-document are not expanded. If "
  4729. "@var{word} is unquoted, all lines of the here-document are subjected to "
  4730. "parameter expansion, command substitution, and arithmetic expansion, the "
  4731. "character sequence @code{\\newline} is ignored, and @samp{\\} must be used "
  4732. "to quote the characters @samp{\\}, @samp{$}, and @samp{`}."
  4733. msgstr ""
  4734. #. type: Plain text
  4735. #: ./bashref.texi:2869
  4736. msgid ""
  4737. "If the redirection operator is @samp{<<-}, then all leading tab characters "
  4738. "are stripped from input lines and the line containing @var{delimiter}. This "
  4739. "allows here-documents within shell scripts to be indented in a natural "
  4740. "fashion."
  4741. msgstr ""
  4742. #. type: subsection
  4743. #: ./bashref.texi:2870
  4744. #, no-wrap
  4745. msgid "Here Strings"
  4746. msgstr ""
  4747. #. type: Plain text
  4748. #: ./bashref.texi:2872
  4749. msgid "A variant of here documents, the format is:"
  4750. msgstr ""
  4751. #. type: example
  4752. #: ./bashref.texi:2874
  4753. #, no-wrap
  4754. msgid "[@var{n}]<<< @var{word}\n"
  4755. msgstr ""
  4756. #. type: Plain text
  4757. #: ./bashref.texi:2884
  4758. msgid ""
  4759. "The @var{word} undergoes tilde expansion, parameter and variable expansion, "
  4760. "command substitution, arithmetic expansion, and quote removal. Pathname "
  4761. "expansion and word splitting are not performed. The result is supplied as a "
  4762. "single string, with a newline appended, to the command on its standard input "
  4763. "(or file descriptor @var{n} if @var{n} is specified)."
  4764. msgstr ""
  4765. #. type: subsection
  4766. #: ./bashref.texi:2885
  4767. #, no-wrap
  4768. msgid "Duplicating File Descriptors"
  4769. msgstr ""
  4770. #. type: Plain text
  4771. #: ./bashref.texi:2887 ./bashref.texi:2918 ./bashref.texi:2936
  4772. msgid "The redirection operator"
  4773. msgstr ""
  4774. #. type: example
  4775. #: ./bashref.texi:2889
  4776. #, no-wrap
  4777. msgid "[@var{n}]<&@var{word}\n"
  4778. msgstr ""
  4779. #. type: Plain text
  4780. #: ./bashref.texi:2900
  4781. msgid ""
  4782. "is used to duplicate input file descriptors. If @var{word} expands to one "
  4783. "or more digits, the file descriptor denoted by @var{n} is made to be a copy "
  4784. "of that file descriptor. If the digits in @var{word} do not specify a file "
  4785. "descriptor open for input, a redirection error occurs. If @var{word} "
  4786. "evaluates to @samp{-}, file descriptor @var{n} is closed. If @var{n} is not "
  4787. "specified, the standard input (file descriptor 0) is used."
  4788. msgstr ""
  4789. #. type: Plain text
  4790. #: ./bashref.texi:2902
  4791. msgid "The operator"
  4792. msgstr ""
  4793. #. type: example
  4794. #: ./bashref.texi:2904
  4795. #, no-wrap
  4796. msgid "[@var{n}]>&@var{word}\n"
  4797. msgstr ""
  4798. #. type: Plain text
  4799. #: ./bashref.texi:2915
  4800. msgid ""
  4801. "is used similarly to duplicate output file descriptors. If @var{n} is not "
  4802. "specified, the standard output (file descriptor 1) is used. If the digits "
  4803. "in @var{word} do not specify a file descriptor open for output, a "
  4804. "redirection error occurs. If @var{word} evaluates to @samp{-}, file "
  4805. "descriptor @var{n} is closed. As a special case, if @var{n} is omitted, and "
  4806. "@var{word} does not expand to one or more digits or @samp{-}, the standard "
  4807. "output and standard error are redirected as described previously."
  4808. msgstr ""
  4809. #. type: subsection
  4810. #: ./bashref.texi:2916
  4811. #, no-wrap
  4812. msgid "Moving File Descriptors"
  4813. msgstr ""
  4814. #. type: example
  4815. #: ./bashref.texi:2920
  4816. #, no-wrap
  4817. msgid "[@var{n}]<&@var{digit}-\n"
  4818. msgstr ""
  4819. #. type: Plain text
  4820. #: ./bashref.texi:2925
  4821. msgid ""
  4822. "moves the file descriptor @var{digit} to file descriptor @var{n}, or the "
  4823. "standard input (file descriptor 0) if @var{n} is not specified. @var{digit} "
  4824. "is closed after being duplicated to @var{n}."
  4825. msgstr ""
  4826. #. type: Plain text
  4827. #: ./bashref.texi:2927
  4828. msgid "Similarly, the redirection operator"
  4829. msgstr ""
  4830. #. type: example
  4831. #: ./bashref.texi:2929
  4832. #, no-wrap
  4833. msgid "[@var{n}]>&@var{digit}-\n"
  4834. msgstr ""
  4835. #. type: Plain text
  4836. #: ./bashref.texi:2933
  4837. msgid ""
  4838. "moves the file descriptor @var{digit} to file descriptor @var{n}, or the "
  4839. "standard output (file descriptor 1) if @var{n} is not specified."
  4840. msgstr ""
  4841. #. type: subsection
  4842. #: ./bashref.texi:2934
  4843. #, no-wrap
  4844. msgid "Opening File Descriptors for Reading and Writing"
  4845. msgstr ""
  4846. #. type: example
  4847. #: ./bashref.texi:2938
  4848. #, no-wrap
  4849. msgid "[@var{n}]<>@var{word}\n"
  4850. msgstr ""
  4851. #. type: Plain text
  4852. #: ./bashref.texi:2944
  4853. msgid ""
  4854. "causes the file whose name is the expansion of @var{word} to be opened for "
  4855. "both reading and writing on file descriptor @var{n}, or on file descriptor 0 "
  4856. "if @var{n} is not specified. If the file does not exist, it is created."
  4857. msgstr ""
  4858. #. type: subsection
  4859. #: ./bashref.texi:2960 ./bashref.texi:2962 ./bashref.texi:2963
  4860. #, no-wrap
  4861. msgid "Simple Command Expansion"
  4862. msgstr ""
  4863. #. type: menuentry
  4864. #: ./bashref.texi:2960
  4865. msgid "How Bash expands simple commands before executing them."
  4866. msgstr ""
  4867. #. type: subsection
  4868. #: ./bashref.texi:2960 ./bashref.texi:3007 ./bashref.texi:3008
  4869. #, no-wrap
  4870. msgid "Command Search and Execution"
  4871. msgstr ""
  4872. #. type: menuentry
  4873. #: ./bashref.texi:2960
  4874. msgid "How Bash finds commands and runs them."
  4875. msgstr ""
  4876. #. type: subsection
  4877. #: ./bashref.texi:2960 ./bashref.texi:3064 ./bashref.texi:3065
  4878. #, no-wrap
  4879. msgid "Command Execution Environment"
  4880. msgstr ""
  4881. #. type: menuentry
  4882. #: ./bashref.texi:2960
  4883. msgid "The environment in which Bash executes commands that are not shell builtins."
  4884. msgstr ""
  4885. #. type: subsection
  4886. #: ./bashref.texi:2960 ./bashref.texi:3160 ./bashref.texi:3161
  4887. #, no-wrap
  4888. msgid "Environment"
  4889. msgstr ""
  4890. #. type: menuentry
  4891. #: ./bashref.texi:2960
  4892. msgid "The environment given to a command."
  4893. msgstr ""
  4894. #. type: subsection
  4895. #: ./bashref.texi:2960 ./bashref.texi:3198 ./bashref.texi:3199
  4896. #, no-wrap
  4897. msgid "Exit Status"
  4898. msgstr ""
  4899. #. type: menuentry
  4900. #: ./bashref.texi:2960
  4901. msgid "The status returned by commands and how Bash interprets it."
  4902. msgstr ""
  4903. #. type: subsection
  4904. #: ./bashref.texi:2960 ./bashref.texi:3236 ./bashref.texi:3237
  4905. #, no-wrap
  4906. msgid "Signals"
  4907. msgstr ""
  4908. #. type: menuentry
  4909. #: ./bashref.texi:2960
  4910. msgid "What happens when Bash or a command it runs receives a signal."
  4911. msgstr ""
  4912. #. type: cindex
  4913. #: ./bashref.texi:2964
  4914. #, no-wrap
  4915. msgid "command expansion"
  4916. msgstr ""
  4917. #. type: Plain text
  4918. #: ./bashref.texi:2968
  4919. msgid ""
  4920. "When a simple command is executed, the shell performs the following "
  4921. "expansions, assignments, and redirections, from left to right."
  4922. msgstr ""
  4923. #. type: enumerate
  4924. #: ./bashref.texi:2974
  4925. msgid ""
  4926. "The words that the parser has marked as variable assignments (those "
  4927. "preceding the command name) and redirections are saved for later processing."
  4928. msgstr ""
  4929. #. type: enumerate
  4930. #: ./bashref.texi:2981
  4931. msgid ""
  4932. "The words that are not variable assignments or redirections are expanded "
  4933. "(@pxref{Shell Expansions}). If any words remain after expansion, the first "
  4934. "word is taken to be the name of the command and the remaining words are the "
  4935. "arguments."
  4936. msgstr ""
  4937. #. type: enumerate
  4938. #: ./bashref.texi:2984
  4939. msgid "Redirections are performed as described above (@pxref{Redirections})."
  4940. msgstr ""
  4941. #. type: enumerate
  4942. #: ./bashref.texi:2989
  4943. msgid ""
  4944. "The text after the @samp{=} in each variable assignment undergoes tilde "
  4945. "expansion, parameter expansion, command substitution, arithmetic expansion, "
  4946. "and quote removal before being assigned to the variable."
  4947. msgstr ""
  4948. #. type: Plain text
  4949. #: ./bashref.texi:2996
  4950. msgid ""
  4951. "If no command name results, the variable assignments affect the current "
  4952. "shell environment. Otherwise, the variables are added to the environment of "
  4953. "the executed command and do not affect the current shell environment. If "
  4954. "any of the assignments attempts to assign a value to a readonly variable, an "
  4955. "error occurs, and the command exits with a non-zero status."
  4956. msgstr ""
  4957. #. type: Plain text
  4958. #: ./bashref.texi:3000
  4959. msgid ""
  4960. "If no command name results, redirections are performed, but do not affect "
  4961. "the current shell environment. A redirection error causes the command to "
  4962. "exit with a non-zero status."
  4963. msgstr ""
  4964. #. type: Plain text
  4965. #: ./bashref.texi:3006
  4966. msgid ""
  4967. "If there is a command name left after expansion, execution proceeds as "
  4968. "described below. Otherwise, the command exits. If one of the expansions "
  4969. "contained a command substitution, the exit status of the command is the exit "
  4970. "status of the last command substitution performed. If there were no command "
  4971. "substitutions, the command exits with a status of zero."
  4972. msgstr ""
  4973. #. type: cindex
  4974. #: ./bashref.texi:3009
  4975. #, no-wrap
  4976. msgid "command execution"
  4977. msgstr ""
  4978. #. type: cindex
  4979. #: ./bashref.texi:3010
  4980. #, no-wrap
  4981. msgid "command search"
  4982. msgstr ""
  4983. #. type: Plain text
  4984. #: ./bashref.texi:3015
  4985. msgid ""
  4986. "After a command has been split into words, if it results in a simple command "
  4987. "and an optional list of arguments, the following actions are taken."
  4988. msgstr ""
  4989. #. type: enumerate
  4990. #: ./bashref.texi:3021
  4991. msgid ""
  4992. "If the command name contains no slashes, the shell attempts to locate it. "
  4993. "If there exists a shell function by that name, that function is invoked as "
  4994. "described in @ref{Shell Functions}."
  4995. msgstr ""
  4996. #. type: enumerate
  4997. #: ./bashref.texi:3026
  4998. msgid ""
  4999. "If the name does not match a function, the shell searches for it in the list "
  5000. "of shell builtins. If a match is found, that builtin is invoked."
  5001. msgstr ""
  5002. #. type: enumerate
  5003. #: ./bashref.texi:3044
  5004. msgid ""
  5005. "If the name is neither a shell function nor a builtin, and contains no "
  5006. "slashes, Bash searches each element of @env{$PATH} for a directory "
  5007. "containing an executable file by that name. Bash uses a hash table to "
  5008. "remember the full pathnames of executable files to avoid multiple @env{PATH} "
  5009. "searches (see the description of @code{hash} in @ref{Bourne Shell "
  5010. "Builtins}). A full search of the directories in @env{$PATH} is performed "
  5011. "only if the command is not found in the hash table. If the search is "
  5012. "unsuccessful, the shell searches for a defined shell function named "
  5013. "@code{command_not_found_handle}. If that function exists, it is invoked in "
  5014. "a separate execution environment with the original command and the original "
  5015. "command's arguments as its arguments, and the function's exit status becomes "
  5016. "the exit status of that subshell. If that function is not defined, the "
  5017. "shell prints an error message and returns an exit status of 127."
  5018. msgstr ""
  5019. #. type: enumerate
  5020. #: ./bashref.texi:3051
  5021. msgid ""
  5022. "If the search is successful, or if the command name contains one or more "
  5023. "slashes, the shell executes the named program in a separate execution "
  5024. "environment. Argument 0 is set to the name given, and the remaining "
  5025. "arguments to the command are set to the arguments supplied, if any."
  5026. msgstr ""
  5027. #. type: enumerate
  5028. #: ./bashref.texi:3057
  5029. msgid ""
  5030. "If this execution fails because the file is not in executable format, and "
  5031. "the file is not a directory, it is assumed to be a @var{shell script} and "
  5032. "the shell executes it as described in @ref{Shell Scripts}."
  5033. msgstr ""
  5034. #. type: enumerate
  5035. #: ./bashref.texi:3061
  5036. msgid ""
  5037. "If the command was not begun asynchronously, the shell waits for the command "
  5038. "to complete and collects its exit status."
  5039. msgstr ""
  5040. #. type: cindex
  5041. #: ./bashref.texi:3066
  5042. #, no-wrap
  5043. msgid "execution environment"
  5044. msgstr ""
  5045. #. type: Plain text
  5046. #: ./bashref.texi:3070
  5047. msgid ""
  5048. "The shell has an @var{execution environment}, which consists of the "
  5049. "following:"
  5050. msgstr ""
  5051. #. type: itemize
  5052. #: ./bashref.texi:3075
  5053. msgid ""
  5054. "open files inherited by the shell at invocation, as modified by redirections "
  5055. "supplied to the @code{exec} builtin"
  5056. msgstr ""
  5057. #. type: itemize
  5058. #: ./bashref.texi:3079
  5059. msgid ""
  5060. "the current working directory as set by @code{cd}, @code{pushd}, or "
  5061. "@code{popd}, or inherited by the shell at invocation"
  5062. msgstr ""
  5063. #. type: itemize
  5064. #: ./bashref.texi:3083
  5065. msgid ""
  5066. "the file creation mode mask as set by @code{umask} or inherited from the "
  5067. "shell's parent"
  5068. msgstr ""
  5069. #. type: itemize
  5070. #: ./bashref.texi:3086
  5071. msgid "current traps set by @code{trap}"
  5072. msgstr ""
  5073. #. type: itemize
  5074. #: ./bashref.texi:3090
  5075. msgid ""
  5076. "shell parameters that are set by variable assignment or with @code{set} or "
  5077. "inherited from the shell's parent in the environment"
  5078. msgstr ""
  5079. #. type: itemize
  5080. #: ./bashref.texi:3094
  5081. msgid ""
  5082. "shell functions defined during execution or inherited from the shell's "
  5083. "parent in the environment"
  5084. msgstr ""
  5085. #. type: itemize
  5086. #: ./bashref.texi:3098
  5087. msgid ""
  5088. "options enabled at invocation (either by default or with command-line "
  5089. "arguments) or by @code{set}"
  5090. msgstr ""
  5091. #. type: itemize
  5092. #: ./bashref.texi:3101
  5093. msgid "options enabled by @code{shopt} (@pxref{The Shopt Builtin})"
  5094. msgstr ""
  5095. #. type: itemize
  5096. #: ./bashref.texi:3104
  5097. msgid "shell aliases defined with @code{alias} (@pxref{Aliases})"
  5098. msgstr ""
  5099. #. type: itemize
  5100. #: ./bashref.texi:3109
  5101. msgid ""
  5102. "various process @sc{id}s, including those of background jobs "
  5103. "(@pxref{Lists}), the value of @code{$$}, and the value of @env{$PPID}"
  5104. msgstr ""
  5105. #. type: Plain text
  5106. #: ./bashref.texi:3117
  5107. msgid ""
  5108. "When a simple command other than a builtin or shell function is to be "
  5109. "executed, it is invoked in a separate execution environment that consists of "
  5110. "the following. Unless otherwise noted, the values are inherited from the "
  5111. "shell."
  5112. msgstr ""
  5113. #. type: itemize
  5114. #: ./bashref.texi:3122
  5115. msgid ""
  5116. "the shell's open files, plus any modifications and additions specified by "
  5117. "redirections to the command"
  5118. msgstr ""
  5119. #. type: itemize
  5120. #: ./bashref.texi:3125
  5121. msgid "the current working directory"
  5122. msgstr ""
  5123. #. type: itemize
  5124. #: ./bashref.texi:3128
  5125. msgid "the file creation mode mask"
  5126. msgstr ""
  5127. #. type: itemize
  5128. #: ./bashref.texi:3132
  5129. msgid ""
  5130. "shell variables and functions marked for export, along with variables "
  5131. "exported for the command, passed in the environment (@pxref{Environment})"
  5132. msgstr ""
  5133. #. type: itemize
  5134. #: ./bashref.texi:3136
  5135. msgid ""
  5136. "traps caught by the shell are reset to the values inherited from the shell's "
  5137. "parent, and traps ignored by the shell are ignored"
  5138. msgstr ""
  5139. #. type: Plain text
  5140. #: ./bashref.texi:3141
  5141. msgid ""
  5142. "A command invoked in this separate environment cannot affect the shell's "
  5143. "execution environment."
  5144. msgstr ""
  5145. #. type: Plain text
  5146. #: ./bashref.texi:3150
  5147. msgid ""
  5148. "Command substitution, commands grouped with parentheses, and asynchronous "
  5149. "commands are invoked in a subshell environment that is a duplicate of the "
  5150. "shell environment, except that traps caught by the shell are reset to the "
  5151. "values that the shell inherited from its parent at invocation. Builtin "
  5152. "commands that are invoked as part of a pipeline are also executed in a "
  5153. "subshell environment. Changes made to the subshell environment cannot "
  5154. "affect the shell's execution environment."
  5155. msgstr ""
  5156. #. type: Plain text
  5157. #: ./bashref.texi:3154
  5158. msgid ""
  5159. "Subshells spawned to execute command substitutions inherit the value of the "
  5160. "@option{-e} option from the parent shell. When not in @sc{posix} mode, Bash "
  5161. "clears the @option{-e} option in such subshells."
  5162. msgstr ""
  5163. #. type: Plain text
  5164. #: ./bashref.texi:3159
  5165. msgid ""
  5166. "If a command is followed by a @samp{&} and job control is not active, the "
  5167. "default standard input for the command is the empty file @file{/dev/null}. "
  5168. "Otherwise, the invoked command inherits the file descriptors of the calling "
  5169. "shell as modified by redirections."
  5170. msgstr ""
  5171. #. type: cindex
  5172. #: ./bashref.texi:3162
  5173. #, no-wrap
  5174. msgid "environment"
  5175. msgstr ""
  5176. #. type: Plain text
  5177. #: ./bashref.texi:3167
  5178. msgid ""
  5179. "When a program is invoked it is given an array of strings called the "
  5180. "@var{environment}. This is a list of name-value pairs, of the form "
  5181. "@code{name=value}."
  5182. msgstr ""
  5183. #. type: Plain text
  5184. #: ./bashref.texi:3183
  5185. msgid ""
  5186. "Bash provides several ways to manipulate the environment. On invocation, "
  5187. "the shell scans its own environment and creates a parameter for each name "
  5188. "found, automatically marking it for @var{export} to child processes. "
  5189. "Executed commands inherit the environment. The @code{export} and "
  5190. "@samp{declare -x} commands allow parameters and functions to be added to and "
  5191. "deleted from the environment. If the value of a parameter in the "
  5192. "environment is modified, the new value becomes part of the environment, "
  5193. "replacing the old. The environment inherited by any executed command "
  5194. "consists of the shell's initial environment, whose values may be modified in "
  5195. "the shell, less any pairs removed by the @code{unset} and @samp{export -n} "
  5196. "commands, plus any additions via the @code{export} and @samp{declare -x} "
  5197. "commands."
  5198. msgstr ""
  5199. #. type: Plain text
  5200. #: ./bashref.texi:3189
  5201. msgid ""
  5202. "The environment for any simple command or function may be augmented "
  5203. "temporarily by prefixing it with parameter assignments, as described in "
  5204. "@ref{Shell Parameters}. These assignment statements affect only the "
  5205. "environment seen by that command."
  5206. msgstr ""
  5207. #. type: Plain text
  5208. #: ./bashref.texi:3193
  5209. msgid ""
  5210. "If the @option{-k} option is set (@pxref{The Set Builtin}), then all "
  5211. "parameter assignments are placed in the environment for a command, not just "
  5212. "those that precede the command name."
  5213. msgstr ""
  5214. #. type: Plain text
  5215. #: ./bashref.texi:3197
  5216. msgid ""
  5217. "When Bash invokes an external command, the variable @samp{$_} is set to the "
  5218. "full pathname of the command and passed to that command in its environment."
  5219. msgstr ""
  5220. #. type: Plain text
  5221. #: ./bashref.texi:3209
  5222. msgid ""
  5223. "The exit status of an executed command is the value returned by the "
  5224. "@var{waitpid} system call or equivalent function. Exit statuses fall "
  5225. "between 0 and 255, though, as explained below, the shell may use values "
  5226. "above 125 specially. Exit statuses from shell builtins and compound "
  5227. "commands are also limited to this range. Under certain circumstances, the "
  5228. "shell will use special values to indicate specific failure modes."
  5229. msgstr ""
  5230. #. type: Plain text
  5231. #: ./bashref.texi:3218
  5232. msgid ""
  5233. "For the shell's purposes, a command which exits with a zero exit status has "
  5234. "succeeded. A non-zero exit status indicates failure. This seemingly "
  5235. "counter-intuitive scheme is used so there is one well-defined way to "
  5236. "indicate success and a variety of ways to indicate various failure modes. "
  5237. "When a command terminates on a fatal signal whose number is @var{N}, Bash "
  5238. "uses the value 128+@var{N} as the exit status."
  5239. msgstr ""
  5240. #. type: Plain text
  5241. #: ./bashref.texi:3222
  5242. msgid ""
  5243. "If a command is not found, the child process created to execute it returns a "
  5244. "status of 127. If a command is found but is not executable, the return "
  5245. "status is 126."
  5246. msgstr ""
  5247. #. type: Plain text
  5248. #: ./bashref.texi:3225
  5249. msgid ""
  5250. "If a command fails because of an error during expansion or redirection, the "
  5251. "exit status is greater than zero."
  5252. msgstr ""
  5253. #. type: Plain text
  5254. #: ./bashref.texi:3229
  5255. msgid ""
  5256. "The exit status is used by the Bash conditional commands (@pxref{Conditional "
  5257. "Constructs}) and some of the list constructs (@pxref{Lists})."
  5258. msgstr ""
  5259. #. type: Plain text
  5260. #: ./bashref.texi:3235
  5261. msgid ""
  5262. "All of the Bash builtins return an exit status of zero if they succeed and a "
  5263. "non-zero status on failure, so they may be used by the conditional and list "
  5264. "constructs. All builtins return an exit status of 2 to indicate incorrect "
  5265. "usage, generally invalid options or missing arguments."
  5266. msgstr ""
  5267. #. type: cindex
  5268. #: ./bashref.texi:3238
  5269. #, no-wrap
  5270. msgid "signal handling"
  5271. msgstr ""
  5272. #. type: Plain text
  5273. #: ./bashref.texi:3248
  5274. msgid ""
  5275. "When Bash is interactive, in the absence of any traps, it ignores "
  5276. "@code{SIGTERM} (so that @samp{kill 0} does not kill an interactive shell), "
  5277. "and @code{SIGINT} is caught and handled (so that the @code{wait} builtin is "
  5278. "interruptible). When Bash receives a @code{SIGINT}, it breaks out of any "
  5279. "executing loops. In all cases, Bash ignores @code{SIGQUIT}. If job control "
  5280. "is in effect (@pxref{Job Control}), Bash ignores @code{SIGTTIN}, "
  5281. "@code{SIGTTOU}, and @code{SIGTSTP}."
  5282. msgstr ""
  5283. #. type: Plain text
  5284. #: ./bashref.texi:3257
  5285. msgid ""
  5286. "Non-builtin commands started by Bash have signal handlers set to the values "
  5287. "inherited by the shell from its parent. When job control is not in effect, "
  5288. "asynchronous commands ignore @code{SIGINT} and @code{SIGQUIT} in addition to "
  5289. "these inherited handlers. Commands run as a result of command substitution "
  5290. "ignore the keyboard-generated job control signals @code{SIGTTIN}, "
  5291. "@code{SIGTTOU}, and @code{SIGTSTP}."
  5292. msgstr ""
  5293. #. type: Plain text
  5294. #: ./bashref.texi:3268
  5295. msgid ""
  5296. "The shell exits by default upon receipt of a @code{SIGHUP}. Before exiting, "
  5297. "an interactive shell resends the @code{SIGHUP} to all jobs, running or "
  5298. "stopped. Stopped jobs are sent @code{SIGCONT} to ensure that they receive "
  5299. "the @code{SIGHUP}. To prevent the shell from sending the @code{SIGHUP} "
  5300. "signal to a particular job, it should be removed from the jobs table with "
  5301. "the @code{disown} builtin (@pxref{Job Control Builtins}) or marked to not "
  5302. "receive @code{SIGHUP} using @code{disown -h}."
  5303. msgstr ""
  5304. #. type: Plain text
  5305. #: ./bashref.texi:3272
  5306. msgid ""
  5307. "If the @code{huponexit} shell option has been set with @code{shopt} "
  5308. "(@pxref{The Shopt Builtin}), Bash sends a @code{SIGHUP} to all jobs when an "
  5309. "interactive login shell exits."
  5310. msgstr ""
  5311. #. type: Plain text
  5312. #: ./bashref.texi:3281
  5313. msgid ""
  5314. "If Bash is waiting for a command to complete and receives a signal for which "
  5315. "a trap has been set, the trap will not be executed until the command "
  5316. "completes. When Bash is waiting for an asynchronous command via the "
  5317. "@code{wait} builtin, the reception of a signal for which a trap has been set "
  5318. "will cause the @code{wait} builtin to return immediately with an exit status "
  5319. "greater than 128, immediately after which the trap is executed."
  5320. msgstr ""
  5321. #. type: cindex
  5322. #: ./bashref.texi:3284
  5323. #, no-wrap
  5324. msgid "shell script"
  5325. msgstr ""
  5326. #. type: Plain text
  5327. #: ./bashref.texi:3294
  5328. msgid ""
  5329. "A shell script is a text file containing shell commands. When such a file "
  5330. "is used as the first non-option argument when invoking Bash, and neither the "
  5331. "@option{-c} nor @option{-s} option is supplied (@pxref{Invoking Bash}), Bash "
  5332. "reads and executes commands from the file, then exits. This mode of "
  5333. "operation creates a non-interactive shell. The shell first searches for the "
  5334. "file in the current directory, and looks in the directories in @env{$PATH} "
  5335. "if not found there."
  5336. msgstr ""
  5337. #. type: Plain text
  5338. #: ./bashref.texi:3301
  5339. msgid ""
  5340. "When Bash runs a shell script, it sets the special parameter @code{0} to the "
  5341. "name of the file, rather than the name of the shell, and the positional "
  5342. "parameters are set to the remaining arguments, if any are given. If no "
  5343. "additional arguments are supplied, the positional parameters are unset."
  5344. msgstr ""
  5345. #. type: Plain text
  5346. #: ./bashref.texi:3306
  5347. msgid ""
  5348. "A shell script may be made executable by using the @code{chmod} command to "
  5349. "turn on the execute bit. When Bash finds such a file while searching the "
  5350. "@env{$PATH} for a command, it spawns a subshell to execute it. In other "
  5351. "words, executing"
  5352. msgstr ""
  5353. #. type: example
  5354. #: ./bashref.texi:3308
  5355. #, no-wrap
  5356. msgid "filename @var{arguments}\n"
  5357. msgstr ""
  5358. #. type: Plain text
  5359. #: ./bashref.texi:3311
  5360. msgid "is equivalent to executing"
  5361. msgstr ""
  5362. #. type: example
  5363. #: ./bashref.texi:3313
  5364. #, no-wrap
  5365. msgid "bash filename @var{arguments}\n"
  5366. msgstr ""
  5367. #. type: Plain text
  5368. #: ./bashref.texi:3322
  5369. msgid ""
  5370. "if @code{filename} is an executable shell script. This subshell "
  5371. "reinitializes itself, so that the effect is as if a new shell had been "
  5372. "invoked to interpret the script, with the exception that the locations of "
  5373. "commands remembered by the parent (see the description of @code{hash} in "
  5374. "@ref{Bourne Shell Builtins}) are retained by the child."
  5375. msgstr ""
  5376. #. type: Plain text
  5377. #: ./bashref.texi:3329
  5378. msgid ""
  5379. "Most versions of Unix make this a part of the operating system's command "
  5380. "execution mechanism. If the first line of a script begins with the two "
  5381. "characters @samp{#!}, the remainder of the line specifies an interpreter for "
  5382. "the program. Thus, you can specify Bash, @code{awk}, Perl, or some other "
  5383. "interpreter and write the rest of the script file in that language."
  5384. msgstr ""
  5385. #. type: Plain text
  5386. #: ./bashref.texi:3337
  5387. msgid ""
  5388. "The arguments to the interpreter consist of a single optional argument "
  5389. "following the interpreter name on the first line of the script file, "
  5390. "followed by the name of the script file, followed by the rest of the "
  5391. "arguments. Bash will perform this action on operating systems that do not "
  5392. "handle it themselves. Note that some older versions of Unix limit the "
  5393. "interpreter name and argument to a maximum of 32 characters."
  5394. msgstr ""
  5395. #. type: Plain text
  5396. #: ./bashref.texi:3342
  5397. msgid ""
  5398. "Bash scripts often begin with @code{#! /bin/bash} (assuming that Bash has "
  5399. "been installed in @file{/bin}), since this ensures that Bash will be used to "
  5400. "interpret the script, even if it is executed under another shell."
  5401. msgstr ""
  5402. #. type: section
  5403. #: ./bashref.texi:3354 ./bashref.texi:3389 ./bashref.texi:3390
  5404. #, no-wrap
  5405. msgid "Bourne Shell Builtins"
  5406. msgstr ""
  5407. #. type: menuentry
  5408. #: ./bashref.texi:3354
  5409. msgid "Builtin commands inherited from the Bourne Shell."
  5410. msgstr ""
  5411. #. type: node
  5412. #: ./bashref.texi:3354 ./bashref.texi:3947
  5413. #, no-wrap
  5414. msgid "Bash Builtins"
  5415. msgstr ""
  5416. #. type: menuentry
  5417. #: ./bashref.texi:3354
  5418. msgid "Table of builtins specific to Bash."
  5419. msgstr ""
  5420. #. type: section
  5421. #: ./bashref.texi:3354 ./bashref.texi:4783 ./bashref.texi:4784
  5422. #, no-wrap
  5423. msgid "Modifying Shell Behavior"
  5424. msgstr ""
  5425. #. type: menuentry
  5426. #: ./bashref.texi:3354
  5427. msgid "Builtins to modify shell attributes and optional behavior."
  5428. msgstr ""
  5429. #. type: section
  5430. #: ./bashref.texi:3354 ./bashref.texi:5506 ./bashref.texi:5507
  5431. #, no-wrap
  5432. msgid "Special Builtins"
  5433. msgstr ""
  5434. #. type: menuentry
  5435. #: ./bashref.texi:3354
  5436. msgid "Builtin commands classified specially by POSIX."
  5437. msgstr ""
  5438. #. type: Plain text
  5439. #: ./bashref.texi:3362
  5440. msgid ""
  5441. "Builtin commands are contained within the shell itself. When the name of a "
  5442. "builtin command is used as the first word of a simple command (@pxref{Simple "
  5443. "Commands}), the shell executes the command directly, without invoking "
  5444. "another program. Builtin commands are necessary to implement functionality "
  5445. "impossible or inconvenient to obtain with separate utilities."
  5446. msgstr ""
  5447. #. type: Plain text
  5448. #: ./bashref.texi:3366
  5449. msgid ""
  5450. "This section briefly describes the builtins which Bash inherits from the "
  5451. "Bourne Shell, as well as the builtin commands which are unique to or have "
  5452. "been extended in Bash."
  5453. msgstr ""
  5454. #. type: Plain text
  5455. #: ./bashref.texi:3373
  5456. msgid ""
  5457. "Several builtin commands are described in other chapters: builtin commands "
  5458. "which provide the Bash interface to the job control facilities (@pxref{Job "
  5459. "Control Builtins}), the directory stack (@pxref{Directory Stack Builtins}), "
  5460. "the command history (@pxref{Bash History Builtins}), and the programmable "
  5461. "completion facilities (@pxref{Programmable Completion Builtins})."
  5462. msgstr ""
  5463. #. type: Plain text
  5464. #: ./bashref.texi:3375
  5465. msgid "Many of the builtins have been extended by @sc{posix} or Bash."
  5466. msgstr ""
  5467. #. type: Plain text
  5468. #: ./bashref.texi:3388
  5469. msgid ""
  5470. "Unless otherwise noted, each builtin command documented as accepting options "
  5471. "preceded by @samp{-} accepts @samp{--} to signify the end of the options. "
  5472. "The @code{:}, @code{true}, @code{false}, and @code{test}/@code{[} builtins "
  5473. "do not accept options and do not treat @samp{--} specially. The "
  5474. "@code{exit}, @code{logout}, @code{return}, @code{break}, @code{continue}, "
  5475. "@code{let}, and @code{shift} builtins accept and process arguments beginning "
  5476. "with @samp{-} without requiring @samp{--}. Other builtins that accept "
  5477. "arguments but are not specified as accepting options interpret arguments "
  5478. "beginning with @samp{-} as invalid options and require @samp{--} to prevent "
  5479. "this interpretation."
  5480. msgstr ""
  5481. #. type: Plain text
  5482. #: ./bashref.texi:3394
  5483. msgid ""
  5484. "The following shell builtin commands are inherited from the Bourne Shell. "
  5485. "These commands are implemented as specified by the @sc{posix} standard."
  5486. msgstr ""
  5487. #. type: item
  5488. #: ./bashref.texi:3396
  5489. #, no-wrap
  5490. msgid ": @r{(a colon)}"
  5491. msgstr ""
  5492. #. type: btindex
  5493. #: ./bashref.texi:3397
  5494. #, no-wrap
  5495. msgid ":"
  5496. msgstr ""
  5497. #. type: example
  5498. #: ./bashref.texi:3400
  5499. #, no-wrap
  5500. msgid ": [@var{arguments}]\n"
  5501. msgstr ""
  5502. #. type: table
  5503. #: ./bashref.texi:3404
  5504. msgid ""
  5505. "Do nothing beyond expanding @var{arguments} and performing redirections. "
  5506. "The return status is zero."
  5507. msgstr ""
  5508. #. type: item
  5509. #: ./bashref.texi:3405
  5510. #, no-wrap
  5511. msgid ". @r{(a period)}"
  5512. msgstr ""
  5513. #. type: btindex
  5514. #: ./bashref.texi:3406
  5515. #, no-wrap
  5516. msgid "."
  5517. msgstr ""
  5518. #. type: example
  5519. #: ./bashref.texi:3409
  5520. #, no-wrap
  5521. msgid ". @var{filename} [@var{arguments}]\n"
  5522. msgstr ""
  5523. #. type: table
  5524. #: ./bashref.texi:3429
  5525. msgid ""
  5526. "Read and execute commands from the @var{filename} argument in the current "
  5527. "shell context. If @var{filename} does not contain a slash, the @env{PATH} "
  5528. "variable is used to find @var{filename}. When Bash is not in @sc{posix} "
  5529. "mode, the current directory is searched if @var{filename} is not found in "
  5530. "@env{$PATH}. If any @var{arguments} are supplied, they become the "
  5531. "positional parameters when @var{filename} is executed. Otherwise the "
  5532. "positional parameters are unchanged. If the @option{-T} option is enabled, "
  5533. "@code{source} inherits any trap on @code{DEBUG}; if it is not, any "
  5534. "@code{DEBUG} trap string is saved and restored around the call to "
  5535. "@code{source}, and @code{source} unsets the @code{DEBUG} trap while it "
  5536. "executes. If @option{-T} is not set, and the sourced file changes the "
  5537. "@code{DEBUG} trap, the new value is retained when @code{source} completes. "
  5538. "The return status is the exit status of the last command executed, or zero "
  5539. "if no commands are executed. If @var{filename} is not found, or cannot be "
  5540. "read, the return status is non-zero. This builtin is equivalent to "
  5541. "@code{source}."
  5542. msgstr ""
  5543. #. type: btindex
  5544. #: ./bashref.texi:3430 ./bashref.texi:3431
  5545. #, no-wrap
  5546. msgid "break"
  5547. msgstr ""
  5548. #. type: example
  5549. #: ./bashref.texi:3434
  5550. #, no-wrap
  5551. msgid "break [@var{n}]\n"
  5552. msgstr ""
  5553. #. type: table
  5554. #: ./bashref.texi:3440
  5555. msgid ""
  5556. "Exit from a @code{for}, @code{while}, @code{until}, or @code{select} loop. "
  5557. "If @var{n} is supplied, the @var{n}th enclosing loop is exited. @var{n} "
  5558. "must be greater than or equal to 1. The return status is zero unless "
  5559. "@var{n} is not greater than or equal to 1."
  5560. msgstr ""
  5561. #. type: btindex
  5562. #: ./bashref.texi:3441 ./bashref.texi:3442
  5563. #, no-wrap
  5564. msgid "cd"
  5565. msgstr ""
  5566. #. type: example
  5567. #: ./bashref.texi:3445
  5568. #, no-wrap
  5569. msgid "cd [-L|[-P [-e]] [-@@] [@var{directory}]\n"
  5570. msgstr ""
  5571. #. type: table
  5572. #: ./bashref.texi:3457
  5573. msgid ""
  5574. "Change the current working directory to @var{directory}. If @var{directory} "
  5575. "is not supplied, the value of the @env{HOME} shell variable is used. Any "
  5576. "additional arguments following @var{directory} are ignored. If the shell "
  5577. "variable @env{CDPATH} exists, it is used as a search path: each directory "
  5578. "name in @env{CDPATH} is searched for @var{directory}, with alternative "
  5579. "directory names in @env{CDPATH} separated by a colon (@samp{:}). If "
  5580. "@var{directory} begins with a slash, @env{CDPATH} is not used."
  5581. msgstr ""
  5582. #. type: table
  5583. #: ./bashref.texi:3461
  5584. msgid ""
  5585. "The @option{-P} option means to not follow symbolic links: symbolic links "
  5586. "are resolved while @code{cd} is traversing @var{directory} and before "
  5587. "processing an instance of @samp{..} in @var{directory}."
  5588. msgstr ""
  5589. #. type: table
  5590. #: ./bashref.texi:3465
  5591. msgid ""
  5592. "By default, or when the @option{-L} option is supplied, symbolic links in "
  5593. "@var{directory} are resolved after @code{cd} processes an instance of "
  5594. "@samp{..} in @var{directory}."
  5595. msgstr ""
  5596. #. type: table
  5597. #: ./bashref.texi:3469
  5598. msgid ""
  5599. "If @samp{..} appears in @var{directory}, it is processed by removing the "
  5600. "immediately preceding pathname component, back to a slash or the beginning "
  5601. "of @var{directory}."
  5602. msgstr ""
  5603. #. type: table
  5604. #: ./bashref.texi:3474
  5605. msgid ""
  5606. "If the @option{-e} option is supplied with @option{-P} and the current "
  5607. "working directory cannot be successfully determined after a successful "
  5608. "directory change, @code{cd} will return an unsuccessful status."
  5609. msgstr ""
  5610. #. type: table
  5611. #: ./bashref.texi:3477
  5612. msgid ""
  5613. "On systems that support it, the @option{-@@} option presents the extended "
  5614. "attributes associated with a file as a directory."
  5615. msgstr ""
  5616. #. type: table
  5617. #: ./bashref.texi:3480
  5618. msgid ""
  5619. "If @var{directory} is @samp{-}, it is converted to @env{$OLDPWD} before the "
  5620. "directory change is attempted."
  5621. msgstr ""
  5622. #. type: table
  5623. #: ./bashref.texi:3485
  5624. msgid ""
  5625. "If a non-empty directory name from @env{CDPATH} is used, or if @samp{-} is "
  5626. "the first argument, and the directory change is successful, the absolute "
  5627. "pathname of the new working directory is written to the standard output."
  5628. msgstr ""
  5629. #. type: table
  5630. #: ./bashref.texi:3488
  5631. msgid ""
  5632. "The return status is zero if the directory is successfully changed, non-zero "
  5633. "otherwise."
  5634. msgstr ""
  5635. #. type: btindex
  5636. #: ./bashref.texi:3489 ./bashref.texi:3490
  5637. #, no-wrap
  5638. msgid "continue"
  5639. msgstr ""
  5640. #. type: example
  5641. #: ./bashref.texi:3493
  5642. #, no-wrap
  5643. msgid "continue [@var{n}]\n"
  5644. msgstr ""
  5645. #. type: table
  5646. #: ./bashref.texi:3501
  5647. msgid ""
  5648. "Resume the next iteration of an enclosing @code{for}, @code{while}, "
  5649. "@code{until}, or @code{select} loop. If @var{n} is supplied, the execution "
  5650. "of the @var{n}th enclosing loop is resumed. @var{n} must be greater than or "
  5651. "equal to 1. The return status is zero unless @var{n} is not greater than or "
  5652. "equal to 1."
  5653. msgstr ""
  5654. #. type: btindex
  5655. #: ./bashref.texi:3502 ./bashref.texi:3503
  5656. #, no-wrap
  5657. msgid "eval"
  5658. msgstr ""
  5659. #. type: example
  5660. #: ./bashref.texi:3506
  5661. #, no-wrap
  5662. msgid "eval [@var{arguments}]\n"
  5663. msgstr ""
  5664. #. type: table
  5665. #: ./bashref.texi:3513
  5666. msgid ""
  5667. "The arguments are concatenated together into a single command, which is then "
  5668. "read and executed, and its exit status returned as the exit status of "
  5669. "@code{eval}. If there are no arguments or only empty arguments, the return "
  5670. "status is zero."
  5671. msgstr ""
  5672. #. type: btindex
  5673. #: ./bashref.texi:3514 ./bashref.texi:3515
  5674. #, no-wrap
  5675. msgid "exec"
  5676. msgstr ""
  5677. #. type: example
  5678. #: ./bashref.texi:3518
  5679. #, no-wrap
  5680. msgid "exec [-cl] [-a @var{name}] [@var{command} [@var{arguments}]]\n"
  5681. msgstr ""
  5682. #. type: table
  5683. #: ./bashref.texi:3538
  5684. msgid ""
  5685. "If @var{command} is supplied, it replaces the shell without creating a new "
  5686. "process. If the @option{-l} option is supplied, the shell places a dash at "
  5687. "the beginning of the zeroth argument passed to @var{command}. This is what "
  5688. "the @code{login} program does. The @option{-c} option causes @var{command} "
  5689. "to be executed with an empty environment. If @option{-a} is supplied, the "
  5690. "shell passes @var{name} as the zeroth argument to @var{command}. If "
  5691. "@var{command} cannot be executed for some reason, a non-interactive shell "
  5692. "exits, unless the @code{execfail} shell option is enabled. In that case, it "
  5693. "returns failure. An interactive shell returns failure if the file cannot be "
  5694. "executed. A subshell exits unconditionally if @code{exec} fails. If no "
  5695. "@var{command} is specified, redirections may be used to affect the current "
  5696. "shell environment. If there are no redirection errors, the return status is "
  5697. "zero; otherwise the return status is non-zero."
  5698. msgstr ""
  5699. #. type: btindex
  5700. #: ./bashref.texi:3539 ./bashref.texi:3540
  5701. #, no-wrap
  5702. msgid "exit"
  5703. msgstr ""
  5704. #. type: example
  5705. #: ./bashref.texi:3543
  5706. #, no-wrap
  5707. msgid "exit [@var{n}]\n"
  5708. msgstr ""
  5709. #. type: table
  5710. #: ./bashref.texi:3548
  5711. msgid ""
  5712. "Exit the shell, returning a status of @var{n} to the shell's parent. If "
  5713. "@var{n} is omitted, the exit status is that of the last command executed. "
  5714. "Any trap on @code{EXIT} is executed before the shell terminates."
  5715. msgstr ""
  5716. #. type: btindex
  5717. #: ./bashref.texi:3549 ./bashref.texi:3550
  5718. #, no-wrap
  5719. msgid "export"
  5720. msgstr ""
  5721. #. type: example
  5722. #: ./bashref.texi:3553
  5723. #, no-wrap
  5724. msgid "export [-fn] [-p] [@var{name}[=@var{value}]]\n"
  5725. msgstr ""
  5726. #. type: table
  5727. #: ./bashref.texi:3564
  5728. msgid ""
  5729. "Mark each @var{name} to be passed to child processes in the environment. If "
  5730. "the @option{-f} option is supplied, the @var{name}s refer to shell "
  5731. "functions; otherwise the names refer to shell variables. The @option{-n} "
  5732. "option means to no longer mark each @var{name} for export. If no "
  5733. "@var{names} are supplied, or if the @option{-p} option is given, a list of "
  5734. "names of all exported variables is displayed. The @option{-p} option "
  5735. "displays output in a form that may be reused as input. If a variable name "
  5736. "is followed by =@var{value}, the value of the variable is set to "
  5737. "@var{value}."
  5738. msgstr ""
  5739. #. type: table
  5740. #: ./bashref.texi:3568
  5741. msgid ""
  5742. "The return status is zero unless an invalid option is supplied, one of the "
  5743. "names is not a valid shell variable name, or @option{-f} is supplied with a "
  5744. "name that is not a shell function."
  5745. msgstr ""
  5746. #. type: btindex
  5747. #: ./bashref.texi:3569 ./bashref.texi:3570
  5748. #, no-wrap
  5749. msgid "getopts"
  5750. msgstr ""
  5751. #. type: example
  5752. #: ./bashref.texi:3573
  5753. #, no-wrap
  5754. msgid "getopts @var{optstring} @var{name} [@var{args}]\n"
  5755. msgstr ""
  5756. #. type: table
  5757. #: ./bashref.texi:3593
  5758. msgid ""
  5759. "@code{getopts} is used by shell scripts to parse positional parameters. "
  5760. "@var{optstring} contains the option characters to be recognized; if a "
  5761. "character is followed by a colon, the option is expected to have an "
  5762. "argument, which should be separated from it by whitespace. The colon "
  5763. "(@samp{:}) and question mark (@samp{?}) may not be used as option "
  5764. "characters. Each time it is invoked, @code{getopts} places the next option "
  5765. "in the shell variable @var{name}, initializing @var{name} if it does not "
  5766. "exist, and the index of the next argument to be processed into the variable "
  5767. "@env{OPTIND}. @env{OPTIND} is initialized to 1 each time the shell or a "
  5768. "shell script is invoked. When an option requires an argument, "
  5769. "@code{getopts} places that argument into the variable @env{OPTARG}. The "
  5770. "shell does not reset @env{OPTIND} automatically; it must be manually reset "
  5771. "between multiple calls to @code{getopts} within the same shell invocation if "
  5772. "a new set of parameters is to be used."
  5773. msgstr ""
  5774. #. type: table
  5775. #: ./bashref.texi:3598
  5776. msgid ""
  5777. "When the end of options is encountered, @code{getopts} exits with a return "
  5778. "value greater than zero. @env{OPTIND} is set to the index of the first "
  5779. "non-option argument, and @var{name} is set to @samp{?}."
  5780. msgstr ""
  5781. #. type: table
  5782. #: ./bashref.texi:3602
  5783. msgid ""
  5784. "@code{getopts} normally parses the positional parameters, but if more "
  5785. "arguments are given in @var{args}, @code{getopts} parses those instead."
  5786. msgstr ""
  5787. #. type: table
  5788. #: ./bashref.texi:3611
  5789. msgid ""
  5790. "@code{getopts} can report errors in two ways. If the first character of "
  5791. "@var{optstring} is a colon, @var{silent} error reporting is used. In normal "
  5792. "operation, diagnostic messages are printed when invalid options or missing "
  5793. "option arguments are encountered. If the variable @env{OPTERR} is set to 0, "
  5794. "no error messages will be displayed, even if the first character of "
  5795. "@code{optstring} is not a colon."
  5796. msgstr ""
  5797. #. type: table
  5798. #: ./bashref.texi:3617
  5799. msgid ""
  5800. "If an invalid option is seen, @code{getopts} places @samp{?} into @var{name} "
  5801. "and, if not silent, prints an error message and unsets @env{OPTARG}. If "
  5802. "@code{getopts} is silent, the option character found is placed in "
  5803. "@env{OPTARG} and no diagnostic message is printed."
  5804. msgstr ""
  5805. #. type: table
  5806. #: ./bashref.texi:3623
  5807. msgid ""
  5808. "If a required argument is not found, and @code{getopts} is not silent, a "
  5809. "question mark (@samp{?}) is placed in @var{name}, @code{OPTARG} is unset, "
  5810. "and a diagnostic message is printed. If @code{getopts} is silent, then a "
  5811. "colon (@samp{:}) is placed in @var{name} and @env{OPTARG} is set to the "
  5812. "option character found."
  5813. msgstr ""
  5814. #. type: btindex
  5815. #: ./bashref.texi:3624 ./bashref.texi:3625
  5816. #, no-wrap
  5817. msgid "hash"
  5818. msgstr ""
  5819. #. type: example
  5820. #: ./bashref.texi:3628
  5821. #, no-wrap
  5822. msgid "hash [-r] [-p @var{filename}] [-dt] [@var{name}]\n"
  5823. msgstr ""
  5824. #. type: table
  5825. #: ./bashref.texi:3651
  5826. msgid ""
  5827. "Each time @code{hash} is invoked, it remembers the full pathnames of the "
  5828. "commands specified as @var{name} arguments, so they need not be searched for "
  5829. "on subsequent invocations. The commands are found by searching through the "
  5830. "directories listed in @env{$PATH}. Any previously-remembered pathname is "
  5831. "discarded. The @option{-p} option inhibits the path search, and "
  5832. "@var{filename} is used as the location of @var{name}. The @option{-r} "
  5833. "option causes the shell to forget all remembered locations. The @option{-d} "
  5834. "option causes the shell to forget the remembered location of each "
  5835. "@var{name}. If the @option{-t} option is supplied, the full pathname to "
  5836. "which each @var{name} corresponds is printed. If multiple @var{name} "
  5837. "arguments are supplied with @option{-t}, the @var{name} is printed before "
  5838. "the hashed full pathname. The @option{-l} option causes output to be "
  5839. "displayed in a format that may be reused as input. If no arguments are "
  5840. "given, or if only @option{-l} is supplied, information about remembered "
  5841. "commands is printed. The return status is zero unless a @var{name} is not "
  5842. "found or an invalid option is supplied."
  5843. msgstr ""
  5844. #. type: btindex
  5845. #: ./bashref.texi:3652 ./bashref.texi:3653
  5846. #, no-wrap
  5847. msgid "pwd"
  5848. msgstr ""
  5849. #. type: example
  5850. #: ./bashref.texi:3656
  5851. #, no-wrap
  5852. msgid "pwd [-LP]\n"
  5853. msgstr ""
  5854. #. type: table
  5855. #: ./bashref.texi:3666
  5856. msgid ""
  5857. "Print the absolute pathname of the current working directory. If the "
  5858. "@option{-P} option is supplied, the pathname printed will not contain "
  5859. "symbolic links. If the @option{-L} option is supplied, the pathname printed "
  5860. "may contain symbolic links. The return status is zero unless an error is "
  5861. "encountered while determining the name of the current directory or an "
  5862. "invalid option is supplied."
  5863. msgstr ""
  5864. #. type: btindex
  5865. #: ./bashref.texi:3667 ./bashref.texi:3668
  5866. #, no-wrap
  5867. msgid "readonly"
  5868. msgstr ""
  5869. #. type: example
  5870. #: ./bashref.texi:3671
  5871. #, no-wrap
  5872. msgid "readonly [-aAf] [-p] [@var{name}[=@var{value}]] @dots{}\n"
  5873. msgstr ""
  5874. #. type: table
  5875. #: ./bashref.texi:3692
  5876. msgid ""
  5877. "Mark each @var{name} as readonly. The values of these names may not be "
  5878. "changed by subsequent assignment. If the @option{-f} option is supplied, "
  5879. "each @var{name} refers to a shell function. The @option{-a} option means "
  5880. "each @var{name} refers to an indexed array variable; the @option{-A} option "
  5881. "means each @var{name} refers to an associative array variable. If both "
  5882. "options are supplied, @option{-A} takes precedence. If no @var{name} "
  5883. "arguments are given, or if the @option{-p} option is supplied, a list of all "
  5884. "readonly names is printed. The other options may be used to restrict the "
  5885. "output to a subset of the set of readonly names. The @option{-p} option "
  5886. "causes output to be displayed in a format that may be reused as input. If a "
  5887. "variable name is followed by =@var{value}, the value of the variable is set "
  5888. "to @var{value}. The return status is zero unless an invalid option is "
  5889. "supplied, one of the @var{name} arguments is not a valid shell variable or "
  5890. "function name, or the @option{-f} option is supplied with a name that is not "
  5891. "a shell function."
  5892. msgstr ""
  5893. #. type: btindex
  5894. #: ./bashref.texi:3693 ./bashref.texi:3694
  5895. #, no-wrap
  5896. msgid "return"
  5897. msgstr ""
  5898. #. type: example
  5899. #: ./bashref.texi:3697
  5900. #, no-wrap
  5901. msgid "return [@var{n}]\n"
  5902. msgstr ""
  5903. #. type: table
  5904. #: ./bashref.texi:3720
  5905. msgid ""
  5906. "Cause a shell function to stop executing and return the value @var{n} to its "
  5907. "caller. If @var{n} is not supplied, the return value is the exit status of "
  5908. "the last command executed in the function. If @code{return} is executed by "
  5909. "a trap handler, the last command used to determine the status is the last "
  5910. "command executed before the trap handler. If @code{return} is executed "
  5911. "during a @code{DEBUG} trap, the last command used to determine the status is "
  5912. "the last command executed by the trap handler before @code{return} was "
  5913. "invoked. @code{return} may also be used to terminate execution of a script "
  5914. "being executed with the @code{.} (@code{source}) builtin, returning either "
  5915. "@var{n} or the exit status of the last command executed within the script as "
  5916. "the exit status of the script. If @var{n} is supplied, the return value is "
  5917. "its least significant 8 bits. Any command associated with the @code{RETURN} "
  5918. "trap is executed before execution resumes after the function or script. The "
  5919. "return status is non-zero if @code{return} is supplied a non-numeric "
  5920. "argument or is used outside a function and not during the execution of a "
  5921. "script by @code{.} or @code{source}."
  5922. msgstr ""
  5923. #. type: btindex
  5924. #: ./bashref.texi:3721 ./bashref.texi:3722
  5925. #, no-wrap
  5926. msgid "shift"
  5927. msgstr ""
  5928. #. type: example
  5929. #: ./bashref.texi:3725
  5930. #, no-wrap
  5931. msgid "shift [@var{n}]\n"
  5932. msgstr ""
  5933. #. type: table
  5934. #: ./bashref.texi:3738
  5935. msgid ""
  5936. "Shift the positional parameters to the left by @var{n}. The positional "
  5937. "parameters from @var{n}+1 @dots{} @code{$#} are renamed to @code{$1} @dots{} "
  5938. "@code{$#}-@var{n}. Parameters represented by the numbers @code{$#} to "
  5939. "@code{$#}-@var{n}+1 are unset. @var{n} must be a non-negative number less "
  5940. "than or equal to @code{$#}. If @var{n} is zero or greater than @code{$#}, "
  5941. "the positional parameters are not changed. If @var{n} is not supplied, it "
  5942. "is assumed to be 1. The return status is zero unless @var{n} is greater "
  5943. "than @code{$#} or less than zero, non-zero otherwise."
  5944. msgstr ""
  5945. #. type: btindex
  5946. #: ./bashref.texi:3739 ./bashref.texi:3741
  5947. #, no-wrap
  5948. msgid "test"
  5949. msgstr ""
  5950. #. type: btindex
  5951. #: ./bashref.texi:3740 ./bashref.texi:3742
  5952. #, no-wrap
  5953. msgid "["
  5954. msgstr ""
  5955. #. type: example
  5956. #: ./bashref.texi:3745
  5957. #, no-wrap
  5958. msgid "test @var{expr}\n"
  5959. msgstr ""
  5960. #. type: table
  5961. #: ./bashref.texi:3754
  5962. msgid ""
  5963. "Evaluate a conditional expression @var{expr} and return a status of 0 (true) "
  5964. "or 1 (false). Each operator and operand must be a separate argument. "
  5965. "Expressions are composed of the primaries described below in @ref{Bash "
  5966. "Conditional Expressions}. @code{test} does not accept any options, nor does "
  5967. "it accept and ignore an argument of @option{--} as signifying the end of "
  5968. "options."
  5969. msgstr ""
  5970. #. type: table
  5971. #: ./bashref.texi:3757
  5972. msgid ""
  5973. "When the @code{[} form is used, the last argument to the command must be a "
  5974. "@code{]}."
  5975. msgstr ""
  5976. #. type: table
  5977. #: ./bashref.texi:3762
  5978. msgid ""
  5979. "Expressions may be combined using the following operators, listed in "
  5980. "decreasing order of precedence. The evaluation depends on the number of "
  5981. "arguments; see below. Operator precedence is used when there are five or "
  5982. "more arguments."
  5983. msgstr ""
  5984. #. type: item
  5985. #: ./bashref.texi:3764
  5986. #, no-wrap
  5987. msgid "! @var{expr}"
  5988. msgstr ""
  5989. #. type: table
  5990. #: ./bashref.texi:3766
  5991. msgid "True if @var{expr} is false."
  5992. msgstr ""
  5993. #. type: item
  5994. #: ./bashref.texi:3767
  5995. #, no-wrap
  5996. msgid "( @var{expr} )"
  5997. msgstr ""
  5998. #. type: table
  5999. #: ./bashref.texi:3770
  6000. msgid ""
  6001. "Returns the value of @var{expr}. This may be used to override the normal "
  6002. "precedence of operators."
  6003. msgstr ""
  6004. #. type: item
  6005. #: ./bashref.texi:3771
  6006. #, no-wrap
  6007. msgid "@var{expr1} -a @var{expr2}"
  6008. msgstr ""
  6009. #. type: table
  6010. #: ./bashref.texi:3773
  6011. msgid "True if both @var{expr1} and @var{expr2} are true."
  6012. msgstr ""
  6013. #. type: item
  6014. #: ./bashref.texi:3774
  6015. #, no-wrap
  6016. msgid "@var{expr1} -o @var{expr2}"
  6017. msgstr ""
  6018. #. type: table
  6019. #: ./bashref.texi:3776
  6020. msgid "True if either @var{expr1} or @var{expr2} is true."
  6021. msgstr ""
  6022. #. type: table
  6023. #: ./bashref.texi:3780
  6024. msgid ""
  6025. "The @code{test} and @code{[} builtins evaluate conditional expressions using "
  6026. "a set of rules based on the number of arguments."
  6027. msgstr ""
  6028. #. type: item
  6029. #: ./bashref.texi:3782
  6030. #, no-wrap
  6031. msgid "0 arguments"
  6032. msgstr ""
  6033. #. type: table
  6034. #: ./bashref.texi:3784
  6035. msgid "The expression is false."
  6036. msgstr ""
  6037. #. type: item
  6038. #: ./bashref.texi:3785
  6039. #, no-wrap
  6040. msgid "1 argument"
  6041. msgstr ""
  6042. #. type: table
  6043. #: ./bashref.texi:3787
  6044. msgid "The expression is true if, and only if, the argument is not null."
  6045. msgstr ""
  6046. #. type: item
  6047. #: ./bashref.texi:3788
  6048. #, no-wrap
  6049. msgid "2 arguments"
  6050. msgstr ""
  6051. #. type: table
  6052. #: ./bashref.texi:3796
  6053. msgid ""
  6054. "If the first argument is @samp{!}, the expression is true if and only if the "
  6055. "second argument is null. If the first argument is one of the unary "
  6056. "conditional operators (@pxref{Bash Conditional Expressions}), the expression "
  6057. "is true if the unary test is true. If the first argument is not a valid "
  6058. "unary operator, the expression is false."
  6059. msgstr ""
  6060. #. type: item
  6061. #: ./bashref.texi:3797
  6062. #, no-wrap
  6063. msgid "3 arguments"
  6064. msgstr ""
  6065. #. type: table
  6066. #: ./bashref.texi:3799
  6067. msgid "The following conditions are applied in the order listed."
  6068. msgstr ""
  6069. #. type: enumerate
  6070. #: ./bashref.texi:3808
  6071. msgid ""
  6072. "If the second argument is one of the binary conditional operators "
  6073. "(@pxref{Bash Conditional Expressions}), the result of the expression is the "
  6074. "result of the binary test using the first and third arguments as operands. "
  6075. "The @samp{-a} and @samp{-o} operators are considered binary operators when "
  6076. "there are three arguments."
  6077. msgstr ""
  6078. #. type: enumerate
  6079. #: ./bashref.texi:3811
  6080. msgid ""
  6081. "If the first argument is @samp{!}, the value is the negation of the "
  6082. "two-argument test using the second and third arguments."
  6083. msgstr ""
  6084. #. type: enumerate
  6085. #: ./bashref.texi:3815
  6086. msgid ""
  6087. "If the first argument is exactly @samp{(} and the third argument is exactly "
  6088. "@samp{)}, the result is the one-argument test of the second argument."
  6089. msgstr ""
  6090. #. type: enumerate
  6091. #: ./bashref.texi:3817
  6092. msgid "Otherwise, the expression is false."
  6093. msgstr ""
  6094. #. type: item
  6095. #: ./bashref.texi:3819
  6096. #, no-wrap
  6097. msgid "4 arguments"
  6098. msgstr ""
  6099. #. type: table
  6100. #: ./bashref.texi:3824
  6101. msgid ""
  6102. "If the first argument is @samp{!}, the result is the negation of the "
  6103. "three-argument expression composed of the remaining arguments. Otherwise, "
  6104. "the expression is parsed and evaluated according to precedence using the "
  6105. "rules listed above."
  6106. msgstr ""
  6107. #. type: item
  6108. #: ./bashref.texi:3825
  6109. #, no-wrap
  6110. msgid "5 or more arguments"
  6111. msgstr ""
  6112. #. type: table
  6113. #: ./bashref.texi:3828
  6114. msgid ""
  6115. "The expression is parsed and evaluated according to precedence using the "
  6116. "rules listed above."
  6117. msgstr ""
  6118. #. type: table
  6119. #: ./bashref.texi:3832
  6120. msgid ""
  6121. "When used with @code{test} or @samp{[}, the @samp{<} and @samp{>} operators "
  6122. "sort lexicographically using ASCII ordering."
  6123. msgstr ""
  6124. #. type: btindex
  6125. #: ./bashref.texi:3833 ./bashref.texi:3834
  6126. #, no-wrap
  6127. msgid "times"
  6128. msgstr ""
  6129. #. type: example
  6130. #: ./bashref.texi:3837
  6131. #, no-wrap
  6132. msgid "times\n"
  6133. msgstr ""
  6134. #. type: table
  6135. #: ./bashref.texi:3841
  6136. msgid ""
  6137. "Print out the user and system times used by the shell and its children. The "
  6138. "return status is zero."
  6139. msgstr ""
  6140. #. type: btindex
  6141. #: ./bashref.texi:3842 ./bashref.texi:3843
  6142. #, no-wrap
  6143. msgid "trap"
  6144. msgstr ""
  6145. #. type: example
  6146. #: ./bashref.texi:3846
  6147. #, no-wrap
  6148. msgid "trap [-lp] [@var{arg}] [@var{sigspec} @dots{}]\n"
  6149. msgstr ""
  6150. #. type: table
  6151. #: ./bashref.texi:3865
  6152. msgid ""
  6153. "The commands in @var{arg} are to be read and executed when the shell "
  6154. "receives signal @var{sigspec}. If @var{arg} is absent (and there is a "
  6155. "single @var{sigspec}) or equal to @samp{-}, each specified signal's "
  6156. "disposition is reset to the value it had when the shell was started. If "
  6157. "@var{arg} is the null string, then the signal specified by each "
  6158. "@var{sigspec} is ignored by the shell and commands it invokes. If @var{arg} "
  6159. "is not present and @option{-p} has been supplied, the shell displays the "
  6160. "trap commands associated with each @var{sigspec}. If no arguments are "
  6161. "supplied, or only @option{-p} is given, @code{trap} prints the list of "
  6162. "commands associated with each signal number in a form that may be reused as "
  6163. "shell input. The @option{-l} option causes the shell to print a list of "
  6164. "signal names and their corresponding numbers. Each @var{sigspec} is either "
  6165. "a signal name or a signal number. Signal names are case insensitive and the "
  6166. "@code{SIG} prefix is optional."
  6167. msgstr ""
  6168. #. type: table
  6169. #: ./bashref.texi:3878
  6170. msgid ""
  6171. "If a @var{sigspec} is @code{0} or @code{EXIT}, @var{arg} is executed when "
  6172. "the shell exits. If a @var{sigspec} is @code{DEBUG}, the command @var{arg} "
  6173. "is executed before every simple command, @code{for} command, @code{case} "
  6174. "command, @code{select} command, every arithmetic @code{for} command, and "
  6175. "before the first command executes in a shell function. Refer to the "
  6176. "description of the @code{extdebug} option to the @code{shopt} builtin "
  6177. "(@pxref{The Shopt Builtin}) for details of its effect on the @code{DEBUG} "
  6178. "trap. If a @var{sigspec} is @code{RETURN}, the command @var{arg} is "
  6179. "executed each time a shell function or a script executed with the @code{.} "
  6180. "or @code{source} builtins finishes executing."
  6181. msgstr ""
  6182. #. type: table
  6183. #: ./bashref.texi:3895
  6184. msgid ""
  6185. "If a @var{sigspec} is @code{ERR}, the command @var{arg} is executed whenever "
  6186. "a pipeline (which may consist of a single simple command), a list, or a "
  6187. "compound command returns a non-zero exit status, subject to the following "
  6188. "conditions. The @code{ERR} trap is not executed if the failed command is "
  6189. "part of the command list immediately following an @code{until} or "
  6190. "@code{while} keyword, part of the test following the @code{if} or "
  6191. "@code{elif} reserved words, part of a command executed in a @code{&&} or "
  6192. "@code{||} list except the command following the final @code{&&} or "
  6193. "@code{||}, any command in a pipeline but the last, or if the command's "
  6194. "return status is being inverted using @code{!}. These are the same "
  6195. "conditions obeyed by the @code{errexit} (@option{-e}) option."
  6196. msgstr ""
  6197. #. type: table
  6198. #: ./bashref.texi:3899
  6199. msgid ""
  6200. "Signals ignored upon entry to the shell cannot be trapped or reset. Trapped "
  6201. "signals that are not being ignored are reset to their original values in a "
  6202. "subshell or subshell environment when one is created."
  6203. msgstr ""
  6204. #. type: table
  6205. #: ./bashref.texi:3902
  6206. msgid ""
  6207. "The return status is zero unless a @var{sigspec} does not specify a valid "
  6208. "signal."
  6209. msgstr ""
  6210. #. type: btindex
  6211. #: ./bashref.texi:3903 ./bashref.texi:3904
  6212. #, no-wrap
  6213. msgid "umask"
  6214. msgstr ""
  6215. #. type: example
  6216. #: ./bashref.texi:3907
  6217. #, no-wrap
  6218. msgid "umask [-p] [-S] [@var{mode}]\n"
  6219. msgstr ""
  6220. #. type: table
  6221. #: ./bashref.texi:3920
  6222. msgid ""
  6223. "Set the shell process's file creation mask to @var{mode}. If @var{mode} "
  6224. "begins with a digit, it is interpreted as an octal number; if not, it is "
  6225. "interpreted as a symbolic mode mask similar to that accepted by the "
  6226. "@code{chmod} command. If @var{mode} is omitted, the current value of the "
  6227. "mask is printed. If the @option{-S} option is supplied without a @var{mode} "
  6228. "argument, the mask is printed in a symbolic format. If the @option{-p} "
  6229. "option is supplied, and @var{mode} is omitted, the output is in a form that "
  6230. "may be reused as input. The return status is zero if the mode is "
  6231. "successfully changed or if no @var{mode} argument is supplied, and non-zero "
  6232. "otherwise."
  6233. msgstr ""
  6234. #. type: table
  6235. #: ./bashref.texi:3924
  6236. msgid ""
  6237. "Note that when the mode is interpreted as an octal number, each number of "
  6238. "the umask is subtracted from @code{7}. Thus, a umask of @code{022} results "
  6239. "in permissions of @code{755}."
  6240. msgstr ""
  6241. #. type: btindex
  6242. #: ./bashref.texi:3925 ./bashref.texi:3926
  6243. #, no-wrap
  6244. msgid "unset"
  6245. msgstr ""
  6246. #. type: example
  6247. #: ./bashref.texi:3929
  6248. #, no-wrap
  6249. msgid "unset [-fnv] [@var{name}]\n"
  6250. msgstr ""
  6251. #. type: table
  6252. #: ./bashref.texi:3945
  6253. msgid ""
  6254. "Remove each variable or function @var{name}. If the @option{-v} option is "
  6255. "given, each @var{name} refers to a shell variable and that variable is "
  6256. "removed. If the @option{-f} option is given, the @var{name}s refer to shell "
  6257. "functions, and the function definition is removed. If the @option{-n} "
  6258. "option is supplied, and @var{name} is a variable with the @var{nameref} "
  6259. "attribute, @var{name} will be unset rather than the variable it references. "
  6260. "@option{-n} has no effect if the @option{-f} option is supplied. If no "
  6261. "options are supplied, each @var{name} refers to a variable; if there is no "
  6262. "variable by that name, any function with that name is unset. Readonly "
  6263. "variables and functions may not be unset. The return status is zero unless "
  6264. "a @var{name} is readonly."
  6265. msgstr ""
  6266. #. type: section
  6267. #: ./bashref.texi:3948
  6268. #, no-wrap
  6269. msgid "Bash Builtin Commands"
  6270. msgstr ""
  6271. #. type: Plain text
  6272. #: ./bashref.texi:3953
  6273. msgid ""
  6274. "This section describes builtin commands which are unique to or have been "
  6275. "extended in Bash. Some of these commands are specified in the @sc{posix} "
  6276. "standard."
  6277. msgstr ""
  6278. #. type: btindex
  6279. #: ./bashref.texi:3956 ./bashref.texi:3957
  6280. #, no-wrap
  6281. msgid "alias"
  6282. msgstr ""
  6283. #. type: example
  6284. #: ./bashref.texi:3960
  6285. #, no-wrap
  6286. msgid "alias [-p] [@var{name}[=@var{value}] @dots{}]\n"
  6287. msgstr ""
  6288. #. type: table
  6289. #: ./bashref.texi:3969
  6290. msgid ""
  6291. "Without arguments or with the @option{-p} option, @code{alias} prints the "
  6292. "list of aliases on the standard output in a form that allows them to be "
  6293. "reused as input. If arguments are supplied, an alias is defined for each "
  6294. "@var{name} whose @var{value} is given. If no @var{value} is given, the name "
  6295. "and value of the alias is printed. Aliases are described in @ref{Aliases}."
  6296. msgstr ""
  6297. #. type: btindex
  6298. #: ./bashref.texi:3970 ./bashref.texi:3971
  6299. #, no-wrap
  6300. msgid "bind"
  6301. msgstr ""
  6302. #. type: example
  6303. #: ./bashref.texi:3979
  6304. #, no-wrap
  6305. msgid ""
  6306. "bind [-m @var{keymap}] [-lpsvPSVX]\n"
  6307. "bind [-m @var{keymap}] [-q @var{function}] [-u @var{function}] [-r "
  6308. "@var{keyseq}]\n"
  6309. "bind [-m @var{keymap}] -f @var{filename}\n"
  6310. "bind [-m @var{keymap}] -x @var{keyseq:shell-command}\n"
  6311. "bind [-m @var{keymap}] @var{keyseq:function-name}\n"
  6312. "bind [-m @var{keymap}] @var{keyseq:readline-command}\n"
  6313. msgstr ""
  6314. #. type: table
  6315. #: ./bashref.texi:3989
  6316. msgid ""
  6317. "Display current Readline (@pxref{Command Line Editing}) key and function "
  6318. "bindings, bind a key sequence to a Readline function or macro, or set a "
  6319. "Readline variable. Each non-option argument is a command as it would appear "
  6320. "in a Readline initialization file (@pxref{Readline Init File}), but each "
  6321. "binding or command must be passed as a separate argument; e.g., "
  6322. "@samp{\"\\C-x\\C-r\":re-read-init-file}."
  6323. msgstr ""
  6324. #. type: table
  6325. #: ./bashref.texi:3991 ./bashref.texi:4334 ./bashref.texi:4521
  6326. msgid "Options, if supplied, have the following meanings:"
  6327. msgstr ""
  6328. #. type: item
  6329. #: ./bashref.texi:3993
  6330. #, no-wrap
  6331. msgid "-m @var{keymap}"
  6332. msgstr ""
  6333. #. type: table
  6334. #: ./bashref.texi:4007
  6335. msgid ""
  6336. "Use @var{keymap} as the keymap to be affected by the subsequent bindings. "
  6337. "Acceptable @var{keymap} names are @code{emacs}, @code{emacs-standard}, "
  6338. "@code{emacs-meta}, @code{emacs-ctlx}, @code{vi}, @code{vi-move}, "
  6339. "@code{vi-command}, and @code{vi-insert}. @code{vi} is equivalent to "
  6340. "@code{vi-command} (@code{vi-move} is also a synonym); @code{emacs} is "
  6341. "equivalent to @code{emacs-standard}."
  6342. msgstr ""
  6343. #. type: item
  6344. #: ./bashref.texi:4008 ./bashref.texi:4175 ./bashref.texi:4705 ./bashref.texi:6481 ./bashref.texi:7331 ./bashref.texi:8031
  6345. #, no-wrap
  6346. msgid "-l"
  6347. msgstr ""
  6348. #. type: table
  6349. #: ./bashref.texi:4010
  6350. msgid "List the names of all Readline functions."
  6351. msgstr ""
  6352. #. type: item
  6353. #: ./bashref.texi:4011 ./bashref.texi:4715 ./bashref.texi:4977 ./bashref.texi:7334 ./bashref.texi:8038
  6354. #, no-wrap
  6355. msgid "-p"
  6356. msgstr ""
  6357. #. type: table
  6358. #: ./bashref.texi:4014
  6359. msgid ""
  6360. "Display Readline function names and bindings in such a way that they can be "
  6361. "used as input or in a Readline initialization file."
  6362. msgstr ""
  6363. #. type: item
  6364. #: ./bashref.texi:4015 ./bashref.texi:4740 ./bashref.texi:5028
  6365. #, no-wrap
  6366. msgid "-P"
  6367. msgstr ""
  6368. #. type: table
  6369. #: ./bashref.texi:4017
  6370. msgid "List current Readline function names and bindings."
  6371. msgstr ""
  6372. #. type: item
  6373. #: ./bashref.texi:4018 ./bashref.texi:4733 ./bashref.texi:5000 ./bashref.texi:7337
  6374. #, no-wrap
  6375. msgid "-v"
  6376. msgstr ""
  6377. #. type: table
  6378. #: ./bashref.texi:4021
  6379. msgid ""
  6380. "Display Readline variable names and values in such a way that they can be "
  6381. "used as input or in a Readline initialization file."
  6382. msgstr ""
  6383. #. type: item
  6384. #: ./bashref.texi:4022
  6385. #, no-wrap
  6386. msgid "-V"
  6387. msgstr ""
  6388. #. type: table
  6389. #: ./bashref.texi:4024
  6390. msgid "List current Readline variable names and values."
  6391. msgstr ""
  6392. #. type: item
  6393. #: ./bashref.texi:4025 ./bashref.texi:4340 ./bashref.texi:4412 ./bashref.texi:4571 ./bashref.texi:4724 ./bashref.texi:5108 ./bashref.texi:6495 ./bashref.texi:8044
  6394. #, no-wrap
  6395. msgid "-s"
  6396. msgstr ""
  6397. #. type: table
  6398. #: ./bashref.texi:4029
  6399. msgid ""
  6400. "Display Readline key sequences bound to macros and the strings they output "
  6401. "in such a way that they can be used as input or in a Readline initialization "
  6402. "file."
  6403. msgstr ""
  6404. #. type: item
  6405. #: ./bashref.texi:4030 ./bashref.texi:4675
  6406. #, no-wrap
  6407. msgid "-S"
  6408. msgstr ""
  6409. #. type: table
  6410. #: ./bashref.texi:4032
  6411. msgid "Display Readline key sequences bound to macros and the strings they output."
  6412. msgstr ""
  6413. #. type: item
  6414. #: ./bashref.texi:4033
  6415. #, no-wrap
  6416. msgid "-f @var{filename}"
  6417. msgstr ""
  6418. #. type: table
  6419. #: ./bashref.texi:4035
  6420. msgid "Read key bindings from @var{filename}."
  6421. msgstr ""
  6422. #. type: item
  6423. #: ./bashref.texi:4036
  6424. #, no-wrap
  6425. msgid "-q @var{function}"
  6426. msgstr ""
  6427. #. type: table
  6428. #: ./bashref.texi:4038
  6429. msgid "Query about which keys invoke the named @var{function}."
  6430. msgstr ""
  6431. #. type: item
  6432. #: ./bashref.texi:4039
  6433. #, no-wrap
  6434. msgid "-u @var{function}"
  6435. msgstr ""
  6436. #. type: table
  6437. #: ./bashref.texi:4041
  6438. msgid "Unbind all keys bound to the named @var{function}."
  6439. msgstr ""
  6440. #. type: item
  6441. #: ./bashref.texi:4042
  6442. #, no-wrap
  6443. msgid "-r @var{keyseq}"
  6444. msgstr ""
  6445. #. type: table
  6446. #: ./bashref.texi:4044
  6447. msgid "Remove any current binding for @var{keyseq}."
  6448. msgstr ""
  6449. #. type: item
  6450. #: ./bashref.texi:4045
  6451. #, no-wrap
  6452. msgid "-x @var{keyseq:shell-command}"
  6453. msgstr ""
  6454. #. type: table
  6455. #: ./bashref.texi:4055
  6456. msgid ""
  6457. "Cause @var{shell-command} to be executed whenever @var{keyseq} is entered. "
  6458. "When @var{shell-command} is executed, the shell sets the "
  6459. "@code{READLINE_LINE} variable to the contents of the Readline line buffer "
  6460. "and the @code{READLINE_POINT} variable to the current location of the "
  6461. "insertion point. If the executed command changes the value of "
  6462. "@code{READLINE_LINE} or @code{READLINE_POINT}, those new values will be "
  6463. "reflected in the editing state."
  6464. msgstr ""
  6465. #. type: item
  6466. #: ./bashref.texi:4056
  6467. #, no-wrap
  6468. msgid "-X"
  6469. msgstr ""
  6470. #. type: table
  6471. #: ./bashref.texi:4059
  6472. msgid ""
  6473. "List all key sequences bound to shell commands and the associated commands "
  6474. "in a format that can be reused as input."
  6475. msgstr ""
  6476. #. type: table
  6477. #: ./bashref.texi:4064
  6478. msgid ""
  6479. "The return status is zero unless an invalid option is supplied or an error "
  6480. "occurs."
  6481. msgstr ""
  6482. #. type: example
  6483. #: ./bashref.texi:4069
  6484. #, no-wrap
  6485. msgid "builtin [@var{shell-builtin} [@var{args}]]\n"
  6486. msgstr ""
  6487. #. type: table
  6488. #: ./bashref.texi:4077
  6489. msgid ""
  6490. "Run a shell builtin, passing it @var{args}, and return its exit status. "
  6491. "This is useful when defining a shell function with the same name as a shell "
  6492. "builtin, retaining the functionality of the builtin within the function. "
  6493. "The return status is non-zero if @var{shell-builtin} is not a shell builtin "
  6494. "command."
  6495. msgstr ""
  6496. #. type: btindex
  6497. #: ./bashref.texi:4078 ./bashref.texi:4079
  6498. #, no-wrap
  6499. msgid "caller"
  6500. msgstr ""
  6501. #. type: example
  6502. #: ./bashref.texi:4082
  6503. #, no-wrap
  6504. msgid "caller [@var{expr}]\n"
  6505. msgstr ""
  6506. #. type: table
  6507. #: ./bashref.texi:4086
  6508. msgid ""
  6509. "Returns the context of any active subroutine call (a shell function or a "
  6510. "script executed with the @code{.} or @code{source} builtins)."
  6511. msgstr ""
  6512. #. type: table
  6513. #: ./bashref.texi:4094
  6514. msgid ""
  6515. "Without @var{expr}, @code{caller} displays the line number and source "
  6516. "filename of the current subroutine call. If a non-negative integer is "
  6517. "supplied as @var{expr}, @code{caller} displays the line number, subroutine "
  6518. "name, and source file corresponding to that position in the current "
  6519. "execution call stack. This extra information may be used, for example, to "
  6520. "print a stack trace. The current frame is frame 0."
  6521. msgstr ""
  6522. #. type: table
  6523. #: ./bashref.texi:4098
  6524. msgid ""
  6525. "The return value is 0 unless the shell is not executing a subroutine call or "
  6526. "@var{expr} does not correspond to a valid position in the call stack."
  6527. msgstr ""
  6528. #. type: btindex
  6529. #: ./bashref.texi:4099 ./bashref.texi:4100
  6530. #, no-wrap
  6531. msgid "command"
  6532. msgstr ""
  6533. #. type: example
  6534. #: ./bashref.texi:4103
  6535. #, no-wrap
  6536. msgid "command [-pVv] @var{command} [@var{arguments} @dots{}]\n"
  6537. msgstr ""
  6538. #. type: table
  6539. #: ./bashref.texi:4117
  6540. msgid ""
  6541. "Runs @var{command} with @var{arguments} ignoring any shell function named "
  6542. "@var{command}. Only shell builtin commands or commands found by searching "
  6543. "the @env{PATH} are executed. If there is a shell function named @code{ls}, "
  6544. "running @samp{command ls} within the function will execute the external "
  6545. "command @code{ls} instead of calling the function recursively. The "
  6546. "@option{-p} option means to use a default value for @env{PATH} that is "
  6547. "guaranteed to find all of the standard utilities. The return status in this "
  6548. "case is 127 if @var{command} cannot be found or an error occurred, and the "
  6549. "exit status of @var{command} otherwise."
  6550. msgstr ""
  6551. #. type: table
  6552. #: ./bashref.texi:4124
  6553. msgid ""
  6554. "If either the @option{-V} or @option{-v} option is supplied, a description "
  6555. "of @var{command} is printed. The @option{-v} option causes a single word "
  6556. "indicating the command or file name used to invoke @var{command} to be "
  6557. "displayed; the @option{-V} option produces a more verbose description. In "
  6558. "this case, the return status is zero if @var{command} is found, and non-zero "
  6559. "if not."
  6560. msgstr ""
  6561. #. type: btindex
  6562. #: ./bashref.texi:4125 ./bashref.texi:4126
  6563. #, no-wrap
  6564. msgid "declare"
  6565. msgstr ""
  6566. #. type: example
  6567. #: ./bashref.texi:4129
  6568. #, no-wrap
  6569. msgid "declare [-aAfFgilnrtux] [-p] [@var{name}[=@var{value}] @dots{}]\n"
  6570. msgstr ""
  6571. #. type: table
  6572. #: ./bashref.texi:4133
  6573. msgid ""
  6574. "Declare variables and give them attributes. If no @var{name}s are given, "
  6575. "then display the values of variables instead."
  6576. msgstr ""
  6577. #. type: table
  6578. #: ./bashref.texi:4138
  6579. msgid ""
  6580. "The @option{-p} option will display the attributes and values of each "
  6581. "@var{name}. When @option{-p} is used with @var{name} arguments, additional "
  6582. "options, other than @option{-f} and @option{-F}, are ignored."
  6583. msgstr ""
  6584. #. type: table
  6585. #: ./bashref.texi:4145
  6586. msgid ""
  6587. "When @option{-p} is supplied without @var{name} arguments, @code{declare} "
  6588. "will display the attributes and values of all variables having the "
  6589. "attributes specified by the additional options. If no other options are "
  6590. "supplied with @option{-p}, @code{declare} will display the attributes and "
  6591. "values of all shell variables. The @option{-f} option will restrict the "
  6592. "display to shell functions."
  6593. msgstr ""
  6594. #. type: table
  6595. #: ./bashref.texi:4152
  6596. msgid ""
  6597. "The @option{-F} option inhibits the display of function definitions; only "
  6598. "the function name and attributes are printed. If the @code{extdebug} shell "
  6599. "option is enabled using @code{shopt} (@pxref{The Shopt Builtin}), the source "
  6600. "file name and line number where each @var{name} is defined are displayed as "
  6601. "well. @option{-F} implies @option{-f}."
  6602. msgstr ""
  6603. #. type: table
  6604. #: ./bashref.texi:4156
  6605. msgid ""
  6606. "The @option{-g} option forces variables to be created or modified at the "
  6607. "global scope, even when @code{declare} is executed in a shell function. It "
  6608. "is ignored in all other cases."
  6609. msgstr ""
  6610. #. type: table
  6611. #: ./bashref.texi:4159
  6612. msgid ""
  6613. "The following options can be used to restrict output to variables with the "
  6614. "specified attributes or to give variables attributes:"
  6615. msgstr ""
  6616. #. type: item
  6617. #: ./bashref.texi:4161 ./bashref.texi:4681 ./bashref.texi:4818
  6618. #, no-wrap
  6619. msgid "-a"
  6620. msgstr ""
  6621. #. type: table
  6622. #: ./bashref.texi:4163
  6623. msgid "Each @var{name} is an indexed array variable (@pxref{Arrays})."
  6624. msgstr ""
  6625. #. type: item
  6626. #: ./bashref.texi:4164
  6627. #, no-wrap
  6628. msgid "-A"
  6629. msgstr ""
  6630. #. type: table
  6631. #: ./bashref.texi:4166
  6632. msgid "Each @var{name} is an associative array variable (@pxref{Arrays})."
  6633. msgstr ""
  6634. #. type: item
  6635. #: ./bashref.texi:4167 ./bashref.texi:4696 ./bashref.texi:4860
  6636. #, no-wrap
  6637. msgid "-f"
  6638. msgstr ""
  6639. #. type: table
  6640. #: ./bashref.texi:4169
  6641. msgid "Use function names only."
  6642. msgstr ""
  6643. #. type: item
  6644. #: ./bashref.texi:4170 ./bashref.texi:4699 ./bashref.texi:6477
  6645. #, no-wrap
  6646. msgid "-i"
  6647. msgstr ""
  6648. #. type: table
  6649. #: ./bashref.texi:4174
  6650. msgid ""
  6651. "The variable is to be treated as an integer; arithmetic evaluation "
  6652. "(@pxref{Shell Arithmetic}) is performed when the variable is assigned a "
  6653. "value."
  6654. msgstr ""
  6655. #. type: table
  6656. #: ./bashref.texi:4179
  6657. msgid ""
  6658. "When the variable is assigned a value, all upper-case characters are "
  6659. "converted to lower-case. The upper-case attribute is disabled."
  6660. msgstr ""
  6661. #. type: item
  6662. #: ./bashref.texi:4180 ./bashref.texi:4407 ./bashref.texi:4711 ./bashref.texi:4878 ./bashref.texi:7363 ./bashref.texi:7386 ./bashref.texi:8034
  6663. #, no-wrap
  6664. msgid "-n"
  6665. msgstr ""
  6666. #. type: table
  6667. #: ./bashref.texi:4189
  6668. msgid ""
  6669. "Give each @var{name} the @var{nameref} attribute, making it a name reference "
  6670. "to another variable. That other variable is defined by the value of "
  6671. "@var{name}. All references, assignments, and attribute modifications to "
  6672. "@var{name}, except for those using or changing the @option{-n} attribute "
  6673. "itself, are performed on the variable referenced by @var{name}'s value. The "
  6674. "nameref attribute cannot be applied to array variables."
  6675. msgstr ""
  6676. #. type: item
  6677. #: ./bashref.texi:4190 ./bashref.texi:4565 ./bashref.texi:4721 ./bashref.texi:6492 ./bashref.texi:8041
  6678. #, no-wrap
  6679. msgid "-r"
  6680. msgstr ""
  6681. #. type: table
  6682. #: ./bashref.texi:4193
  6683. msgid ""
  6684. "Make @var{name}s readonly. These names cannot then be assigned values by "
  6685. "subsequent assignment statements or unset."
  6686. msgstr ""
  6687. #. type: item
  6688. #: ./bashref.texi:4194 ./bashref.texi:4414 ./bashref.texi:4727 ./bashref.texi:4991
  6689. #, no-wrap
  6690. msgid "-t"
  6691. msgstr ""
  6692. #. type: table
  6693. #: ./bashref.texi:4199
  6694. msgid ""
  6695. "Give each @var{name} the @code{trace} attribute. Traced functions inherit "
  6696. "the @code{DEBUG} and @code{RETURN} traps from the calling shell. The trace "
  6697. "attribute has no special meaning for variables."
  6698. msgstr ""
  6699. #. type: item
  6700. #: ./bashref.texi:4200 ./bashref.texi:4416 ./bashref.texi:4730 ./bashref.texi:4994 ./bashref.texi:5111
  6701. #, no-wrap
  6702. msgid "-u"
  6703. msgstr ""
  6704. #. type: table
  6705. #: ./bashref.texi:4204
  6706. msgid ""
  6707. "When the variable is assigned a value, all lower-case characters are "
  6708. "converted to upper-case. The lower-case attribute is disabled."
  6709. msgstr ""
  6710. #. type: item
  6711. #: ./bashref.texi:4205 ./bashref.texi:4737 ./bashref.texi:5003
  6712. #, no-wrap
  6713. msgid "-x"
  6714. msgstr ""
  6715. #. type: table
  6716. #: ./bashref.texi:4208
  6717. msgid "Mark each @var{name} for export to subsequent commands via the environment."
  6718. msgstr ""
  6719. #. type: table
  6720. #: ./bashref.texi:4218
  6721. msgid ""
  6722. "Using @samp{+} instead of @samp{-} turns off the attribute instead, with the "
  6723. "exceptions that @samp{+a} and @samp{+A} may not be used to destroy array "
  6724. "variables and @samp{+r} will not remove the readonly attribute. When used "
  6725. "in a function, @code{declare} makes each @var{name} local, as with the "
  6726. "@code{local} command, unless the @option{-g} option is used. If a variable "
  6727. "name is followed by =@var{value}, the value of the variable is set to "
  6728. "@var{value}."
  6729. msgstr ""
  6730. #. type: table
  6731. #: ./bashref.texi:4222
  6732. msgid ""
  6733. "When using @option{-a} or @option{-A} and the compound assignment syntax to "
  6734. "create array variables, additional attributes do not take effect until "
  6735. "subsequent assignments."
  6736. msgstr ""
  6737. #. type: table
  6738. #: ./bashref.texi:4232
  6739. msgid ""
  6740. "The return status is zero unless an invalid option is encountered, an "
  6741. "attempt is made to define a function using @samp{-f foo=bar}, an attempt is "
  6742. "made to assign a value to a readonly variable, an attempt is made to assign "
  6743. "a value to an array variable without using the compound assignment syntax "
  6744. "(@pxref{Arrays}), one of the @var{names} is not a valid shell variable name, "
  6745. "an attempt is made to turn off readonly status for a readonly variable, an "
  6746. "attempt is made to turn off array status for an array variable, or an "
  6747. "attempt is made to display a non-existent function with @option{-f}."
  6748. msgstr ""
  6749. #. type: btindex
  6750. #: ./bashref.texi:4233 ./bashref.texi:4234
  6751. #, no-wrap
  6752. msgid "echo"
  6753. msgstr ""
  6754. #. type: example
  6755. #: ./bashref.texi:4237
  6756. #, no-wrap
  6757. msgid "echo [-neE] [@var{arg} @dots{}]\n"
  6758. msgstr ""
  6759. #. type: table
  6760. #: ./bashref.texi:4251
  6761. msgid ""
  6762. "Output the @var{arg}s, separated by spaces, terminated with a newline. The "
  6763. "return status is 0 unless a write error occurs. If @option{-n} is "
  6764. "specified, the trailing newline is suppressed. If the @option{-e} option is "
  6765. "given, interpretation of the following backslash-escaped characters is "
  6766. "enabled. The @option{-E} option disables the interpretation of these escape "
  6767. "characters, even on systems where they are interpreted by default. The "
  6768. "@code{xpg_echo} shell option may be used to dynamically determine whether or "
  6769. "not @code{echo} expands these escape characters by default. @code{echo} "
  6770. "does not interpret @option{--} to mean the end of options."
  6771. msgstr ""
  6772. #. type: table
  6773. #: ./bashref.texi:4253
  6774. msgid "@code{echo} interprets the following escape sequences:"
  6775. msgstr ""
  6776. #. type: item
  6777. #: ./bashref.texi:4258
  6778. #, no-wrap
  6779. msgid "\\c"
  6780. msgstr ""
  6781. #. type: table
  6782. #: ./bashref.texi:4260
  6783. msgid "suppress further output"
  6784. msgstr ""
  6785. #. type: table
  6786. #: ./bashref.texi:4263
  6787. msgid "escape"
  6788. msgstr ""
  6789. #. type: table
  6790. #: ./bashref.texi:4267
  6791. msgid "new line"
  6792. msgstr ""
  6793. #. type: item
  6794. #: ./bashref.texi:4275
  6795. #, no-wrap
  6796. msgid "\\0@var{nnn}"
  6797. msgstr ""
  6798. #. type: table
  6799. #: ./bashref.texi:4278
  6800. msgid ""
  6801. "the eight-bit character whose value is the octal value @var{nnn} (zero to "
  6802. "three octal digits)"
  6803. msgstr ""
  6804. #. type: btindex
  6805. #: ./bashref.texi:4289 ./bashref.texi:4290
  6806. #, no-wrap
  6807. msgid "enable"
  6808. msgstr ""
  6809. #. type: example
  6810. #: ./bashref.texi:4293
  6811. #, no-wrap
  6812. msgid "enable [-a] [-dnps] [-f @var{filename}] [@var{name} @dots{}]\n"
  6813. msgstr ""
  6814. #. type: table
  6815. #: ./bashref.texi:4303
  6816. msgid ""
  6817. "Enable and disable builtin shell commands. Disabling a builtin allows a "
  6818. "disk command which has the same name as a shell builtin to be executed "
  6819. "without specifying a full pathname, even though the shell normally searches "
  6820. "for builtins before disk commands. If @option{-n} is used, the @var{name}s "
  6821. "become disabled. Otherwise @var{name}s are enabled. For example, to use "
  6822. "the @code{test} binary found via @env{$PATH} instead of the shell builtin "
  6823. "version, type @samp{enable -n test}."
  6824. msgstr ""
  6825. #. type: table
  6826. #: ./bashref.texi:4309
  6827. msgid ""
  6828. "If the @option{-p} option is supplied, or no @var{name} arguments appear, a "
  6829. "list of shell builtins is printed. With no other arguments, the list "
  6830. "consists of all enabled shell builtins. The @option{-a} option means to "
  6831. "list each builtin with an indication of whether or not it is enabled."
  6832. msgstr ""
  6833. #. type: table
  6834. #: ./bashref.texi:4313
  6835. msgid ""
  6836. "The @option{-f} option means to load the new builtin command @var{name} from "
  6837. "shared object @var{filename}, on systems that support dynamic loading. The "
  6838. "@option{-d} option will delete a builtin loaded with @option{-f}."
  6839. msgstr ""
  6840. #. type: table
  6841. #: ./bashref.texi:4318
  6842. msgid ""
  6843. "If there are no options, a list of the shell builtins is displayed. The "
  6844. "@option{-s} option restricts @code{enable} to the @sc{posix} special "
  6845. "builtins. If @option{-s} is used with @option{-f}, the new builtin becomes "
  6846. "a special builtin (@pxref{Special Builtins})."
  6847. msgstr ""
  6848. #. type: table
  6849. #: ./bashref.texi:4321
  6850. msgid ""
  6851. "The return status is zero unless a @var{name} is not a shell builtin or "
  6852. "there is an error loading a new builtin from a shared object."
  6853. msgstr ""
  6854. #. type: btindex
  6855. #: ./bashref.texi:4322 ./bashref.texi:4323
  6856. #, no-wrap
  6857. msgid "help"
  6858. msgstr ""
  6859. #. type: example
  6860. #: ./bashref.texi:4326
  6861. #, no-wrap
  6862. msgid "help [-dms] [@var{pattern}]\n"
  6863. msgstr ""
  6864. #. type: table
  6865. #: ./bashref.texi:4332
  6866. msgid ""
  6867. "Display helpful information about builtin commands. If @var{pattern} is "
  6868. "specified, @code{help} gives detailed help on all commands matching "
  6869. "@var{pattern}, otherwise a list of the builtins is printed."
  6870. msgstr ""
  6871. #. type: item
  6872. #: ./bashref.texi:4336 ./bashref.texi:4402 ./bashref.texi:4690
  6873. #, no-wrap
  6874. msgid "-d"
  6875. msgstr ""
  6876. #. type: table
  6877. #: ./bashref.texi:4338
  6878. msgid "Display a short description of each @var{pattern}"
  6879. msgstr ""
  6880. #. type: item
  6881. #: ./bashref.texi:4338 ./bashref.texi:4708 ./bashref.texi:4872
  6882. #, no-wrap
  6883. msgid "-m"
  6884. msgstr ""
  6885. #. type: table
  6886. #: ./bashref.texi:4340
  6887. msgid "Display the description of each @var{pattern} in a manpage-like format"
  6888. msgstr ""
  6889. #. type: table
  6890. #: ./bashref.texi:4342
  6891. msgid "Display only a short usage synopsis for each @var{pattern}"
  6892. msgstr ""
  6893. #. type: table
  6894. #: ./bashref.texi:4345
  6895. msgid "The return status is zero unless no command matches @var{pattern}."
  6896. msgstr ""
  6897. #. type: btindex
  6898. #: ./bashref.texi:4346 ./bashref.texi:4347
  6899. #, no-wrap
  6900. msgid "let"
  6901. msgstr ""
  6902. #. type: example
  6903. #: ./bashref.texi:4350
  6904. #, no-wrap
  6905. msgid "let @var{expression} [@var{expression} @dots{}]\n"
  6906. msgstr ""
  6907. #. type: table
  6908. #: ./bashref.texi:4357
  6909. msgid ""
  6910. "The @code{let} builtin allows arithmetic to be performed on shell "
  6911. "variables. Each @var{expression} is evaluated according to the rules given "
  6912. "below in @ref{Shell Arithmetic}. If the last @var{expression} evaluates to "
  6913. "0, @code{let} returns 1; otherwise 0 is returned."
  6914. msgstr ""
  6915. #. type: btindex
  6916. #: ./bashref.texi:4358 ./bashref.texi:4359
  6917. #, no-wrap
  6918. msgid "local"
  6919. msgstr ""
  6920. #. type: example
  6921. #: ./bashref.texi:4362
  6922. #, no-wrap
  6923. msgid "local [@var{option}] @var{name}[=@var{value}] @dots{}\n"
  6924. msgstr ""
  6925. #. type: table
  6926. #: ./bashref.texi:4377
  6927. msgid ""
  6928. "For each argument, a local variable named @var{name} is created, and "
  6929. "assigned @var{value}. The @var{option} can be any of the options accepted "
  6930. "by @code{declare}. @code{local} can only be used within a function; it "
  6931. "makes the variable @var{name} have a visible scope restricted to that "
  6932. "function and its children. If @var{name} is @samp{-}, the set of shell "
  6933. "options is made local to the function in which @code{local} is invoked: "
  6934. "shell options changed using the @code{set} builtin inside the function are "
  6935. "restored to their original values when the function returns. The return "
  6936. "status is zero unless @code{local} is used outside a function, an invalid "
  6937. "@var{name} is supplied, or @var{name} is a readonly variable."
  6938. msgstr ""
  6939. #. type: btindex
  6940. #: ./bashref.texi:4378 ./bashref.texi:4379
  6941. #, no-wrap
  6942. msgid "logout"
  6943. msgstr ""
  6944. #. type: example
  6945. #: ./bashref.texi:4382
  6946. #, no-wrap
  6947. msgid "logout [@var{n}]\n"
  6948. msgstr ""
  6949. #. type: table
  6950. #: ./bashref.texi:4386
  6951. msgid "Exit a login shell, returning a status of @var{n} to the shell's parent."
  6952. msgstr ""
  6953. #. type: btindex
  6954. #: ./bashref.texi:4387 ./bashref.texi:4388
  6955. #, no-wrap
  6956. msgid "mapfile"
  6957. msgstr ""
  6958. #. type: example
  6959. #: ./bashref.texi:4392
  6960. #, no-wrap
  6961. msgid ""
  6962. "mapfile [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s "
  6963. "@var{count}]\n"
  6964. " [-t] [-u @var{fd}] [-C @var{callback}] [-c @var{quantum}] "
  6965. "[@var{array}]\n"
  6966. msgstr ""
  6967. #. type: table
  6968. #: ./bashref.texi:4399
  6969. msgid ""
  6970. "Read lines from the standard input into the indexed array variable "
  6971. "@var{array}, or from file descriptor @var{fd} if the @option{-u} option is "
  6972. "supplied. The variable @code{MAPFILE} is the default @var{array}. Options, "
  6973. "if supplied, have the following meanings:"
  6974. msgstr ""
  6975. #. type: table
  6976. #: ./bashref.texi:4407
  6977. msgid ""
  6978. "The first character of @var{delim} is used to terminate each input line, "
  6979. "rather than newline. If @var{delim} is the empty string, @code{mapfile} "
  6980. "will terminate a line when it reads a NUL character."
  6981. msgstr ""
  6982. #. type: table
  6983. #: ./bashref.texi:4409
  6984. msgid "Copy at most @var{count} lines. If @var{count} is 0, all lines are copied."
  6985. msgstr ""
  6986. #. type: item
  6987. #: ./bashref.texi:4409
  6988. #, no-wrap
  6989. msgid "-O"
  6990. msgstr ""
  6991. #. type: table
  6992. #: ./bashref.texi:4412
  6993. msgid ""
  6994. "Begin assigning to @var{array} at index @var{origin}. The default index is "
  6995. "0."
  6996. msgstr ""
  6997. #. type: table
  6998. #: ./bashref.texi:4414
  6999. msgid "Discard the first @var{count} lines read."
  7000. msgstr ""
  7001. #. type: table
  7002. #: ./bashref.texi:4416
  7003. msgid "Remove a trailing @var{delim} (default newline) from each line read."
  7004. msgstr ""
  7005. #. type: table
  7006. #: ./bashref.texi:4418
  7007. msgid "Read lines from file descriptor @var{fd} instead of the standard input."
  7008. msgstr ""
  7009. #. type: item
  7010. #: ./bashref.texi:4418 ./bashref.texi:5015
  7011. #, no-wrap
  7012. msgid "-C"
  7013. msgstr ""
  7014. #. type: table
  7015. #: ./bashref.texi:4421
  7016. msgid ""
  7017. "Evaluate @var{callback} each time @var{quantum} lines are read. The "
  7018. "@option{-c} option specifies @var{quantum}."
  7019. msgstr ""
  7020. #. type: item
  7021. #: ./bashref.texi:4421 ./bashref.texi:4687 ./bashref.texi:6468 ./bashref.texi:7329
  7022. #, no-wrap
  7023. msgid "-c"
  7024. msgstr ""
  7025. #. type: table
  7026. #: ./bashref.texi:4423
  7027. msgid "Specify the number of lines read between each call to @var{callback}."
  7028. msgstr ""
  7029. #. type: table
  7030. #: ./bashref.texi:4432
  7031. msgid ""
  7032. "If @option{-C} is specified without @option{-c}, the default quantum is "
  7033. "5000. When @var{callback} is evaluated, it is supplied the index of the "
  7034. "next array element to be assigned and the line to be assigned to that "
  7035. "element as additional arguments. @var{callback} is evaluated after the line "
  7036. "is read but before the array element is assigned."
  7037. msgstr ""
  7038. #. type: table
  7039. #: ./bashref.texi:4435
  7040. msgid ""
  7041. "If not supplied with an explicit origin, @code{mapfile} will clear "
  7042. "@var{array} before assigning to it."
  7043. msgstr ""
  7044. #. type: table
  7045. #: ./bashref.texi:4439
  7046. msgid ""
  7047. "@code{mapfile} returns successfully unless an invalid option or option "
  7048. "argument is supplied, @var{array} is invalid or unassignable, or @var{array} "
  7049. "is not an indexed array."
  7050. msgstr ""
  7051. #. type: btindex
  7052. #: ./bashref.texi:4440 ./bashref.texi:4441
  7053. #, no-wrap
  7054. msgid "printf"
  7055. msgstr ""
  7056. #. type: example
  7057. #: ./bashref.texi:4444
  7058. #, no-wrap
  7059. msgid "printf [-v @var{var}] @var{format} [@var{arguments}]\n"
  7060. msgstr ""
  7061. #. type: table
  7062. #: ./bashref.texi:4450
  7063. msgid ""
  7064. "Write the formatted @var{arguments} to the standard output under the control "
  7065. "of the @var{format}. The @option{-v} option causes the output to be "
  7066. "assigned to the variable @var{var} rather than being printed to the standard "
  7067. "output."
  7068. msgstr ""
  7069. #. type: table
  7070. #: ./bashref.texi:4458
  7071. msgid ""
  7072. "The @var{format} is a character string which contains three types of "
  7073. "objects: plain characters, which are simply copied to standard output, "
  7074. "character escape sequences, which are converted and copied to the standard "
  7075. "output, and format specifications, each of which causes printing of the next "
  7076. "successive @var{argument}. In addition to the standard @code{printf(1)} "
  7077. "formats, @code{printf} interprets the following extensions:"
  7078. msgstr ""
  7079. #. type: item
  7080. #: ./bashref.texi:4460
  7081. #, no-wrap
  7082. msgid "%b"
  7083. msgstr ""
  7084. #. type: table
  7085. #: ./bashref.texi:4464
  7086. msgid ""
  7087. "Causes @code{printf} to expand backslash escape sequences in the "
  7088. "corresponding @var{argument} in the same way as @code{echo -e} (@pxref{Bash "
  7089. "Builtins})."
  7090. msgstr ""
  7091. #. type: item
  7092. #: ./bashref.texi:4464
  7093. #, no-wrap
  7094. msgid "%q"
  7095. msgstr ""
  7096. #. type: table
  7097. #: ./bashref.texi:4467
  7098. msgid ""
  7099. "Causes @code{printf} to output the corresponding @var{argument} in a format "
  7100. "that can be reused as shell input."
  7101. msgstr ""
  7102. #. type: item
  7103. #: ./bashref.texi:4467
  7104. #, no-wrap
  7105. msgid "%(@var{datefmt})T"
  7106. msgstr ""
  7107. #. type: table
  7108. #: ./bashref.texi:4476
  7109. msgid ""
  7110. "Causes @code{printf} to output the date-time string resulting from using "
  7111. "@var{datefmt} as a format string for @code{strftime}(3). The corresponding "
  7112. "@var{argument} is an integer representing the number of seconds since the "
  7113. "epoch. Two special argument values may be used: -1 represents the current "
  7114. "time, and -2 represents the time the shell was invoked. If no argument is "
  7115. "specified, conversion behaves as if -1 had been given. This is an exception "
  7116. "to the usual @code{printf} behavior."
  7117. msgstr ""
  7118. #. type: table
  7119. #: ./bashref.texi:4483
  7120. msgid ""
  7121. "Arguments to non-string format specifiers are treated as C language "
  7122. "constants, except that a leading plus or minus sign is allowed, and if the "
  7123. "leading character is a single or double quote, the value is the ASCII value "
  7124. "of the following character."
  7125. msgstr ""
  7126. #. type: table
  7127. #: ./bashref.texi:4489
  7128. msgid ""
  7129. "The @var{format} is reused as necessary to consume all of the "
  7130. "@var{arguments}. If the @var{format} requires more @var{arguments} than are "
  7131. "supplied, the extra format specifications behave as if a zero value or null "
  7132. "string, as appropriate, had been supplied. The return value is zero on "
  7133. "success, non-zero on failure."
  7134. msgstr ""
  7135. #. type: btindex
  7136. #: ./bashref.texi:4490 ./bashref.texi:4491
  7137. #, no-wrap
  7138. msgid "read"
  7139. msgstr ""
  7140. #. type: example
  7141. #: ./bashref.texi:4495
  7142. #, no-wrap
  7143. msgid ""
  7144. "read [-ers] [-a @var{aname}] [-d @var{delim}] [-i @var{text}] [-n "
  7145. "@var{nchars}]\n"
  7146. " [-N @var{nchars}] [-p @var{prompt}] [-t @var{timeout}] [-u @var{fd}] "
  7147. "[@var{name} @dots{}]\n"
  7148. msgstr ""
  7149. #. type: table
  7150. #: ./bashref.texi:4519
  7151. msgid ""
  7152. "One line is read from the standard input, or from the file descriptor "
  7153. "@var{fd} supplied as an argument to the @option{-u} option, split into words "
  7154. "as described above in @ref{Word Splitting}, and the first word is assigned "
  7155. "to the first @var{name}, the second word to the second @var{name}, and so "
  7156. "on. If there are more words than names, the remaining words and their "
  7157. "intervening delimiters are assigned to the last @var{name}. If there are "
  7158. "fewer words read from the input stream than names, the remaining names are "
  7159. "assigned empty values. The characters in the value of the @env{IFS} "
  7160. "variable are used to split the line into words using the same rules the "
  7161. "shell uses for expansion (described above in @ref{Word Splitting}). The "
  7162. "backslash character @samp{\\} may be used to remove any special meaning for "
  7163. "the next character read and for line continuation. If no names are "
  7164. "supplied, the line read is assigned to the variable @env{REPLY}. The exit "
  7165. "status is zero, unless end-of-file is encountered, @code{read} times out (in "
  7166. "which case the status is greater than 128), a variable assignment error "
  7167. "(such as assigning to a readonly variable) occurs, or an invalid file "
  7168. "descriptor is supplied as the argument to @option{-u}."
  7169. msgstr ""
  7170. #. type: item
  7171. #: ./bashref.texi:4523
  7172. #, no-wrap
  7173. msgid "-a @var{aname}"
  7174. msgstr ""
  7175. #. type: table
  7176. #: ./bashref.texi:4528
  7177. msgid ""
  7178. "The words are assigned to sequential indices of the array variable "
  7179. "@var{aname}, starting at 0. All elements are removed from @var{aname} "
  7180. "before the assignment. Other @var{name} arguments are ignored."
  7181. msgstr ""
  7182. #. type: item
  7183. #: ./bashref.texi:4529
  7184. #, no-wrap
  7185. msgid "-d @var{delim}"
  7186. msgstr ""
  7187. #. type: table
  7188. #: ./bashref.texi:4534
  7189. msgid ""
  7190. "The first character of @var{delim} is used to terminate the input line, "
  7191. "rather than newline. If @var{delim} is the empty string, @code{read} will "
  7192. "terminate a line when it reads a NUL character."
  7193. msgstr ""
  7194. #. type: item
  7195. #: ./bashref.texi:4535 ./bashref.texi:4693 ./bashref.texi:4827
  7196. #, no-wrap
  7197. msgid "-e"
  7198. msgstr ""
  7199. #. type: table
  7200. #: ./bashref.texi:4539
  7201. msgid ""
  7202. "Readline (@pxref{Command Line Editing}) is used to obtain the line. "
  7203. "Readline uses the current (or default, if line editing was not previously "
  7204. "active) editing settings, but uses Readline's default filename completion."
  7205. msgstr ""
  7206. #. type: item
  7207. #: ./bashref.texi:4540
  7208. #, no-wrap
  7209. msgid "-i @var{text}"
  7210. msgstr ""
  7211. #. type: table
  7212. #: ./bashref.texi:4543
  7213. msgid ""
  7214. "If Readline is being used to read the line, @var{text} is placed into the "
  7215. "editing buffer before editing begins."
  7216. msgstr ""
  7217. #. type: item
  7218. #: ./bashref.texi:4544
  7219. #, no-wrap
  7220. msgid "-n @var{nchars}"
  7221. msgstr ""
  7222. #. type: table
  7223. #: ./bashref.texi:4548
  7224. msgid ""
  7225. "@code{read} returns after reading @var{nchars} characters rather than "
  7226. "waiting for a complete line of input, but honors a delimiter if fewer than "
  7227. "@var{nchars} characters are read before the delimiter."
  7228. msgstr ""
  7229. #. type: item
  7230. #: ./bashref.texi:4549
  7231. #, no-wrap
  7232. msgid "-N @var{nchars}"
  7233. msgstr ""
  7234. #. type: table
  7235. #: ./bashref.texi:4559
  7236. msgid ""
  7237. "@code{read} returns after reading exactly @var{nchars} characters rather "
  7238. "than waiting for a complete line of input, unless EOF is encountered or "
  7239. "@code{read} times out. Delimiter characters encountered in the input are "
  7240. "not treated specially and do not cause @code{read} to return until "
  7241. "@var{nchars} characters are read. The result is not split on the characters "
  7242. "in @code{IFS}; the intent is that the variable is assigned exactly the "
  7243. "characters read (with the exception of backslash; see the @option{-r} option "
  7244. "below)."
  7245. msgstr ""
  7246. #. type: item
  7247. #: ./bashref.texi:4560
  7248. #, no-wrap
  7249. msgid "-p @var{prompt}"
  7250. msgstr ""
  7251. #. type: table
  7252. #: ./bashref.texi:4564
  7253. msgid ""
  7254. "Display @var{prompt}, without a trailing newline, before attempting to read "
  7255. "any input. The prompt is displayed only if input is coming from a terminal."
  7256. msgstr ""
  7257. #. type: table
  7258. #: ./bashref.texi:4570
  7259. msgid ""
  7260. "If this option is given, backslash does not act as an escape character. The "
  7261. "backslash is considered to be part of the line. In particular, a "
  7262. "backslash-newline pair may not then be used as a line continuation."
  7263. msgstr ""
  7264. #. type: table
  7265. #: ./bashref.texi:4574
  7266. msgid "Silent mode. If input is coming from a terminal, characters are not echoed."
  7267. msgstr ""
  7268. #. type: item
  7269. #: ./bashref.texi:4575
  7270. #, no-wrap
  7271. msgid "-t @var{timeout}"
  7272. msgstr ""
  7273. #. type: table
  7274. #: ./bashref.texi:4590
  7275. msgid ""
  7276. "Cause @code{read} to time out and return failure if a complete line of input "
  7277. "(or a specified number of characters) is not read within @var{timeout} "
  7278. "seconds. @var{timeout} may be a decimal number with a fractional portion "
  7279. "following the decimal point. This option is only effective if @code{read} "
  7280. "is reading input from a terminal, pipe, or other special file; it has no "
  7281. "effect when reading from regular files. If @code{read} times out, "
  7282. "@code{read} saves any partial input read into the specified variable "
  7283. "@var{name}. If @var{timeout} is 0, @code{read} returns immediately, without "
  7284. "trying to read and data. The exit status is 0 if input is available on the "
  7285. "specified file descriptor, non-zero otherwise. The exit status is greater "
  7286. "than 128 if the timeout is exceeded."
  7287. msgstr ""
  7288. #. type: item
  7289. #: ./bashref.texi:4591
  7290. #, no-wrap
  7291. msgid "-u @var{fd}"
  7292. msgstr ""
  7293. #. type: table
  7294. #: ./bashref.texi:4593
  7295. msgid "Read input from file descriptor @var{fd}."
  7296. msgstr ""
  7297. #. type: btindex
  7298. #: ./bashref.texi:4595 ./bashref.texi:4596
  7299. #, no-wrap
  7300. msgid "readarray"
  7301. msgstr ""
  7302. #. type: example
  7303. #: ./bashref.texi:4600
  7304. #, no-wrap
  7305. msgid ""
  7306. "readarray [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s "
  7307. "@var{count}]\n"
  7308. " [-t] [-u @var{fd}] [-C @var{callback}] [-c @var{quantum}] "
  7309. "[@var{array}]\n"
  7310. msgstr ""
  7311. #. type: table
  7312. #: ./bashref.texi:4605
  7313. msgid ""
  7314. "Read lines from the standard input into the indexed array variable "
  7315. "@var{array}, or from file descriptor @var{fd} if the @option{-u} option is "
  7316. "supplied."
  7317. msgstr ""
  7318. #. type: table
  7319. #: ./bashref.texi:4607
  7320. msgid "A synonym for @code{mapfile}."
  7321. msgstr ""
  7322. #. type: btindex
  7323. #: ./bashref.texi:4608 ./bashref.texi:4609
  7324. #, no-wrap
  7325. msgid "source"
  7326. msgstr ""
  7327. #. type: example
  7328. #: ./bashref.texi:4612
  7329. #, no-wrap
  7330. msgid "source @var{filename}\n"
  7331. msgstr ""
  7332. #. type: table
  7333. #: ./bashref.texi:4615
  7334. msgid "A synonym for @code{.} (@pxref{Bourne Shell Builtins})."
  7335. msgstr ""
  7336. #. type: btindex
  7337. #: ./bashref.texi:4616 ./bashref.texi:4617
  7338. #, no-wrap
  7339. msgid "type"
  7340. msgstr ""
  7341. #. type: example
  7342. #: ./bashref.texi:4620
  7343. #, no-wrap
  7344. msgid "type [-afptP] [@var{name} @dots{}]\n"
  7345. msgstr ""
  7346. #. type: table
  7347. #: ./bashref.texi:4624
  7348. msgid ""
  7349. "For each @var{name}, indicate how it would be interpreted if used as a "
  7350. "command name."
  7351. msgstr ""
  7352. #. type: table
  7353. #: ./bashref.texi:4632
  7354. msgid ""
  7355. "If the @option{-t} option is used, @code{type} prints a single word which is "
  7356. "one of @samp{alias}, @samp{function}, @samp{builtin}, @samp{file} or "
  7357. "@samp{keyword}, if @var{name} is an alias, shell function, shell builtin, "
  7358. "disk file, or shell reserved word, respectively. If the @var{name} is not "
  7359. "found, then nothing is printed, and @code{type} returns a failure status."
  7360. msgstr ""
  7361. #. type: table
  7362. #: ./bashref.texi:4636
  7363. msgid ""
  7364. "If the @option{-p} option is used, @code{type} either returns the name of "
  7365. "the disk file that would be executed, or nothing if @option{-t} would not "
  7366. "return @samp{file}."
  7367. msgstr ""
  7368. #. type: table
  7369. #: ./bashref.texi:4639
  7370. msgid ""
  7371. "The @option{-P} option forces a path search for each @var{name}, even if "
  7372. "@option{-t} would not return @samp{file}."
  7373. msgstr ""
  7374. #. type: table
  7375. #: ./bashref.texi:4642
  7376. msgid ""
  7377. "If a command is hashed, @option{-p} and @option{-P} print the hashed value, "
  7378. "which is not necessarily the file that appears first in @code{$PATH}."
  7379. msgstr ""
  7380. #. type: table
  7381. #: ./bashref.texi:4647
  7382. msgid ""
  7383. "If the @option{-a} option is used, @code{type} returns all of the places "
  7384. "that contain an executable named @var{file}. This includes aliases and "
  7385. "functions, if and only if the @option{-p} option is not also used."
  7386. msgstr ""
  7387. #. type: table
  7388. #: ./bashref.texi:4650
  7389. msgid ""
  7390. "If the @option{-f} option is used, @code{type} does not attempt to find "
  7391. "shell functions, as with the @code{command} builtin."
  7392. msgstr ""
  7393. #. type: table
  7394. #: ./bashref.texi:4653
  7395. msgid ""
  7396. "The return status is zero if all of the @var{names} are found, non-zero if "
  7397. "any are not found."
  7398. msgstr ""
  7399. #. type: btindex
  7400. #: ./bashref.texi:4654 ./bashref.texi:4655
  7401. #, no-wrap
  7402. msgid "typeset"
  7403. msgstr ""
  7404. #. type: example
  7405. #: ./bashref.texi:4658
  7406. #, no-wrap
  7407. msgid "typeset [-afFgrxilnrtux] [-p] [@var{name}[=@var{value}] @dots{}]\n"
  7408. msgstr ""
  7409. #. type: table
  7410. #: ./bashref.texi:4663
  7411. msgid ""
  7412. "The @code{typeset} command is supplied for compatibility with the Korn "
  7413. "shell. It is a synonym for the @code{declare} builtin command."
  7414. msgstr ""
  7415. #. type: btindex
  7416. #: ./bashref.texi:4664 ./bashref.texi:4665
  7417. #, no-wrap
  7418. msgid "ulimit"
  7419. msgstr ""
  7420. #. type: example
  7421. #: ./bashref.texi:4668
  7422. #, no-wrap
  7423. msgid "ulimit [-HSabcdefiklmnpqrstuvxPT] [@var{limit}]\n"
  7424. msgstr ""
  7425. #. type: table
  7426. #: ./bashref.texi:4673
  7427. msgid ""
  7428. "@code{ulimit} provides control over the resources available to processes "
  7429. "started by the shell, on systems that allow such control. If an option is "
  7430. "given, it is interpreted as follows:"
  7431. msgstr ""
  7432. #. type: table
  7433. #: ./bashref.texi:4677
  7434. msgid "Change and report the soft limit associated with a resource."
  7435. msgstr ""
  7436. #. type: item
  7437. #: ./bashref.texi:4678 ./bashref.texi:5024
  7438. #, no-wrap
  7439. msgid "-H"
  7440. msgstr ""
  7441. #. type: table
  7442. #: ./bashref.texi:4680
  7443. msgid "Change and report the hard limit associated with a resource."
  7444. msgstr ""
  7445. #. type: table
  7446. #: ./bashref.texi:4683
  7447. msgid "All current limits are reported."
  7448. msgstr ""
  7449. #. type: item
  7450. #: ./bashref.texi:4684 ./bashref.texi:4823
  7451. #, no-wrap
  7452. msgid "-b"
  7453. msgstr ""
  7454. #. type: table
  7455. #: ./bashref.texi:4686
  7456. msgid "The maximum socket buffer size."
  7457. msgstr ""
  7458. #. type: table
  7459. #: ./bashref.texi:4689
  7460. msgid "The maximum size of core files created."
  7461. msgstr ""
  7462. #. type: table
  7463. #: ./bashref.texi:4692
  7464. msgid "The maximum size of a process's data segment."
  7465. msgstr ""
  7466. #. type: table
  7467. #: ./bashref.texi:4695
  7468. msgid "The maximum scheduling priority (\"nice\")."
  7469. msgstr ""
  7470. #. type: table
  7471. #: ./bashref.texi:4698
  7472. msgid "The maximum size of files written by the shell and its children."
  7473. msgstr ""
  7474. #. type: table
  7475. #: ./bashref.texi:4701
  7476. msgid "The maximum number of pending signals."
  7477. msgstr ""
  7478. #. type: item
  7479. #: ./bashref.texi:4702 ./bashref.texi:4867
  7480. #, no-wrap
  7481. msgid "-k"
  7482. msgstr ""
  7483. #. type: table
  7484. #: ./bashref.texi:4704
  7485. msgid "The maximum number of kqueues that may be allocated."
  7486. msgstr ""
  7487. #. type: table
  7488. #: ./bashref.texi:4707
  7489. msgid "The maximum size that may be locked into memory."
  7490. msgstr ""
  7491. #. type: table
  7492. #: ./bashref.texi:4710
  7493. msgid "The maximum resident set size (many systems do not honor this limit)."
  7494. msgstr ""
  7495. #. type: table
  7496. #: ./bashref.texi:4714
  7497. msgid ""
  7498. "The maximum number of open file descriptors (most systems do not allow this "
  7499. "value to be set)."
  7500. msgstr ""
  7501. #. type: table
  7502. #: ./bashref.texi:4717
  7503. msgid "The pipe buffer size."
  7504. msgstr ""
  7505. #. type: itemx
  7506. #: ./bashref.texi:4718 ./bashref.texi:5114 ./bashref.texi:8413
  7507. #, no-wrap
  7508. msgid "-q"
  7509. msgstr ""
  7510. #. type: table
  7511. #: ./bashref.texi:4720
  7512. msgid "The maximum number of bytes in POSIX message queues."
  7513. msgstr ""
  7514. #. type: table
  7515. #: ./bashref.texi:4723
  7516. msgid "The maximum real-time scheduling priority."
  7517. msgstr ""
  7518. #. type: table
  7519. #: ./bashref.texi:4726
  7520. msgid "The maximum stack size."
  7521. msgstr ""
  7522. #. type: table
  7523. #: ./bashref.texi:4729
  7524. msgid "The maximum amount of cpu time in seconds."
  7525. msgstr ""
  7526. #. type: table
  7527. #: ./bashref.texi:4732
  7528. msgid "The maximum number of processes available to a single user."
  7529. msgstr ""
  7530. #. type: table
  7531. #: ./bashref.texi:4736
  7532. msgid ""
  7533. "The maximum amount of virtual memory available to the shell, and, on some "
  7534. "systems, to its children."
  7535. msgstr ""
  7536. #. type: table
  7537. #: ./bashref.texi:4739
  7538. msgid "The maximum number of file locks."
  7539. msgstr ""
  7540. #. type: table
  7541. #: ./bashref.texi:4742
  7542. msgid "The maximum number of pseudoterminals."
  7543. msgstr ""
  7544. #. type: item
  7545. #: ./bashref.texi:4743 ./bashref.texi:5053
  7546. #, no-wrap
  7547. msgid "-T"
  7548. msgstr ""
  7549. #. type: table
  7550. #: ./bashref.texi:4745
  7551. msgid "The maximum number of threads."
  7552. msgstr ""
  7553. #. type: table
  7554. #: ./bashref.texi:4768
  7555. msgid ""
  7556. "If @var{limit} is given, and the @option{-a} option is not used, @var{limit} "
  7557. "is the new value of the specified resource. The special @var{limit} values "
  7558. "@code{hard}, @code{soft}, and @code{unlimited} stand for the current hard "
  7559. "limit, the current soft limit, and no limit, respectively. A hard limit "
  7560. "cannot be increased by a non-root user once it is set; a soft limit may be "
  7561. "increased up to the value of the hard limit. Otherwise, the current value "
  7562. "of the soft limit for the specified resource is printed, unless the "
  7563. "@option{-H} option is supplied. When setting new limits, if neither "
  7564. "@option{-H} nor @option{-S} is supplied, both the hard and soft limits are "
  7565. "set. If no option is given, then @option{-f} is assumed. Values are in "
  7566. "1024-byte increments, except for @option{-t}, which is in seconds; "
  7567. "@option{-p}, which is in units of 512-byte blocks; @option{-P}, @option{-T}, "
  7568. "@option{-b}, @option{-k}, @option{-n} and @option{-u}, which are unscaled "
  7569. "values; and, when in @sc{posix} Mode (@pxref{Bash POSIX Mode}), @option{-c} "
  7570. "and @option{-f}, which are in 512-byte increments."
  7571. msgstr ""
  7572. #. type: table
  7573. #: ./bashref.texi:4771
  7574. msgid ""
  7575. "The return status is zero unless an invalid option or argument is supplied, "
  7576. "or an error occurs while setting a new limit."
  7577. msgstr ""
  7578. #. type: btindex
  7579. #: ./bashref.texi:4772 ./bashref.texi:4773
  7580. #, no-wrap
  7581. msgid "unalias"
  7582. msgstr ""
  7583. #. type: example
  7584. #: ./bashref.texi:4776
  7585. #, no-wrap
  7586. msgid "unalias [-a] [@var{name} @dots{} ]\n"
  7587. msgstr ""
  7588. #. type: table
  7589. #: ./bashref.texi:4781
  7590. msgid ""
  7591. "Remove each @var{name} from the list of aliases. If @option{-a} is "
  7592. "supplied, all aliases are removed. Aliases are described in @ref{Aliases}."
  7593. msgstr ""
  7594. #. type: subsection
  7595. #: ./bashref.texi:4790 ./bashref.texi:4792 ./bashref.texi:4793
  7596. #, no-wrap
  7597. msgid "The Set Builtin"
  7598. msgstr ""
  7599. #. type: menuentry
  7600. #: ./bashref.texi:4790
  7601. msgid "Change the values of shell attributes and positional parameters."
  7602. msgstr ""
  7603. #. type: subsection
  7604. #: ./bashref.texi:4790 ./bashref.texi:5083 ./bashref.texi:5084
  7605. #, no-wrap
  7606. msgid "The Shopt Builtin"
  7607. msgstr ""
  7608. #. type: menuentry
  7609. #: ./bashref.texi:4790
  7610. msgid "Modify shell optional behavior."
  7611. msgstr ""
  7612. #. type: Plain text
  7613. #: ./bashref.texi:4798
  7614. msgid ""
  7615. "This builtin is so complicated that it deserves its own section. @code{set} "
  7616. "allows you to change the values of shell options and set the positional "
  7617. "parameters, or to display the names and values of shell variables."
  7618. msgstr ""
  7619. #. type: btindex
  7620. #: ./bashref.texi:4800 ./bashref.texi:4801
  7621. #, no-wrap
  7622. msgid "set"
  7623. msgstr ""
  7624. #. type: example
  7625. #: ./bashref.texi:4805
  7626. #, no-wrap
  7627. msgid ""
  7628. "set [--abefhkmnptuvxBCEHPT] [-o @var{option-name}] [@var{argument} "
  7629. "@dots{}]\n"
  7630. "set [+abefhkmnptuvxBCEHPT] [+o @var{option-name}] [@var{argument} @dots{}]\n"
  7631. msgstr ""
  7632. #. type: table
  7633. #: ./bashref.texi:4813
  7634. msgid ""
  7635. "If no options or arguments are supplied, @code{set} displays the names and "
  7636. "values of all shell variables and functions, sorted according to the current "
  7637. "locale, in a format that may be reused as input for setting or resetting the "
  7638. "currently-set variables. Read-only variables cannot be reset. In "
  7639. "@sc{posix} mode, only shell variables are listed."
  7640. msgstr ""
  7641. #. type: table
  7642. #: ./bashref.texi:4816
  7643. msgid ""
  7644. "When options are supplied, they set or unset shell attributes. Options, if "
  7645. "specified, have the following meanings:"
  7646. msgstr ""
  7647. #. type: table
  7648. #: ./bashref.texi:4822
  7649. msgid ""
  7650. "Each variable or function that is created or modified is given the export "
  7651. "attribute and marked for export to the environment of subsequent commands."
  7652. msgstr ""
  7653. #. type: table
  7654. #: ./bashref.texi:4826
  7655. msgid ""
  7656. "Cause the status of terminated background jobs to be reported immediately, "
  7657. "rather than before printing the next primary prompt."
  7658. msgstr ""
  7659. #. type: table
  7660. #: ./bashref.texi:4845
  7661. msgid ""
  7662. "Exit immediately if a pipeline (@pxref{Pipelines}), which may consist of a "
  7663. "single simple command (@pxref{Simple Commands}), a list (@pxref{Lists}), or "
  7664. "a compound command (@pxref{Compound Commands}) returns a non-zero status. "
  7665. "The shell does not exit if the command that fails is part of the command "
  7666. "list immediately following a @code{while} or @code{until} keyword, part of "
  7667. "the test in an @code{if} statement, part of any command executed in a "
  7668. "@code{&&} or @code{||} list except the command following the final @code{&&} "
  7669. "or @code{||}, any command in a pipeline but the last, or if the command's "
  7670. "return status is being inverted with @code{!}. If a compound command other "
  7671. "than a subshell returns a non-zero status because a command failed while "
  7672. "@option{-e} was being ignored, the shell does not exit. A trap on "
  7673. "@code{ERR}, if set, is executed before the shell exits."
  7674. msgstr ""
  7675. #. type: table
  7676. #: ./bashref.texi:4849
  7677. msgid ""
  7678. "This option applies to the shell environment and each subshell environment "
  7679. "separately (@pxref{Command Execution Environment}), and may cause subshells "
  7680. "to exit before executing all the commands in the subshell."
  7681. msgstr ""
  7682. #. type: table
  7683. #: ./bashref.texi:4859
  7684. msgid ""
  7685. "If a compound command or shell function executes in a context where "
  7686. "@option{-e} is being ignored, none of the commands executed within the "
  7687. "compound command or function body will be affected by the @option{-e} "
  7688. "setting, even if @option{-e} is set and a command returns a failure status. "
  7689. "If a compound command or shell function sets @option{-e} while executing in "
  7690. "a context where @option{-e} is ignored, that setting will not have any "
  7691. "effect until the compound command or the command containing the function "
  7692. "call completes."
  7693. msgstr ""
  7694. #. type: table
  7695. #: ./bashref.texi:4862
  7696. msgid "Disable filename expansion (globbing)."
  7697. msgstr ""
  7698. #. type: item
  7699. #: ./bashref.texi:4863
  7700. #, no-wrap
  7701. msgid "-h"
  7702. msgstr ""
  7703. #. type: table
  7704. #: ./bashref.texi:4866
  7705. msgid ""
  7706. "Locate and remember (hash) commands as they are looked up for execution. "
  7707. "This option is enabled by default."
  7708. msgstr ""
  7709. #. type: table
  7710. #: ./bashref.texi:4871
  7711. msgid ""
  7712. "All arguments in the form of assignment statements are placed in the "
  7713. "environment for a command, not just those that precede the command name."
  7714. msgstr ""
  7715. #. type: table
  7716. #: ./bashref.texi:4877
  7717. msgid ""
  7718. "Job control is enabled (@pxref{Job Control}). All processes run in a "
  7719. "separate process group. When a background job completes, the shell prints a "
  7720. "line containing its exit status."
  7721. msgstr ""
  7722. #. type: table
  7723. #: ./bashref.texi:4882
  7724. msgid ""
  7725. "Read commands but do not execute them. This may be used to check a script "
  7726. "for syntax errors. This option is ignored by interactive shells."
  7727. msgstr ""
  7728. #. type: item
  7729. #: ./bashref.texi:4883
  7730. #, no-wrap
  7731. msgid "-o @var{option-name}"
  7732. msgstr ""
  7733. #. type: table
  7734. #: ./bashref.texi:4886
  7735. msgid "Set the option corresponding to @var{option-name}:"
  7736. msgstr ""
  7737. #. type: item
  7738. #: ./bashref.texi:4888
  7739. #, no-wrap
  7740. msgid "allexport"
  7741. msgstr ""
  7742. #. type: table
  7743. #: ./bashref.texi:4890
  7744. msgid "Same as @code{-a}."
  7745. msgstr ""
  7746. #. type: item
  7747. #: ./bashref.texi:4891
  7748. #, no-wrap
  7749. msgid "braceexpand"
  7750. msgstr ""
  7751. #. type: table
  7752. #: ./bashref.texi:4893
  7753. msgid "Same as @code{-B}."
  7754. msgstr ""
  7755. #. type: item
  7756. #: ./bashref.texi:4894
  7757. #, no-wrap
  7758. msgid "emacs"
  7759. msgstr ""
  7760. #. type: table
  7761. #: ./bashref.texi:4897
  7762. msgid ""
  7763. "Use an @code{emacs}-style line editing interface (@pxref{Command Line "
  7764. "Editing}). This also affects the editing interface used for @code{read -e}."
  7765. msgstr ""
  7766. #. type: item
  7767. #: ./bashref.texi:4898
  7768. #, no-wrap
  7769. msgid "errexit"
  7770. msgstr ""
  7771. #. type: table
  7772. #: ./bashref.texi:4900
  7773. msgid "Same as @code{-e}."
  7774. msgstr ""
  7775. #. type: item
  7776. #: ./bashref.texi:4901
  7777. #, no-wrap
  7778. msgid "errtrace"
  7779. msgstr ""
  7780. #. type: table
  7781. #: ./bashref.texi:4903
  7782. msgid "Same as @code{-E}."
  7783. msgstr ""
  7784. #. type: item
  7785. #: ./bashref.texi:4904
  7786. #, no-wrap
  7787. msgid "functrace"
  7788. msgstr ""
  7789. #. type: table
  7790. #: ./bashref.texi:4906
  7791. msgid "Same as @code{-T}."
  7792. msgstr ""
  7793. #. type: item
  7794. #: ./bashref.texi:4907
  7795. #, no-wrap
  7796. msgid "hashall"
  7797. msgstr ""
  7798. #. type: table
  7799. #: ./bashref.texi:4909
  7800. msgid "Same as @code{-h}."
  7801. msgstr ""
  7802. #. type: item
  7803. #: ./bashref.texi:4910
  7804. #, no-wrap
  7805. msgid "histexpand"
  7806. msgstr ""
  7807. #. type: table
  7808. #: ./bashref.texi:4912
  7809. msgid "Same as @code{-H}."
  7810. msgstr ""
  7811. #. type: item
  7812. #: ./bashref.texi:4913
  7813. #, no-wrap
  7814. msgid "history"
  7815. msgstr ""
  7816. #. type: table
  7817. #: ./bashref.texi:4916
  7818. msgid ""
  7819. "Enable command history, as described in @ref{Bash History Facilities}. This "
  7820. "option is on by default in interactive shells."
  7821. msgstr ""
  7822. #. type: item
  7823. #: ./bashref.texi:4917
  7824. #, no-wrap
  7825. msgid "ignoreeof"
  7826. msgstr ""
  7827. #. type: table
  7828. #: ./bashref.texi:4919
  7829. msgid "An interactive shell will not exit upon reading EOF."
  7830. msgstr ""
  7831. #. type: item
  7832. #: ./bashref.texi:4920
  7833. #, no-wrap
  7834. msgid "keyword"
  7835. msgstr ""
  7836. #. type: table
  7837. #: ./bashref.texi:4922
  7838. msgid "Same as @code{-k}."
  7839. msgstr ""
  7840. #. type: item
  7841. #: ./bashref.texi:4923
  7842. #, no-wrap
  7843. msgid "monitor"
  7844. msgstr ""
  7845. #. type: table
  7846. #: ./bashref.texi:4925
  7847. msgid "Same as @code{-m}."
  7848. msgstr ""
  7849. #. type: item
  7850. #: ./bashref.texi:4926
  7851. #, no-wrap
  7852. msgid "noclobber"
  7853. msgstr ""
  7854. #. type: table
  7855. #: ./bashref.texi:4928
  7856. msgid "Same as @code{-C}."
  7857. msgstr ""
  7858. #. type: item
  7859. #: ./bashref.texi:4929
  7860. #, no-wrap
  7861. msgid "noexec"
  7862. msgstr ""
  7863. #. type: table
  7864. #: ./bashref.texi:4931
  7865. msgid "Same as @code{-n}."
  7866. msgstr ""
  7867. #. type: item
  7868. #: ./bashref.texi:4932
  7869. #, no-wrap
  7870. msgid "noglob"
  7871. msgstr ""
  7872. #. type: table
  7873. #: ./bashref.texi:4934
  7874. msgid "Same as @code{-f}."
  7875. msgstr ""
  7876. #. type: item
  7877. #: ./bashref.texi:4935
  7878. #, no-wrap
  7879. msgid "nolog"
  7880. msgstr ""
  7881. #. type: table
  7882. #: ./bashref.texi:4937
  7883. msgid "Currently ignored."
  7884. msgstr ""
  7885. #. type: item
  7886. #: ./bashref.texi:4938
  7887. #, no-wrap
  7888. msgid "notify"
  7889. msgstr ""
  7890. #. type: table
  7891. #: ./bashref.texi:4940
  7892. msgid "Same as @code{-b}."
  7893. msgstr ""
  7894. #. type: item
  7895. #: ./bashref.texi:4941
  7896. #, no-wrap
  7897. msgid "nounset"
  7898. msgstr ""
  7899. #. type: table
  7900. #: ./bashref.texi:4943
  7901. msgid "Same as @code{-u}."
  7902. msgstr ""
  7903. #. type: item
  7904. #: ./bashref.texi:4944
  7905. #, no-wrap
  7906. msgid "onecmd"
  7907. msgstr ""
  7908. #. type: table
  7909. #: ./bashref.texi:4946
  7910. msgid "Same as @code{-t}."
  7911. msgstr ""
  7912. #. type: item
  7913. #: ./bashref.texi:4947
  7914. #, no-wrap
  7915. msgid "physical"
  7916. msgstr ""
  7917. #. type: table
  7918. #: ./bashref.texi:4949
  7919. msgid "Same as @code{-P}."
  7920. msgstr ""
  7921. #. type: item
  7922. #: ./bashref.texi:4950
  7923. #, no-wrap
  7924. msgid "pipefail"
  7925. msgstr ""
  7926. #. type: table
  7927. #: ./bashref.texi:4955
  7928. msgid ""
  7929. "If set, the return value of a pipeline is the value of the last (rightmost) "
  7930. "command to exit with a non-zero status, or zero if all commands in the "
  7931. "pipeline exit successfully. This option is disabled by default."
  7932. msgstr ""
  7933. #. type: item
  7934. #: ./bashref.texi:4956
  7935. #, no-wrap
  7936. msgid "posix"
  7937. msgstr ""
  7938. #. type: table
  7939. #: ./bashref.texi:4962
  7940. msgid ""
  7941. "Change the behavior of Bash where the default operation differs from the "
  7942. "@sc{posix} standard to match the standard (@pxref{Bash POSIX Mode}). This "
  7943. "is intended to make Bash behave as a strict superset of that standard."
  7944. msgstr ""
  7945. #. type: item
  7946. #: ./bashref.texi:4963
  7947. #, no-wrap
  7948. msgid "privileged"
  7949. msgstr ""
  7950. #. type: table
  7951. #: ./bashref.texi:4965
  7952. msgid "Same as @code{-p}."
  7953. msgstr ""
  7954. #. type: item
  7955. #: ./bashref.texi:4966
  7956. #, no-wrap
  7957. msgid "verbose"
  7958. msgstr ""
  7959. #. type: table
  7960. #: ./bashref.texi:4968
  7961. msgid "Same as @code{-v}."
  7962. msgstr ""
  7963. #. type: item
  7964. #: ./bashref.texi:4969
  7965. #, no-wrap
  7966. msgid "vi"
  7967. msgstr ""
  7968. #. type: table
  7969. #: ./bashref.texi:4972
  7970. msgid ""
  7971. "Use a @code{vi}-style line editing interface. This also affects the editing "
  7972. "interface used for @code{read -e}."
  7973. msgstr ""
  7974. #. type: item
  7975. #: ./bashref.texi:4973
  7976. #, no-wrap
  7977. msgid "xtrace"
  7978. msgstr ""
  7979. #. type: table
  7980. #: ./bashref.texi:4975
  7981. msgid "Same as @code{-x}."
  7982. msgstr ""
  7983. #. type: table
  7984. #: ./bashref.texi:4990
  7985. msgid ""
  7986. "Turn on privileged mode. In this mode, the @env{$BASH_ENV} and @env{$ENV} "
  7987. "files are not processed, shell functions are not inherited from the "
  7988. "environment, and the @env{SHELLOPTS}, @env{BASHOPTS}, @env{CDPATH} and "
  7989. "@env{GLOBIGNORE} variables, if they appear in the environment, are ignored. "
  7990. "If the shell is started with the effective user (group) id not equal to the "
  7991. "real user (group) id, and the @option{-p} option is not supplied, these "
  7992. "actions are taken and the effective user id is set to the real user id. If "
  7993. "the @option{-p} option is supplied at startup, the effective user id is not "
  7994. "reset. Turning this option off causes the effective user and group ids to "
  7995. "be set to the real user and group ids."
  7996. msgstr ""
  7997. #. type: table
  7998. #: ./bashref.texi:4993
  7999. msgid "Exit after reading and executing one command."
  8000. msgstr ""
  8001. #. type: table
  8002. #: ./bashref.texi:4999
  8003. msgid ""
  8004. "Treat unset variables and parameters other than the special parameters "
  8005. "@samp{@@} or @samp{*} as an error when performing parameter expansion. An "
  8006. "error message will be written to the standard error, and a non-interactive "
  8007. "shell will exit."
  8008. msgstr ""
  8009. #. type: table
  8010. #: ./bashref.texi:5002
  8011. msgid "Print shell input lines as they are read."
  8012. msgstr ""
  8013. #. type: table
  8014. #: ./bashref.texi:5010
  8015. msgid ""
  8016. "Print a trace of simple commands, @code{for} commands, @code{case} commands, "
  8017. "@code{select} commands, and arithmetic @code{for} commands and their "
  8018. "arguments or associated word lists after they are expanded and before they "
  8019. "are executed. The value of the @env{PS4} variable is expanded and the "
  8020. "resultant value is printed before the command and its expanded arguments."
  8021. msgstr ""
  8022. #. type: item
  8023. #: ./bashref.texi:5011
  8024. #, no-wrap
  8025. msgid "-B"
  8026. msgstr ""
  8027. #. type: table
  8028. #: ./bashref.texi:5014
  8029. msgid ""
  8030. "The shell will perform brace expansion (@pxref{Brace Expansion}). This "
  8031. "option is on by default."
  8032. msgstr ""
  8033. #. type: table
  8034. #: ./bashref.texi:5018
  8035. msgid ""
  8036. "Prevent output redirection using @samp{>}, @samp{>&}, and @samp{<>} from "
  8037. "overwriting existing files."
  8038. msgstr ""
  8039. #. type: item
  8040. #: ./bashref.texi:5019
  8041. #, no-wrap
  8042. msgid "-E"
  8043. msgstr ""
  8044. #. type: table
  8045. #: ./bashref.texi:5023
  8046. msgid ""
  8047. "If set, any trap on @code{ERR} is inherited by shell functions, command "
  8048. "substitutions, and commands executed in a subshell environment. The "
  8049. "@code{ERR} trap is normally not inherited in such cases."
  8050. msgstr ""
  8051. #. type: table
  8052. #: ./bashref.texi:5027
  8053. msgid ""
  8054. "Enable @samp{!} style history substitution (@pxref{History Interaction}). "
  8055. "This option is on by default for interactive shells."
  8056. msgstr ""
  8057. #. type: table
  8058. #: ./bashref.texi:5034
  8059. msgid ""
  8060. "If set, do not resolve symbolic links when performing commands such as "
  8061. "@code{cd} which change the current directory. The physical directory is "
  8062. "used instead. By default, Bash follows the logical chain of directories "
  8063. "when performing commands which change the current directory."
  8064. msgstr ""
  8065. #. type: table
  8066. #: ./bashref.texi:5037
  8067. msgid ""
  8068. "For example, if @file{/usr/sys} is a symbolic link to @file{/usr/local/sys} "
  8069. "then:"
  8070. msgstr ""
  8071. #. type: example
  8072. #: ./bashref.texi:5042
  8073. #, no-wrap
  8074. msgid ""
  8075. "$ cd /usr/sys; echo $PWD\n"
  8076. "/usr/sys\n"
  8077. "$ cd ..; pwd\n"
  8078. "/usr\n"
  8079. msgstr ""
  8080. #. type: table
  8081. #: ./bashref.texi:5046
  8082. msgid "If @code{set -P} is on, then:"
  8083. msgstr ""
  8084. #. type: example
  8085. #: ./bashref.texi:5051
  8086. #, no-wrap
  8087. msgid ""
  8088. "$ cd /usr/sys; echo $PWD\n"
  8089. "/usr/local/sys\n"
  8090. "$ cd ..; pwd\n"
  8091. "/usr/local\n"
  8092. msgstr ""
  8093. #. type: table
  8094. #: ./bashref.texi:5059
  8095. msgid ""
  8096. "If set, any trap on @code{DEBUG} and @code{RETURN} are inherited by shell "
  8097. "functions, command substitutions, and commands executed in a subshell "
  8098. "environment. The @code{DEBUG} and @code{RETURN} traps are normally not "
  8099. "inherited in such cases."
  8100. msgstr ""
  8101. #. type: item
  8102. #: ./bashref.texi:5060 ./bashref.texi:6520
  8103. #, no-wrap
  8104. msgid "--"
  8105. msgstr ""
  8106. #. type: table
  8107. #: ./bashref.texi:5064
  8108. msgid ""
  8109. "If no arguments follow this option, then the positional parameters are "
  8110. "unset. Otherwise, the positional parameters are set to the @var{arguments}, "
  8111. "even if some of them begin with a @samp{-}."
  8112. msgstr ""
  8113. #. type: table
  8114. #: ./bashref.texi:5070
  8115. msgid ""
  8116. "Signal the end of options, cause all remaining @var{arguments} to be "
  8117. "assigned to the positional parameters. The @option{-x} and @option{-v} "
  8118. "options are turned off. If there are no arguments, the positional "
  8119. "parameters remain unchanged."
  8120. msgstr ""
  8121. #. type: table
  8122. #: ./bashref.texi:5075
  8123. msgid ""
  8124. "Using @samp{+} rather than @samp{-} causes these options to be turned off. "
  8125. "The options can also be used upon invocation of the shell. The current set "
  8126. "of options may be found in @code{$-}."
  8127. msgstr ""
  8128. #. type: table
  8129. #: ./bashref.texi:5079
  8130. msgid ""
  8131. "The remaining N @var{arguments} are positional parameters and are assigned, "
  8132. "in order, to @code{$1}, @code{$2}, @dots{} @code{$N}. The special parameter "
  8133. "@code{#} is set to N."
  8134. msgstr ""
  8135. #. type: table
  8136. #: ./bashref.texi:5081
  8137. msgid "The return status is always zero unless an invalid option is supplied."
  8138. msgstr ""
  8139. #. type: Plain text
  8140. #: ./bashref.texi:5087
  8141. msgid "This builtin allows you to change additional shell optional behavior."
  8142. msgstr ""
  8143. #. type: btindex
  8144. #: ./bashref.texi:5090 ./bashref.texi:5091
  8145. #, no-wrap
  8146. msgid "shopt"
  8147. msgstr ""
  8148. #. type: example
  8149. #: ./bashref.texi:5094
  8150. #, no-wrap
  8151. msgid "shopt [-pqsu] [-o] [@var{optname} @dots{}]\n"
  8152. msgstr ""
  8153. #. type: table
  8154. #: ./bashref.texi:5106
  8155. msgid ""
  8156. "Toggle the values of settings controlling optional shell behavior. The "
  8157. "settings can be either those listed below, or, if the @option{-o} option is "
  8158. "used, those available with the @option{-o} option to the @code{set} builtin "
  8159. "command (@pxref{The Set Builtin}). With no options, or with the @option{-p} "
  8160. "option, a list of all settable options is displayed, with an indication of "
  8161. "whether or not each is set; if @var{optnames} are supplied, the output is "
  8162. "restricted to those options. The @option{-p} option causes output to be "
  8163. "displayed in a form that may be reused as input. Other options have the "
  8164. "following meanings:"
  8165. msgstr ""
  8166. #. type: table
  8167. #: ./bashref.texi:5110
  8168. msgid "Enable (set) each @var{optname}."
  8169. msgstr ""
  8170. #. type: table
  8171. #: ./bashref.texi:5113
  8172. msgid "Disable (unset) each @var{optname}."
  8173. msgstr ""
  8174. #. type: table
  8175. #: ./bashref.texi:5120
  8176. msgid ""
  8177. "Suppresses normal output; the return status indicates whether the "
  8178. "@var{optname} is set or unset. If multiple @var{optname} arguments are "
  8179. "given with @option{-q}, the return status is zero if all @var{optnames} are "
  8180. "enabled; non-zero otherwise."
  8181. msgstr ""
  8182. #. type: item
  8183. #: ./bashref.texi:5121
  8184. #, no-wrap
  8185. msgid "-o"
  8186. msgstr ""
  8187. #. type: table
  8188. #: ./bashref.texi:5125
  8189. msgid ""
  8190. "Restricts the values of @var{optname} to be those defined for the "
  8191. "@option{-o} option to the @code{set} builtin (@pxref{The Set Builtin})."
  8192. msgstr ""
  8193. #. type: table
  8194. #: ./bashref.texi:5130
  8195. msgid ""
  8196. "If either @option{-s} or @option{-u} is used with no @var{optname} "
  8197. "arguments, @code{shopt} shows only those options which are set or unset, "
  8198. "respectively."
  8199. msgstr ""
  8200. #. type: table
  8201. #: ./bashref.texi:5133
  8202. msgid ""
  8203. "Unless otherwise noted, the @code{shopt} options are disabled (off) by "
  8204. "default."
  8205. msgstr ""
  8206. #. type: table
  8207. #: ./bashref.texi:5138 ./bashref.texi:5504
  8208. msgid ""
  8209. "The return status when listing options is zero if all @var{optnames} are "
  8210. "enabled, non-zero otherwise. When setting or unsetting options, the return "
  8211. "status is zero unless an @var{optname} is not a valid shell option."
  8212. msgstr ""
  8213. #. type: table
  8214. #: ./bashref.texi:5140
  8215. msgid "The list of @code{shopt} options is:"
  8216. msgstr ""
  8217. #. type: item
  8218. #: ./bashref.texi:5142
  8219. #, no-wrap
  8220. msgid "assoc_expand_once"
  8221. msgstr ""
  8222. #. type: table
  8223. #: ./bashref.texi:5147
  8224. msgid ""
  8225. "If set, the shell suppresses multiple evaluation of associative array "
  8226. "subscripts during arithmetic expression evaluation, while executing builtins "
  8227. "that can perform variable assignments, and while executing builtins that "
  8228. "perform array dereferencing."
  8229. msgstr ""
  8230. #. type: item
  8231. #: ./bashref.texi:5148
  8232. #, no-wrap
  8233. msgid "autocd"
  8234. msgstr ""
  8235. #. type: table
  8236. #: ./bashref.texi:5152
  8237. msgid ""
  8238. "If set, a command name that is the name of a directory is executed as if it "
  8239. "were the argument to the @code{cd} command. This option is only used by "
  8240. "interactive shells."
  8241. msgstr ""
  8242. #. type: item
  8243. #: ./bashref.texi:5153
  8244. #, no-wrap
  8245. msgid "cdable_vars"
  8246. msgstr ""
  8247. #. type: table
  8248. #: ./bashref.texi:5157
  8249. msgid ""
  8250. "If this is set, an argument to the @code{cd} builtin command that is not a "
  8251. "directory is assumed to be the name of a variable whose value is the "
  8252. "directory to change to."
  8253. msgstr ""
  8254. #. type: item
  8255. #: ./bashref.texi:5158
  8256. #, no-wrap
  8257. msgid "cdspell"
  8258. msgstr ""
  8259. #. type: table
  8260. #: ./bashref.texi:5166
  8261. msgid ""
  8262. "If set, minor errors in the spelling of a directory component in a @code{cd} "
  8263. "command will be corrected. The errors checked for are transposed "
  8264. "characters, a missing character, and a character too many. If a correction "
  8265. "is found, the corrected path is printed, and the command proceeds. This "
  8266. "option is only used by interactive shells."
  8267. msgstr ""
  8268. #. type: item
  8269. #: ./bashref.texi:5167
  8270. #, no-wrap
  8271. msgid "checkhash"
  8272. msgstr ""
  8273. #. type: table
  8274. #: ./bashref.texi:5171
  8275. msgid ""
  8276. "If this is set, Bash checks that a command found in the hash table exists "
  8277. "before trying to execute it. If a hashed command no longer exists, a normal "
  8278. "path search is performed."
  8279. msgstr ""
  8280. #. type: item
  8281. #: ./bashref.texi:5172
  8282. #, no-wrap
  8283. msgid "checkjobs"
  8284. msgstr ""
  8285. #. type: table
  8286. #: ./bashref.texi:5178
  8287. msgid ""
  8288. "If set, Bash lists the status of any stopped and running jobs before exiting "
  8289. "an interactive shell. If any jobs are running, this causes the exit to be "
  8290. "deferred until a second exit is attempted without an intervening command "
  8291. "(@pxref{Job Control}). The shell always postpones exiting if any jobs are "
  8292. "stopped."
  8293. msgstr ""
  8294. #. type: item
  8295. #: ./bashref.texi:5179
  8296. #, no-wrap
  8297. msgid "checkwinsize"
  8298. msgstr ""
  8299. #. type: table
  8300. #: ./bashref.texi:5184
  8301. msgid ""
  8302. "If set, Bash checks the window size after each external (non-builtin) "
  8303. "command and, if necessary, updates the values of @env{LINES} and "
  8304. "@env{COLUMNS}. This option is enabled by default."
  8305. msgstr ""
  8306. #. type: item
  8307. #: ./bashref.texi:5185
  8308. #, no-wrap
  8309. msgid "cmdhist"
  8310. msgstr ""
  8311. #. type: table
  8312. #: ./bashref.texi:5192
  8313. msgid ""
  8314. "If set, Bash attempts to save all lines of a multiple-line command in the "
  8315. "same history entry. This allows easy re-editing of multi-line commands. "
  8316. "This option is enabled by default, but only has an effect if command history "
  8317. "is enabled (@pxref{Bash History Facilities})."
  8318. msgstr ""
  8319. #. type: item
  8320. #: ./bashref.texi:5193
  8321. #, no-wrap
  8322. msgid "compat31"
  8323. msgstr ""
  8324. #. type: table
  8325. #: ./bashref.texi:5202
  8326. msgid ""
  8327. "If set, Bash changes its behavior to that of version 3.1 with respect to "
  8328. "quoted arguments to the conditional command's @samp{=~} operator and with "
  8329. "respect to locale-specific string comparison when using the @code{[[} "
  8330. "conditional command's @samp{<} and @samp{>} operators. Bash versions prior "
  8331. "to bash-4.1 use ASCII collation and strcmp(3); bash-4.1 and later use the "
  8332. "current locale's collation sequence and strcoll(3)."
  8333. msgstr ""
  8334. #. type: item
  8335. #: ./bashref.texi:5203
  8336. #, no-wrap
  8337. msgid "compat32"
  8338. msgstr ""
  8339. #. type: table
  8340. #: ./bashref.texi:5211
  8341. msgid ""
  8342. "If set, Bash changes its behavior to that of version 3.2 with respect to "
  8343. "locale-specific string comparison when using the @code{[[} conditional "
  8344. "command's @samp{<} and @samp{>} operators (see previous item) and the "
  8345. "effect of interrupting a command list. Bash versions 3.2 and earlier "
  8346. "continue with the next command in the list after one terminates due to an "
  8347. "interrupt."
  8348. msgstr ""
  8349. #. type: item
  8350. #: ./bashref.texi:5212
  8351. #, no-wrap
  8352. msgid "compat40"
  8353. msgstr ""
  8354. #. type: table
  8355. #: ./bashref.texi:5221
  8356. msgid ""
  8357. "If set, Bash changes its behavior to that of version 4.0 with respect to "
  8358. "locale-specific string comparison when using the @code{[[} conditional "
  8359. "command's @samp{<} and @samp{>} operators (see description of "
  8360. "@code{compat31}) and the effect of interrupting a command list. Bash "
  8361. "versions 4.0 and later interrupt the list as if the shell received the "
  8362. "interrupt; previous versions continue with the next command in the list."
  8363. msgstr ""
  8364. #. type: item
  8365. #: ./bashref.texi:5222
  8366. #, no-wrap
  8367. msgid "compat41"
  8368. msgstr ""
  8369. #. type: table
  8370. #: ./bashref.texi:5228
  8371. msgid ""
  8372. "If set, Bash, when in @sc{posix} mode, treats a single quote in a "
  8373. "double-quoted parameter expansion as a special character. The single quotes "
  8374. "must match (an even number) and the characters between the single quotes are "
  8375. "considered quoted. This is the behavior of @sc{posix} mode through version "
  8376. "4.1. The default Bash behavior remains as in previous versions."
  8377. msgstr ""
  8378. #. type: item
  8379. #: ./bashref.texi:5229
  8380. #, no-wrap
  8381. msgid "compat42"
  8382. msgstr ""
  8383. #. type: table
  8384. #: ./bashref.texi:5233
  8385. msgid ""
  8386. "If set, Bash does not process the replacement string in the pattern "
  8387. "substitution word expansion using quote removal."
  8388. msgstr ""
  8389. #. type: item
  8390. #: ./bashref.texi:5234
  8391. #, no-wrap
  8392. msgid "compat43"
  8393. msgstr ""
  8394. #. type: table
  8395. #: ./bashref.texi:5244
  8396. msgid ""
  8397. "If set, Bash does not print a warning message if an attempt is made to use a "
  8398. "quoted compound array assignment as an argument to @code{declare}, makes "
  8399. "word expansion errors non-fatal errors that cause the current command to "
  8400. "fail (the default behavior is to make them fatal errors that cause the shell "
  8401. "to exit), and does not reset the loop state when a shell function is "
  8402. "executed (this allows @code{break} or @code{continue} in a shell function to "
  8403. "affect loops in the caller's context)."
  8404. msgstr ""
  8405. #. type: item
  8406. #: ./bashref.texi:5245
  8407. #, no-wrap
  8408. msgid "compat44"
  8409. msgstr ""
  8410. #. type: table
  8411. #: ./bashref.texi:5249
  8412. msgid ""
  8413. "If set, Bash saves the positional parameters to BASH_ARGV and BASH_ARGC "
  8414. "before they are used, regardless of whether or not extended debugging mode "
  8415. "is enabled."
  8416. msgstr ""
  8417. #. type: item
  8418. #: ./bashref.texi:5250
  8419. #, no-wrap
  8420. msgid "complete_fullquote"
  8421. msgstr ""
  8422. #. type: table
  8423. #: ./bashref.texi:5266
  8424. msgid ""
  8425. "If set, Bash quotes all shell metacharacters in filenames and directory "
  8426. "names when performing completion. If not set, Bash removes metacharacters "
  8427. "such as the dollar sign from the set of characters that will be quoted in "
  8428. "completed filenames when these metacharacters appear in shell variable "
  8429. "references in words to be completed. This means that dollar signs in "
  8430. "variable names that expand to directories will not be quoted; however, any "
  8431. "dollar signs appearing in filenames will not be quoted, either. This is "
  8432. "active only when bash is using backslashes to quote completed filenames. "
  8433. "This variable is set by default, which is the default Bash behavior in "
  8434. "versions through 4.2."
  8435. msgstr ""
  8436. #. type: item
  8437. #: ./bashref.texi:5267
  8438. #, no-wrap
  8439. msgid "direxpand"
  8440. msgstr ""
  8441. #. type: table
  8442. #: ./bashref.texi:5273
  8443. msgid ""
  8444. "If set, Bash replaces directory names with the results of word expansion "
  8445. "when performing filename completion. This changes the contents of the "
  8446. "readline editing buffer. If not set, Bash attempts to preserve what the "
  8447. "user typed."
  8448. msgstr ""
  8449. #. type: item
  8450. #: ./bashref.texi:5274
  8451. #, no-wrap
  8452. msgid "dirspell"
  8453. msgstr ""
  8454. #. type: table
  8455. #: ./bashref.texi:5278
  8456. msgid ""
  8457. "If set, Bash attempts spelling correction on directory names during word "
  8458. "completion if the directory name initially supplied does not exist."
  8459. msgstr ""
  8460. #. type: item
  8461. #: ./bashref.texi:5279
  8462. #, no-wrap
  8463. msgid "dotglob"
  8464. msgstr ""
  8465. #. type: table
  8466. #: ./bashref.texi:5284
  8467. msgid ""
  8468. "If set, Bash includes filenames beginning with a `.' in the results of "
  8469. "filename expansion. The filenames @samp{.} and @samp{..} must always be "
  8470. "matched explicitly, even if @code{dotglob} is set."
  8471. msgstr ""
  8472. #. type: item
  8473. #: ./bashref.texi:5285
  8474. #, no-wrap
  8475. msgid "execfail"
  8476. msgstr ""
  8477. #. type: table
  8478. #: ./bashref.texi:5290
  8479. msgid ""
  8480. "If this is set, a non-interactive shell will not exit if it cannot execute "
  8481. "the file specified as an argument to the @code{exec} builtin command. An "
  8482. "interactive shell does not exit if @code{exec} fails."
  8483. msgstr ""
  8484. #. type: item
  8485. #: ./bashref.texi:5291
  8486. #, no-wrap
  8487. msgid "expand_aliases"
  8488. msgstr ""
  8489. #. type: table
  8490. #: ./bashref.texi:5295
  8491. msgid ""
  8492. "If set, aliases are expanded as described below under Aliases, "
  8493. "@ref{Aliases}. This option is enabled by default for interactive shells."
  8494. msgstr ""
  8495. #. type: item
  8496. #: ./bashref.texi:5296
  8497. #, no-wrap
  8498. msgid "extdebug"
  8499. msgstr ""
  8500. #. type: table
  8501. #: ./bashref.texi:5300
  8502. msgid ""
  8503. "If set at shell invocation, arrange to execute the debugger profile before "
  8504. "the shell starts, identical to the @option{--debugger} option. If set after "
  8505. "invocation, behavior intended for use by debuggers is enabled:"
  8506. msgstr ""
  8507. #. type: enumerate
  8508. #: ./bashref.texi:5306
  8509. msgid ""
  8510. "The @option{-F} option to the @code{declare} builtin (@pxref{Bash Builtins}) "
  8511. "displays the source file name and line number corresponding to each function "
  8512. "name supplied as an argument."
  8513. msgstr ""
  8514. #. type: enumerate
  8515. #: ./bashref.texi:5310
  8516. msgid ""
  8517. "If the command run by the @code{DEBUG} trap returns a non-zero value, the "
  8518. "next command is skipped and not executed."
  8519. msgstr ""
  8520. #. type: enumerate
  8521. #: ./bashref.texi:5316
  8522. msgid ""
  8523. "If the command run by the @code{DEBUG} trap returns a value of 2, and the "
  8524. "shell is executing in a subroutine (a shell function or a shell script "
  8525. "executed by the @code{.} or @code{source} builtins), the shell simulates a "
  8526. "call to @code{return}."
  8527. msgstr ""
  8528. #. type: enumerate
  8529. #: ./bashref.texi:5320
  8530. msgid ""
  8531. "@code{BASH_ARGC} and @code{BASH_ARGV} are updated as described in their "
  8532. "descriptions (@pxref{Bash Variables})."
  8533. msgstr ""
  8534. #. type: enumerate
  8535. #: ./bashref.texi:5325
  8536. msgid ""
  8537. "Function tracing is enabled: command substitution, shell functions, and "
  8538. "subshells invoked with @code{( @var{command} )} inherit the @code{DEBUG} and "
  8539. "@code{RETURN} traps."
  8540. msgstr ""
  8541. #. type: enumerate
  8542. #: ./bashref.texi:5330
  8543. msgid ""
  8544. "Error tracing is enabled: command substitution, shell functions, and "
  8545. "subshells invoked with @code{( @var{command} )} inherit the @code{ERR} trap."
  8546. msgstr ""
  8547. #. type: item
  8548. #: ./bashref.texi:5332
  8549. #, no-wrap
  8550. msgid "extglob"
  8551. msgstr ""
  8552. #. type: table
  8553. #: ./bashref.texi:5335
  8554. msgid ""
  8555. "If set, the extended pattern matching features described above "
  8556. "(@pxref{Pattern Matching}) are enabled."
  8557. msgstr ""
  8558. #. type: item
  8559. #: ./bashref.texi:5336
  8560. #, no-wrap
  8561. msgid "extquote"
  8562. msgstr ""
  8563. #. type: table
  8564. #: ./bashref.texi:5340
  8565. msgid ""
  8566. "If set, @code{$'@var{string}'} and @code{$\"@var{string}\"} quoting is "
  8567. "performed within @code{$@{@var{parameter}@}} expansions enclosed in double "
  8568. "quotes. This option is enabled by default."
  8569. msgstr ""
  8570. #. type: item
  8571. #: ./bashref.texi:5341
  8572. #, no-wrap
  8573. msgid "failglob"
  8574. msgstr ""
  8575. #. type: table
  8576. #: ./bashref.texi:5344
  8577. msgid ""
  8578. "If set, patterns which fail to match filenames during filename expansion "
  8579. "result in an expansion error."
  8580. msgstr ""
  8581. #. type: item
  8582. #: ./bashref.texi:5345
  8583. #, no-wrap
  8584. msgid "force_fignore"
  8585. msgstr ""
  8586. #. type: table
  8587. #: ./bashref.texi:5351
  8588. msgid ""
  8589. "If set, the suffixes specified by the @env{FIGNORE} shell variable cause "
  8590. "words to be ignored when performing word completion even if the ignored "
  8591. "words are the only possible completions. @xref{Bash Variables}, for a "
  8592. "description of @env{FIGNORE}. This option is enabled by default."
  8593. msgstr ""
  8594. #. type: item
  8595. #: ./bashref.texi:5352
  8596. #, no-wrap
  8597. msgid "globasciiranges"
  8598. msgstr ""
  8599. #. type: table
  8600. #: ./bashref.texi:5360
  8601. msgid ""
  8602. "If set, range expressions used in pattern matching bracket expressions "
  8603. "(@pxref{Pattern Matching}) behave as if in the traditional C locale when "
  8604. "performing comparisons. That is, the current locale's collating sequence is "
  8605. "not taken into account, so @samp{b} will not collate between @samp{A} and "
  8606. "@samp{B}, and upper-case and lower-case ASCII characters will collate "
  8607. "together."
  8608. msgstr ""
  8609. #. type: item
  8610. #: ./bashref.texi:5361
  8611. #, no-wrap
  8612. msgid "globstar"
  8613. msgstr ""
  8614. #. type: table
  8615. #: ./bashref.texi:5366
  8616. msgid ""
  8617. "If set, the pattern @samp{**} used in a filename expansion context will "
  8618. "match all files and zero or more directories and subdirectories. If the "
  8619. "pattern is followed by a @samp{/}, only directories and subdirectories "
  8620. "match."
  8621. msgstr ""
  8622. #. type: item
  8623. #: ./bashref.texi:5367
  8624. #, no-wrap
  8625. msgid "gnu_errfmt"
  8626. msgstr ""
  8627. #. type: table
  8628. #: ./bashref.texi:5370
  8629. msgid ""
  8630. "If set, shell error messages are written in the standard @sc{gnu} error "
  8631. "message format."
  8632. msgstr ""
  8633. #. type: item
  8634. #: ./bashref.texi:5371
  8635. #, no-wrap
  8636. msgid "histappend"
  8637. msgstr ""
  8638. #. type: table
  8639. #: ./bashref.texi:5375
  8640. msgid ""
  8641. "If set, the history list is appended to the file named by the value of the "
  8642. "@env{HISTFILE} variable when the shell exits, rather than overwriting the "
  8643. "file."
  8644. msgstr ""
  8645. #. type: item
  8646. #: ./bashref.texi:5376
  8647. #, no-wrap
  8648. msgid "histreedit"
  8649. msgstr ""
  8650. #. type: table
  8651. #: ./bashref.texi:5380
  8652. msgid ""
  8653. "If set, and Readline is being used, a user is given the opportunity to "
  8654. "re-edit a failed history substitution."
  8655. msgstr ""
  8656. #. type: item
  8657. #: ./bashref.texi:5381
  8658. #, no-wrap
  8659. msgid "histverify"
  8660. msgstr ""
  8661. #. type: table
  8662. #: ./bashref.texi:5386
  8663. msgid ""
  8664. "If set, and Readline is being used, the results of history substitution are "
  8665. "not immediately passed to the shell parser. Instead, the resulting line is "
  8666. "loaded into the Readline editing buffer, allowing further modification."
  8667. msgstr ""
  8668. #. type: item
  8669. #: ./bashref.texi:5387
  8670. #, no-wrap
  8671. msgid "hostcomplete"
  8672. msgstr ""
  8673. #. type: table
  8674. #: ./bashref.texi:5392
  8675. msgid ""
  8676. "If set, and Readline is being used, Bash will attempt to perform hostname "
  8677. "completion when a word containing a @samp{@@} is being completed "
  8678. "(@pxref{Commands For Completion}). This option is enabled by default."
  8679. msgstr ""
  8680. #. type: item
  8681. #: ./bashref.texi:5393
  8682. #, no-wrap
  8683. msgid "huponexit"
  8684. msgstr ""
  8685. #. type: table
  8686. #: ./bashref.texi:5396
  8687. msgid ""
  8688. "If set, Bash will send @code{SIGHUP} to all jobs when an interactive login "
  8689. "shell exits (@pxref{Signals})."
  8690. msgstr ""
  8691. #. type: item
  8692. #: ./bashref.texi:5397
  8693. #, no-wrap
  8694. msgid "inherit_errexit"
  8695. msgstr ""
  8696. #. type: table
  8697. #: ./bashref.texi:5401
  8698. msgid ""
  8699. "If set, command substitution inherits the value of the @code{errexit} "
  8700. "option, instead of unsetting it in the subshell environment. This option is "
  8701. "enabled when @sc{posix} mode is enabled."
  8702. msgstr ""
  8703. #. type: item
  8704. #: ./bashref.texi:5402
  8705. #, no-wrap
  8706. msgid "interactive_comments"
  8707. msgstr ""
  8708. #. type: table
  8709. #: ./bashref.texi:5407
  8710. msgid ""
  8711. "Allow a word beginning with @samp{#} to cause that word and all remaining "
  8712. "characters on that line to be ignored in an interactive shell. This option "
  8713. "is enabled by default."
  8714. msgstr ""
  8715. #. type: item
  8716. #: ./bashref.texi:5408
  8717. #, no-wrap
  8718. msgid "lastpipe"
  8719. msgstr ""
  8720. #. type: table
  8721. #: ./bashref.texi:5411
  8722. msgid ""
  8723. "If set, and job control is not active, the shell runs the last command of a "
  8724. "pipeline not executed in the background in the current shell environment."
  8725. msgstr ""
  8726. #. type: item
  8727. #: ./bashref.texi:5412
  8728. #, no-wrap
  8729. msgid "lithist"
  8730. msgstr ""
  8731. #. type: table
  8732. #: ./bashref.texi:5416
  8733. msgid ""
  8734. "If enabled, and the @code{cmdhist} option is enabled, multi-line commands "
  8735. "are saved to the history with embedded newlines rather than using semicolon "
  8736. "separators where possible."
  8737. msgstr ""
  8738. #. type: item
  8739. #: ./bashref.texi:5417
  8740. #, no-wrap
  8741. msgid "localvar_inherit"
  8742. msgstr ""
  8743. #. type: table
  8744. #: ./bashref.texi:5421
  8745. msgid ""
  8746. "If set, local variables inherit the value and attributes of a variable of "
  8747. "the same name that exists at a previous scope before any new value is "
  8748. "assigned. The @var{nameref} attribute is not inherited."
  8749. msgstr ""
  8750. #. type: item
  8751. #: ./bashref.texi:5422
  8752. #, no-wrap
  8753. msgid "localvar_unset"
  8754. msgstr ""
  8755. #. type: table
  8756. #: ./bashref.texi:5427
  8757. msgid ""
  8758. "If set, calling @code{unset} on local variables in previous function scopes "
  8759. "marks them so subsequent lookups find them unset until that function "
  8760. "returns. This is identical to the behavior of unsetting local variables at "
  8761. "the current function scope."
  8762. msgstr ""
  8763. #. type: item
  8764. #: ./bashref.texi:5428
  8765. #, no-wrap
  8766. msgid "login_shell"
  8767. msgstr ""
  8768. #. type: table
  8769. #: ./bashref.texi:5432
  8770. msgid ""
  8771. "The shell sets this option if it is started as a login shell "
  8772. "(@pxref{Invoking Bash}). The value may not be changed."
  8773. msgstr ""
  8774. #. type: item
  8775. #: ./bashref.texi:5433
  8776. #, no-wrap
  8777. msgid "mailwarn"
  8778. msgstr ""
  8779. #. type: table
  8780. #: ./bashref.texi:5437
  8781. msgid ""
  8782. "If set, and a file that Bash is checking for mail has been accessed since "
  8783. "the last time it was checked, the message @code{\"The mail in @var{mailfile} "
  8784. "has been read\"} is displayed."
  8785. msgstr ""
  8786. #. type: item
  8787. #: ./bashref.texi:5438
  8788. #, no-wrap
  8789. msgid "no_empty_cmd_completion"
  8790. msgstr ""
  8791. #. type: table
  8792. #: ./bashref.texi:5442
  8793. msgid ""
  8794. "If set, and Readline is being used, Bash will not attempt to search the "
  8795. "@env{PATH} for possible completions when completion is attempted on an empty "
  8796. "line."
  8797. msgstr ""
  8798. #. type: item
  8799. #: ./bashref.texi:5443
  8800. #, no-wrap
  8801. msgid "nocaseglob"
  8802. msgstr ""
  8803. #. type: table
  8804. #: ./bashref.texi:5446
  8805. msgid ""
  8806. "If set, Bash matches filenames in a case-insensitive fashion when performing "
  8807. "filename expansion."
  8808. msgstr ""
  8809. #. type: item
  8810. #: ./bashref.texi:5447
  8811. #, no-wrap
  8812. msgid "nocasematch"
  8813. msgstr ""
  8814. #. type: table
  8815. #: ./bashref.texi:5453
  8816. msgid ""
  8817. "If set, Bash matches patterns in a case-insensitive fashion when performing "
  8818. "matching while executing @code{case} or @code{[[} conditional commands, when "
  8819. "performing pattern substitution word expansions, or when filtering possible "
  8820. "completions as part of programmable completion."
  8821. msgstr ""
  8822. #. type: item
  8823. #: ./bashref.texi:5454
  8824. #, no-wrap
  8825. msgid "nullglob"
  8826. msgstr ""
  8827. #. type: table
  8828. #: ./bashref.texi:5457
  8829. msgid ""
  8830. "If set, Bash allows filename patterns which match no files to expand to a "
  8831. "null string, rather than themselves."
  8832. msgstr ""
  8833. #. type: item
  8834. #: ./bashref.texi:5458
  8835. #, no-wrap
  8836. msgid "progcomp"
  8837. msgstr ""
  8838. #. type: table
  8839. #: ./bashref.texi:5462
  8840. msgid ""
  8841. "If set, the programmable completion facilities (@pxref{Programmable "
  8842. "Completion}) are enabled. This option is enabled by default."
  8843. msgstr ""
  8844. #. type: item
  8845. #: ./bashref.texi:5463
  8846. #, no-wrap
  8847. msgid "progcomp_alias"
  8848. msgstr ""
  8849. #. type: table
  8850. #: ./bashref.texi:5468
  8851. msgid ""
  8852. "If set, and programmable completion is enabled, Bash treats a command name "
  8853. "that doesn't have any completions as a possible alias and attempts alias "
  8854. "expansion. If it has an alias, Bash attempts programmable completion using "
  8855. "the command word resulting from the expanded alias."
  8856. msgstr ""
  8857. #. type: item
  8858. #: ./bashref.texi:5469
  8859. #, no-wrap
  8860. msgid "promptvars"
  8861. msgstr ""
  8862. #. type: table
  8863. #: ./bashref.texi:5475
  8864. msgid ""
  8865. "If set, prompt strings undergo parameter expansion, command substitution, "
  8866. "arithmetic expansion, and quote removal after being expanded as described "
  8867. "below (@pxref{Controlling the Prompt}). This option is enabled by default."
  8868. msgstr ""
  8869. #. type: item
  8870. #: ./bashref.texi:5476
  8871. #, no-wrap
  8872. msgid "restricted_shell"
  8873. msgstr ""
  8874. #. type: table
  8875. #: ./bashref.texi:5482
  8876. msgid ""
  8877. "The shell sets this option if it is started in restricted mode (@pxref{The "
  8878. "Restricted Shell}). The value may not be changed. This is not reset when "
  8879. "the startup files are executed, allowing the startup files to discover "
  8880. "whether or not a shell is restricted."
  8881. msgstr ""
  8882. #. type: item
  8883. #: ./bashref.texi:5483
  8884. #, no-wrap
  8885. msgid "shift_verbose"
  8886. msgstr ""
  8887. #. type: table
  8888. #: ./bashref.texi:5487
  8889. msgid ""
  8890. "If this is set, the @code{shift} builtin prints an error message when the "
  8891. "shift count exceeds the number of positional parameters."
  8892. msgstr ""
  8893. #. type: item
  8894. #: ./bashref.texi:5488
  8895. #, no-wrap
  8896. msgid "sourcepath"
  8897. msgstr ""
  8898. #. type: table
  8899. #: ./bashref.texi:5492
  8900. msgid ""
  8901. "If set, the @code{source} builtin uses the value of @env{PATH} to find the "
  8902. "directory containing the file supplied as an argument. This option is "
  8903. "enabled by default."
  8904. msgstr ""
  8905. #. type: item
  8906. #: ./bashref.texi:5493
  8907. #, no-wrap
  8908. msgid "xpg_echo"
  8909. msgstr ""
  8910. #. type: table
  8911. #: ./bashref.texi:5496
  8912. msgid ""
  8913. "If set, the @code{echo} builtin expands backslash-escape sequences by "
  8914. "default."
  8915. msgstr ""
  8916. #. type: Plain text
  8917. #: ./bashref.texi:5514
  8918. msgid ""
  8919. "For historical reasons, the @sc{posix} standard has classified several "
  8920. "builtin commands as @emph{special}. When Bash is executing in @sc{posix} "
  8921. "mode, the special builtins differ from other builtin commands in three "
  8922. "respects:"
  8923. msgstr ""
  8924. #. type: enumerate
  8925. #: ./bashref.texi:5518
  8926. msgid "Special builtins are found before shell functions during command lookup."
  8927. msgstr ""
  8928. #. type: enumerate
  8929. #: ./bashref.texi:5521
  8930. msgid "If a special builtin returns an error status, a non-interactive shell exits."
  8931. msgstr ""
  8932. #. type: enumerate
  8933. #: ./bashref.texi:5525
  8934. msgid ""
  8935. "Assignment statements preceding the command stay in effect in the shell "
  8936. "environment after the command completes."
  8937. msgstr ""
  8938. #. type: Plain text
  8939. #: ./bashref.texi:5530
  8940. msgid ""
  8941. "When Bash is not executing in @sc{posix} mode, these builtins behave no "
  8942. "differently than the rest of the Bash builtin commands. The Bash @sc{posix} "
  8943. "mode is described in @ref{Bash POSIX Mode}."
  8944. msgstr ""
  8945. #. type: Plain text
  8946. #: ./bashref.texi:5532
  8947. msgid "These are the @sc{posix} special builtins:"
  8948. msgstr ""
  8949. #. type: example
  8950. #: ./bashref.texi:5535
  8951. #, no-wrap
  8952. msgid ""
  8953. "@w{break : . continue eval exec exit export readonly return set}\n"
  8954. "@w{shift trap unset}\n"
  8955. msgstr ""
  8956. #. type: section
  8957. #: ./bashref.texi:5544 ./bashref.texi:5549 ./bashref.texi:5550
  8958. #, no-wrap
  8959. msgid "Bourne Shell Variables"
  8960. msgstr ""
  8961. #. type: menuentry
  8962. #: ./bashref.texi:5544
  8963. msgid "Variables which Bash uses in the same way as the Bourne Shell."
  8964. msgstr ""
  8965. #. type: section
  8966. #: ./bashref.texi:5544 ./bashref.texi:5612 ./bashref.texi:5613
  8967. #, no-wrap
  8968. msgid "Bash Variables"
  8969. msgstr ""
  8970. #. type: menuentry
  8971. #: ./bashref.texi:5544
  8972. msgid "List of variables that exist in Bash."
  8973. msgstr ""
  8974. #. type: Plain text
  8975. #: ./bashref.texi:5548
  8976. msgid ""
  8977. "This chapter describes the shell variables that Bash uses. Bash "
  8978. "automatically assigns default values to a number of variables."
  8979. msgstr ""
  8980. #. type: Plain text
  8981. #: ./bashref.texi:5554
  8982. msgid ""
  8983. "Bash uses certain shell variables in the same way as the Bourne shell. In "
  8984. "some cases, Bash assigns a default value to the variable."
  8985. msgstr ""
  8986. #. type: item
  8987. #: ./bashref.texi:5557
  8988. #, no-wrap
  8989. msgid "CDPATH"
  8990. msgstr ""
  8991. #. type: Plain text
  8992. #: ./bashref.texi:5560
  8993. msgid ""
  8994. "A colon-separated list of directories used as a search path for the "
  8995. "@code{cd} builtin command."
  8996. msgstr ""
  8997. #. type: item
  8998. #: ./bashref.texi:5561
  8999. #, no-wrap
  9000. msgid "HOME"
  9001. msgstr ""
  9002. #. type: Plain text
  9003. #: ./bashref.texi:5566
  9004. msgid ""
  9005. "The current user's home directory; the default for the @code{cd} builtin "
  9006. "command. The value of this variable is also used by tilde expansion "
  9007. "(@pxref{Tilde Expansion})."
  9008. msgstr ""
  9009. #. type: item
  9010. #: ./bashref.texi:5567
  9011. #, no-wrap
  9012. msgid "IFS"
  9013. msgstr ""
  9014. #. type: Plain text
  9015. #: ./bashref.texi:5570
  9016. msgid ""
  9017. "A list of characters that separate fields; used when the shell splits words "
  9018. "as part of expansion."
  9019. msgstr ""
  9020. #. type: item
  9021. #: ./bashref.texi:5571
  9022. #, no-wrap
  9023. msgid "MAIL"
  9024. msgstr ""
  9025. #. type: Plain text
  9026. #: ./bashref.texi:5576
  9027. msgid ""
  9028. "If this parameter is set to a filename or directory name and the "
  9029. "@env{MAILPATH} variable is not set, Bash informs the user of the arrival of "
  9030. "mail in the specified file or Maildir-format directory."
  9031. msgstr ""
  9032. #. type: item
  9033. #: ./bashref.texi:5577
  9034. #, no-wrap
  9035. msgid "MAILPATH"
  9036. msgstr ""
  9037. #. type: Plain text
  9038. #: ./bashref.texi:5585
  9039. msgid ""
  9040. "A colon-separated list of filenames which the shell periodically checks for "
  9041. "new mail. Each list entry can specify the message that is printed when new "
  9042. "mail arrives in the mail file by separating the filename from the message "
  9043. "with a @samp{?}. When used in the text of the message, @code{$_} expands to "
  9044. "the name of the current mail file."
  9045. msgstr ""
  9046. #. type: item
  9047. #: ./bashref.texi:5586
  9048. #, no-wrap
  9049. msgid "OPTARG"
  9050. msgstr ""
  9051. #. type: Plain text
  9052. #: ./bashref.texi:5588
  9053. msgid ""
  9054. "The value of the last option argument processed by the @code{getopts} "
  9055. "builtin."
  9056. msgstr ""
  9057. #. type: item
  9058. #: ./bashref.texi:5589
  9059. #, no-wrap
  9060. msgid "OPTIND"
  9061. msgstr ""
  9062. #. type: Plain text
  9063. #: ./bashref.texi:5591
  9064. msgid ""
  9065. "The index of the last option argument processed by the @code{getopts} "
  9066. "builtin."
  9067. msgstr ""
  9068. #. type: item
  9069. #: ./bashref.texi:5592
  9070. #, no-wrap
  9071. msgid "PATH"
  9072. msgstr ""
  9073. #. type: Plain text
  9074. #: ./bashref.texi:5599
  9075. msgid ""
  9076. "A colon-separated list of directories in which the shell looks for "
  9077. "commands. A zero-length (null) directory name in the value of @code{PATH} "
  9078. "indicates the current directory. A null directory name may appear as two "
  9079. "adjacent colons, or as an initial or trailing colon."
  9080. msgstr ""
  9081. #. type: item
  9082. #: ./bashref.texi:5600
  9083. #, no-wrap
  9084. msgid "PS1"
  9085. msgstr ""
  9086. #. type: Plain text
  9087. #: ./bashref.texi:5604
  9088. msgid ""
  9089. "The primary prompt string. The default value is @samp{\\s-\\v\\$ }. "
  9090. "@xref{Controlling the Prompt}, for the complete list of escape sequences "
  9091. "that are expanded before @env{PS1} is displayed."
  9092. msgstr ""
  9093. #. type: item
  9094. #: ./bashref.texi:5605
  9095. #, no-wrap
  9096. msgid "PS2"
  9097. msgstr ""
  9098. #. type: Plain text
  9099. #: ./bashref.texi:5609
  9100. msgid ""
  9101. "The secondary prompt string. The default value is @samp{> }. @env{PS2} is "
  9102. "expanded in the same way as @env{PS1} before being displayed."
  9103. msgstr ""
  9104. #. type: Plain text
  9105. #: ./bashref.texi:5617
  9106. msgid ""
  9107. "These variables are set or used by Bash, but other shells do not normally "
  9108. "treat them specially."
  9109. msgstr ""
  9110. #. type: Plain text
  9111. #: ./bashref.texi:5621
  9112. msgid ""
  9113. "A few variables used by Bash are described in different chapters: variables "
  9114. "for controlling the job control facilities (@pxref{Job Control Variables})."
  9115. msgstr ""
  9116. #. type: item
  9117. #: ./bashref.texi:5624
  9118. #, no-wrap
  9119. msgid "BASH"
  9120. msgstr ""
  9121. #. type: Plain text
  9122. #: ./bashref.texi:5626
  9123. msgid "The full pathname used to execute the current instance of Bash."
  9124. msgstr ""
  9125. #. type: item
  9126. #: ./bashref.texi:5627
  9127. #, no-wrap
  9128. msgid "BASHOPTS"
  9129. msgstr ""
  9130. #. type: Plain text
  9131. #: ./bashref.texi:5636
  9132. msgid ""
  9133. "A colon-separated list of enabled shell options. Each word in the list is a "
  9134. "valid argument for the @option{-s} option to the @code{shopt} builtin "
  9135. "command (@pxref{The Shopt Builtin}). The options appearing in "
  9136. "@env{BASHOPTS} are those reported as @samp{on} by @samp{shopt}. If this "
  9137. "variable is in the environment when Bash starts up, each shell option in the "
  9138. "list will be enabled before reading any startup files. This variable is "
  9139. "readonly."
  9140. msgstr ""
  9141. #. type: item
  9142. #: ./bashref.texi:5637
  9143. #, no-wrap
  9144. msgid "BASHPID"
  9145. msgstr ""
  9146. #. type: Plain text
  9147. #: ./bashref.texi:5645
  9148. msgid ""
  9149. "Expands to the process ID of the current Bash process. This differs from "
  9150. "@code{$$} under certain circumstances, such as subshells that do not require "
  9151. "Bash to be re-initialized. Assignments to @env{BASHPID} have no effect. If "
  9152. "@code{BASHPID} is unset, it loses its special properties, even if it is "
  9153. "subsequently reset."
  9154. msgstr ""
  9155. #. type: item
  9156. #: ./bashref.texi:5646
  9157. #, no-wrap
  9158. msgid "BASH_ALIASES"
  9159. msgstr ""
  9160. #. type: Plain text
  9161. #: ./bashref.texi:5656
  9162. msgid ""
  9163. "An associative array variable whose members correspond to the internal list "
  9164. "of aliases as maintained by the @code{alias} builtin. (@pxref{Bourne Shell "
  9165. "Builtins}). Elements added to this array appear in the alias list; however, "
  9166. "unsetting array elements currently does not cause aliases to be removed from "
  9167. "the alias list. If @code{BASH_ALIASES} is unset, it loses its special "
  9168. "properties, even if it is subsequently reset."
  9169. msgstr ""
  9170. #. type: item
  9171. #: ./bashref.texi:5657
  9172. #, no-wrap
  9173. msgid "BASH_ARGC"
  9174. msgstr ""
  9175. #. type: Plain text
  9176. #: ./bashref.texi:5671
  9177. msgid ""
  9178. "An array variable whose values are the number of parameters in each frame of "
  9179. "the current bash execution call stack. The number of parameters to the "
  9180. "current subroutine (shell function or script executed with @code{.} or "
  9181. "@code{source}) is at the top of the stack. When a subroutine is executed, "
  9182. "the number of parameters passed is pushed onto @code{BASH_ARGC}. The shell "
  9183. "sets @code{BASH_ARGC} only when in extended debugging mode (see @ref{The "
  9184. "Shopt Builtin} for a description of the @code{extdebug} option to the "
  9185. "@code{shopt} builtin). Setting @code{extdebug} after the shell has started "
  9186. "to execute a script, or referencing this variable when @code{extdebug} is "
  9187. "not set, may result in inconsistent values."
  9188. msgstr ""
  9189. #. type: item
  9190. #: ./bashref.texi:5672
  9191. #, no-wrap
  9192. msgid "BASH_ARGV"
  9193. msgstr ""
  9194. #. type: Plain text
  9195. #: ./bashref.texi:5685
  9196. msgid ""
  9197. "An array variable containing all of the parameters in the current bash "
  9198. "execution call stack. The final parameter of the last subroutine call is at "
  9199. "the top of the stack; the first parameter of the initial call is at the "
  9200. "bottom. When a subroutine is executed, the parameters supplied are pushed "
  9201. "onto @code{BASH_ARGV}. The shell sets @code{BASH_ARGV} only when in "
  9202. "extended debugging mode (see @ref{The Shopt Builtin} for a description of "
  9203. "the @code{extdebug} option to the @code{shopt} builtin). Setting "
  9204. "@code{extdebug} after the shell has started to execute a script, or "
  9205. "referencing this variable when @code{extdebug} is not set, may result in "
  9206. "inconsistent values."
  9207. msgstr ""
  9208. #. type: item
  9209. #: ./bashref.texi:5686
  9210. #, no-wrap
  9211. msgid "BASH_ARGV0"
  9212. msgstr ""
  9213. #. type: Plain text
  9214. #: ./bashref.texi:5695
  9215. msgid ""
  9216. "When referenced, this variable expands to the name of the shell or shell "
  9217. "script (identical to @code{$0}; @xref{Special Parameters}, for the "
  9218. "description of special parameter 0). Assignment to @code{BASH_ARGV0} causes "
  9219. "the value assigned to also be assigned to @code{$0}. If @code{BASH_ARGV0} "
  9220. "is unset, it loses its special properties, even if it is subsequently reset."
  9221. msgstr ""
  9222. #. type: item
  9223. #: ./bashref.texi:5696
  9224. #, no-wrap
  9225. msgid "BASH_CMDS"
  9226. msgstr ""
  9227. #. type: Plain text
  9228. #: ./bashref.texi:5706
  9229. msgid ""
  9230. "An associative array variable whose members correspond to the internal hash "
  9231. "table of commands as maintained by the @code{hash} builtin (@pxref{Bourne "
  9232. "Shell Builtins}). Elements added to this array appear in the hash table; "
  9233. "however, unsetting array elements currently does not cause command names to "
  9234. "be removed from the hash table. If @code{BASH_CMDS} is unset, it loses its "
  9235. "special properties, even if it is subsequently reset."
  9236. msgstr ""
  9237. #. type: item
  9238. #: ./bashref.texi:5707
  9239. #, no-wrap
  9240. msgid "BASH_COMMAND"
  9241. msgstr ""
  9242. #. type: Plain text
  9243. #: ./bashref.texi:5711
  9244. msgid ""
  9245. "The command currently being executed or about to be executed, unless the "
  9246. "shell is executing a command as the result of a trap, in which case it is "
  9247. "the command executing at the time of the trap."
  9248. msgstr ""
  9249. #. type: item
  9250. #: ./bashref.texi:5712
  9251. #, no-wrap
  9252. msgid "BASH_COMPAT"
  9253. msgstr ""
  9254. #. type: Plain text
  9255. #: ./bashref.texi:5727
  9256. msgid ""
  9257. "The value is used to set the shell's compatibility level. @xref{The Shopt "
  9258. "Builtin}, for a description of the various compatibility levels and their "
  9259. "effects. The value may be a decimal number (e.g., 4.2) or an integer (e.g., "
  9260. "42) corresponding to the desired compatibility level. If "
  9261. "@code{BASH_COMPAT} is unset or set to the empty string, the compatibility "
  9262. "level is set to the default for the current version. If @code{BASH_COMPAT} "
  9263. "is set to a value that is not one of the valid compatibility levels, the "
  9264. "shell prints an error message and sets the compatibility level to the "
  9265. "default for the current version. The valid compatibility levels correspond "
  9266. "to the compatibility options accepted by the @code{shopt} builtin described "
  9267. "above (for example, @var{compat42} means that 4.2 and 42 are valid values). "
  9268. "The current version is also a valid value."
  9269. msgstr ""
  9270. #. type: item
  9271. #: ./bashref.texi:5728
  9272. #, no-wrap
  9273. msgid "BASH_ENV"
  9274. msgstr ""
  9275. #. type: Plain text
  9276. #: ./bashref.texi:5732
  9277. msgid ""
  9278. "If this variable is set when Bash is invoked to execute a shell script, its "
  9279. "value is expanded and used as the name of a startup file to read before "
  9280. "executing the script. @xref{Bash Startup Files}."
  9281. msgstr ""
  9282. #. type: item
  9283. #: ./bashref.texi:5733
  9284. #, no-wrap
  9285. msgid "BASH_EXECUTION_STRING"
  9286. msgstr ""
  9287. #. type: Plain text
  9288. #: ./bashref.texi:5735
  9289. msgid "The command argument to the @option{-c} invocation option."
  9290. msgstr ""
  9291. #. type: item
  9292. #: ./bashref.texi:5736
  9293. #, no-wrap
  9294. msgid "BASH_LINENO"
  9295. msgstr ""
  9296. #. type: Plain text
  9297. #: ./bashref.texi:5744
  9298. msgid ""
  9299. "An array variable whose members are the line numbers in source files where "
  9300. "each corresponding member of @var{FUNCNAME} was invoked. "
  9301. "@code{$@{BASH_LINENO[$i]@}} is the line number in the source file "
  9302. "(@code{$@{BASH_SOURCE[$i+1]@}}) where @code{$@{FUNCNAME[$i]@}} was called "
  9303. "(or @code{$@{BASH_LINENO[$i-1]@}} if referenced within another shell "
  9304. "function). Use @code{LINENO} to obtain the current line number."
  9305. msgstr ""
  9306. #. type: item
  9307. #: ./bashref.texi:5745
  9308. #, no-wrap
  9309. msgid "BASH_LOADABLES_PATH"
  9310. msgstr ""
  9311. #. type: Plain text
  9312. #: ./bashref.texi:5749
  9313. msgid ""
  9314. "A colon-separated list of directories in which the shell looks for "
  9315. "dynamically loadable builtins specified by the @code{enable} command."
  9316. msgstr ""
  9317. #. type: item
  9318. #: ./bashref.texi:5750
  9319. #, no-wrap
  9320. msgid "BASH_REMATCH"
  9321. msgstr ""
  9322. #. type: Plain text
  9323. #: ./bashref.texi:5759
  9324. msgid ""
  9325. "An array variable whose members are assigned by the @samp{=~} binary "
  9326. "operator to the @code{[[} conditional command (@pxref{Conditional "
  9327. "Constructs}). The element with index 0 is the portion of the string "
  9328. "matching the entire regular expression. The element with index @var{n} is "
  9329. "the portion of the string matching the @var{n}th parenthesized "
  9330. "subexpression. This variable is read-only."
  9331. msgstr ""
  9332. #. type: item
  9333. #: ./bashref.texi:5760
  9334. #, no-wrap
  9335. msgid "BASH_SOURCE"
  9336. msgstr ""
  9337. #. type: Plain text
  9338. #: ./bashref.texi:5766
  9339. msgid ""
  9340. "An array variable whose members are the source filenames where the "
  9341. "corresponding shell function names in the @code{FUNCNAME} array variable are "
  9342. "defined. The shell function @code{$@{FUNCNAME[$i]@}} is defined in the file "
  9343. "@code{$@{BASH_SOURCE[$i]@}} and called from @code{$@{BASH_SOURCE[$i+1]@}}"
  9344. msgstr ""
  9345. #. type: item
  9346. #: ./bashref.texi:5767
  9347. #, no-wrap
  9348. msgid "BASH_SUBSHELL"
  9349. msgstr ""
  9350. #. type: Plain text
  9351. #: ./bashref.texi:5771
  9352. msgid ""
  9353. "Incremented by one within each subshell or subshell environment when the "
  9354. "shell begins executing in that environment. The initial value is 0."
  9355. msgstr ""
  9356. #. type: item
  9357. #: ./bashref.texi:5772
  9358. #, no-wrap
  9359. msgid "BASH_VERSINFO"
  9360. msgstr ""
  9361. #. type: Plain text
  9362. #: ./bashref.texi:5776
  9363. msgid ""
  9364. "A readonly array variable (@pxref{Arrays}) whose members hold version "
  9365. "information for this instance of Bash. The values assigned to the array "
  9366. "members are as follows:"
  9367. msgstr ""
  9368. #. type: item
  9369. #: ./bashref.texi:5779
  9370. #, no-wrap
  9371. msgid "BASH_VERSINFO[0]"
  9372. msgstr ""
  9373. #. type: table
  9374. #: ./bashref.texi:5781
  9375. msgid "The major version number (the @var{release})."
  9376. msgstr ""
  9377. #. type: item
  9378. #: ./bashref.texi:5782
  9379. #, no-wrap
  9380. msgid "BASH_VERSINFO[1]"
  9381. msgstr ""
  9382. #. type: table
  9383. #: ./bashref.texi:5784
  9384. msgid "The minor version number (the @var{version})."
  9385. msgstr ""
  9386. #. type: item
  9387. #: ./bashref.texi:5785
  9388. #, no-wrap
  9389. msgid "BASH_VERSINFO[2]"
  9390. msgstr ""
  9391. #. type: table
  9392. #: ./bashref.texi:5787
  9393. msgid "The patch level."
  9394. msgstr ""
  9395. #. type: item
  9396. #: ./bashref.texi:5788
  9397. #, no-wrap
  9398. msgid "BASH_VERSINFO[3]"
  9399. msgstr ""
  9400. #. type: table
  9401. #: ./bashref.texi:5790
  9402. msgid "The build version."
  9403. msgstr ""
  9404. #. type: item
  9405. #: ./bashref.texi:5791
  9406. #, no-wrap
  9407. msgid "BASH_VERSINFO[4]"
  9408. msgstr ""
  9409. #. type: table
  9410. #: ./bashref.texi:5793
  9411. msgid "The release status (e.g., @var{beta1})."
  9412. msgstr ""
  9413. #. type: item
  9414. #: ./bashref.texi:5794
  9415. #, no-wrap
  9416. msgid "BASH_VERSINFO[5]"
  9417. msgstr ""
  9418. #. type: table
  9419. #: ./bashref.texi:5796
  9420. msgid "The value of @env{MACHTYPE}."
  9421. msgstr ""
  9422. #. type: item
  9423. #: ./bashref.texi:5798
  9424. #, no-wrap
  9425. msgid "BASH_VERSION"
  9426. msgstr ""
  9427. #. type: Plain text
  9428. #: ./bashref.texi:5800
  9429. msgid "The version number of the current instance of Bash."
  9430. msgstr ""
  9431. #. type: item
  9432. #: ./bashref.texi:5801
  9433. #, no-wrap
  9434. msgid "BASH_XTRACEFD"
  9435. msgstr ""
  9436. #. type: Plain text
  9437. #: ./bashref.texi:5814
  9438. msgid ""
  9439. "If set to an integer corresponding to a valid file descriptor, Bash will "
  9440. "write the trace output generated when @samp{set -x} is enabled to that file "
  9441. "descriptor. This allows tracing output to be separated from diagnostic and "
  9442. "error messages. The file descriptor is closed when @code{BASH_XTRACEFD} is "
  9443. "unset or assigned a new value. Unsetting @code{BASH_XTRACEFD} or assigning "
  9444. "it the empty string causes the trace output to be sent to the standard "
  9445. "error. Note that setting @code{BASH_XTRACEFD} to 2 (the standard error file "
  9446. "descriptor) and then unsetting it will result in the standard error being "
  9447. "closed."
  9448. msgstr ""
  9449. #. type: item
  9450. #: ./bashref.texi:5815
  9451. #, no-wrap
  9452. msgid "CHILD_MAX"
  9453. msgstr ""
  9454. #. type: Plain text
  9455. #: ./bashref.texi:5821
  9456. msgid ""
  9457. "Set the number of exited child status values for the shell to remember. "
  9458. "Bash will not allow this value to be decreased below a @sc{posix}-mandated "
  9459. "minimum, and there is a maximum value (currently 8192) that this may not "
  9460. "exceed. The minimum value is system-dependent."
  9461. msgstr ""
  9462. #. type: item
  9463. #: ./bashref.texi:5822
  9464. #, no-wrap
  9465. msgid "COLUMNS"
  9466. msgstr ""
  9467. #. type: Plain text
  9468. #: ./bashref.texi:5828
  9469. msgid ""
  9470. "Used by the @code{select} command to determine the terminal width when "
  9471. "printing selection lists. Automatically set if the @code{checkwinsize} "
  9472. "option is enabled (@pxref{The Shopt Builtin}), or in an interactive shell "
  9473. "upon receipt of a @code{SIGWINCH}."
  9474. msgstr ""
  9475. #. type: item
  9476. #: ./bashref.texi:5829
  9477. #, no-wrap
  9478. msgid "COMP_CWORD"
  9479. msgstr ""
  9480. #. type: Plain text
  9481. #: ./bashref.texi:5834
  9482. msgid ""
  9483. "An index into @env{$@{COMP_WORDS@}} of the word containing the current "
  9484. "cursor position. This variable is available only in shell functions invoked "
  9485. "by the programmable completion facilities (@pxref{Programmable Completion})."
  9486. msgstr ""
  9487. #. type: item
  9488. #: ./bashref.texi:5835
  9489. #, no-wrap
  9490. msgid "COMP_LINE"
  9491. msgstr ""
  9492. #. type: Plain text
  9493. #: ./bashref.texi:5840
  9494. msgid ""
  9495. "The current command line. This variable is available only in shell "
  9496. "functions and external commands invoked by the programmable completion "
  9497. "facilities (@pxref{Programmable Completion})."
  9498. msgstr ""
  9499. #. type: item
  9500. #: ./bashref.texi:5841
  9501. #, no-wrap
  9502. msgid "COMP_POINT"
  9503. msgstr ""
  9504. #. type: Plain text
  9505. #: ./bashref.texi:5849
  9506. msgid ""
  9507. "The index of the current cursor position relative to the beginning of the "
  9508. "current command. If the current cursor position is at the end of the "
  9509. "current command, the value of this variable is equal to "
  9510. "@code{$@{#COMP_LINE@}}. This variable is available only in shell functions "
  9511. "and external commands invoked by the programmable completion facilities "
  9512. "(@pxref{Programmable Completion})."
  9513. msgstr ""
  9514. #. type: item
  9515. #: ./bashref.texi:5850
  9516. #, no-wrap
  9517. msgid "COMP_TYPE"
  9518. msgstr ""
  9519. #. type: Plain text
  9520. #: ./bashref.texi:5862
  9521. msgid ""
  9522. "Set to an integer value corresponding to the type of completion attempted "
  9523. "that caused a completion function to be called: @var{TAB}, for normal "
  9524. "completion, @samp{?}, for listing completions after successive tabs, "
  9525. "@samp{!}, for listing alternatives on partial word completion, @samp{@@}, to "
  9526. "list completions if the word is not unmodified, or @samp{%}, for menu "
  9527. "completion. This variable is available only in shell functions and external "
  9528. "commands invoked by the programmable completion facilities "
  9529. "(@pxref{Programmable Completion})."
  9530. msgstr ""
  9531. #. type: item
  9532. #: ./bashref.texi:5863
  9533. #, no-wrap
  9534. msgid "COMP_KEY"
  9535. msgstr ""
  9536. #. type: Plain text
  9537. #: ./bashref.texi:5866
  9538. msgid ""
  9539. "The key (or final key of a key sequence) used to invoke the current "
  9540. "completion function."
  9541. msgstr ""
  9542. #. type: item
  9543. #: ./bashref.texi:5867
  9544. #, no-wrap
  9545. msgid "COMP_WORDBREAKS"
  9546. msgstr ""
  9547. #. type: Plain text
  9548. #: ./bashref.texi:5872
  9549. msgid ""
  9550. "The set of characters that the Readline library treats as word separators "
  9551. "when performing word completion. If @code{COMP_WORDBREAKS} is unset, it "
  9552. "loses its special properties, even if it is subsequently reset."
  9553. msgstr ""
  9554. #. type: item
  9555. #: ./bashref.texi:5873
  9556. #, no-wrap
  9557. msgid "COMP_WORDS"
  9558. msgstr ""
  9559. #. type: Plain text
  9560. #: ./bashref.texi:5880
  9561. msgid ""
  9562. "An array variable consisting of the individual words in the current command "
  9563. "line. The line is split into words as Readline would split it, using "
  9564. "@code{COMP_WORDBREAKS} as described above. This variable is available only "
  9565. "in shell functions invoked by the programmable completion facilities "
  9566. "(@pxref{Programmable Completion})."
  9567. msgstr ""
  9568. #. type: item
  9569. #: ./bashref.texi:5881
  9570. #, no-wrap
  9571. msgid "COMPREPLY"
  9572. msgstr ""
  9573. #. type: Plain text
  9574. #: ./bashref.texi:5886
  9575. msgid ""
  9576. "An array variable from which Bash reads the possible completions generated "
  9577. "by a shell function invoked by the programmable completion facility "
  9578. "(@pxref{Programmable Completion}). Each array element contains one possible "
  9579. "completion."
  9580. msgstr ""
  9581. #. type: item
  9582. #: ./bashref.texi:5887
  9583. #, no-wrap
  9584. msgid "COPROC"
  9585. msgstr ""
  9586. #. type: Plain text
  9587. #: ./bashref.texi:5890
  9588. msgid ""
  9589. "An array variable created to hold the file descriptors for output from and "
  9590. "input to an unnamed coprocess (@pxref{Coprocesses})."
  9591. msgstr ""
  9592. #. type: item
  9593. #: ./bashref.texi:5891
  9594. #, no-wrap
  9595. msgid "DIRSTACK"
  9596. msgstr ""
  9597. #. type: Plain text
  9598. #: ./bashref.texi:5901
  9599. msgid ""
  9600. "An array variable containing the current contents of the directory stack. "
  9601. "Directories appear in the stack in the order they are displayed by the "
  9602. "@code{dirs} builtin. Assigning to members of this array variable may be "
  9603. "used to modify directories already in the stack, but the @code{pushd} and "
  9604. "@code{popd} builtins must be used to add and remove directories. Assignment "
  9605. "to this variable will not change the current directory. If @env{DIRSTACK} "
  9606. "is unset, it loses its special properties, even if it is subsequently reset."
  9607. msgstr ""
  9608. #. type: item
  9609. #: ./bashref.texi:5902
  9610. #, no-wrap
  9611. msgid "EMACS"
  9612. msgstr ""
  9613. #. type: Plain text
  9614. #: ./bashref.texi:5906
  9615. msgid ""
  9616. "If Bash finds this variable in the environment when the shell starts with "
  9617. "value @samp{t}, it assumes that the shell is running in an Emacs shell "
  9618. "buffer and disables line editing."
  9619. msgstr ""
  9620. #. type: item
  9621. #: ./bashref.texi:5907
  9622. #, no-wrap
  9623. msgid "ENV"
  9624. msgstr ""
  9625. #. type: Plain text
  9626. #: ./bashref.texi:5910
  9627. msgid ""
  9628. "Similar to @code{BASH_ENV}; used when the shell is invoked in @sc{posix} "
  9629. "Mode (@pxref{Bash POSIX Mode})."
  9630. msgstr ""
  9631. #. type: item
  9632. #: ./bashref.texi:5911
  9633. #, no-wrap
  9634. msgid "EPOCHREALTIME"
  9635. msgstr ""
  9636. #. type: Plain text
  9637. #: ./bashref.texi:5919
  9638. msgid ""
  9639. "Each time this parameter is referenced, it expands to the number of seconds "
  9640. "since the Unix Epoch as a floating point value with micro-second granularity "
  9641. "(see the documentation for the C library function @var{time} for the "
  9642. "definition of Epoch). Assignments to @env{EPOCHREALTIME} are ignored. If "
  9643. "@env{EPOCHREALTIME} is unset, it loses its special properties, even if it is "
  9644. "subsequently reset."
  9645. msgstr ""
  9646. #. type: item
  9647. #: ./bashref.texi:5920
  9648. #, no-wrap
  9649. msgid "EPOCHSECONDS"
  9650. msgstr ""
  9651. #. type: Plain text
  9652. #: ./bashref.texi:5927
  9653. msgid ""
  9654. "Each time this parameter is referenced, it expands to the number of seconds "
  9655. "since the Unix Epoch (see the documentation for the C library function "
  9656. "@var{time} for the definition of Epoch). Assignments to @env{EPOCHSECONDS} "
  9657. "are ignored. If @env{EPOCHSECONDS} is unset, it loses its special "
  9658. "properties, even if it is subsequently reset."
  9659. msgstr ""
  9660. #. type: item
  9661. #: ./bashref.texi:5928
  9662. #, no-wrap
  9663. msgid "EUID"
  9664. msgstr ""
  9665. #. type: Plain text
  9666. #: ./bashref.texi:5931
  9667. msgid ""
  9668. "The numeric effective user id of the current user. This variable is "
  9669. "readonly."
  9670. msgstr ""
  9671. #. type: item
  9672. #: ./bashref.texi:5932
  9673. #, no-wrap
  9674. msgid "EXECIGNORE"
  9675. msgstr ""
  9676. #. type: Plain text
  9677. #: ./bashref.texi:5946
  9678. msgid ""
  9679. "A colon-separated list of shell patterns (@pxref{Pattern Matching}) "
  9680. "defining the list of filenames to be ignored by command search using "
  9681. "@code{PATH}. Files whose full pathnames match one of these patterns are not "
  9682. "considered executable files for the purposes of completion and command "
  9683. "execution via @code{PATH} lookup. This does not affect the behavior of the "
  9684. "@code{[}, @code{test}, and @code{[[} commands. Full pathnames in the "
  9685. "command hash table are not subject to @code{EXECIGNORE}. Use this variable "
  9686. "to ignore shared library files that have the executable bit set, but are not "
  9687. "executable files. The pattern matching honors the setting of the "
  9688. "@code{extglob} shell option."
  9689. msgstr ""
  9690. #. type: item
  9691. #: ./bashref.texi:5947
  9692. #, no-wrap
  9693. msgid "FCEDIT"
  9694. msgstr ""
  9695. #. type: Plain text
  9696. #: ./bashref.texi:5950
  9697. msgid ""
  9698. "The editor used as a default by the @option{-e} option to the @code{fc} "
  9699. "builtin command."
  9700. msgstr ""
  9701. #. type: item
  9702. #: ./bashref.texi:5951
  9703. #, no-wrap
  9704. msgid "FIGNORE"
  9705. msgstr ""
  9706. #. type: Plain text
  9707. #: ./bashref.texi:5958
  9708. msgid ""
  9709. "A colon-separated list of suffixes to ignore when performing filename "
  9710. "completion. A filename whose suffix matches one of the entries in "
  9711. "@env{FIGNORE} is excluded from the list of matched filenames. A sample "
  9712. "value is @samp{.o:~}"
  9713. msgstr ""
  9714. #. type: item
  9715. #: ./bashref.texi:5959
  9716. #, no-wrap
  9717. msgid "FUNCNAME"
  9718. msgstr ""
  9719. #. type: Plain text
  9720. #: ./bashref.texi:5970
  9721. msgid ""
  9722. "An array variable containing the names of all shell functions currently in "
  9723. "the execution call stack. The element with index 0 is the name of any "
  9724. "currently-executing shell function. The bottom-most element (the one with "
  9725. "the highest index) is @code{\"main\"}. This variable exists only when a "
  9726. "shell function is executing. Assignments to @env{FUNCNAME} have no effect. "
  9727. "If @env{FUNCNAME} is unset, it loses its special properties, even if it is "
  9728. "subsequently reset."
  9729. msgstr ""
  9730. #. type: Plain text
  9731. #: ./bashref.texi:5978
  9732. msgid ""
  9733. "This variable can be used with @code{BASH_LINENO} and @code{BASH_SOURCE}. "
  9734. "Each element of @code{FUNCNAME} has corresponding elements in "
  9735. "@code{BASH_LINENO} and @code{BASH_SOURCE} to describe the call stack. For "
  9736. "instance, @code{$@{FUNCNAME[$i]@}} was called from the file "
  9737. "@code{$@{BASH_SOURCE[$i+1]@}} at line number @code{$@{BASH_LINENO[$i]@}}. "
  9738. "The @code{caller} builtin displays the current call stack using this "
  9739. "information."
  9740. msgstr ""
  9741. #. type: item
  9742. #: ./bashref.texi:5979
  9743. #, no-wrap
  9744. msgid "FUNCNEST"
  9745. msgstr ""
  9746. #. type: Plain text
  9747. #: ./bashref.texi:5983
  9748. msgid ""
  9749. "If set to a numeric value greater than 0, defines a maximum function nesting "
  9750. "level. Function invocations that exceed this nesting level will cause the "
  9751. "current command to abort."
  9752. msgstr ""
  9753. #. type: item
  9754. #: ./bashref.texi:5984
  9755. #, no-wrap
  9756. msgid "GLOBIGNORE"
  9757. msgstr ""
  9758. #. type: Plain text
  9759. #: ./bashref.texi:5992
  9760. msgid ""
  9761. "A colon-separated list of patterns defining the set of file names to be "
  9762. "ignored by filename expansion. If a file name matched by a filename "
  9763. "expansion pattern also matches one of the patterns in @env{GLOBIGNORE}, it "
  9764. "is removed from the list of matches. The pattern matching honors the "
  9765. "setting of the @code{extglob} shell option."
  9766. msgstr ""
  9767. #. type: item
  9768. #: ./bashref.texi:5993
  9769. #, no-wrap
  9770. msgid "GROUPS"
  9771. msgstr ""
  9772. #. type: Plain text
  9773. #: ./bashref.texi:5999
  9774. msgid ""
  9775. "An array variable containing the list of groups of which the current user is "
  9776. "a member. Assignments to @env{GROUPS} have no effect. If @env{GROUPS} is "
  9777. "unset, it loses its special properties, even if it is subsequently reset."
  9778. msgstr ""
  9779. #. type: item
  9780. #: ./bashref.texi:6000
  9781. #, no-wrap
  9782. msgid "histchars"
  9783. msgstr ""
  9784. #. type: Plain text
  9785. #: ./bashref.texi:6013
  9786. msgid ""
  9787. "Up to three characters which control history expansion, quick substitution, "
  9788. "and tokenization (@pxref{History Interaction}). The first character is the "
  9789. "@var{history expansion} character, that is, the character which signifies "
  9790. "the start of a history expansion, normally @samp{!}. The second character "
  9791. "is the character which signifies `quick substitution' when seen as the first "
  9792. "character on a line, normally @samp{^}. The optional third character is the "
  9793. "character which indicates that the remainder of the line is a comment when "
  9794. "found as the first character of a word, usually @samp{#}. The history "
  9795. "comment character causes history substitution to be skipped for the "
  9796. "remaining words on the line. It does not necessarily cause the shell parser "
  9797. "to treat the rest of the line as a comment."
  9798. msgstr ""
  9799. #. type: item
  9800. #: ./bashref.texi:6014
  9801. #, no-wrap
  9802. msgid "HISTCMD"
  9803. msgstr ""
  9804. #. type: Plain text
  9805. #: ./bashref.texi:6018
  9806. msgid ""
  9807. "The history number, or index in the history list, of the current command. "
  9808. "If @env{HISTCMD} is unset, it loses its special properties, even if it is "
  9809. "subsequently reset."
  9810. msgstr ""
  9811. #. type: item
  9812. #: ./bashref.texi:6019
  9813. #, no-wrap
  9814. msgid "HISTCONTROL"
  9815. msgstr ""
  9816. #. type: Plain text
  9817. #: ./bashref.texi:6038
  9818. msgid ""
  9819. "A colon-separated list of values controlling how commands are saved on the "
  9820. "history list. If the list of values includes @samp{ignorespace}, lines "
  9821. "which begin with a space character are not saved in the history list. A "
  9822. "value of @samp{ignoredups} causes lines which match the previous history "
  9823. "entry to not be saved. A value of @samp{ignoreboth} is shorthand for "
  9824. "@samp{ignorespace} and @samp{ignoredups}. A value of @samp{erasedups} "
  9825. "causes all previous lines matching the current line to be removed from the "
  9826. "history list before that line is saved. Any value not in the above list is "
  9827. "ignored. If @env{HISTCONTROL} is unset, or does not include a valid value, "
  9828. "all lines read by the shell parser are saved on the history list, subject to "
  9829. "the value of @env{HISTIGNORE}. The second and subsequent lines of a "
  9830. "multi-line compound command are not tested, and are added to the history "
  9831. "regardless of the value of @env{HISTCONTROL}."
  9832. msgstr ""
  9833. #. type: item
  9834. #: ./bashref.texi:6039
  9835. #, no-wrap
  9836. msgid "HISTFILE"
  9837. msgstr ""
  9838. #. type: Plain text
  9839. #: ./bashref.texi:6042
  9840. msgid ""
  9841. "The name of the file to which the command history is saved. The default "
  9842. "value is @file{~/.bash_history}."
  9843. msgstr ""
  9844. #. type: item
  9845. #: ./bashref.texi:6043
  9846. #, no-wrap
  9847. msgid "HISTFILESIZE"
  9848. msgstr ""
  9849. #. type: Plain text
  9850. #: ./bashref.texi:6054
  9851. msgid ""
  9852. "The maximum number of lines contained in the history file. When this "
  9853. "variable is assigned a value, the history file is truncated, if necessary, "
  9854. "to contain no more than that number of lines by removing the oldest "
  9855. "entries. The history file is also truncated to this size after writing it "
  9856. "when a shell exits. If the value is 0, the history file is truncated to "
  9857. "zero size. Non-numeric values and numeric values less than zero inhibit "
  9858. "truncation. The shell sets the default value to the value of @env{HISTSIZE} "
  9859. "after reading any startup files."
  9860. msgstr ""
  9861. #. type: item
  9862. #: ./bashref.texi:6055
  9863. #, no-wrap
  9864. msgid "HISTIGNORE"
  9865. msgstr ""
  9866. #. type: Plain text
  9867. #: ./bashref.texi:6070
  9868. msgid ""
  9869. "A colon-separated list of patterns used to decide which command lines should "
  9870. "be saved on the history list. Each pattern is anchored at the beginning of "
  9871. "the line and must match the complete line (no implicit @samp{*} is "
  9872. "appended). Each pattern is tested against the line after the checks "
  9873. "specified by @env{HISTCONTROL} are applied. In addition to the normal shell "
  9874. "pattern matching characters, @samp{&} matches the previous history line. "
  9875. "@samp{&} may be escaped using a backslash; the backslash is removed before "
  9876. "attempting a match. The second and subsequent lines of a multi-line "
  9877. "compound command are not tested, and are added to the history regardless of "
  9878. "the value of @env{HISTIGNORE}. The pattern matching honors the setting of "
  9879. "the @code{extglob} shell option."
  9880. msgstr ""
  9881. #. type: Plain text
  9882. #: ./bashref.texi:6076
  9883. msgid ""
  9884. "@env{HISTIGNORE} subsumes the function of @env{HISTCONTROL}. A pattern of "
  9885. "@samp{&} is identical to @code{ignoredups}, and a pattern of @samp{[ ]*} is "
  9886. "identical to @code{ignorespace}. Combining these two patterns, separating "
  9887. "them with a colon, provides the functionality of @code{ignoreboth}."
  9888. msgstr ""
  9889. #. type: item
  9890. #: ./bashref.texi:6077
  9891. #, no-wrap
  9892. msgid "HISTSIZE"
  9893. msgstr ""
  9894. #. type: Plain text
  9895. #: ./bashref.texi:6083
  9896. msgid ""
  9897. "The maximum number of commands to remember on the history list. If the "
  9898. "value is 0, commands are not saved in the history list. Numeric values less "
  9899. "than zero result in every command being saved on the history list (there is "
  9900. "no limit). The shell sets the default value to 500 after reading any "
  9901. "startup files."
  9902. msgstr ""
  9903. #. type: item
  9904. #: ./bashref.texi:6084
  9905. #, no-wrap
  9906. msgid "HISTTIMEFORMAT"
  9907. msgstr ""
  9908. #. type: Plain text
  9909. #: ./bashref.texi:6092
  9910. msgid ""
  9911. "If this variable is set and not null, its value is used as a format string "
  9912. "for @var{strftime} to print the time stamp associated with each history "
  9913. "entry displayed by the @code{history} builtin. If this variable is set, "
  9914. "time stamps are written to the history file so they may be preserved across "
  9915. "shell sessions. This uses the history comment character to distinguish "
  9916. "timestamps from other history lines."
  9917. msgstr ""
  9918. #. type: item
  9919. #: ./bashref.texi:6093
  9920. #, no-wrap
  9921. msgid "HOSTFILE"
  9922. msgstr ""
  9923. #. type: Plain text
  9924. #: ./bashref.texi:6105
  9925. msgid ""
  9926. "Contains the name of a file in the same format as @file{/etc/hosts} that "
  9927. "should be read when the shell needs to complete a hostname. The list of "
  9928. "possible hostname completions may be changed while the shell is running; the "
  9929. "next time hostname completion is attempted after the value is changed, Bash "
  9930. "adds the contents of the new file to the existing list. If @env{HOSTFILE} "
  9931. "is set, but has no value, or does not name a readable file, Bash attempts to "
  9932. "read @file{/etc/hosts} to obtain the list of possible hostname completions. "
  9933. "When @env{HOSTFILE} is unset, the hostname list is cleared."
  9934. msgstr ""
  9935. #. type: item
  9936. #: ./bashref.texi:6106
  9937. #, no-wrap
  9938. msgid "HOSTNAME"
  9939. msgstr ""
  9940. #. type: Plain text
  9941. #: ./bashref.texi:6108
  9942. msgid "The name of the current host."
  9943. msgstr ""
  9944. #. type: item
  9945. #: ./bashref.texi:6109
  9946. #, no-wrap
  9947. msgid "HOSTTYPE"
  9948. msgstr ""
  9949. #. type: Plain text
  9950. #: ./bashref.texi:6111
  9951. msgid "A string describing the machine Bash is running on."
  9952. msgstr ""
  9953. #. type: item
  9954. #: ./bashref.texi:6112
  9955. #, no-wrap
  9956. msgid "IGNOREEOF"
  9957. msgstr ""
  9958. #. type: Plain text
  9959. #: ./bashref.texi:6121
  9960. msgid ""
  9961. "Controls the action of the shell on receipt of an @code{EOF} character as "
  9962. "the sole input. If set, the value denotes the number of consecutive "
  9963. "@code{EOF} characters that can be read as the first character on an input "
  9964. "line before the shell will exit. If the variable exists but does not have a "
  9965. "numeric value, or has no value, then the default is 10. If the variable "
  9966. "does not exist, then @code{EOF} signifies the end of input to the shell. "
  9967. "This is only in effect for interactive shells."
  9968. msgstr ""
  9969. #. type: item
  9970. #: ./bashref.texi:6122
  9971. #, no-wrap
  9972. msgid "INPUTRC"
  9973. msgstr ""
  9974. #. type: Plain text
  9975. #: ./bashref.texi:6125
  9976. msgid ""
  9977. "The name of the Readline initialization file, overriding the default of "
  9978. "@file{~/.inputrc}."
  9979. msgstr ""
  9980. #. type: item
  9981. #: ./bashref.texi:6126
  9982. #, no-wrap
  9983. msgid "INSIDE_EMACS"
  9984. msgstr ""
  9985. #. type: Plain text
  9986. #: ./bashref.texi:6130
  9987. msgid ""
  9988. "If Bash finds this variable in the environment when the shell starts, it "
  9989. "assumes that the shell is running in an Emacs shell buffer and may disable "
  9990. "line editing depending on the value of @env{TERM}."
  9991. msgstr ""
  9992. #. type: item
  9993. #: ./bashref.texi:6131
  9994. #, no-wrap
  9995. msgid "LANG"
  9996. msgstr ""
  9997. #. type: Plain text
  9998. #: ./bashref.texi:6134
  9999. msgid ""
  10000. "Used to determine the locale category for any category not specifically "
  10001. "selected with a variable starting with @code{LC_}."
  10002. msgstr ""
  10003. #. type: item
  10004. #: ./bashref.texi:6135
  10005. #, no-wrap
  10006. msgid "LC_ALL"
  10007. msgstr ""
  10008. #. type: Plain text
  10009. #: ./bashref.texi:6138
  10010. msgid ""
  10011. "This variable overrides the value of @env{LANG} and any other @code{LC_} "
  10012. "variable specifying a locale category."
  10013. msgstr ""
  10014. #. type: item
  10015. #: ./bashref.texi:6139
  10016. #, no-wrap
  10017. msgid "LC_COLLATE"
  10018. msgstr ""
  10019. #. type: Plain text
  10020. #: ./bashref.texi:6145
  10021. msgid ""
  10022. "This variable determines the collation order used when sorting the results "
  10023. "of filename expansion, and determines the behavior of range expressions, "
  10024. "equivalence classes, and collating sequences within filename expansion and "
  10025. "pattern matching (@pxref{Filename Expansion})."
  10026. msgstr ""
  10027. #. type: item
  10028. #: ./bashref.texi:6146
  10029. #, no-wrap
  10030. msgid "LC_CTYPE"
  10031. msgstr ""
  10032. #. type: Plain text
  10033. #: ./bashref.texi:6150
  10034. msgid ""
  10035. "This variable determines the interpretation of characters and the behavior "
  10036. "of character classes within filename expansion and pattern matching "
  10037. "(@pxref{Filename Expansion})."
  10038. msgstr ""
  10039. #. type: Plain text
  10040. #: ./bashref.texi:6154
  10041. msgid ""
  10042. "This variable determines the locale used to translate double-quoted strings "
  10043. "preceded by a @samp{$} (@pxref{Locale Translation})."
  10044. msgstr ""
  10045. #. type: item
  10046. #: ./bashref.texi:6155
  10047. #, no-wrap
  10048. msgid "LC_NUMERIC"
  10049. msgstr ""
  10050. #. type: Plain text
  10051. #: ./bashref.texi:6157
  10052. msgid "This variable determines the locale category used for number formatting."
  10053. msgstr ""
  10054. #. type: item
  10055. #: ./bashref.texi:6158
  10056. #, no-wrap
  10057. msgid "LC_TIME"
  10058. msgstr ""
  10059. #. type: Plain text
  10060. #: ./bashref.texi:6161
  10061. msgid ""
  10062. "This variable determines the locale category used for data and time "
  10063. "formatting."
  10064. msgstr ""
  10065. #. type: item
  10066. #: ./bashref.texi:6162
  10067. #, no-wrap
  10068. msgid "LINENO"
  10069. msgstr ""
  10070. #. type: Plain text
  10071. #: ./bashref.texi:6164
  10072. msgid "The line number in the script or shell function currently executing."
  10073. msgstr ""
  10074. #. type: item
  10075. #: ./bashref.texi:6165
  10076. #, no-wrap
  10077. msgid "LINES"
  10078. msgstr ""
  10079. #. type: Plain text
  10080. #: ./bashref.texi:6171
  10081. msgid ""
  10082. "Used by the @code{select} command to determine the column length for "
  10083. "printing selection lists. Automatically set if the @code{checkwinsize} "
  10084. "option is enabled (@pxref{The Shopt Builtin}), or in an interactive shell "
  10085. "upon receipt of a @code{SIGWINCH}."
  10086. msgstr ""
  10087. #. type: item
  10088. #: ./bashref.texi:6172
  10089. #, no-wrap
  10090. msgid "MACHTYPE"
  10091. msgstr ""
  10092. #. type: Plain text
  10093. #: ./bashref.texi:6175
  10094. msgid ""
  10095. "A string that fully describes the system type on which Bash is executing, in "
  10096. "the standard @sc{gnu} @var{cpu-company-system} format."
  10097. msgstr ""
  10098. #. type: item
  10099. #: ./bashref.texi:6176
  10100. #, no-wrap
  10101. msgid "MAILCHECK"
  10102. msgstr ""
  10103. #. type: Plain text
  10104. #: ./bashref.texi:6183
  10105. msgid ""
  10106. "How often (in seconds) that the shell should check for mail in the files "
  10107. "specified in the @env{MAILPATH} or @env{MAIL} variables. The default is 60 "
  10108. "seconds. When it is time to check for mail, the shell does so before "
  10109. "displaying the primary prompt. If this variable is unset, or set to a value "
  10110. "that is not a number greater than or equal to zero, the shell disables mail "
  10111. "checking."
  10112. msgstr ""
  10113. #. type: item
  10114. #: ./bashref.texi:6184
  10115. #, no-wrap
  10116. msgid "MAPFILE"
  10117. msgstr ""
  10118. #. type: Plain text
  10119. #: ./bashref.texi:6187
  10120. msgid ""
  10121. "An array variable created to hold the text read by the @code{mapfile} "
  10122. "builtin when no variable name is supplied."
  10123. msgstr ""
  10124. #. type: item
  10125. #: ./bashref.texi:6188
  10126. #, no-wrap
  10127. msgid "OLDPWD"
  10128. msgstr ""
  10129. #. type: Plain text
  10130. #: ./bashref.texi:6190
  10131. msgid "The previous working directory as set by the @code{cd} builtin."
  10132. msgstr ""
  10133. #. type: item
  10134. #: ./bashref.texi:6191
  10135. #, no-wrap
  10136. msgid "OPTERR"
  10137. msgstr ""
  10138. #. type: Plain text
  10139. #: ./bashref.texi:6194
  10140. msgid ""
  10141. "If set to the value 1, Bash displays error messages generated by the "
  10142. "@code{getopts} builtin command."
  10143. msgstr ""
  10144. #. type: item
  10145. #: ./bashref.texi:6195
  10146. #, no-wrap
  10147. msgid "OSTYPE"
  10148. msgstr ""
  10149. #. type: Plain text
  10150. #: ./bashref.texi:6197
  10151. msgid "A string describing the operating system Bash is running on."
  10152. msgstr ""
  10153. #. type: item
  10154. #: ./bashref.texi:6198
  10155. #, no-wrap
  10156. msgid "PIPESTATUS"
  10157. msgstr ""
  10158. #. type: Plain text
  10159. #: ./bashref.texi:6203
  10160. msgid ""
  10161. "An array variable (@pxref{Arrays}) containing a list of exit status values "
  10162. "from the processes in the most-recently-executed foreground pipeline (which "
  10163. "may contain only a single command)."
  10164. msgstr ""
  10165. #. type: item
  10166. #: ./bashref.texi:6204
  10167. #, no-wrap
  10168. msgid "POSIXLY_CORRECT"
  10169. msgstr ""
  10170. #. type: Plain text
  10171. #: ./bashref.texi:6210
  10172. msgid ""
  10173. "If this variable is in the environment when Bash starts, the shell enters "
  10174. "@sc{posix} mode (@pxref{Bash POSIX Mode}) before reading the startup files, "
  10175. "as if the @option{--posix} invocation option had been supplied. If it is "
  10176. "set while the shell is running, Bash enables @sc{posix} mode, as if the "
  10177. "command"
  10178. msgstr ""
  10179. #. type: example
  10180. #: ./bashref.texi:6212
  10181. #, no-wrap
  10182. msgid "@code{set -o posix}\n"
  10183. msgstr ""
  10184. #. type: Plain text
  10185. #: ./bashref.texi:6217
  10186. msgid ""
  10187. "had been executed. When the shell enters @sc{posix} mode, it sets this "
  10188. "variable if it was not already set."
  10189. msgstr ""
  10190. #. type: item
  10191. #: ./bashref.texi:6218
  10192. #, no-wrap
  10193. msgid "PPID"
  10194. msgstr ""
  10195. #. type: Plain text
  10196. #: ./bashref.texi:6221
  10197. msgid ""
  10198. "The process @sc{id} of the shell's parent process. This variable is "
  10199. "readonly."
  10200. msgstr ""
  10201. #. type: item
  10202. #: ./bashref.texi:6222
  10203. #, no-wrap
  10204. msgid "PROMPT_COMMAND"
  10205. msgstr ""
  10206. #. type: Plain text
  10207. #: ./bashref.texi:6225
  10208. msgid ""
  10209. "If set, the value is interpreted as a command to execute before the printing "
  10210. "of each primary prompt (@env{$PS1})."
  10211. msgstr ""
  10212. #. type: item
  10213. #: ./bashref.texi:6226
  10214. #, no-wrap
  10215. msgid "PROMPT_DIRTRIM"
  10216. msgstr ""
  10217. #. type: Plain text
  10218. #: ./bashref.texi:6231
  10219. msgid ""
  10220. "If set to a number greater than zero, the value is used as the number of "
  10221. "trailing directory components to retain when expanding the @code{\\w} and "
  10222. "@code{\\W} prompt string escapes (@pxref{Controlling the Prompt}). "
  10223. "Characters removed are replaced with an ellipsis."
  10224. msgstr ""
  10225. #. type: item
  10226. #: ./bashref.texi:6232
  10227. #, no-wrap
  10228. msgid "PS0"
  10229. msgstr ""
  10230. #. type: Plain text
  10231. #: ./bashref.texi:6236
  10232. msgid ""
  10233. "The value of this parameter is expanded like @var{PS1} and displayed by "
  10234. "interactive shells after reading a command and before the command is "
  10235. "executed."
  10236. msgstr ""
  10237. #. type: item
  10238. #: ./bashref.texi:6237
  10239. #, no-wrap
  10240. msgid "PS3"
  10241. msgstr ""
  10242. #. type: Plain text
  10243. #: ./bashref.texi:6241
  10244. msgid ""
  10245. "The value of this variable is used as the prompt for the @code{select} "
  10246. "command. If this variable is not set, the @code{select} command prompts "
  10247. "with @samp{#? }"
  10248. msgstr ""
  10249. #. type: item
  10250. #: ./bashref.texi:6242
  10251. #, no-wrap
  10252. msgid "PS4"
  10253. msgstr ""
  10254. #. type: Plain text
  10255. #: ./bashref.texi:6249
  10256. msgid ""
  10257. "The value of this parameter is expanded like @var{PS1} and the expanded "
  10258. "value is the prompt printed before the command line is echoed when the "
  10259. "@option{-x} option is set (@pxref{The Set Builtin}). The first character of "
  10260. "the expanded value is replicated multiple times, as necessary, to indicate "
  10261. "multiple levels of indirection. The default is @samp{+ }."
  10262. msgstr ""
  10263. #. type: item
  10264. #: ./bashref.texi:6250
  10265. #, no-wrap
  10266. msgid "PWD"
  10267. msgstr ""
  10268. #. type: Plain text
  10269. #: ./bashref.texi:6252
  10270. msgid "The current working directory as set by the @code{cd} builtin."
  10271. msgstr ""
  10272. #. type: item
  10273. #: ./bashref.texi:6253
  10274. #, no-wrap
  10275. msgid "RANDOM"
  10276. msgstr ""
  10277. #. type: Plain text
  10278. #: ./bashref.texi:6257
  10279. msgid ""
  10280. "Each time this parameter is referenced, a random integer between 0 and 32767 "
  10281. "is generated. Assigning a value to this variable seeds the random number "
  10282. "generator."
  10283. msgstr ""
  10284. #. type: item
  10285. #: ./bashref.texi:6258
  10286. #, no-wrap
  10287. msgid "READLINE_LINE"
  10288. msgstr ""
  10289. #. type: Plain text
  10290. #: ./bashref.texi:6261
  10291. msgid ""
  10292. "The contents of the Readline line buffer, for use with @samp{bind -x} "
  10293. "(@pxref{Bash Builtins})."
  10294. msgstr ""
  10295. #. type: item
  10296. #: ./bashref.texi:6262
  10297. #, no-wrap
  10298. msgid "READLINE_POINT"
  10299. msgstr ""
  10300. #. type: Plain text
  10301. #: ./bashref.texi:6265
  10302. msgid ""
  10303. "The position of the insertion point in the Readline line buffer, for use "
  10304. "with @samp{bind -x} (@pxref{Bash Builtins})."
  10305. msgstr ""
  10306. #. type: item
  10307. #: ./bashref.texi:6266
  10308. #, no-wrap
  10309. msgid "REPLY"
  10310. msgstr ""
  10311. #. type: Plain text
  10312. #: ./bashref.texi:6268
  10313. msgid "The default variable for the @code{read} builtin."
  10314. msgstr ""
  10315. #. type: item
  10316. #: ./bashref.texi:6269
  10317. #, no-wrap
  10318. msgid "SECONDS"
  10319. msgstr ""
  10320. #. type: Plain text
  10321. #: ./bashref.texi:6275
  10322. msgid ""
  10323. "This variable expands to the number of seconds since the shell was started. "
  10324. "Assignment to this variable resets the count to the value assigned, and the "
  10325. "expanded value becomes the value assigned plus the number of seconds since "
  10326. "the assignment."
  10327. msgstr ""
  10328. #. type: item
  10329. #: ./bashref.texi:6276
  10330. #, no-wrap
  10331. msgid "SHELL"
  10332. msgstr ""
  10333. #. type: Plain text
  10334. #: ./bashref.texi:6280
  10335. msgid ""
  10336. "The full pathname to the shell is kept in this environment variable. If it "
  10337. "is not set when the shell starts, Bash assigns to it the full pathname of "
  10338. "the current user's login shell."
  10339. msgstr ""
  10340. #. type: item
  10341. #: ./bashref.texi:6281
  10342. #, no-wrap
  10343. msgid "SHELLOPTS"
  10344. msgstr ""
  10345. #. type: Plain text
  10346. #: ./bashref.texi:6290
  10347. msgid ""
  10348. "A colon-separated list of enabled shell options. Each word in the list is a "
  10349. "valid argument for the @option{-o} option to the @code{set} builtin command "
  10350. "(@pxref{The Set Builtin}). The options appearing in @env{SHELLOPTS} are "
  10351. "those reported as @samp{on} by @samp{set -o}. If this variable is in the "
  10352. "environment when Bash starts up, each shell option in the list will be "
  10353. "enabled before reading any startup files. This variable is readonly."
  10354. msgstr ""
  10355. #. type: item
  10356. #: ./bashref.texi:6291
  10357. #, no-wrap
  10358. msgid "SHLVL"
  10359. msgstr ""
  10360. #. type: Plain text
  10361. #: ./bashref.texi:6294
  10362. msgid ""
  10363. "Incremented by one each time a new instance of Bash is started. This is "
  10364. "intended to be a count of how deeply your Bash shells are nested."
  10365. msgstr ""
  10366. #. type: item
  10367. #: ./bashref.texi:6295
  10368. #, no-wrap
  10369. msgid "TIMEFORMAT"
  10370. msgstr ""
  10371. #. type: Plain text
  10372. #: ./bashref.texi:6304
  10373. msgid ""
  10374. "The value of this parameter is used as a format string specifying how the "
  10375. "timing information for pipelines prefixed with the @code{time} reserved word "
  10376. "should be displayed. The @samp{%} character introduces an escape sequence "
  10377. "that is expanded to a time value or other information. The escape sequences "
  10378. "and their meanings are as follows; the braces denote optional portions."
  10379. msgstr ""
  10380. #. type: item
  10381. #: ./bashref.texi:6307
  10382. #, no-wrap
  10383. msgid "%%"
  10384. msgstr ""
  10385. #. type: table
  10386. #: ./bashref.texi:6309
  10387. msgid "A literal @samp{%}."
  10388. msgstr ""
  10389. #. type: item
  10390. #: ./bashref.texi:6310
  10391. #, no-wrap
  10392. msgid "%[@var{p}][l]R"
  10393. msgstr ""
  10394. #. type: table
  10395. #: ./bashref.texi:6312
  10396. msgid "The elapsed time in seconds."
  10397. msgstr ""
  10398. #. type: item
  10399. #: ./bashref.texi:6313
  10400. #, no-wrap
  10401. msgid "%[@var{p}][l]U"
  10402. msgstr ""
  10403. #. type: table
  10404. #: ./bashref.texi:6315
  10405. msgid "The number of CPU seconds spent in user mode."
  10406. msgstr ""
  10407. #. type: item
  10408. #: ./bashref.texi:6316
  10409. #, no-wrap
  10410. msgid "%[@var{p}][l]S"
  10411. msgstr ""
  10412. #. type: table
  10413. #: ./bashref.texi:6318
  10414. msgid "The number of CPU seconds spent in system mode."
  10415. msgstr ""
  10416. #. type: item
  10417. #: ./bashref.texi:6319
  10418. #, no-wrap
  10419. msgid "%P"
  10420. msgstr ""
  10421. #. type: table
  10422. #: ./bashref.texi:6321
  10423. msgid "The CPU percentage, computed as (%U + %S) / %R."
  10424. msgstr ""
  10425. #. type: Plain text
  10426. #: ./bashref.texi:6329
  10427. msgid ""
  10428. "The optional @var{p} is a digit specifying the precision, the number of "
  10429. "fractional digits after a decimal point. A value of 0 causes no decimal "
  10430. "point or fraction to be output. At most three places after the decimal "
  10431. "point may be specified; values of @var{p} greater than 3 are changed to 3. "
  10432. "If @var{p} is not specified, the value 3 is used."
  10433. msgstr ""
  10434. #. type: Plain text
  10435. #: ./bashref.texi:6333
  10436. msgid ""
  10437. "The optional @code{l} specifies a longer format, including minutes, of the "
  10438. "form @var{MM}m@var{SS}.@var{FF}s. The value of @var{p} determines whether "
  10439. "or not the fraction is included."
  10440. msgstr ""
  10441. #. type: Plain text
  10442. #: ./bashref.texi:6335
  10443. msgid "If this variable is not set, Bash acts as if it had the value"
  10444. msgstr ""
  10445. #. type: example
  10446. #: ./bashref.texi:6337
  10447. #, no-wrap
  10448. msgid "@code{$'\\nreal\\t%3lR\\nuser\\t%3lU\\nsys\\t%3lS'}\n"
  10449. msgstr ""
  10450. #. type: Plain text
  10451. #: ./bashref.texi:6340
  10452. msgid ""
  10453. "If the value is null, no timing information is displayed. A trailing "
  10454. "newline is added when the format string is displayed."
  10455. msgstr ""
  10456. #. type: item
  10457. #: ./bashref.texi:6341
  10458. #, no-wrap
  10459. msgid "TMOUT"
  10460. msgstr ""
  10461. #. type: Plain text
  10462. #: ./bashref.texi:6347
  10463. msgid ""
  10464. "If set to a value greater than zero, @code{TMOUT} is treated as the default "
  10465. "timeout for the @code{read} builtin (@pxref{Bash Builtins}). The "
  10466. "@code{select} command (@pxref{Conditional Constructs}) terminates if input "
  10467. "does not arrive after @code{TMOUT} seconds when input is coming from a "
  10468. "terminal."
  10469. msgstr ""
  10470. #. type: Plain text
  10471. #: ./bashref.texi:6354
  10472. msgid ""
  10473. "In an interactive shell, the value is interpreted as the number of seconds "
  10474. "to wait for a line of input after issuing the primary prompt. Bash "
  10475. "terminates after waiting for that number of seconds if a complete line of "
  10476. "input does not arrive."
  10477. msgstr ""
  10478. #. type: item
  10479. #: ./bashref.texi:6355
  10480. #, no-wrap
  10481. msgid "TMPDIR"
  10482. msgstr ""
  10483. #. type: Plain text
  10484. #: ./bashref.texi:6358
  10485. msgid ""
  10486. "If set, Bash uses its value as the name of a directory in which Bash creates "
  10487. "temporary files for the shell's use."
  10488. msgstr ""
  10489. #. type: item
  10490. #: ./bashref.texi:6359
  10491. #, no-wrap
  10492. msgid "UID"
  10493. msgstr ""
  10494. #. type: Plain text
  10495. #: ./bashref.texi:6361
  10496. msgid "The numeric real user id of the current user. This variable is readonly."
  10497. msgstr ""
  10498. #. type: Plain text
  10499. #: ./bashref.texi:6368
  10500. msgid "This chapter describes features unique to Bash."
  10501. msgstr ""
  10502. #. type: section
  10503. #: ./bashref.texi:6384 ./bashref.texi:6386 ./bashref.texi:6387
  10504. #, no-wrap
  10505. msgid "Invoking Bash"
  10506. msgstr ""
  10507. #. type: menuentry
  10508. #: ./bashref.texi:6384
  10509. msgid "Command line options that you can give to Bash."
  10510. msgstr ""
  10511. #. type: section
  10512. #: ./bashref.texi:6384 ./bashref.texi:6549 ./bashref.texi:6550
  10513. #, no-wrap
  10514. msgid "Bash Startup Files"
  10515. msgstr ""
  10516. #. type: menuentry
  10517. #: ./bashref.texi:6384
  10518. msgid "When and how Bash executes scripts."
  10519. msgstr ""
  10520. #. type: section
  10521. #: ./bashref.texi:6384 ./bashref.texi:6667 ./bashref.texi:6668
  10522. #, no-wrap
  10523. msgid "Interactive Shells"
  10524. msgstr ""
  10525. #. type: menuentry
  10526. #: ./bashref.texi:6384
  10527. msgid "What an interactive shell is."
  10528. msgstr ""
  10529. #. type: section
  10530. #: ./bashref.texi:6384 ./bashref.texi:6828 ./bashref.texi:6829
  10531. #, no-wrap
  10532. msgid "Bash Conditional Expressions"
  10533. msgstr ""
  10534. #. type: menuentry
  10535. #: ./bashref.texi:6384
  10536. msgid "Primitives used in composing expressions for the @code{test} builtin."
  10537. msgstr ""
  10538. #. type: section
  10539. #: ./bashref.texi:6384 ./bashref.texi:6983 ./bashref.texi:6984
  10540. #, no-wrap
  10541. msgid "Shell Arithmetic"
  10542. msgstr ""
  10543. #. type: menuentry
  10544. #: ./bashref.texi:6384
  10545. msgid "Arithmetic on shell variables."
  10546. msgstr ""
  10547. #. type: section
  10548. #: ./bashref.texi:6384 ./bashref.texi:7090 ./bashref.texi:7091
  10549. #, no-wrap
  10550. msgid "Aliases"
  10551. msgstr ""
  10552. #. type: menuentry
  10553. #: ./bashref.texi:6384
  10554. msgid "Substituting one command for another."
  10555. msgstr ""
  10556. #. type: section
  10557. #: ./bashref.texi:6384 ./bashref.texi:7151 ./bashref.texi:7152
  10558. #, no-wrap
  10559. msgid "Arrays"
  10560. msgstr ""
  10561. #. type: menuentry
  10562. #: ./bashref.texi:6384
  10563. msgid "Array Variables."
  10564. msgstr ""
  10565. #. type: section
  10566. #: ./bashref.texi:6384 ./bashref.texi:7292 ./bashref.texi:7293
  10567. #, no-wrap
  10568. msgid "The Directory Stack"
  10569. msgstr ""
  10570. #. type: menuentry
  10571. #: ./bashref.texi:6384
  10572. msgid "History of visited directories."
  10573. msgstr ""
  10574. #. type: section
  10575. #: ./bashref.texi:6384 ./bashref.texi:7404 ./bashref.texi:7405
  10576. #, no-wrap
  10577. msgid "Controlling the Prompt"
  10578. msgstr ""
  10579. #. type: menuentry
  10580. #: ./bashref.texi:6384
  10581. msgid "Customizing the various prompt strings."
  10582. msgstr ""
  10583. #. type: section
  10584. #: ./bashref.texi:6384 ./bashref.texi:7491 ./bashref.texi:7492
  10585. #, no-wrap
  10586. msgid "The Restricted Shell"
  10587. msgstr ""
  10588. #. type: menuentry
  10589. #: ./bashref.texi:6384
  10590. msgid "A more controlled mode of shell execution."
  10591. msgstr ""
  10592. #. type: section
  10593. #: ./bashref.texi:6384 ./bashref.texi:7545 ./bashref.texi:7546
  10594. #, no-wrap
  10595. msgid "Bash POSIX Mode"
  10596. msgstr ""
  10597. #. type: menuentry
  10598. #: ./bashref.texi:6384
  10599. msgid "Making Bash behave more closely to what the POSIX standard specifies."
  10600. msgstr ""
  10601. #. type: example
  10602. #: ./bashref.texi:6396
  10603. #, no-wrap
  10604. msgid ""
  10605. "bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @var{option}]\n"
  10606. " [-O @var{shopt_option}] [@var{argument} @dots{}]\n"
  10607. "bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @var{option}]\n"
  10608. " [-O @var{shopt_option}] -c @var{string} [@var{argument} @dots{}]\n"
  10609. "bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @var{option}]\n"
  10610. " [-O @var{shopt_option}] [@var{argument} @dots{}]\n"
  10611. msgstr ""
  10612. #. type: Plain text
  10613. #: ./bashref.texi:6403
  10614. msgid ""
  10615. "All of the single-character options used with the @code{set} builtin "
  10616. "(@pxref{The Set Builtin}) can be used as options when the shell is invoked. "
  10617. "In addition, there are several multi-character options that you can use. "
  10618. "These options must appear on the command line before the single-character "
  10619. "options to be recognized."
  10620. msgstr ""
  10621. #. type: item
  10622. #: ./bashref.texi:6405
  10623. #, no-wrap
  10624. msgid "--debugger"
  10625. msgstr ""
  10626. #. type: table
  10627. #: ./bashref.texi:6410
  10628. msgid ""
  10629. "Arrange for the debugger profile to be executed before the shell starts. "
  10630. "Turns on extended debugging mode (see @ref{The Shopt Builtin} for a "
  10631. "description of the @code{extdebug} option to the @code{shopt} builtin)."
  10632. msgstr ""
  10633. #. type: item
  10634. #: ./bashref.texi:6411
  10635. #, no-wrap
  10636. msgid "--dump-po-strings"
  10637. msgstr ""
  10638. #. type: table
  10639. #: ./bashref.texi:6416
  10640. msgid ""
  10641. "A list of all double-quoted strings preceded by @samp{$} is printed on the "
  10642. "standard output in the @sc{gnu} @code{gettext} PO (portable object) file "
  10643. "format. Equivalent to @option{-D} except for the output format."
  10644. msgstr ""
  10645. #. type: item
  10646. #: ./bashref.texi:6417
  10647. #, no-wrap
  10648. msgid "--dump-strings"
  10649. msgstr ""
  10650. #. type: table
  10651. #: ./bashref.texi:6419
  10652. msgid "Equivalent to @option{-D}."
  10653. msgstr ""
  10654. #. type: item
  10655. #: ./bashref.texi:6420 ./bashref.texi:8408
  10656. #, no-wrap
  10657. msgid "--help"
  10658. msgstr ""
  10659. #. type: table
  10660. #: ./bashref.texi:6422
  10661. msgid "Display a usage message on standard output and exit successfully."
  10662. msgstr ""
  10663. #. type: item
  10664. #: ./bashref.texi:6423
  10665. #, no-wrap
  10666. msgid "--init-file @var{filename}"
  10667. msgstr ""
  10668. #. type: itemx
  10669. #: ./bashref.texi:6424
  10670. #, no-wrap
  10671. msgid "--rcfile @var{filename}"
  10672. msgstr ""
  10673. #. type: table
  10674. #: ./bashref.texi:6427
  10675. msgid ""
  10676. "Execute commands from @var{filename} (instead of @file{~/.bashrc}) in an "
  10677. "interactive shell."
  10678. msgstr ""
  10679. #. type: item
  10680. #: ./bashref.texi:6428
  10681. #, no-wrap
  10682. msgid "--login"
  10683. msgstr ""
  10684. #. type: table
  10685. #: ./bashref.texi:6430
  10686. msgid "Equivalent to @option{-l}."
  10687. msgstr ""
  10688. #. type: item
  10689. #: ./bashref.texi:6431
  10690. #, no-wrap
  10691. msgid "--noediting"
  10692. msgstr ""
  10693. #. type: table
  10694. #: ./bashref.texi:6434
  10695. msgid ""
  10696. "Do not use the @sc{gnu} Readline library (@pxref{Command Line Editing}) to "
  10697. "read command lines when the shell is interactive."
  10698. msgstr ""
  10699. #. type: item
  10700. #: ./bashref.texi:6435
  10701. #, no-wrap
  10702. msgid "--noprofile"
  10703. msgstr ""
  10704. #. type: table
  10705. #: ./bashref.texi:6440
  10706. msgid ""
  10707. "Don't load the system-wide startup file @file{/etc/profile} or any of the "
  10708. "personal initialization files @file{~/.bash_profile}, @file{~/.bash_login}, "
  10709. "or @file{~/.profile} when Bash is invoked as a login shell."
  10710. msgstr ""
  10711. #. type: item
  10712. #: ./bashref.texi:6441
  10713. #, no-wrap
  10714. msgid "--norc"
  10715. msgstr ""
  10716. #. type: table
  10717. #: ./bashref.texi:6445
  10718. msgid ""
  10719. "Don't read the @file{~/.bashrc} initialization file in an interactive "
  10720. "shell. This is on by default if the shell is invoked as @code{sh}."
  10721. msgstr ""
  10722. #. type: item
  10723. #: ./bashref.texi:6446
  10724. #, no-wrap
  10725. msgid "--posix"
  10726. msgstr ""
  10727. #. type: table
  10728. #: ./bashref.texi:6452
  10729. msgid ""
  10730. "Change the behavior of Bash where the default operation differs from the "
  10731. "@sc{posix} standard to match the standard. This is intended to make Bash "
  10732. "behave as a strict superset of that standard. @xref{Bash POSIX Mode}, for a "
  10733. "description of the Bash @sc{posix} mode."
  10734. msgstr ""
  10735. #. type: item
  10736. #: ./bashref.texi:6453
  10737. #, no-wrap
  10738. msgid "--restricted"
  10739. msgstr ""
  10740. #. type: table
  10741. #: ./bashref.texi:6455 ./bashref.texi:6494
  10742. msgid "Make the shell a restricted shell (@pxref{The Restricted Shell})."
  10743. msgstr ""
  10744. #. type: item
  10745. #: ./bashref.texi:6456
  10746. #, no-wrap
  10747. msgid "--verbose"
  10748. msgstr ""
  10749. #. type: table
  10750. #: ./bashref.texi:6458
  10751. msgid "Equivalent to @option{-v}. Print shell input lines as they're read."
  10752. msgstr ""
  10753. #. type: item
  10754. #: ./bashref.texi:6459 ./bashref.texi:8420
  10755. #, no-wrap
  10756. msgid "--version"
  10757. msgstr ""
  10758. #. type: table
  10759. #: ./bashref.texi:6462
  10760. msgid ""
  10761. "Show version information for this instance of Bash on the standard output "
  10762. "and exit successfully."
  10763. msgstr ""
  10764. #. type: Plain text
  10765. #: ./bashref.texi:6466
  10766. msgid ""
  10767. "There are several single-character options that may be supplied at "
  10768. "invocation which are not available with the @code{set} builtin."
  10769. msgstr ""
  10770. #. type: table
  10771. #: ./bashref.texi:6476
  10772. msgid ""
  10773. "Read and execute commands from the first non-option argument "
  10774. "@var{command_string}, then exit. If there are arguments after the "
  10775. "@var{command_string}, the first argument is assigned to @code{$0} and any "
  10776. "remaining arguments are assigned to the positional parameters. The "
  10777. "assignment to @code{$0} sets the name of the shell, which is used in warning "
  10778. "and error messages."
  10779. msgstr ""
  10780. #. type: table
  10781. #: ./bashref.texi:6480
  10782. msgid ""
  10783. "Force the shell to run interactively. Interactive shells are described in "
  10784. "@ref{Interactive Shells}."
  10785. msgstr ""
  10786. #. type: table
  10787. #: ./bashref.texi:6491
  10788. msgid ""
  10789. "Make this shell act as if it had been directly invoked by login. When the "
  10790. "shell is interactive, this is equivalent to starting a login shell with "
  10791. "@samp{exec -l bash}. When the shell is not interactive, the login shell "
  10792. "startup files will be executed. @samp{exec bash -l} or @samp{exec bash "
  10793. "--login} will replace the current shell with a Bash login shell. @xref{Bash "
  10794. "Startup Files}, for a description of the special behavior of a login shell."
  10795. msgstr ""
  10796. #. type: table
  10797. #: ./bashref.texi:6501
  10798. msgid ""
  10799. "If this option is present, or if no arguments remain after option "
  10800. "processing, then commands are read from the standard input. This option "
  10801. "allows the positional parameters to be set when invoking an interactive "
  10802. "shell or when reading input through a pipe."
  10803. msgstr ""
  10804. #. type: item
  10805. #: ./bashref.texi:6502
  10806. #, no-wrap
  10807. msgid "-D"
  10808. msgstr ""
  10809. #. type: table
  10810. #: ./bashref.texi:6509
  10811. msgid ""
  10812. "A list of all double-quoted strings preceded by @samp{$} is printed on the "
  10813. "standard output. These are the strings that are subject to language "
  10814. "translation when the current locale is not @code{C} or @code{POSIX} "
  10815. "(@pxref{Locale Translation}). This implies the @option{-n} option; no "
  10816. "commands will be executed."
  10817. msgstr ""
  10818. #. type: item
  10819. #: ./bashref.texi:6510
  10820. #, no-wrap
  10821. msgid "[-+]O [@var{shopt_option}]"
  10822. msgstr ""
  10823. #. type: table
  10824. #: ./bashref.texi:6519
  10825. msgid ""
  10826. "@var{shopt_option} is one of the shell options accepted by the @code{shopt} "
  10827. "builtin (@pxref{The Shopt Builtin}). If @var{shopt_option} is present, "
  10828. "@option{-O} sets the value of that option; @option{+O} unsets it. If "
  10829. "@var{shopt_option} is not supplied, the names and values of the shell "
  10830. "options accepted by @code{shopt} are printed on the standard output. If the "
  10831. "invocation option is @option{+O}, the output is displayed in a format that "
  10832. "may be reused as input."
  10833. msgstr ""
  10834. #. type: table
  10835. #: ./bashref.texi:6524
  10836. msgid ""
  10837. "A @code{--} signals the end of options and disables further option "
  10838. "processing. Any arguments after the @code{--} are treated as filenames and "
  10839. "arguments."
  10840. msgstr ""
  10841. #. type: cindex
  10842. #: ./bashref.texi:6526
  10843. #, no-wrap
  10844. msgid "login shell"
  10845. msgstr ""
  10846. #. type: Plain text
  10847. #: ./bashref.texi:6529
  10848. msgid ""
  10849. "A @emph{login} shell is one whose first character of argument zero is "
  10850. "@samp{-}, or one invoked with the @option{--login} option."
  10851. msgstr ""
  10852. #. type: cindex
  10853. #: ./bashref.texi:6530 ./bashref.texi:6669
  10854. #, no-wrap
  10855. msgid "interactive shell"
  10856. msgstr ""
  10857. #. type: Plain text
  10858. #: ./bashref.texi:6537
  10859. msgid ""
  10860. "An @emph{interactive} shell is one started without non-option arguments, "
  10861. "unless @option{-s} is specified, without specifying the @option{-c} option, "
  10862. "and whose input and output are both connected to terminals (as determined by "
  10863. "@code{isatty(3)}), or one started with the @option{-i} option. "
  10864. "@xref{Interactive Shells}, for more information."
  10865. msgstr ""
  10866. #. type: Plain text
  10867. #: ./bashref.texi:6548
  10868. msgid ""
  10869. "If arguments remain after option processing, and neither the @option{-c} nor "
  10870. "the @option{-s} option has been supplied, the first argument is assumed to "
  10871. "be the name of a file containing shell commands (@pxref{Shell Scripts}). "
  10872. "When Bash is invoked in this fashion, @code{$0} is set to the name of the "
  10873. "file, and the positional parameters are set to the remaining arguments. "
  10874. "Bash reads and executes commands from this file, then exits. Bash's exit "
  10875. "status is the exit status of the last command executed in the script. If no "
  10876. "commands are executed, the exit status is 0."
  10877. msgstr ""
  10878. #. type: cindex
  10879. #: ./bashref.texi:6551
  10880. #, no-wrap
  10881. msgid "startup files"
  10882. msgstr ""
  10883. #. type: Plain text
  10884. #: ./bashref.texi:6557
  10885. msgid ""
  10886. "This section describes how Bash executes its startup files. If any of the "
  10887. "files exist but cannot be read, Bash reports an error. Tildes are expanded "
  10888. "in filenames as described above under Tilde Expansion (@pxref{Tilde "
  10889. "Expansion})."
  10890. msgstr ""
  10891. #. type: Plain text
  10892. #: ./bashref.texi:6559
  10893. msgid "Interactive shells are described in @ref{Interactive Shells}."
  10894. msgstr ""
  10895. #. type: subsubheading
  10896. #: ./bashref.texi:6560
  10897. #, no-wrap
  10898. msgid "Invoked as an interactive login shell, or with @option{--login}"
  10899. msgstr ""
  10900. #. type: Plain text
  10901. #: ./bashref.texi:6570
  10902. msgid ""
  10903. "When Bash is invoked as an interactive login shell, or as a non-interactive "
  10904. "shell with the @option{--login} option, it first reads and executes commands "
  10905. "from the file @file{/etc/profile}, if that file exists. After reading that "
  10906. "file, it looks for @file{~/.bash_profile}, @file{~/.bash_login}, and "
  10907. "@file{~/.profile}, in that order, and reads and executes commands from the "
  10908. "first one that exists and is readable. The @option{--noprofile} option may "
  10909. "be used when the shell is started to inhibit this behavior."
  10910. msgstr ""
  10911. #. type: Plain text
  10912. #: ./bashref.texi:6575
  10913. msgid ""
  10914. "When an interactive login shell exits, or a non-interactive login shell "
  10915. "executes the @code{exit} builtin command, Bash reads and executes commands "
  10916. "from the file @file{~/.bash_logout}, if it exists."
  10917. msgstr ""
  10918. #. type: subsubheading
  10919. #: ./bashref.texi:6576
  10920. #, no-wrap
  10921. msgid "Invoked as an interactive non-login shell"
  10922. msgstr ""
  10923. #. type: Plain text
  10924. #: ./bashref.texi:6583
  10925. msgid ""
  10926. "When an interactive shell that is not a login shell is started, Bash reads "
  10927. "and executes commands from @file{~/.bashrc}, if that file exists. This may "
  10928. "be inhibited by using the @option{--norc} option. The @option{--rcfile "
  10929. "@var{file}} option will force Bash to read and execute commands from "
  10930. "@var{file} instead of @file{~/.bashrc}."
  10931. msgstr ""
  10932. #. type: Plain text
  10933. #: ./bashref.texi:6585
  10934. msgid "So, typically, your @file{~/.bash_profile} contains the line"
  10935. msgstr ""
  10936. #. type: example
  10937. #: ./bashref.texi:6587
  10938. #, no-wrap
  10939. msgid "@code{if [ -f ~/.bashrc ]; then . ~/.bashrc; fi}\n"
  10940. msgstr ""
  10941. #. type: Plain text
  10942. #: ./bashref.texi:6590
  10943. msgid "after (or before) any login-specific initializations."
  10944. msgstr ""
  10945. #. type: subsubheading
  10946. #: ./bashref.texi:6591
  10947. #, no-wrap
  10948. msgid "Invoked non-interactively"
  10949. msgstr ""
  10950. #. type: Plain text
  10951. #: ./bashref.texi:6598
  10952. msgid ""
  10953. "When Bash is started non-interactively, to run a shell script, for example, "
  10954. "it looks for the variable @env{BASH_ENV} in the environment, expands its "
  10955. "value if it appears there, and uses the expanded value as the name of a file "
  10956. "to read and execute. Bash behaves as if the following command were "
  10957. "executed:"
  10958. msgstr ""
  10959. #. type: example
  10960. #: ./bashref.texi:6600
  10961. #, no-wrap
  10962. msgid "@code{if [ -n \"$BASH_ENV\" ]; then . \"$BASH_ENV\"; fi}\n"
  10963. msgstr ""
  10964. #. type: Plain text
  10965. #: ./bashref.texi:6604
  10966. msgid ""
  10967. "but the value of the @env{PATH} variable is not used to search for the "
  10968. "filename."
  10969. msgstr ""
  10970. #. type: Plain text
  10971. #: ./bashref.texi:6608
  10972. msgid ""
  10973. "As noted above, if a non-interactive shell is invoked with the "
  10974. "@option{--login} option, Bash attempts to read and execute commands from the "
  10975. "login shell startup files."
  10976. msgstr ""
  10977. #. type: subsubheading
  10978. #: ./bashref.texi:6609
  10979. #, no-wrap
  10980. msgid "Invoked with name @code{sh}"
  10981. msgstr ""
  10982. #. type: Plain text
  10983. #: ./bashref.texi:6614
  10984. msgid ""
  10985. "If Bash is invoked with the name @code{sh}, it tries to mimic the startup "
  10986. "behavior of historical versions of @code{sh} as closely as possible, while "
  10987. "conforming to the @sc{posix} standard as well."
  10988. msgstr ""
  10989. #. type: Plain text
  10990. #: ./bashref.texi:6628
  10991. msgid ""
  10992. "When invoked as an interactive login shell, or as a non-interactive shell "
  10993. "with the @option{--login} option, it first attempts to read and execute "
  10994. "commands from @file{/etc/profile} and @file{~/.profile}, in that order. The "
  10995. "@option{--noprofile} option may be used to inhibit this behavior. When "
  10996. "invoked as an interactive shell with the name @code{sh}, Bash looks for the "
  10997. "variable @env{ENV}, expands its value if it is defined, and uses the "
  10998. "expanded value as the name of a file to read and execute. Since a shell "
  10999. "invoked as @code{sh} does not attempt to read and execute commands from any "
  11000. "other startup files, the @option{--rcfile} option has no effect. A "
  11001. "non-interactive shell invoked with the name @code{sh} does not attempt to "
  11002. "read any other startup files."
  11003. msgstr ""
  11004. #. type: Plain text
  11005. #: ./bashref.texi:6631
  11006. msgid ""
  11007. "When invoked as @code{sh}, Bash enters @sc{posix} mode after the startup "
  11008. "files are read."
  11009. msgstr ""
  11010. #. type: subsubheading
  11011. #: ./bashref.texi:6632
  11012. #, no-wrap
  11013. msgid "Invoked in @sc{posix} mode"
  11014. msgstr ""
  11015. #. type: Plain text
  11016. #: ./bashref.texi:6641
  11017. msgid ""
  11018. "When Bash is started in @sc{posix} mode, as with the @option{--posix} "
  11019. "command line option, it follows the @sc{posix} standard for startup files. "
  11020. "In this mode, interactive shells expand the @env{ENV} variable and commands "
  11021. "are read and executed from the file whose name is the expanded value. No "
  11022. "other startup files are read."
  11023. msgstr ""
  11024. #. type: subsubheading
  11025. #: ./bashref.texi:6642
  11026. #, no-wrap
  11027. msgid "Invoked by remote shell daemon"
  11028. msgstr ""
  11029. #. type: Plain text
  11030. #: ./bashref.texi:6655
  11031. msgid ""
  11032. "Bash attempts to determine when it is being run with its standard input "
  11033. "connected to a network connection, as when executed by the remote shell "
  11034. "daemon, usually @code{rshd}, or the secure shell daemon @code{sshd}. If "
  11035. "Bash determines it is being run in this fashion, it reads and executes "
  11036. "commands from @file{~/.bashrc}, if that file exists and is readable. It "
  11037. "will not do this if invoked as @code{sh}. The @option{--norc} option may be "
  11038. "used to inhibit this behavior, and the @option{--rcfile} option may be used "
  11039. "to force another file to be read, but neither @code{rshd} nor @code{sshd} "
  11040. "generally invoke the shell with those options or allow them to be specified."
  11041. msgstr ""
  11042. #. type: subsubheading
  11043. #: ./bashref.texi:6656
  11044. #, no-wrap
  11045. msgid "Invoked with unequal effective and real @sc{uid/gid}s"
  11046. msgstr ""
  11047. #. type: Plain text
  11048. #: ./bashref.texi:6666
  11049. msgid ""
  11050. "If Bash is started with the effective user (group) id not equal to the real "
  11051. "user (group) id, and the @option{-p} option is not supplied, no startup "
  11052. "files are read, shell functions are not inherited from the environment, the "
  11053. "@env{SHELLOPTS}, @env{BASHOPTS}, @env{CDPATH}, and @env{GLOBIGNORE} "
  11054. "variables, if they appear in the environment, are ignored, and the effective "
  11055. "user id is set to the real user id. If the @option{-p} option is supplied "
  11056. "at invocation, the startup behavior is the same, but the effective user id "
  11057. "is not reset."
  11058. msgstr ""
  11059. #. type: cindex
  11060. #: ./bashref.texi:6670
  11061. #, no-wrap
  11062. msgid "shell, interactive"
  11063. msgstr ""
  11064. #. type: subsection
  11065. #: ./bashref.texi:6676 ./bashref.texi:6678 ./bashref.texi:6679
  11066. #, no-wrap
  11067. msgid "What is an Interactive Shell?"
  11068. msgstr ""
  11069. #. type: menuentry
  11070. #: ./bashref.texi:6676
  11071. msgid "What determines whether a shell is Interactive."
  11072. msgstr ""
  11073. #. type: subsection
  11074. #: ./bashref.texi:6676 ./bashref.texi:6694 ./bashref.texi:6695
  11075. #, no-wrap
  11076. msgid "Is this Shell Interactive?"
  11077. msgstr ""
  11078. #. type: menuentry
  11079. #: ./bashref.texi:6676
  11080. msgid "How to tell if a shell is interactive."
  11081. msgstr ""
  11082. #. type: subsection
  11083. #: ./bashref.texi:6676 ./bashref.texi:6721 ./bashref.texi:6722
  11084. #, no-wrap
  11085. msgid "Interactive Shell Behavior"
  11086. msgstr ""
  11087. #. type: menuentry
  11088. #: ./bashref.texi:6676
  11089. msgid "What changes in a interactive shell?"
  11090. msgstr ""
  11091. #. type: Plain text
  11092. #: ./bashref.texi:6687
  11093. msgid ""
  11094. "An interactive shell is one started without non-option arguments, unless "
  11095. "@option{-s} is specified, without specifying the @option{-c} option, and "
  11096. "whose input and error output are both connected to terminals (as determined "
  11097. "by @code{isatty(3)}), or one started with the @option{-i} option."
  11098. msgstr ""
  11099. #. type: Plain text
  11100. #: ./bashref.texi:6690
  11101. msgid "An interactive shell generally reads from and writes to a user's terminal."
  11102. msgstr ""
  11103. #. type: Plain text
  11104. #: ./bashref.texi:6693
  11105. msgid ""
  11106. "The @option{-s} invocation option may be used to set the positional "
  11107. "parameters when an interactive shell is started."
  11108. msgstr ""
  11109. #. type: Plain text
  11110. #: ./bashref.texi:6701
  11111. msgid ""
  11112. "To determine within a startup script whether or not Bash is running "
  11113. "interactively, test the value of the @samp{-} special parameter. It "
  11114. "contains @code{i} when the shell is interactive. For example:"
  11115. msgstr ""
  11116. #. type: example
  11117. #: ./bashref.texi:6707
  11118. #, no-wrap
  11119. msgid ""
  11120. "case \"$-\" in\n"
  11121. "*i*)\techo This shell is interactive ;;\n"
  11122. "*)\techo This shell is not interactive ;;\n"
  11123. "esac\n"
  11124. msgstr ""
  11125. #. type: Plain text
  11126. #: ./bashref.texi:6712
  11127. msgid ""
  11128. "Alternatively, startup scripts may examine the variable @env{PS1}; it is "
  11129. "unset in non-interactive shells, and set in interactive shells. Thus:"
  11130. msgstr ""
  11131. #. type: example
  11132. #: ./bashref.texi:6719
  11133. #, no-wrap
  11134. msgid ""
  11135. "if [ -z \"$PS1\" ]; then\n"
  11136. " echo This shell is not interactive\n"
  11137. "else\n"
  11138. " echo This shell is interactive\n"
  11139. "fi\n"
  11140. msgstr ""
  11141. #. type: Plain text
  11142. #: ./bashref.texi:6726
  11143. msgid ""
  11144. "When the shell is running interactively, it changes its behavior in several "
  11145. "ways."
  11146. msgstr ""
  11147. #. type: enumerate
  11148. #: ./bashref.texi:6730
  11149. msgid ""
  11150. "Startup files are read and executed as described in @ref{Bash Startup "
  11151. "Files}."
  11152. msgstr ""
  11153. #. type: enumerate
  11154. #: ./bashref.texi:6735
  11155. msgid ""
  11156. "Job Control (@pxref{Job Control}) is enabled by default. When job control "
  11157. "is in effect, Bash ignores the keyboard-generated job control signals "
  11158. "@code{SIGTTIN}, @code{SIGTTOU}, and @code{SIGTSTP}."
  11159. msgstr ""
  11160. #. type: enumerate
  11161. #: ./bashref.texi:6744
  11162. msgid ""
  11163. "Bash expands and displays @env{PS1} before reading the first line of a "
  11164. "command, and expands and displays @env{PS2} before reading the second and "
  11165. "subsequent lines of a multi-line command. Bash expands and displays "
  11166. "@env{PS0} after it reads a command but before executing it. See "
  11167. "@ref{Controlling the Prompt}, for a complete list of prompt string escape "
  11168. "sequences."
  11169. msgstr ""
  11170. #. type: enumerate
  11171. #: ./bashref.texi:6749
  11172. msgid ""
  11173. "Bash executes the value of the @env{PROMPT_COMMAND} variable as a command "
  11174. "before printing the primary prompt, @env{$PS1} (@pxref{Bash Variables})."
  11175. msgstr ""
  11176. #. type: enumerate
  11177. #: ./bashref.texi:6753
  11178. msgid ""
  11179. "Readline (@pxref{Command Line Editing}) is used to read commands from the "
  11180. "user's terminal."
  11181. msgstr ""
  11182. #. type: enumerate
  11183. #: ./bashref.texi:6758
  11184. msgid ""
  11185. "Bash inspects the value of the @code{ignoreeof} option to @code{set -o} "
  11186. "instead of exiting immediately when it receives an @code{EOF} on its "
  11187. "standard input when reading a command (@pxref{The Set Builtin})."
  11188. msgstr ""
  11189. #. type: enumerate
  11190. #: ./bashref.texi:6765
  11191. msgid ""
  11192. "Command history (@pxref{Bash History Facilities}) and history expansion "
  11193. "(@pxref{History Interaction}) are enabled by default. Bash will save the "
  11194. "command history to the file named by @env{$HISTFILE} when a shell with "
  11195. "history enabled exits."
  11196. msgstr ""
  11197. #. type: enumerate
  11198. #: ./bashref.texi:6768
  11199. msgid "Alias expansion (@pxref{Aliases}) is performed by default."
  11200. msgstr ""
  11201. #. type: enumerate
  11202. #: ./bashref.texi:6772
  11203. msgid "In the absence of any traps, Bash ignores @code{SIGTERM} (@pxref{Signals})."
  11204. msgstr ""
  11205. #. type: enumerate
  11206. #: ./bashref.texi:6777
  11207. msgid ""
  11208. "In the absence of any traps, @code{SIGINT} is caught and handled "
  11209. "(@pxref{Signals}). @code{SIGINT} will interrupt some shell builtins."
  11210. msgstr ""
  11211. #. type: enumerate
  11212. #: ./bashref.texi:6781
  11213. msgid ""
  11214. "An interactive login shell sends a @code{SIGHUP} to all jobs on exit if the "
  11215. "@code{huponexit} shell option has been enabled (@pxref{Signals})."
  11216. msgstr ""
  11217. #. type: enumerate
  11218. #: ./bashref.texi:6785
  11219. msgid ""
  11220. "The @option{-n} invocation option is ignored, and @samp{set -n} has no "
  11221. "effect (@pxref{The Set Builtin})."
  11222. msgstr ""
  11223. #. type: enumerate
  11224. #: ./bashref.texi:6790
  11225. msgid ""
  11226. "Bash will check for mail periodically, depending on the values of the "
  11227. "@env{MAIL}, @env{MAILPATH}, and @env{MAILCHECK} shell variables (@pxref{Bash "
  11228. "Variables})."
  11229. msgstr ""
  11230. #. type: enumerate
  11231. #: ./bashref.texi:6795
  11232. msgid ""
  11233. "Expansion errors due to references to unbound shell variables after "
  11234. "@samp{set -u} has been enabled will not cause the shell to exit (@pxref{The "
  11235. "Set Builtin})."
  11236. msgstr ""
  11237. #. type: enumerate
  11238. #: ./bashref.texi:6800
  11239. msgid ""
  11240. "The shell will not exit on expansion errors caused by @var{var} being unset "
  11241. "or null in @code{$@{@var{var}:?@var{word}@}} expansions (@pxref{Shell "
  11242. "Parameter Expansion})."
  11243. msgstr ""
  11244. #. type: enumerate
  11245. #: ./bashref.texi:6804
  11246. msgid ""
  11247. "Redirection errors encountered by shell builtins will not cause the shell to "
  11248. "exit."
  11249. msgstr ""
  11250. #. type: enumerate
  11251. #: ./bashref.texi:6808
  11252. msgid ""
  11253. "When running in @sc{posix} mode, a special builtin returning an error status "
  11254. "will not cause the shell to exit (@pxref{Bash POSIX Mode})."
  11255. msgstr ""
  11256. #. type: enumerate
  11257. #: ./bashref.texi:6812
  11258. msgid ""
  11259. "A failed @code{exec} will not cause the shell to exit (@pxref{Bourne Shell "
  11260. "Builtins})."
  11261. msgstr ""
  11262. #. type: enumerate
  11263. #: ./bashref.texi:6815
  11264. msgid "Parser syntax errors will not cause the shell to exit."
  11265. msgstr ""
  11266. #. type: enumerate
  11267. #: ./bashref.texi:6820
  11268. msgid ""
  11269. "Simple spelling correction for directory arguments to the @code{cd} builtin "
  11270. "is enabled by default (see the description of the @code{cdspell} option to "
  11271. "the @code{shopt} builtin in @ref{The Shopt Builtin})."
  11272. msgstr ""
  11273. #. type: enumerate
  11274. #: ./bashref.texi:6825
  11275. msgid ""
  11276. "The shell will check the value of the @env{TMOUT} variable and exit if a "
  11277. "command is not read within the specified number of seconds after printing "
  11278. "@env{$PS1} (@pxref{Bash Variables})."
  11279. msgstr ""
  11280. #. type: cindex
  11281. #: ./bashref.texi:6830
  11282. #, no-wrap
  11283. msgid "expressions, conditional"
  11284. msgstr ""
  11285. #. type: Plain text
  11286. #: ./bashref.texi:6837
  11287. msgid ""
  11288. "Conditional expressions are used by the @code{[[} compound command and the "
  11289. "@code{test} and @code{[} builtin commands. The @code{test} and @code{[} "
  11290. "commands determine their behavior based on the number of arguments; see the "
  11291. "descriptions of those commands for any other command-specific actions."
  11292. msgstr ""
  11293. #. type: Plain text
  11294. #: ./bashref.texi:6852
  11295. msgid ""
  11296. "Expressions may be unary or binary, and are formed from the following "
  11297. "primaries. Unary expressions are often used to examine the status of a "
  11298. "file. There are string operators and numeric comparison operators as well. "
  11299. "Bash handles several filenames specially when they are used in expressions. "
  11300. "If the operating system on which Bash is running provides these special "
  11301. "files, Bash will use them; otherwise it will emulate them internally with "
  11302. "this behavior: If the @var{file} argument to one of the primaries is of the "
  11303. "form @file{/dev/fd/@var{N}}, then file descriptor @var{N} is checked. If "
  11304. "the @var{file} argument to one of the primaries is one of @file{/dev/stdin}, "
  11305. "@file{/dev/stdout}, or @file{/dev/stderr}, file descriptor 0, 1, or 2, "
  11306. "respectively, is checked."
  11307. msgstr ""
  11308. #. type: Plain text
  11309. #: ./bashref.texi:6856
  11310. msgid ""
  11311. "When used with @code{[[}, the @samp{<} and @samp{>} operators sort "
  11312. "lexicographically using the current locale. The @code{test} command uses "
  11313. "ASCII ordering."
  11314. msgstr ""
  11315. #. type: Plain text
  11316. #: ./bashref.texi:6859
  11317. msgid ""
  11318. "Unless otherwise specified, primaries that operate on files follow symbolic "
  11319. "links and operate on the target of the link, rather than the link itself."
  11320. msgstr ""
  11321. #. type: item
  11322. #: ./bashref.texi:6861
  11323. #, no-wrap
  11324. msgid "-a @var{file}"
  11325. msgstr ""
  11326. #. type: table
  11327. #: ./bashref.texi:6863 ./bashref.texi:6875
  11328. msgid "True if @var{file} exists."
  11329. msgstr ""
  11330. #. type: item
  11331. #: ./bashref.texi:6864
  11332. #, no-wrap
  11333. msgid "-b @var{file}"
  11334. msgstr ""
  11335. #. type: table
  11336. #: ./bashref.texi:6866
  11337. msgid "True if @var{file} exists and is a block special file."
  11338. msgstr ""
  11339. #. type: item
  11340. #: ./bashref.texi:6867
  11341. #, no-wrap
  11342. msgid "-c @var{file}"
  11343. msgstr ""
  11344. #. type: table
  11345. #: ./bashref.texi:6869
  11346. msgid "True if @var{file} exists and is a character special file."
  11347. msgstr ""
  11348. #. type: item
  11349. #: ./bashref.texi:6870
  11350. #, no-wrap
  11351. msgid "-d @var{file}"
  11352. msgstr ""
  11353. #. type: table
  11354. #: ./bashref.texi:6872
  11355. msgid "True if @var{file} exists and is a directory."
  11356. msgstr ""
  11357. #. type: item
  11358. #: ./bashref.texi:6873
  11359. #, no-wrap
  11360. msgid "-e @var{file}"
  11361. msgstr ""
  11362. #. type: item
  11363. #: ./bashref.texi:6876
  11364. #, no-wrap
  11365. msgid "-f @var{file}"
  11366. msgstr ""
  11367. #. type: table
  11368. #: ./bashref.texi:6878
  11369. msgid "True if @var{file} exists and is a regular file."
  11370. msgstr ""
  11371. #. type: item
  11372. #: ./bashref.texi:6879
  11373. #, no-wrap
  11374. msgid "-g @var{file}"
  11375. msgstr ""
  11376. #. type: table
  11377. #: ./bashref.texi:6881
  11378. msgid "True if @var{file} exists and its set-group-id bit is set."
  11379. msgstr ""
  11380. #. type: item
  11381. #: ./bashref.texi:6882
  11382. #, no-wrap
  11383. msgid "-h @var{file}"
  11384. msgstr ""
  11385. #. type: table
  11386. #: ./bashref.texi:6884 ./bashref.texi:6914
  11387. msgid "True if @var{file} exists and is a symbolic link."
  11388. msgstr ""
  11389. #. type: item
  11390. #: ./bashref.texi:6885
  11391. #, no-wrap
  11392. msgid "-k @var{file}"
  11393. msgstr ""
  11394. #. type: table
  11395. #: ./bashref.texi:6887
  11396. msgid "True if @var{file} exists and its \"sticky\" bit is set."
  11397. msgstr ""
  11398. #. type: item
  11399. #: ./bashref.texi:6888
  11400. #, no-wrap
  11401. msgid "-p @var{file}"
  11402. msgstr ""
  11403. #. type: table
  11404. #: ./bashref.texi:6890
  11405. msgid "True if @var{file} exists and is a named pipe (FIFO)."
  11406. msgstr ""
  11407. #. type: item
  11408. #: ./bashref.texi:6891
  11409. #, no-wrap
  11410. msgid "-r @var{file}"
  11411. msgstr ""
  11412. #. type: table
  11413. #: ./bashref.texi:6893
  11414. msgid "True if @var{file} exists and is readable."
  11415. msgstr ""
  11416. #. type: item
  11417. #: ./bashref.texi:6894
  11418. #, no-wrap
  11419. msgid "-s @var{file}"
  11420. msgstr ""
  11421. #. type: table
  11422. #: ./bashref.texi:6896
  11423. msgid "True if @var{file} exists and has a size greater than zero."
  11424. msgstr ""
  11425. #. type: item
  11426. #: ./bashref.texi:6897
  11427. #, no-wrap
  11428. msgid "-t @var{fd}"
  11429. msgstr ""
  11430. #. type: table
  11431. #: ./bashref.texi:6899
  11432. msgid "True if file descriptor @var{fd} is open and refers to a terminal."
  11433. msgstr ""
  11434. #. type: item
  11435. #: ./bashref.texi:6900
  11436. #, no-wrap
  11437. msgid "-u @var{file}"
  11438. msgstr ""
  11439. #. type: table
  11440. #: ./bashref.texi:6902
  11441. msgid "True if @var{file} exists and its set-user-id bit is set."
  11442. msgstr ""
  11443. #. type: item
  11444. #: ./bashref.texi:6903
  11445. #, no-wrap
  11446. msgid "-w @var{file}"
  11447. msgstr ""
  11448. #. type: table
  11449. #: ./bashref.texi:6905
  11450. msgid "True if @var{file} exists and is writable."
  11451. msgstr ""
  11452. #. type: item
  11453. #: ./bashref.texi:6906
  11454. #, no-wrap
  11455. msgid "-x @var{file}"
  11456. msgstr ""
  11457. #. type: table
  11458. #: ./bashref.texi:6908
  11459. msgid "True if @var{file} exists and is executable."
  11460. msgstr ""
  11461. #. type: item
  11462. #: ./bashref.texi:6909
  11463. #, no-wrap
  11464. msgid "-G @var{file}"
  11465. msgstr ""
  11466. #. type: table
  11467. #: ./bashref.texi:6911
  11468. msgid "True if @var{file} exists and is owned by the effective group id."
  11469. msgstr ""
  11470. #. type: item
  11471. #: ./bashref.texi:6912
  11472. #, no-wrap
  11473. msgid "-L @var{file}"
  11474. msgstr ""
  11475. #. type: item
  11476. #: ./bashref.texi:6915
  11477. #, no-wrap
  11478. msgid "-N @var{file}"
  11479. msgstr ""
  11480. #. type: table
  11481. #: ./bashref.texi:6917
  11482. msgid "True if @var{file} exists and has been modified since it was last read."
  11483. msgstr ""
  11484. #. type: item
  11485. #: ./bashref.texi:6918
  11486. #, no-wrap
  11487. msgid "-O @var{file}"
  11488. msgstr ""
  11489. #. type: table
  11490. #: ./bashref.texi:6920
  11491. msgid "True if @var{file} exists and is owned by the effective user id."
  11492. msgstr ""
  11493. #. type: item
  11494. #: ./bashref.texi:6921
  11495. #, no-wrap
  11496. msgid "-S @var{file}"
  11497. msgstr ""
  11498. #. type: table
  11499. #: ./bashref.texi:6923
  11500. msgid "True if @var{file} exists and is a socket."
  11501. msgstr ""
  11502. #. type: item
  11503. #: ./bashref.texi:6924
  11504. #, no-wrap
  11505. msgid "@var{file1} -ef @var{file2}"
  11506. msgstr ""
  11507. #. type: table
  11508. #: ./bashref.texi:6927
  11509. msgid ""
  11510. "True if @var{file1} and @var{file2} refer to the same device and inode "
  11511. "numbers."
  11512. msgstr ""
  11513. #. type: item
  11514. #: ./bashref.texi:6928
  11515. #, no-wrap
  11516. msgid "@var{file1} -nt @var{file2}"
  11517. msgstr ""
  11518. #. type: table
  11519. #: ./bashref.texi:6931
  11520. msgid ""
  11521. "True if @var{file1} is newer (according to modification date) than "
  11522. "@var{file2}, or if @var{file1} exists and @var{file2} does not."
  11523. msgstr ""
  11524. #. type: item
  11525. #: ./bashref.texi:6932
  11526. #, no-wrap
  11527. msgid "@var{file1} -ot @var{file2}"
  11528. msgstr ""
  11529. #. type: table
  11530. #: ./bashref.texi:6935
  11531. msgid ""
  11532. "True if @var{file1} is older than @var{file2}, or if @var{file2} exists and "
  11533. "@var{file1} does not."
  11534. msgstr ""
  11535. #. type: item
  11536. #: ./bashref.texi:6936
  11537. #, no-wrap
  11538. msgid "-o @var{optname}"
  11539. msgstr ""
  11540. #. type: table
  11541. #: ./bashref.texi:6940
  11542. msgid ""
  11543. "True if the shell option @var{optname} is enabled. The list of options "
  11544. "appears in the description of the @option{-o} option to the @code{set} "
  11545. "builtin (@pxref{The Set Builtin})."
  11546. msgstr ""
  11547. #. type: item
  11548. #: ./bashref.texi:6941
  11549. #, no-wrap
  11550. msgid "-v @var{varname}"
  11551. msgstr ""
  11552. #. type: table
  11553. #: ./bashref.texi:6943
  11554. msgid "True if the shell variable @var{varname} is set (has been assigned a value)."
  11555. msgstr ""
  11556. #. type: item
  11557. #: ./bashref.texi:6944
  11558. #, no-wrap
  11559. msgid "-R @var{varname}"
  11560. msgstr ""
  11561. #. type: table
  11562. #: ./bashref.texi:6946
  11563. msgid "True if the shell variable @var{varname} is set and is a name reference."
  11564. msgstr ""
  11565. #. type: item
  11566. #: ./bashref.texi:6947
  11567. #, no-wrap
  11568. msgid "-z @var{string}"
  11569. msgstr ""
  11570. #. type: table
  11571. #: ./bashref.texi:6949
  11572. msgid "True if the length of @var{string} is zero."
  11573. msgstr ""
  11574. #. type: item
  11575. #: ./bashref.texi:6950
  11576. #, no-wrap
  11577. msgid "-n @var{string}"
  11578. msgstr ""
  11579. #. type: var{#1}
  11580. #: ./bashref.texi:6951
  11581. #, no-wrap
  11582. msgid "string"
  11583. msgstr ""
  11584. #. type: table
  11585. #: ./bashref.texi:6953
  11586. msgid "True if the length of @var{string} is non-zero."
  11587. msgstr ""
  11588. #. type: item
  11589. #: ./bashref.texi:6954
  11590. #, no-wrap
  11591. msgid "@var{string1} == @var{string2}"
  11592. msgstr ""
  11593. #. type: itemx
  11594. #: ./bashref.texi:6955
  11595. #, no-wrap
  11596. msgid "@var{string1} = @var{string2}"
  11597. msgstr ""
  11598. #. type: table
  11599. #: ./bashref.texi:6959
  11600. msgid ""
  11601. "True if the strings are equal. When used with the @code{[[} command, this "
  11602. "performs pattern matching as described above (@pxref{Conditional "
  11603. "Constructs})."
  11604. msgstr ""
  11605. #. type: table
  11606. #: ./bashref.texi:6961
  11607. msgid ""
  11608. "@samp{=} should be used with the @code{test} command for @sc{posix} "
  11609. "conformance."
  11610. msgstr ""
  11611. #. type: item
  11612. #: ./bashref.texi:6962
  11613. #, no-wrap
  11614. msgid "@var{string1} != @var{string2}"
  11615. msgstr ""
  11616. #. type: table
  11617. #: ./bashref.texi:6964
  11618. msgid "True if the strings are not equal."
  11619. msgstr ""
  11620. #. type: item
  11621. #: ./bashref.texi:6965
  11622. #, no-wrap
  11623. msgid "@var{string1} < @var{string2}"
  11624. msgstr ""
  11625. #. type: table
  11626. #: ./bashref.texi:6967
  11627. msgid "True if @var{string1} sorts before @var{string2} lexicographically."
  11628. msgstr ""
  11629. #. type: item
  11630. #: ./bashref.texi:6968
  11631. #, no-wrap
  11632. msgid "@var{string1} > @var{string2}"
  11633. msgstr ""
  11634. #. type: table
  11635. #: ./bashref.texi:6970
  11636. msgid "True if @var{string1} sorts after @var{string2} lexicographically."
  11637. msgstr ""
  11638. #. type: item
  11639. #: ./bashref.texi:6971
  11640. #, no-wrap
  11641. msgid "@var{arg1} OP @var{arg2}"
  11642. msgstr ""
  11643. #. type: table
  11644. #: ./bashref.texi:6981
  11645. msgid ""
  11646. "@code{OP} is one of @samp{-eq}, @samp{-ne}, @samp{-lt}, @samp{-le}, "
  11647. "@samp{-gt}, or @samp{-ge}. These arithmetic binary operators return true if "
  11648. "@var{arg1} is equal to, not equal to, less than, less than or equal to, "
  11649. "greater than, or greater than or equal to @var{arg2}, respectively. "
  11650. "@var{Arg1} and @var{arg2} may be positive or negative integers. When used "
  11651. "with the @code{[[} command, @var{Arg1} and @var{Arg2} are evaluated as "
  11652. "arithmetic expressions (@pxref{Shell Arithmetic})."
  11653. msgstr ""
  11654. #. type: cindex
  11655. #: ./bashref.texi:6985
  11656. #, no-wrap
  11657. msgid "arithmetic, shell"
  11658. msgstr ""
  11659. #. type: cindex
  11660. #: ./bashref.texi:6986
  11661. #, no-wrap
  11662. msgid "shell arithmetic"
  11663. msgstr ""
  11664. #. type: cindex
  11665. #: ./bashref.texi:6987
  11666. #, no-wrap
  11667. msgid "expressions, arithmetic"
  11668. msgstr ""
  11669. #. type: cindex
  11670. #: ./bashref.texi:6988
  11671. #, no-wrap
  11672. msgid "evaluation, arithmetic"
  11673. msgstr ""
  11674. #. type: cindex
  11675. #: ./bashref.texi:6989
  11676. #, no-wrap
  11677. msgid "arithmetic evaluation"
  11678. msgstr ""
  11679. #. type: Plain text
  11680. #: ./bashref.texi:6994
  11681. msgid ""
  11682. "The shell allows arithmetic expressions to be evaluated, as one of the shell "
  11683. "expansions or by using the @code{((} compound command, the @code{let} "
  11684. "builtin, or the @option{-i} option to the @code{declare} builtin."
  11685. msgstr ""
  11686. #. type: Plain text
  11687. #: ./bashref.texi:7002
  11688. msgid ""
  11689. "Evaluation is done in fixed-width integers with no check for overflow, "
  11690. "though division by 0 is trapped and flagged as an error. The operators and "
  11691. "their precedence, associativity, and values are the same as in the C "
  11692. "language. The following list of operators is grouped into levels of "
  11693. "equal-precedence operators. The levels are listed in order of decreasing "
  11694. "precedence."
  11695. msgstr ""
  11696. #. type: item
  11697. #: ./bashref.texi:7005
  11698. #, no-wrap
  11699. msgid "@var{id}++ @var{id}--"
  11700. msgstr ""
  11701. #. type: table
  11702. #: ./bashref.texi:7007
  11703. msgid "variable post-increment and post-decrement"
  11704. msgstr ""
  11705. #. type: item
  11706. #: ./bashref.texi:7008
  11707. #, no-wrap
  11708. msgid "++@var{id} --@var{id}"
  11709. msgstr ""
  11710. #. type: table
  11711. #: ./bashref.texi:7010
  11712. msgid "variable pre-increment and pre-decrement"
  11713. msgstr ""
  11714. #. type: item
  11715. #: ./bashref.texi:7011
  11716. #, no-wrap
  11717. msgid "- +"
  11718. msgstr ""
  11719. #. type: table
  11720. #: ./bashref.texi:7013
  11721. msgid "unary minus and plus"
  11722. msgstr ""
  11723. #. type: item
  11724. #: ./bashref.texi:7014
  11725. #, no-wrap
  11726. msgid "! ~"
  11727. msgstr ""
  11728. #. type: table
  11729. #: ./bashref.texi:7016
  11730. msgid "logical and bitwise negation"
  11731. msgstr ""
  11732. #. type: item
  11733. #: ./bashref.texi:7017
  11734. #, no-wrap
  11735. msgid "**"
  11736. msgstr ""
  11737. #. type: table
  11738. #: ./bashref.texi:7019
  11739. msgid "exponentiation"
  11740. msgstr ""
  11741. #. type: item
  11742. #: ./bashref.texi:7020
  11743. #, no-wrap
  11744. msgid "* / %"
  11745. msgstr ""
  11746. #. type: table
  11747. #: ./bashref.texi:7022
  11748. msgid "multiplication, division, remainder"
  11749. msgstr ""
  11750. #. type: item
  11751. #: ./bashref.texi:7023
  11752. #, no-wrap
  11753. msgid "+ -"
  11754. msgstr ""
  11755. #. type: table
  11756. #: ./bashref.texi:7025
  11757. msgid "addition, subtraction"
  11758. msgstr ""
  11759. #. type: item
  11760. #: ./bashref.texi:7026
  11761. #, no-wrap
  11762. msgid "<< >>"
  11763. msgstr ""
  11764. #. type: table
  11765. #: ./bashref.texi:7028
  11766. msgid "left and right bitwise shifts"
  11767. msgstr ""
  11768. #. type: item
  11769. #: ./bashref.texi:7029
  11770. #, no-wrap
  11771. msgid "<= >= < >"
  11772. msgstr ""
  11773. #. type: table
  11774. #: ./bashref.texi:7031
  11775. msgid "comparison"
  11776. msgstr ""
  11777. #. type: item
  11778. #: ./bashref.texi:7032
  11779. #, no-wrap
  11780. msgid "== !="
  11781. msgstr ""
  11782. #. type: table
  11783. #: ./bashref.texi:7034
  11784. msgid "equality and inequality"
  11785. msgstr ""
  11786. #. type: item
  11787. #: ./bashref.texi:7035
  11788. #, no-wrap
  11789. msgid "&"
  11790. msgstr ""
  11791. #. type: table
  11792. #: ./bashref.texi:7037
  11793. msgid "bitwise AND"
  11794. msgstr ""
  11795. #. type: item
  11796. #: ./bashref.texi:7038
  11797. #, no-wrap
  11798. msgid "^"
  11799. msgstr ""
  11800. #. type: table
  11801. #: ./bashref.texi:7040
  11802. msgid "bitwise exclusive OR"
  11803. msgstr ""
  11804. #. type: item
  11805. #: ./bashref.texi:7041
  11806. #, no-wrap
  11807. msgid "|"
  11808. msgstr ""
  11809. #. type: table
  11810. #: ./bashref.texi:7043
  11811. msgid "bitwise OR"
  11812. msgstr ""
  11813. #. type: item
  11814. #: ./bashref.texi:7044
  11815. #, no-wrap
  11816. msgid "&&"
  11817. msgstr ""
  11818. #. type: table
  11819. #: ./bashref.texi:7046
  11820. msgid "logical AND"
  11821. msgstr ""
  11822. #. type: item
  11823. #: ./bashref.texi:7047
  11824. #, no-wrap
  11825. msgid "||"
  11826. msgstr ""
  11827. #. type: table
  11828. #: ./bashref.texi:7049
  11829. msgid "logical OR"
  11830. msgstr ""
  11831. #. type: item
  11832. #: ./bashref.texi:7050
  11833. #, no-wrap
  11834. msgid "expr ? expr : expr"
  11835. msgstr ""
  11836. #. type: table
  11837. #: ./bashref.texi:7052
  11838. msgid "conditional operator"
  11839. msgstr ""
  11840. #. type: item
  11841. #: ./bashref.texi:7053
  11842. #, no-wrap
  11843. msgid "= *= /= %= += -= <<= >>= &= ^= |="
  11844. msgstr ""
  11845. #. type: table
  11846. #: ./bashref.texi:7055
  11847. msgid "assignment"
  11848. msgstr ""
  11849. #. type: item
  11850. #: ./bashref.texi:7056
  11851. #, no-wrap
  11852. msgid "expr1 , expr2"
  11853. msgstr ""
  11854. #. type: table
  11855. #: ./bashref.texi:7058
  11856. msgid "comma"
  11857. msgstr ""
  11858. #. type: Plain text
  11859. #: ./bashref.texi:7072
  11860. msgid ""
  11861. "Shell variables are allowed as operands; parameter expansion is performed "
  11862. "before the expression is evaluated. Within an expression, shell variables "
  11863. "may also be referenced by name without using the parameter expansion "
  11864. "syntax. A shell variable that is null or unset evaluates to 0 when "
  11865. "referenced by name without using the parameter expansion syntax. The value "
  11866. "of a variable is evaluated as an arithmetic expression when it is "
  11867. "referenced, or when a variable which has been given the @var{integer} "
  11868. "attribute using @samp{declare -i} is assigned a value. A null value "
  11869. "evaluates to 0. A shell variable need not have its @var{integer} attribute "
  11870. "turned on to be used in an expression."
  11871. msgstr ""
  11872. #. type: Plain text
  11873. #: ./bashref.texi:7085
  11874. msgid ""
  11875. "Constants with a leading 0 are interpreted as octal numbers. A leading "
  11876. "@samp{0x} or @samp{0X} denotes hexadecimal. Otherwise, numbers take the "
  11877. "form [@var{base}@code{#}]@var{n}, where the optional @var{base} is a decimal "
  11878. "number between 2 and 64 representing the arithmetic base, and @var{n} is a "
  11879. "number in that base. If @var{base}@code{#} is omitted, then base 10 is "
  11880. "used. When specifying @var{n}, the digits greater than 9 are represented by "
  11881. "the lowercase letters, the uppercase letters, @samp{@@}, and @samp{_}, in "
  11882. "that order. If @var{base} is less than or equal to 36, lowercase and "
  11883. "uppercase letters may be used interchangeably to represent numbers between "
  11884. "10 and 35."
  11885. msgstr ""
  11886. #. type: Plain text
  11887. #: ./bashref.texi:7089
  11888. msgid ""
  11889. "Operators are evaluated in order of precedence. Sub-expressions in "
  11890. "parentheses are evaluated first and may override the precedence rules above."
  11891. msgstr ""
  11892. #. type: cindex
  11893. #: ./bashref.texi:7092
  11894. #, no-wrap
  11895. msgid "alias expansion"
  11896. msgstr ""
  11897. #. type: Plain text
  11898. #: ./bashref.texi:7098
  11899. msgid ""
  11900. "@var{Aliases} allow a string to be substituted for a word when it is used as "
  11901. "the first word of a simple command. The shell maintains a list of aliases "
  11902. "that may be set and unset with the @code{alias} and @code{unalias} builtin "
  11903. "commands."
  11904. msgstr ""
  11905. #. type: Plain text
  11906. #: ./bashref.texi:7116
  11907. msgid ""
  11908. "The first word of each simple command, if unquoted, is checked to see if it "
  11909. "has an alias. If so, that word is replaced by the text of the alias. The "
  11910. "characters @samp{/}, @samp{$}, @samp{`}, @samp{=} and any of the shell "
  11911. "metacharacters or quoting characters listed above may not appear in an alias "
  11912. "name. The replacement text may contain any valid shell input, including "
  11913. "shell metacharacters. The first word of the replacement text is tested for "
  11914. "aliases, but a word that is identical to an alias being expanded is not "
  11915. "expanded a second time. This means that one may alias @code{ls} to "
  11916. "@code{\"ls -F\"}, for instance, and Bash does not try to recursively expand "
  11917. "the replacement text. If the last character of the alias value is a "
  11918. "@var{blank}, then the next command word following the alias is also checked "
  11919. "for alias expansion."
  11920. msgstr ""
  11921. #. type: Plain text
  11922. #: ./bashref.texi:7119
  11923. msgid ""
  11924. "Aliases are created and listed with the @code{alias} command, and removed "
  11925. "with the @code{unalias} command."
  11926. msgstr ""
  11927. #. type: Plain text
  11928. #: ./bashref.texi:7124
  11929. msgid ""
  11930. "There is no mechanism for using arguments in the replacement text, as in "
  11931. "@code{csh}. If arguments are needed, a shell function should be used "
  11932. "(@pxref{Shell Functions})."
  11933. msgstr ""
  11934. #. type: Plain text
  11935. #: ./bashref.texi:7128
  11936. msgid ""
  11937. "Aliases are not expanded when the shell is not interactive, unless the "
  11938. "@code{expand_aliases} shell option is set using @code{shopt} (@pxref{The "
  11939. "Shopt Builtin})."
  11940. msgstr ""
  11941. #. type: Plain text
  11942. #: ./bashref.texi:7148
  11943. msgid ""
  11944. "The rules concerning the definition and use of aliases are somewhat "
  11945. "confusing. Bash always reads at least one complete line of input, and all "
  11946. "lines that make up a compound command, before executing any of the commands "
  11947. "on that line or the compound command. Aliases are expanded when a command "
  11948. "is read, not when it is executed. Therefore, an alias definition appearing "
  11949. "on the same line as another command does not take effect until the next line "
  11950. "of input is read. The commands following the alias definition on that line "
  11951. "are not affected by the new alias. This behavior is also an issue when "
  11952. "functions are executed. Aliases are expanded when a function definition is "
  11953. "read, not when the function is executed, because a function definition is "
  11954. "itself a command. As a consequence, aliases defined in a function are not "
  11955. "available until after that function is executed. To be safe, always put "
  11956. "alias definitions on a separate line, and do not use @code{alias} in "
  11957. "compound commands."
  11958. msgstr ""
  11959. #. type: Plain text
  11960. #: ./bashref.texi:7150
  11961. msgid "For almost every purpose, shell functions are preferred over aliases."
  11962. msgstr ""
  11963. #. type: cindex
  11964. #: ./bashref.texi:7153
  11965. #, no-wrap
  11966. msgid "arrays"
  11967. msgstr ""
  11968. #. type: Plain text
  11969. #: ./bashref.texi:7165
  11970. msgid ""
  11971. "Bash provides one-dimensional indexed and associative array variables. Any "
  11972. "variable may be used as an indexed array; the @code{declare} builtin will "
  11973. "explicitly declare an array. There is no maximum limit on the size of an "
  11974. "array, nor any requirement that members be indexed or assigned "
  11975. "contiguously. Indexed arrays are referenced using integers (including "
  11976. "arithmetic expressions (@pxref{Shell Arithmetic})) and are zero-based; "
  11977. "associative arrays use arbitrary strings. Unless otherwise noted, indexed "
  11978. "array indices must be non-negative integers."
  11979. msgstr ""
  11980. #. type: Plain text
  11981. #: ./bashref.texi:7168
  11982. msgid ""
  11983. "An indexed array is created automatically if any variable is assigned to "
  11984. "using the syntax"
  11985. msgstr ""
  11986. #. type: example
  11987. #: ./bashref.texi:7170
  11988. #, no-wrap
  11989. msgid "@var{name}[@var{subscript}]=@var{value}\n"
  11990. msgstr ""
  11991. #. type: Plain text
  11992. #: ./bashref.texi:7176
  11993. msgid ""
  11994. "The @var{subscript} is treated as an arithmetic expression that must "
  11995. "evaluate to a number. To explicitly declare an array, use"
  11996. msgstr ""
  11997. #. type: example
  11998. #: ./bashref.texi:7178
  11999. #, no-wrap
  12000. msgid "declare -a @var{name}\n"
  12001. msgstr ""
  12002. #. type: Plain text
  12003. #: ./bashref.texi:7181
  12004. msgid "The syntax"
  12005. msgstr ""
  12006. #. type: example
  12007. #: ./bashref.texi:7183
  12008. #, no-wrap
  12009. msgid "declare -a @var{name}[@var{subscript}]\n"
  12010. msgstr ""
  12011. #. type: Plain text
  12012. #: ./bashref.texi:7186
  12013. msgid "is also accepted; the @var{subscript} is ignored."
  12014. msgstr ""
  12015. #. type: Plain text
  12016. #: ./bashref.texi:7189
  12017. msgid "Associative arrays are created using"
  12018. msgstr ""
  12019. #. type: example
  12020. #: ./bashref.texi:7191
  12021. #, no-wrap
  12022. msgid "declare -A @var{name}.\n"
  12023. msgstr ""
  12024. #. type: Plain text
  12025. #: ./bashref.texi:7197
  12026. msgid ""
  12027. "Attributes may be specified for an array variable using the @code{declare} "
  12028. "and @code{readonly} builtins. Each attribute applies to all members of an "
  12029. "array."
  12030. msgstr ""
  12031. #. type: Plain text
  12032. #: ./bashref.texi:7199
  12033. msgid "Arrays are assigned to using compound assignments of the form"
  12034. msgstr ""
  12035. #. type: example
  12036. #: ./bashref.texi:7201
  12037. #, no-wrap
  12038. msgid "@var{name}=(@var{value1} @var{value2} @dots{} )\n"
  12039. msgstr ""
  12040. #. type: Plain text
  12041. #: ./bashref.texi:7210
  12042. msgid ""
  12043. "where each @var{value} is of the form "
  12044. "@code{[@var{subscript}]=}@var{string}. Indexed array assignments do not "
  12045. "require anything but @var{string}. When assigning to indexed arrays, if the "
  12046. "optional subscript is supplied, that index is assigned to; otherwise the "
  12047. "index of the element assigned is the last index assigned to by the statement "
  12048. "plus one. Indexing starts at zero."
  12049. msgstr ""
  12050. #. type: Plain text
  12051. #: ./bashref.texi:7212
  12052. msgid "When assigning to an associative array, the subscript is required."
  12053. msgstr ""
  12054. #. type: Plain text
  12055. #: ./bashref.texi:7216
  12056. msgid ""
  12057. "This syntax is also accepted by the @code{declare} builtin. Individual "
  12058. "array elements may be assigned to using the "
  12059. "@code{@var{name}[@var{subscript}]=@var{value}} syntax introduced above."
  12060. msgstr ""
  12061. #. type: Plain text
  12062. #: ./bashref.texi:7222
  12063. msgid ""
  12064. "When assigning to an indexed array, if @var{name} is subscripted by a "
  12065. "negative number, that number is interpreted as relative to one greater than "
  12066. "the maximum index of @var{name}, so negative indices count back from the end "
  12067. "of the array, and an index of -1 references the last element."
  12068. msgstr ""
  12069. #. type: Plain text
  12070. #: ./bashref.texi:7252
  12071. msgid ""
  12072. "Any element of an array may be referenced using "
  12073. "@code{$@{@var{name}[@var{subscript}]@}}. The braces are required to avoid "
  12074. "conflicts with the shell's filename expansion operators. If the "
  12075. "@var{subscript} is @samp{@@} or @samp{*}, the word expands to all members of "
  12076. "the array @var{name}. These subscripts differ only when the word appears "
  12077. "within double quotes. If the word is double-quoted, "
  12078. "@code{$@{@var{name}[*]@}} expands to a single word with the value of each "
  12079. "array member separated by the first character of the @env{IFS} variable, and "
  12080. "@code{$@{@var{name}[@@]@}} expands each element of @var{name} to a separate "
  12081. "word. When there are no array members, @code{$@{@var{name}[@@]@}} expands "
  12082. "to nothing. If the double-quoted expansion occurs within a word, the "
  12083. "expansion of the first parameter is joined with the beginning part of the "
  12084. "original word, and the expansion of the last parameter is joined with the "
  12085. "last part of the original word. This is analogous to the expansion of the "
  12086. "special parameters @samp{@@} and @samp{*}. "
  12087. "@code{$@{#@var{name}[@var{subscript}]@}} expands to the length of "
  12088. "@code{$@{@var{name}[@var{subscript}]@}}. If @var{subscript} is @samp{@@} or "
  12089. "@samp{*}, the expansion is the number of elements in the array. If the "
  12090. "@var{subscript} used to reference an element of an indexed array evaluates "
  12091. "to a number less than zero, it is interpreted as relative to one greater "
  12092. "than the maximum index of the array, so negative indices count back from the "
  12093. "end of the array, and an index of -1 refers to the last element."
  12094. msgstr ""
  12095. #. type: Plain text
  12096. #: ./bashref.texi:7257
  12097. msgid ""
  12098. "Referencing an array variable without a subscript is equivalent to "
  12099. "referencing with a subscript of 0. Any reference to a variable using a "
  12100. "valid subscript is legal, and @code{bash} will create an array if necessary."
  12101. msgstr ""
  12102. #. type: Plain text
  12103. #: ./bashref.texi:7260
  12104. msgid ""
  12105. "An array variable is considered set if a subscript has been assigned a "
  12106. "value. The null string is a valid value."
  12107. msgstr ""
  12108. #. type: Plain text
  12109. #: ./bashref.texi:7266
  12110. msgid ""
  12111. "It is possible to obtain the keys (indices) of an array as well as the "
  12112. "values. $@{!@var{name}[@@]@} and $@{!@var{name}[*]@} expand to the indices "
  12113. "assigned in array variable @var{name}. The treatment when in double quotes "
  12114. "is similar to the expansion of the special parameters @samp{@@} and @samp{*} "
  12115. "within double quotes."
  12116. msgstr ""
  12117. #. type: Plain text
  12118. #: ./bashref.texi:7275
  12119. msgid ""
  12120. "The @code{unset} builtin is used to destroy arrays. @code{unset "
  12121. "@var{name}[@var{subscript}]} destroys the array element at index "
  12122. "@var{subscript}. Negative subscripts to indexed arrays are interpreted as "
  12123. "described above. Unsetting the last element of an array variable does not "
  12124. "unset the variable. @code{unset @var{name}}, where @var{name} is an array, "
  12125. "removes the entire array. A subscript of @samp{*} or @samp{@@} also removes "
  12126. "the entire array."
  12127. msgstr ""
  12128. #. type: Plain text
  12129. #: ./bashref.texi:7280
  12130. msgid ""
  12131. "When using a variable name with a subscript as an argument to a command, "
  12132. "such as with @code{unset}, without using the word expansion syntax described "
  12133. "above, the argument is subject to the shell's filename expansion. If "
  12134. "filename expansion is not desired, the argument should be quoted."
  12135. msgstr ""
  12136. #. type: Plain text
  12137. #: ./bashref.texi:7291
  12138. msgid ""
  12139. "The @code{declare}, @code{local}, and @code{readonly} builtins each accept a "
  12140. "@option{-a} option to specify an indexed array and a @option{-A} option to "
  12141. "specify an associative array. If both options are supplied, @option{-A} "
  12142. "takes precedence. The @code{read} builtin accepts a @option{-a} option to "
  12143. "assign a list of words read from the standard input to an array, and can "
  12144. "read values from the standard input into individual array elements. The "
  12145. "@code{set} and @code{declare} builtins display array values in a way that "
  12146. "allows them to be reused as input."
  12147. msgstr ""
  12148. #. type: cindex
  12149. #: ./bashref.texi:7294
  12150. #, no-wrap
  12151. msgid "directory stack"
  12152. msgstr ""
  12153. #. type: subsection
  12154. #: ./bashref.texi:7299 ./bashref.texi:7312 ./bashref.texi:7313
  12155. #, no-wrap
  12156. msgid "Directory Stack Builtins"
  12157. msgstr ""
  12158. #. type: menuentry
  12159. #: ./bashref.texi:7299
  12160. msgid "Bash builtin commands to manipulate the directory stack."
  12161. msgstr ""
  12162. #. type: Plain text
  12163. #: ./bashref.texi:7308
  12164. msgid ""
  12165. "The directory stack is a list of recently-visited directories. The "
  12166. "@code{pushd} builtin adds directories to the stack as it changes the current "
  12167. "directory, and the @code{popd} builtin removes specified directories from "
  12168. "the stack and changes the current directory to the directory removed. The "
  12169. "@code{dirs} builtin displays the contents of the directory stack. The "
  12170. "current directory is always the \"top\" of the directory stack."
  12171. msgstr ""
  12172. #. type: Plain text
  12173. #: ./bashref.texi:7311
  12174. msgid ""
  12175. "The contents of the directory stack are also visible as the value of the "
  12176. "@env{DIRSTACK} shell variable."
  12177. msgstr ""
  12178. #. type: btindex
  12179. #: ./bashref.texi:7317 ./bashref.texi:7318
  12180. #, no-wrap
  12181. msgid "dirs"
  12182. msgstr ""
  12183. #. type: example
  12184. #: ./bashref.texi:7321
  12185. #, no-wrap
  12186. msgid "dirs [-clpv] [+@var{N} | -@var{N}]\n"
  12187. msgstr ""
  12188. #. type: table
  12189. #: ./bashref.texi:7327
  12190. msgid ""
  12191. "Display the list of currently remembered directories. Directories are added "
  12192. "to the list with the @code{pushd} command; the @code{popd} command removes "
  12193. "directories from the list. The current directory is always the first "
  12194. "directory in the stack."
  12195. msgstr ""
  12196. #. type: table
  12197. #: ./bashref.texi:7331
  12198. msgid "Clears the directory stack by deleting all of the elements."
  12199. msgstr ""
  12200. #. type: table
  12201. #: ./bashref.texi:7334
  12202. msgid ""
  12203. "Produces a listing using full pathnames; the default listing format uses a "
  12204. "tilde to denote the home directory."
  12205. msgstr ""
  12206. #. type: table
  12207. #: ./bashref.texi:7337
  12208. msgid "Causes @code{dirs} to print the directory stack with one entry per line."
  12209. msgstr ""
  12210. #. type: table
  12211. #: ./bashref.texi:7340
  12212. msgid ""
  12213. "Causes @code{dirs} to print the directory stack with one entry per line, "
  12214. "prefixing each entry with its index in the stack."
  12215. msgstr ""
  12216. #. type: item
  12217. #: ./bashref.texi:7340 ./bashref.texi:7366 ./bashref.texi:7389
  12218. #, no-wrap
  12219. msgid "+@var{N}"
  12220. msgstr ""
  12221. #. type: table
  12222. #: ./bashref.texi:7344
  12223. msgid ""
  12224. "Displays the @var{N}th directory (counting from the left of the list printed "
  12225. "by @code{dirs} when invoked without options), starting with zero."
  12226. msgstr ""
  12227. #. type: item
  12228. #: ./bashref.texi:7344 ./bashref.texi:7369 ./bashref.texi:7393
  12229. #, no-wrap
  12230. msgid "-@var{N}"
  12231. msgstr ""
  12232. #. type: table
  12233. #: ./bashref.texi:7348
  12234. msgid ""
  12235. "Displays the @var{N}th directory (counting from the right of the list "
  12236. "printed by @code{dirs} when invoked without options), starting with zero."
  12237. msgstr ""
  12238. #. type: btindex
  12239. #: ./bashref.texi:7350 ./bashref.texi:7351
  12240. #, no-wrap
  12241. msgid "popd"
  12242. msgstr ""
  12243. #. type: example
  12244. #: ./bashref.texi:7354
  12245. #, no-wrap
  12246. msgid "popd [-n] [+@var{N} | -@var{N}]\n"
  12247. msgstr ""
  12248. #. type: table
  12249. #: ./bashref.texi:7361
  12250. msgid ""
  12251. "When no arguments are given, @code{popd} removes the top directory from the "
  12252. "stack and performs a @code{cd} to the new top directory. The elements are "
  12253. "numbered from 0 starting at the first directory listed with @code{dirs}; "
  12254. "that is, @code{popd} is equivalent to @code{popd +0}."
  12255. msgstr ""
  12256. #. type: table
  12257. #: ./bashref.texi:7366
  12258. msgid ""
  12259. "Suppresses the normal change of directory when removing directories from the "
  12260. "stack, so that only the stack is manipulated."
  12261. msgstr ""
  12262. #. type: table
  12263. #: ./bashref.texi:7369
  12264. msgid ""
  12265. "Removes the @var{N}th directory (counting from the left of the list printed "
  12266. "by @code{dirs}), starting with zero."
  12267. msgstr ""
  12268. #. type: table
  12269. #: ./bashref.texi:7372
  12270. msgid ""
  12271. "Removes the @var{N}th directory (counting from the right of the list printed "
  12272. "by @code{dirs}), starting with zero."
  12273. msgstr ""
  12274. #. type: item
  12275. #: ./bashref.texi:7374 ./bashref.texi:7375
  12276. #, no-wrap
  12277. msgid "pushd"
  12278. msgstr ""
  12279. #. type: example
  12280. #: ./bashref.texi:7378
  12281. #, no-wrap
  12282. msgid "pushd [-n] [@var{+N} | @var{-N} | @var{dir}]\n"
  12283. msgstr ""
  12284. #. type: table
  12285. #: ./bashref.texi:7384
  12286. msgid ""
  12287. "Save the current directory on the top of the directory stack and then "
  12288. "@code{cd} to @var{dir}. With no arguments, @code{pushd} exchanges the top "
  12289. "two directories and makes the new top the current directory."
  12290. msgstr ""
  12291. #. type: table
  12292. #: ./bashref.texi:7389
  12293. msgid ""
  12294. "Suppresses the normal change of directory when rotating or adding "
  12295. "directories to the stack, so that only the stack is manipulated."
  12296. msgstr ""
  12297. #. type: table
  12298. #: ./bashref.texi:7393
  12299. msgid ""
  12300. "Brings the @var{N}th directory (counting from the left of the list printed "
  12301. "by @code{dirs}, starting with zero) to the top of the list by rotating the "
  12302. "stack."
  12303. msgstr ""
  12304. #. type: table
  12305. #: ./bashref.texi:7397
  12306. msgid ""
  12307. "Brings the @var{N}th directory (counting from the right of the list printed "
  12308. "by @code{dirs}, starting with zero) to the top of the list by rotating the "
  12309. "stack."
  12310. msgstr ""
  12311. #. type: var{#1}
  12312. #: ./bashref.texi:7397
  12313. #, no-wrap
  12314. msgid "dir"
  12315. msgstr ""
  12316. #. type: table
  12317. #: ./bashref.texi:7401
  12318. msgid ""
  12319. "Makes @var{dir} be the top of the stack, making it the new current directory "
  12320. "as if it had been supplied as an argument to the @code{cd} builtin."
  12321. msgstr ""
  12322. #. type: cindex
  12323. #: ./bashref.texi:7406
  12324. #, no-wrap
  12325. msgid "prompting"
  12326. msgstr ""
  12327. #. type: Plain text
  12328. #: ./bashref.texi:7412
  12329. msgid ""
  12330. "The value of the variable @env{PROMPT_COMMAND} is examined just before Bash "
  12331. "prints each primary prompt. If @env{PROMPT_COMMAND} is set and has a "
  12332. "non-null value, then the value is executed just as if it had been typed on "
  12333. "the command line."
  12334. msgstr ""
  12335. #. type: Plain text
  12336. #: ./bashref.texi:7416
  12337. msgid ""
  12338. "In addition, the following table describes the special characters which can "
  12339. "appear in the prompt variables @env{PS0}, @env{PS1}, @env{PS2}, and "
  12340. "@env{PS4}:"
  12341. msgstr ""
  12342. #. type: table
  12343. #: ./bashref.texi:7420
  12344. msgid "A bell character."
  12345. msgstr ""
  12346. #. type: item
  12347. #: ./bashref.texi:7420
  12348. #, no-wrap
  12349. msgid "\\d"
  12350. msgstr ""
  12351. #. type: table
  12352. #: ./bashref.texi:7422
  12353. msgid "The date, in \"Weekday Month Date\" format (e.g., \"Tue May 26\")."
  12354. msgstr ""
  12355. #. type: item
  12356. #: ./bashref.texi:7422
  12357. #, no-wrap
  12358. msgid "\\D@{@var{format}@}"
  12359. msgstr ""
  12360. #. type: table
  12361. #: ./bashref.texi:7426
  12362. msgid ""
  12363. "The @var{format} is passed to @code{strftime}(3) and the result is inserted "
  12364. "into the prompt string; an empty @var{format} results in a locale-specific "
  12365. "time representation. The braces are required."
  12366. msgstr ""
  12367. #. type: table
  12368. #: ./bashref.texi:7428
  12369. msgid "An escape character."
  12370. msgstr ""
  12371. #. type: item
  12372. #: ./bashref.texi:7428
  12373. #, no-wrap
  12374. msgid "\\h"
  12375. msgstr ""
  12376. #. type: table
  12377. #: ./bashref.texi:7430
  12378. msgid "The hostname, up to the first `.'."
  12379. msgstr ""
  12380. #. type: item
  12381. #: ./bashref.texi:7430
  12382. #, no-wrap
  12383. msgid "\\H"
  12384. msgstr ""
  12385. #. type: table
  12386. #: ./bashref.texi:7432
  12387. msgid "The hostname."
  12388. msgstr ""
  12389. #. type: item
  12390. #: ./bashref.texi:7432
  12391. #, no-wrap
  12392. msgid "\\j"
  12393. msgstr ""
  12394. #. type: table
  12395. #: ./bashref.texi:7434
  12396. msgid "The number of jobs currently managed by the shell."
  12397. msgstr ""
  12398. #. type: item
  12399. #: ./bashref.texi:7434
  12400. #, no-wrap
  12401. msgid "\\l"
  12402. msgstr ""
  12403. #. type: table
  12404. #: ./bashref.texi:7436
  12405. msgid "The basename of the shell's terminal device name."
  12406. msgstr ""
  12407. #. type: table
  12408. #: ./bashref.texi:7438
  12409. msgid "A newline."
  12410. msgstr ""
  12411. #. type: table
  12412. #: ./bashref.texi:7440
  12413. msgid "A carriage return."
  12414. msgstr ""
  12415. #. type: item
  12416. #: ./bashref.texi:7440
  12417. #, no-wrap
  12418. msgid "\\s"
  12419. msgstr ""
  12420. #. type: table
  12421. #: ./bashref.texi:7443
  12422. msgid ""
  12423. "The name of the shell, the basename of @code{$0} (the portion following the "
  12424. "final slash)."
  12425. msgstr ""
  12426. #. type: table
  12427. #: ./bashref.texi:7445
  12428. msgid "The time, in 24-hour HH:MM:SS format."
  12429. msgstr ""
  12430. #. type: item
  12431. #: ./bashref.texi:7445
  12432. #, no-wrap
  12433. msgid "\\T"
  12434. msgstr ""
  12435. #. type: table
  12436. #: ./bashref.texi:7447
  12437. msgid "The time, in 12-hour HH:MM:SS format."
  12438. msgstr ""
  12439. #. type: item
  12440. #: ./bashref.texi:7447
  12441. #, no-wrap
  12442. msgid "\\@@"
  12443. msgstr ""
  12444. #. type: table
  12445. #: ./bashref.texi:7449
  12446. msgid "The time, in 12-hour am/pm format."
  12447. msgstr ""
  12448. #. type: item
  12449. #: ./bashref.texi:7449
  12450. #, no-wrap
  12451. msgid "\\A"
  12452. msgstr ""
  12453. #. type: table
  12454. #: ./bashref.texi:7451
  12455. msgid "The time, in 24-hour HH:MM format."
  12456. msgstr ""
  12457. #. type: item
  12458. #: ./bashref.texi:7451
  12459. #, no-wrap
  12460. msgid "\\u"
  12461. msgstr ""
  12462. #. type: table
  12463. #: ./bashref.texi:7453
  12464. msgid "The username of the current user."
  12465. msgstr ""
  12466. #. type: table
  12467. #: ./bashref.texi:7455
  12468. msgid "The version of Bash (e.g., 2.00)"
  12469. msgstr ""
  12470. #. type: item
  12471. #: ./bashref.texi:7455
  12472. #, no-wrap
  12473. msgid "\\V"
  12474. msgstr ""
  12475. #. type: table
  12476. #: ./bashref.texi:7457
  12477. msgid "The release of Bash, version + patchlevel (e.g., 2.00.0)"
  12478. msgstr ""
  12479. #. type: item
  12480. #: ./bashref.texi:7457
  12481. #, no-wrap
  12482. msgid "\\w"
  12483. msgstr ""
  12484. #. type: table
  12485. #: ./bashref.texi:7460
  12486. msgid ""
  12487. "The current working directory, with @env{$HOME} abbreviated with a tilde "
  12488. "(uses the @env{$PROMPT_DIRTRIM} variable)."
  12489. msgstr ""
  12490. #. type: item
  12491. #: ./bashref.texi:7460
  12492. #, no-wrap
  12493. msgid "\\W"
  12494. msgstr ""
  12495. #. type: table
  12496. #: ./bashref.texi:7462
  12497. msgid "The basename of @env{$PWD}, with @env{$HOME} abbreviated with a tilde."
  12498. msgstr ""
  12499. #. type: item
  12500. #: ./bashref.texi:7462
  12501. #, no-wrap
  12502. msgid "\\!"
  12503. msgstr ""
  12504. #. type: table
  12505. #: ./bashref.texi:7464
  12506. msgid "The history number of this command."
  12507. msgstr ""
  12508. #. type: item
  12509. #: ./bashref.texi:7464
  12510. #, no-wrap
  12511. msgid "\\#"
  12512. msgstr ""
  12513. #. type: table
  12514. #: ./bashref.texi:7466
  12515. msgid "The command number of this command."
  12516. msgstr ""
  12517. #. type: item
  12518. #: ./bashref.texi:7466
  12519. #, no-wrap
  12520. msgid "\\$"
  12521. msgstr ""
  12522. #. type: table
  12523. #: ./bashref.texi:7468
  12524. msgid "If the effective uid is 0, @code{#}, otherwise @code{$}."
  12525. msgstr ""
  12526. #. type: table
  12527. #: ./bashref.texi:7470
  12528. msgid "The character whose ASCII code is the octal value @var{nnn}."
  12529. msgstr ""
  12530. #. type: table
  12531. #: ./bashref.texi:7472
  12532. msgid "A backslash."
  12533. msgstr ""
  12534. #. type: item
  12535. #: ./bashref.texi:7472
  12536. #, no-wrap
  12537. msgid "\\["
  12538. msgstr ""
  12539. #. type: table
  12540. #: ./bashref.texi:7475
  12541. msgid ""
  12542. "Begin a sequence of non-printing characters. This could be used to embed a "
  12543. "terminal control sequence into the prompt."
  12544. msgstr ""
  12545. #. type: item
  12546. #: ./bashref.texi:7475
  12547. #, no-wrap
  12548. msgid "\\]"
  12549. msgstr ""
  12550. #. type: table
  12551. #: ./bashref.texi:7477
  12552. msgid "End a sequence of non-printing characters."
  12553. msgstr ""
  12554. #. type: Plain text
  12555. #: ./bashref.texi:7485
  12556. msgid ""
  12557. "The command number and the history number are usually different: the history "
  12558. "number of a command is its position in the history list, which may include "
  12559. "commands restored from the history file (@pxref{Bash History Facilities}), "
  12560. "while the command number is the position in the sequence of commands "
  12561. "executed during the current shell session."
  12562. msgstr ""
  12563. #. type: Plain text
  12564. #: ./bashref.texi:7490
  12565. msgid ""
  12566. "After the string is decoded, it is expanded via parameter expansion, command "
  12567. "substitution, arithmetic expansion, and quote removal, subject to the value "
  12568. "of the @code{promptvars} shell option (@pxref{The Shopt Builtin})."
  12569. msgstr ""
  12570. #. type: cindex
  12571. #: ./bashref.texi:7493
  12572. #, no-wrap
  12573. msgid "restricted shell"
  12574. msgstr ""
  12575. #. type: Plain text
  12576. #: ./bashref.texi:7504
  12577. msgid ""
  12578. "If Bash is started with the name @code{rbash}, or the @option{--restricted} "
  12579. "or @option{-r} option is supplied at invocation, the shell becomes "
  12580. "restricted. A restricted shell is used to set up an environment more "
  12581. "controlled than the standard shell. A restricted shell behaves identically "
  12582. "to @code{bash} with the exception that the following are disallowed or not "
  12583. "performed:"
  12584. msgstr ""
  12585. #. type: itemize
  12586. #: ./bashref.texi:7508
  12587. msgid "Changing directories with the @code{cd} builtin."
  12588. msgstr ""
  12589. #. type: itemize
  12590. #: ./bashref.texi:7511
  12591. msgid ""
  12592. "Setting or unsetting the values of the @env{SHELL}, @env{PATH}, @env{ENV}, "
  12593. "or @env{BASH_ENV} variables."
  12594. msgstr ""
  12595. #. type: itemize
  12596. #: ./bashref.texi:7513
  12597. msgid "Specifying command names containing slashes."
  12598. msgstr ""
  12599. #. type: itemize
  12600. #: ./bashref.texi:7516
  12601. msgid ""
  12602. "Specifying a filename containing a slash as an argument to the @code{.} "
  12603. "builtin command."
  12604. msgstr ""
  12605. #. type: itemize
  12606. #: ./bashref.texi:7519
  12607. msgid ""
  12608. "Specifying a filename containing a slash as an argument to the @option{-p} "
  12609. "option to the @code{hash} builtin command."
  12610. msgstr ""
  12611. #. type: itemize
  12612. #: ./bashref.texi:7521
  12613. msgid "Importing function definitions from the shell environment at startup."
  12614. msgstr ""
  12615. #. type: itemize
  12616. #: ./bashref.texi:7523
  12617. msgid "Parsing the value of @env{SHELLOPTS} from the shell environment at startup."
  12618. msgstr ""
  12619. #. type: itemize
  12620. #: ./bashref.texi:7526
  12621. msgid ""
  12622. "Redirecting output using the @samp{>}, @samp{>|}, @samp{<>}, @samp{>&}, "
  12623. "@samp{&>}, and @samp{>>} redirection operators."
  12624. msgstr ""
  12625. #. type: itemize
  12626. #: ./bashref.texi:7528
  12627. msgid "Using the @code{exec} builtin to replace the shell with another command."
  12628. msgstr ""
  12629. #. type: itemize
  12630. #: ./bashref.texi:7531
  12631. msgid ""
  12632. "Adding or deleting builtin commands with the @option{-f} and @option{-d} "
  12633. "options to the @code{enable} builtin."
  12634. msgstr ""
  12635. #. type: itemize
  12636. #: ./bashref.texi:7533
  12637. msgid "Using the @code{enable} builtin command to enable disabled shell builtins."
  12638. msgstr ""
  12639. #. type: itemize
  12640. #: ./bashref.texi:7535
  12641. msgid "Specifying the @option{-p} option to the @code{command} builtin."
  12642. msgstr ""
  12643. #. type: itemize
  12644. #: ./bashref.texi:7537
  12645. msgid "Turning off restricted mode with @samp{set +r} or @samp{set +o restricted}."
  12646. msgstr ""
  12647. #. type: Plain text
  12648. #: ./bashref.texi:7540
  12649. msgid "These restrictions are enforced after any startup files are read."
  12650. msgstr ""
  12651. #. type: Plain text
  12652. #: ./bashref.texi:7544
  12653. msgid ""
  12654. "When a command that is found to be a shell script is executed (@pxref{Shell "
  12655. "Scripts}), @code{rbash} turns off any restrictions in the shell spawned to "
  12656. "execute the script."
  12657. msgstr ""
  12658. #. type: cindex
  12659. #: ./bashref.texi:7547
  12660. #, no-wrap
  12661. msgid "POSIX Mode"
  12662. msgstr ""
  12663. #. type: Plain text
  12664. #: ./bashref.texi:7553
  12665. msgid ""
  12666. "Starting Bash with the @option{--posix} command-line option or executing "
  12667. "@samp{set -o posix} while Bash is running will cause Bash to conform more "
  12668. "closely to the @sc{posix} standard by changing the behavior to match that "
  12669. "specified by @sc{posix} in areas where the Bash default differs."
  12670. msgstr ""
  12671. #. type: Plain text
  12672. #: ./bashref.texi:7556
  12673. msgid ""
  12674. "When invoked as @code{sh}, Bash enters @sc{posix} mode after reading the "
  12675. "startup files."
  12676. msgstr ""
  12677. #. type: Plain text
  12678. #: ./bashref.texi:7558
  12679. msgid "The following list is what's changed when `@sc{posix} mode' is in effect:"
  12680. msgstr ""
  12681. #. type: enumerate
  12682. #: ./bashref.texi:7562
  12683. msgid "Bash ensures that the @env{POSIXLY_CORRECT} variable is set."
  12684. msgstr ""
  12685. #. type: enumerate
  12686. #: ./bashref.texi:7567
  12687. msgid ""
  12688. "When a command in the hash table no longer exists, Bash will re-search "
  12689. "@env{$PATH} to find the new location. This is also available with "
  12690. "@samp{shopt -s checkhash}."
  12691. msgstr ""
  12692. #. type: enumerate
  12693. #: ./bashref.texi:7571
  12694. msgid ""
  12695. "The message printed by the job control code and builtins when a job exits "
  12696. "with a non-zero status is `Done(status)'."
  12697. msgstr ""
  12698. #. type: enumerate
  12699. #: ./bashref.texi:7576
  12700. msgid ""
  12701. "The message printed by the job control code and builtins when a job is "
  12702. "stopped is `Stopped(@var{signame})', where @var{signame} is, for example, "
  12703. "@code{SIGTSTP}."
  12704. msgstr ""
  12705. #. type: enumerate
  12706. #: ./bashref.texi:7579
  12707. msgid "Alias expansion is always enabled, even in non-interactive shells."
  12708. msgstr ""
  12709. #. type: enumerate
  12710. #: ./bashref.texi:7583
  12711. msgid ""
  12712. "Reserved words appearing in a context where reserved words are recognized do "
  12713. "not undergo alias expansion."
  12714. msgstr ""
  12715. #. type: enumerate
  12716. #: ./bashref.texi:7589
  12717. msgid ""
  12718. "The @sc{posix} @env{PS1} and @env{PS2} expansions of @samp{!} to the history "
  12719. "number and @samp{!!} to @samp{!} are enabled, and parameter expansion is "
  12720. "performed on the values of @env{PS1} and @env{PS2} regardless of the setting "
  12721. "of the @code{promptvars} option."
  12722. msgstr ""
  12723. #. type: enumerate
  12724. #: ./bashref.texi:7593
  12725. msgid ""
  12726. "The @sc{posix} startup files are executed (@env{$ENV}) rather than the "
  12727. "normal Bash files."
  12728. msgstr ""
  12729. #. type: enumerate
  12730. #: ./bashref.texi:7597
  12731. msgid ""
  12732. "Tilde expansion is only performed on assignments preceding a command name, "
  12733. "rather than on all assignment statements on the line."
  12734. msgstr ""
  12735. #. type: enumerate
  12736. #: ./bashref.texi:7601
  12737. msgid ""
  12738. "The default history file is @file{~/.sh_history} (this is the default value "
  12739. "of @env{$HISTFILE})."
  12740. msgstr ""
  12741. #. type: enumerate
  12742. #: ./bashref.texi:7605
  12743. msgid ""
  12744. "Redirection operators do not perform filename expansion on the word in the "
  12745. "redirection unless the shell is interactive."
  12746. msgstr ""
  12747. #. type: enumerate
  12748. #: ./bashref.texi:7609
  12749. msgid ""
  12750. "Redirection operators do not perform word splitting on the word in the "
  12751. "redirection."
  12752. msgstr ""
  12753. #. type: enumerate
  12754. #: ./bashref.texi:7615
  12755. msgid ""
  12756. "Function names must be valid shell @code{name}s. That is, they may not "
  12757. "contain characters other than letters, digits, and underscores, and may not "
  12758. "start with a digit. Declaring a function with an invalid name causes a "
  12759. "fatal syntax error in non-interactive shells."
  12760. msgstr ""
  12761. #. type: enumerate
  12762. #: ./bashref.texi:7619
  12763. msgid ""
  12764. "Function names may not be the same as one of the @sc{posix} special "
  12765. "builtins."
  12766. msgstr ""
  12767. #. type: enumerate
  12768. #: ./bashref.texi:7623
  12769. msgid ""
  12770. "@sc{posix} special builtins are found before shell functions during command "
  12771. "lookup."
  12772. msgstr ""
  12773. #. type: enumerate
  12774. #: ./bashref.texi:7627
  12775. msgid ""
  12776. "When printing shell function definitions (e.g., by @code{type}), Bash does "
  12777. "not print the @code{function} keyword."
  12778. msgstr ""
  12779. #. type: enumerate
  12780. #: ./bashref.texi:7632
  12781. msgid ""
  12782. "Literal tildes that appear as the first character in elements of the "
  12783. "@env{PATH} variable are not expanded as described above under @ref{Tilde "
  12784. "Expansion}."
  12785. msgstr ""
  12786. #. type: enumerate
  12787. #: ./bashref.texi:7638
  12788. msgid ""
  12789. "The @code{time} reserved word may be used by itself as a command. When used "
  12790. "in this way, it displays timing statistics for the shell and its completed "
  12791. "children. The @env{TIMEFORMAT} variable controls the format of the timing "
  12792. "information."
  12793. msgstr ""
  12794. #. type: enumerate
  12795. #: ./bashref.texi:7645
  12796. msgid ""
  12797. "When parsing and expanding a $@{@dots{}@} expansion that appears within "
  12798. "double quotes, single quotes are no longer special and cannot be used to "
  12799. "quote a closing brace or other special character, unless the operator is one "
  12800. "of those defined to perform pattern removal. In this case, they do not have "
  12801. "to appear as matched pairs."
  12802. msgstr ""
  12803. #. type: enumerate
  12804. #: ./bashref.texi:7649
  12805. msgid ""
  12806. "The parser does not recognize @code{time} as a reserved word if the next "
  12807. "token begins with a @samp{-}."
  12808. msgstr ""
  12809. #. type: enumerate
  12810. #: ./bashref.texi:7653
  12811. msgid ""
  12812. "The @samp{!} character does not introduce history expansion within a "
  12813. "double-quoted string, even if the @code{histexpand} option is enabled."
  12814. msgstr ""
  12815. #. type: enumerate
  12816. #: ./bashref.texi:7660
  12817. msgid ""
  12818. "If a @sc{posix} special builtin returns an error status, a non-interactive "
  12819. "shell exits. The fatal errors are those listed in the @sc{posix} standard, "
  12820. "and include things like passing incorrect options, redirection errors, "
  12821. "variable assignment errors for assignments preceding the command name, and "
  12822. "so on."
  12823. msgstr ""
  12824. #. type: enumerate
  12825. #: ./bashref.texi:7667
  12826. msgid ""
  12827. "A non-interactive shell exits with an error status if a variable assignment "
  12828. "error occurs when no command name follows the assignment statements. A "
  12829. "variable assignment error occurs, for example, when trying to assign a value "
  12830. "to a readonly variable."
  12831. msgstr ""
  12832. #. type: enumerate
  12833. #: ./bashref.texi:7672
  12834. msgid ""
  12835. "A non-interactive shell exits with an error status if a variable assignment "
  12836. "error occurs in an assignment statement preceding a special builtin, but not "
  12837. "with any other simple command."
  12838. msgstr ""
  12839. #. type: enumerate
  12840. #: ./bashref.texi:7677
  12841. msgid ""
  12842. "A non-interactive shell exits with an error status if the iteration variable "
  12843. "in a @code{for} statement or the selection variable in a @code{select} "
  12844. "statement is a readonly variable."
  12845. msgstr ""
  12846. #. type: enumerate
  12847. #: ./bashref.texi:7681
  12848. msgid ""
  12849. "Non-interactive shells exit if @var{filename} in @code{.} @var{filename} is "
  12850. "not found."
  12851. msgstr ""
  12852. #. type: enumerate
  12853. #: ./bashref.texi:7685
  12854. msgid ""
  12855. "Non-interactive shells exit if a syntax error in an arithmetic expansion "
  12856. "results in an invalid expression."
  12857. msgstr ""
  12858. #. type: enumerate
  12859. #: ./bashref.texi:7688
  12860. msgid "Non-interactive shells exit if a parameter expansion error occurs."
  12861. msgstr ""
  12862. #. type: enumerate
  12863. #: ./bashref.texi:7693
  12864. msgid ""
  12865. "Non-interactive shells exit if there is a syntax error in a script read with "
  12866. "the @code{.} or @code{source} builtins, or in a string processed by the "
  12867. "@code{eval} builtin."
  12868. msgstr ""
  12869. #. type: enumerate
  12870. #: ./bashref.texi:7696
  12871. msgid "Process substitution is not available."
  12872. msgstr ""
  12873. #. type: enumerate
  12874. #: ./bashref.texi:7700
  12875. msgid ""
  12876. "While variable indirection is available, it may not be applied to the "
  12877. "@samp{#} and @samp{?} special parameters."
  12878. msgstr ""
  12879. #. type: enumerate
  12880. #: ./bashref.texi:7705
  12881. msgid ""
  12882. "When expanding the @samp{*} special parameter in a pattern context where the "
  12883. "expansion is double-quoted does not treat the @code{$*} as if it were "
  12884. "double-quoted."
  12885. msgstr ""
  12886. #. type: enumerate
  12887. #: ./bashref.texi:7709
  12888. msgid ""
  12889. "Assignment statements preceding @sc{posix} special builtins persist in the "
  12890. "shell environment after the builtin completes."
  12891. msgstr ""
  12892. #. type: enumerate
  12893. #: ./bashref.texi:7714
  12894. msgid ""
  12895. "Assignment statements preceding shell function calls persist in the shell "
  12896. "environment after the function returns, as if a @sc{posix} special builtin "
  12897. "command had been executed."
  12898. msgstr ""
  12899. #. type: enumerate
  12900. #: ./bashref.texi:7720
  12901. msgid ""
  12902. "The @code{command} builtin does not prevent builtins that take assignment "
  12903. "statements as arguments from expanding them as assignment statements; when "
  12904. "not in @sc{posix} mode, assignment builtins lose their assignment statement "
  12905. "expansion properties when preceded by @code{command}."
  12906. msgstr ""
  12907. #. type: enumerate
  12908. #: ./bashref.texi:7725
  12909. msgid ""
  12910. "The @code{bg} builtin uses the required format to describe each job placed "
  12911. "in the background, which does not include an indication of whether the job "
  12912. "is the current or previous job."
  12913. msgstr ""
  12914. #. type: enumerate
  12915. #: ./bashref.texi:7729
  12916. msgid ""
  12917. "The output of @samp{kill -l} prints all the signal names on a single line, "
  12918. "separated by spaces, without the @samp{SIG} prefix."
  12919. msgstr ""
  12920. #. type: enumerate
  12921. #: ./bashref.texi:7733
  12922. msgid ""
  12923. "The @code{kill} builtin does not accept signal names with a @samp{SIG} "
  12924. "prefix."
  12925. msgstr ""
  12926. #. type: enumerate
  12927. #: ./bashref.texi:7737
  12928. msgid ""
  12929. "The @code{export} and @code{readonly} builtin commands display their output "
  12930. "in the format required by @sc{posix}."
  12931. msgstr ""
  12932. #. type: enumerate
  12933. #: ./bashref.texi:7741
  12934. msgid ""
  12935. "The @code{trap} builtin displays signal names without the leading "
  12936. "@code{SIG}."
  12937. msgstr ""
  12938. #. type: enumerate
  12939. #: ./bashref.texi:7749
  12940. msgid ""
  12941. "The @code{trap} builtin doesn't check the first argument for a possible "
  12942. "signal specification and revert the signal handling to the original "
  12943. "disposition if it is, unless that argument consists solely of digits and is "
  12944. "a valid signal number. If users want to reset the handler for a given "
  12945. "signal to the original disposition, they should use @samp{-} as the first "
  12946. "argument."
  12947. msgstr ""
  12948. #. type: enumerate
  12949. #: ./bashref.texi:7753
  12950. msgid ""
  12951. "The @code{.} and @code{source} builtins do not search the current directory "
  12952. "for the filename argument if it is not found by searching @env{PATH}."
  12953. msgstr ""
  12954. #. type: enumerate
  12955. #: ./bashref.texi:7761
  12956. msgid ""
  12957. "Enabling @sc{posix} mode has the effect of setting the "
  12958. "@code{inherit_errexit} option, so subshells spawned to execute command "
  12959. "substitutions inherit the value of the @option{-e} option from the parent "
  12960. "shell. When the @code{inherit_errexit} option is not enabled, Bash clears "
  12961. "the @option{-e} option in such subshells."
  12962. msgstr ""
  12963. #. type: enumerate
  12964. #: ./bashref.texi:7767
  12965. msgid ""
  12966. "Enabling @sc{posix} mode has the effect of setting the @code{shift_verbose} "
  12967. "option, so numeric arguments to @code{shift} that exceed the number of "
  12968. "positional parameters will result in an error message."
  12969. msgstr ""
  12970. #. type: enumerate
  12971. #: ./bashref.texi:7772
  12972. msgid ""
  12973. "When the @code{alias} builtin displays alias definitions, it does not "
  12974. "display them with a leading @samp{alias } unless the @option{-p} option is "
  12975. "supplied."
  12976. msgstr ""
  12977. #. type: enumerate
  12978. #: ./bashref.texi:7776
  12979. msgid ""
  12980. "When the @code{set} builtin is invoked without options, it does not display "
  12981. "shell function names and definitions."
  12982. msgstr ""
  12983. #. type: enumerate
  12984. #: ./bashref.texi:7781
  12985. msgid ""
  12986. "When the @code{set} builtin is invoked without options, it displays variable "
  12987. "values without quotes, unless they contain shell metacharacters, even if the "
  12988. "result contains nonprinting characters."
  12989. msgstr ""
  12990. #. type: enumerate
  12991. #: ./bashref.texi:7787
  12992. msgid ""
  12993. "When the @code{cd} builtin is invoked in @var{logical} mode, and the "
  12994. "pathname constructed from @code{$PWD} and the directory name supplied as an "
  12995. "argument does not refer to an existing directory, @code{cd} will fail "
  12996. "instead of falling back to @var{physical} mode."
  12997. msgstr ""
  12998. #. type: enumerate
  12999. #: ./bashref.texi:7794
  13000. msgid ""
  13001. "When the @code{cd} builtin cannot change a directory because the length of "
  13002. "the pathname constructed from @code{$PWD} and the directory name supplied as "
  13003. "an argument exceeds @var{PATH_MAX} when all symbolic links are expanded, "
  13004. "@code{cd} will fail instead of attempting to use only the supplied directory "
  13005. "name."
  13006. msgstr ""
  13007. #. type: enumerate
  13008. #: ./bashref.texi:7799
  13009. msgid ""
  13010. "The @code{pwd} builtin verifies that the value it prints is the same as the "
  13011. "current directory, even if it is not asked to check the file system with the "
  13012. "@option{-P} option."
  13013. msgstr ""
  13014. #. type: enumerate
  13015. #: ./bashref.texi:7803
  13016. msgid ""
  13017. "When listing the history, the @code{fc} builtin does not include an "
  13018. "indication of whether or not a history entry has been modified."
  13019. msgstr ""
  13020. #. type: enumerate
  13021. #: ./bashref.texi:7806
  13022. msgid "The default editor used by @code{fc} is @code{ed}."
  13023. msgstr ""
  13024. #. type: enumerate
  13025. #: ./bashref.texi:7811
  13026. msgid ""
  13027. "The @code{type} and @code{command} builtins will not report a non-executable "
  13028. "file as having been found, though the shell will attempt to execute such a "
  13029. "file if it is the only so-named file found in @code{$PATH}."
  13030. msgstr ""
  13031. #. type: enumerate
  13032. #: ./bashref.texi:7816
  13033. msgid ""
  13034. "The @code{vi} editing mode will invoke the @code{vi} editor directly when "
  13035. "the @samp{v} command is run, instead of checking @code{$VISUAL} and "
  13036. "@code{$EDITOR}."
  13037. msgstr ""
  13038. #. type: enumerate
  13039. #: ./bashref.texi:7821
  13040. msgid ""
  13041. "When the @code{xpg_echo} option is enabled, Bash does not attempt to "
  13042. "interpret any arguments to @code{echo} as options. Each argument is "
  13043. "displayed, after escape characters are converted."
  13044. msgstr ""
  13045. #. type: enumerate
  13046. #: ./bashref.texi:7825
  13047. msgid ""
  13048. "The @code{ulimit} builtin uses a block size of 512 bytes for the @option{-c} "
  13049. "and @option{-f} options."
  13050. msgstr ""
  13051. #. type: enumerate
  13052. #: ./bashref.texi:7830
  13053. msgid ""
  13054. "The arrival of @code{SIGCHLD} when a trap is set on @code{SIGCHLD} does not "
  13055. "interrupt the @code{wait} builtin and cause it to return immediately. The "
  13056. "trap command is run once for each child that exits."
  13057. msgstr ""
  13058. #. type: enumerate
  13059. #: ./bashref.texi:7836
  13060. msgid ""
  13061. "The @code{read} builtin may be interrupted by a signal for which a trap has "
  13062. "been set. If Bash receives a trapped signal while executing @code{read}, "
  13063. "the trap handler executes and @code{read} returns an exit status greater "
  13064. "than 128."
  13065. msgstr ""
  13066. #. type: enumerate
  13067. #: ./bashref.texi:7840
  13068. msgid ""
  13069. "Bash removes an exited background process's status from the list of such "
  13070. "statuses after the @code{wait} builtin is used to obtain it."
  13071. msgstr ""
  13072. #. type: Plain text
  13073. #: ./bashref.texi:7846
  13074. msgid ""
  13075. "There is other @sc{posix} behavior that Bash does not implement by default "
  13076. "even when in @sc{posix} mode. Specifically:"
  13077. msgstr ""
  13078. #. type: enumerate
  13079. #: ./bashref.texi:7853
  13080. msgid ""
  13081. "The @code{fc} builtin checks @code{$EDITOR} as a program to edit history "
  13082. "entries if @code{FCEDIT} is unset, rather than defaulting directly to "
  13083. "@code{ed}. @code{fc} uses @code{ed} if @code{EDITOR} is unset."
  13084. msgstr ""
  13085. #. type: enumerate
  13086. #: ./bashref.texi:7857
  13087. msgid ""
  13088. "As noted above, Bash requires the @code{xpg_echo} option to be enabled for "
  13089. "the @code{echo} builtin to be fully conformant."
  13090. msgstr ""
  13091. #. type: Plain text
  13092. #: ./bashref.texi:7863
  13093. msgid ""
  13094. "Bash can be configured to be @sc{posix}-conformant by default, by specifying "
  13095. "the @option{--enable-strict-posix-default} to @code{configure} when building "
  13096. "(@pxref{Optional Features})."
  13097. msgstr ""
  13098. #. type: Plain text
  13099. #: ./bashref.texi:7869
  13100. msgid ""
  13101. "This chapter discusses what job control is, how it works, and how Bash "
  13102. "allows you to access its facilities."
  13103. msgstr ""
  13104. #. type: section
  13105. #: ./bashref.texi:7876 ./bashref.texi:7878 ./bashref.texi:7879
  13106. #, no-wrap
  13107. msgid "Job Control Basics"
  13108. msgstr ""
  13109. #. type: menuentry
  13110. #: ./bashref.texi:7876
  13111. msgid "How job control works."
  13112. msgstr ""
  13113. #. type: section
  13114. #: ./bashref.texi:7876 ./bashref.texi:7988 ./bashref.texi:7989
  13115. #, no-wrap
  13116. msgid "Job Control Builtins"
  13117. msgstr ""
  13118. #. type: menuentry
  13119. #: ./bashref.texi:7876
  13120. msgid "Bash builtin commands used to interact with job control."
  13121. msgstr ""
  13122. #. type: section
  13123. #: ./bashref.texi:7876 ./bashref.texi:8134 ./bashref.texi:8135
  13124. #, no-wrap
  13125. msgid "Job Control Variables"
  13126. msgstr ""
  13127. #. type: menuentry
  13128. #: ./bashref.texi:7876
  13129. msgid "Variables Bash uses to customize job control."
  13130. msgstr ""
  13131. #. type: cindex
  13132. #: ./bashref.texi:7881
  13133. #, no-wrap
  13134. msgid "foreground"
  13135. msgstr ""
  13136. #. type: cindex
  13137. #: ./bashref.texi:7882
  13138. #, no-wrap
  13139. msgid "background"
  13140. msgstr ""
  13141. #. type: cindex
  13142. #: ./bashref.texi:7883
  13143. #, no-wrap
  13144. msgid "suspending jobs"
  13145. msgstr ""
  13146. #. type: Plain text
  13147. #: ./bashref.texi:7891
  13148. msgid ""
  13149. "Job control refers to the ability to selectively stop (suspend) the "
  13150. "execution of processes and continue (resume) their execution at a later "
  13151. "point. A user typically employs this facility via an interactive interface "
  13152. "supplied jointly by the operating system kernel's terminal driver and Bash."
  13153. msgstr ""
  13154. #. type: Plain text
  13155. #: ./bashref.texi:7897
  13156. msgid ""
  13157. "The shell associates a @var{job} with each pipeline. It keeps a table of "
  13158. "currently executing jobs, which may be listed with the @code{jobs} command. "
  13159. "When Bash starts a job asynchronously, it prints a line that looks like:"
  13160. msgstr ""
  13161. #. type: example
  13162. #: ./bashref.texi:7899
  13163. #, no-wrap
  13164. msgid "[1] 25647\n"
  13165. msgstr ""
  13166. #. type: Plain text
  13167. #: ./bashref.texi:7906
  13168. msgid ""
  13169. "indicating that this job is job number 1 and that the process @sc{id} of the "
  13170. "last process in the pipeline associated with this job is 25647. All of the "
  13171. "processes in a single pipeline are members of the same job. Bash uses the "
  13172. "@var{job} abstraction as the basis for job control."
  13173. msgstr ""
  13174. #. type: Plain text
  13175. #: ./bashref.texi:7922
  13176. msgid ""
  13177. "To facilitate the implementation of the user interface to job control, the "
  13178. "operating system maintains the notion of a current terminal process group "
  13179. "@sc{id}. Members of this process group (processes whose process group "
  13180. "@sc{id} is equal to the current terminal process group @sc{id}) receive "
  13181. "keyboard-generated signals such as @code{SIGINT}. These processes are said "
  13182. "to be in the foreground. Background processes are those whose process group "
  13183. "@sc{id} differs from the terminal's; such processes are immune to "
  13184. "keyboard-generated signals. Only foreground processes are allowed to read "
  13185. "from or, if the user so specifies with @code{stty tostop}, write to the "
  13186. "terminal. Background processes which attempt to read from (write to when "
  13187. "@code{stty tostop} is in effect) the terminal are sent a @code{SIGTTIN} "
  13188. "(@code{SIGTTOU}) signal by the kernel's terminal driver, which, unless "
  13189. "caught, suspends the process."
  13190. msgstr ""
  13191. #. type: Plain text
  13192. #: ./bashref.texi:7936
  13193. msgid ""
  13194. "If the operating system on which Bash is running supports job control, Bash "
  13195. "contains facilities to use it. Typing the @var{suspend} character "
  13196. "(typically @samp{^Z}, Control-Z) while a process is running causes that "
  13197. "process to be stopped and returns control to Bash. Typing the @var{delayed "
  13198. "suspend} character (typically @samp{^Y}, Control-Y) causes the process to be "
  13199. "stopped when it attempts to read input from the terminal, and control to be "
  13200. "returned to Bash. The user then manipulates the state of this job, using "
  13201. "the @code{bg} command to continue it in the background, the @code{fg} "
  13202. "command to continue it in the foreground, or the @code{kill} command to kill "
  13203. "it. A @samp{^Z} takes effect immediately, and has the additional side "
  13204. "effect of causing pending output and typeahead to be discarded."
  13205. msgstr ""
  13206. #. type: Plain text
  13207. #: ./bashref.texi:7939
  13208. msgid ""
  13209. "There are a number of ways to refer to a job in the shell. The character "
  13210. "@samp{%} introduces a job specification (@var{jobspec})."
  13211. msgstr ""
  13212. #. type: Plain text
  13213. #: ./bashref.texi:7952
  13214. msgid ""
  13215. "Job number @code{n} may be referred to as @samp{%n}. The symbols @samp{%%} "
  13216. "and @samp{%+} refer to the shell's notion of the current job, which is the "
  13217. "last job stopped while it was in the foreground or started in the "
  13218. "background. A single @samp{%} (with no accompanying job specification) also "
  13219. "refers to the current job. The previous job may be referenced using "
  13220. "@samp{%-}. If there is only a single job, @samp{%+} and @samp{%-} can both "
  13221. "be used to refer to that job. In output pertaining to jobs (e.g., the "
  13222. "output of the @code{jobs} command), the current job is always flagged with a "
  13223. "@samp{+}, and the previous job with a @samp{-}."
  13224. msgstr ""
  13225. #. type: Plain text
  13226. #: ./bashref.texi:7960
  13227. msgid ""
  13228. "A job may also be referred to using a prefix of the name used to start it, "
  13229. "or using a substring that appears in its command line. For example, "
  13230. "@samp{%ce} refers to a stopped @code{ce} job. Using @samp{%?ce}, on the "
  13231. "other hand, refers to any job containing the string @samp{ce} in its command "
  13232. "line. If the prefix or substring matches more than one job, Bash reports an "
  13233. "error."
  13234. msgstr ""
  13235. #. type: Plain text
  13236. #: ./bashref.texi:7965
  13237. msgid ""
  13238. "Simply naming a job can be used to bring it into the foreground: @samp{%1} "
  13239. "is a synonym for @samp{fg %1}, bringing job 1 from the background into the "
  13240. "foreground. Similarly, @samp{%1 &} resumes job 1 in the background, "
  13241. "equivalent to @samp{bg %1}"
  13242. msgstr ""
  13243. #. type: Plain text
  13244. #: ./bashref.texi:7974
  13245. msgid ""
  13246. "The shell learns immediately whenever a job changes state. Normally, Bash "
  13247. "waits until it is about to print a prompt before reporting changes in a "
  13248. "job's status so as to not interrupt any other output. If the @option{-b} "
  13249. "option to the @code{set} builtin is enabled, Bash reports such changes "
  13250. "immediately (@pxref{The Set Builtin}). Any trap on @code{SIGCHLD} is "
  13251. "executed for each child process that exits."
  13252. msgstr ""
  13253. #. type: Plain text
  13254. #: ./bashref.texi:7982
  13255. msgid ""
  13256. "If an attempt to exit Bash is made while jobs are stopped, (or running, if "
  13257. "the @code{checkjobs} option is enabled -- see @ref{The Shopt Builtin}), the "
  13258. "shell prints a warning message, and if the @code{checkjobs} option is "
  13259. "enabled, lists the jobs and their statuses. The @code{jobs} command may "
  13260. "then be used to inspect their status. If a second attempt to exit is made "
  13261. "without an intervening command, Bash does not print another warning, and any "
  13262. "stopped jobs are terminated."
  13263. msgstr ""
  13264. #. type: Plain text
  13265. #: ./bashref.texi:7987
  13266. msgid ""
  13267. "When the shell is waiting for a job or process using the @code{wait} "
  13268. "builtin, and job control is enabled, @code{wait} will return when the job "
  13269. "changes state. The @option{-f} option will force @code{wait} to wait until "
  13270. "the job or process terminates before returning."
  13271. msgstr ""
  13272. #. type: btindex
  13273. #: ./bashref.texi:7993 ./bashref.texi:7994
  13274. #, no-wrap
  13275. msgid "bg"
  13276. msgstr ""
  13277. #. type: example
  13278. #: ./bashref.texi:7997
  13279. #, no-wrap
  13280. msgid "bg [@var{jobspec} @dots{}]\n"
  13281. msgstr ""
  13282. #. type: table
  13283. #: ./bashref.texi:8006
  13284. msgid ""
  13285. "Resume each suspended job @var{jobspec} in the background, as if it had been "
  13286. "started with @samp{&}. If @var{jobspec} is not supplied, the current job is "
  13287. "used. The return status is zero unless it is run when job control is not "
  13288. "enabled, or, when run with job control enabled, any @var{jobspec} was not "
  13289. "found or specifies a job that was started without job control."
  13290. msgstr ""
  13291. #. type: btindex
  13292. #: ./bashref.texi:8007 ./bashref.texi:8008
  13293. #, no-wrap
  13294. msgid "fg"
  13295. msgstr ""
  13296. #. type: example
  13297. #: ./bashref.texi:8011
  13298. #, no-wrap
  13299. msgid "fg [@var{jobspec}]\n"
  13300. msgstr ""
  13301. #. type: table
  13302. #: ./bashref.texi:8019
  13303. msgid ""
  13304. "Resume the job @var{jobspec} in the foreground and make it the current job. "
  13305. "If @var{jobspec} is not supplied, the current job is used. The return "
  13306. "status is that of the command placed into the foreground, or non-zero if run "
  13307. "when job control is disabled or, when run with job control enabled, "
  13308. "@var{jobspec} does not specify a valid job or @var{jobspec} specifies a job "
  13309. "that was started without job control."
  13310. msgstr ""
  13311. #. type: btindex
  13312. #: ./bashref.texi:8020 ./bashref.texi:8021
  13313. #, no-wrap
  13314. msgid "jobs"
  13315. msgstr ""
  13316. #. type: example
  13317. #: ./bashref.texi:8025
  13318. #, no-wrap
  13319. msgid ""
  13320. "jobs [-lnprs] [@var{jobspec}]\n"
  13321. "jobs -x @var{command} [@var{arguments}]\n"
  13322. msgstr ""
  13323. #. type: table
  13324. #: ./bashref.texi:8029
  13325. msgid ""
  13326. "The first form lists the active jobs. The options have the following "
  13327. "meanings:"
  13328. msgstr ""
  13329. #. type: table
  13330. #: ./bashref.texi:8033
  13331. msgid "List process @sc{id}s in addition to the normal information."
  13332. msgstr ""
  13333. #. type: table
  13334. #: ./bashref.texi:8037
  13335. msgid ""
  13336. "Display information only about jobs that have changed status since the user "
  13337. "was last notified of their status."
  13338. msgstr ""
  13339. #. type: table
  13340. #: ./bashref.texi:8040
  13341. msgid "List only the process @sc{id} of the job's process group leader."
  13342. msgstr ""
  13343. #. type: table
  13344. #: ./bashref.texi:8043
  13345. msgid "Display only running jobs."
  13346. msgstr ""
  13347. #. type: table
  13348. #: ./bashref.texi:8046
  13349. msgid "Display only stopped jobs."
  13350. msgstr ""
  13351. #. type: table
  13352. #: ./bashref.texi:8052
  13353. msgid ""
  13354. "If @var{jobspec} is given, output is restricted to information about that "
  13355. "job. If @var{jobspec} is not supplied, the status of all jobs is listed."
  13356. msgstr ""
  13357. #. type: table
  13358. #: ./bashref.texi:8057
  13359. msgid ""
  13360. "If the @option{-x} option is supplied, @code{jobs} replaces any "
  13361. "@var{jobspec} found in @var{command} or @var{arguments} with the "
  13362. "corresponding process group @sc{id}, and executes @var{command}, passing it "
  13363. "@var{argument}s, returning its exit status."
  13364. msgstr ""
  13365. #. type: btindex
  13366. #: ./bashref.texi:8058 ./bashref.texi:8059
  13367. #, no-wrap
  13368. msgid "kill"
  13369. msgstr ""
  13370. #. type: example
  13371. #: ./bashref.texi:8063
  13372. #, no-wrap
  13373. msgid ""
  13374. "kill [-s @var{sigspec}] [-n @var{signum}] [-@var{sigspec}] @var{jobspec} or "
  13375. "@var{pid}\n"
  13376. "kill -l|-L [@var{exit_status}]\n"
  13377. msgstr ""
  13378. #. type: table
  13379. #: ./bashref.texi:8080
  13380. msgid ""
  13381. "Send a signal specified by @var{sigspec} or @var{signum} to the process "
  13382. "named by job specification @var{jobspec} or process @sc{id} @var{pid}. "
  13383. "@var{sigspec} is either a case-insensitive signal name such as @code{SIGINT} "
  13384. "(with or without the @code{SIG} prefix) or a signal number; @var{signum} is "
  13385. "a signal number. If @var{sigspec} and @var{signum} are not present, "
  13386. "@code{SIGTERM} is used. The @option{-l} option lists the signal names. If "
  13387. "any arguments are supplied when @option{-l} is given, the names of the "
  13388. "signals corresponding to the arguments are listed, and the return status is "
  13389. "zero. @var{exit_status} is a number specifying a signal number or the exit "
  13390. "status of a process terminated by a signal. The @option{-L} option is "
  13391. "equivalent to @option{-l}. The return status is zero if at least one signal "
  13392. "was successfully sent, or non-zero if an error occurs or an invalid option "
  13393. "is encountered."
  13394. msgstr ""
  13395. #. type: btindex
  13396. #: ./bashref.texi:8081 ./bashref.texi:8082
  13397. #, no-wrap
  13398. msgid "wait"
  13399. msgstr ""
  13400. #. type: example
  13401. #: ./bashref.texi:8085
  13402. #, no-wrap
  13403. msgid "wait [-fn] [@var{jobspec} or @var{pid} @dots{}]\n"
  13404. msgstr ""
  13405. #. type: table
  13406. #: ./bashref.texi:8100
  13407. msgid ""
  13408. "Wait until the child process specified by each process @sc{id} @var{pid} or "
  13409. "job specification @var{jobspec} exits and return the exit status of the last "
  13410. "command waited for. If a job spec is given, all processes in the job are "
  13411. "waited for. If no arguments are given, all currently active child processes "
  13412. "are waited for, and the return status is zero. If the @option{-n} option is "
  13413. "supplied, @code{wait} waits for any job to terminate and returns its exit "
  13414. "status. If the @option{-f} option is supplied, and job control is enabled, "
  13415. "@code{wait} forces each @var{pid} or @var{jobspec} to terminate before "
  13416. "returning its status, intead of returning when it changes status. If "
  13417. "neither @var{jobspec} nor @var{pid} specifies an active child process of the "
  13418. "shell, the return status is 127."
  13419. msgstr ""
  13420. #. type: btindex
  13421. #: ./bashref.texi:8101 ./bashref.texi:8102
  13422. #, no-wrap
  13423. msgid "disown"
  13424. msgstr ""
  13425. #. type: example
  13426. #: ./bashref.texi:8105
  13427. #, no-wrap
  13428. msgid "disown [-ar] [-h] [@var{jobspec} @dots{} | @var{pid} @dots{} ]\n"
  13429. msgstr ""
  13430. #. type: table
  13431. #: ./bashref.texi:8117
  13432. msgid ""
  13433. "Without options, remove each @var{jobspec} from the table of active jobs. "
  13434. "If the @option{-h} option is given, the job is not removed from the table, "
  13435. "but is marked so that @code{SIGHUP} is not sent to the job if the shell "
  13436. "receives a @code{SIGHUP}. If @var{jobspec} is not present, and neither the "
  13437. "@option{-a} nor the @option{-r} option is supplied, the current job is "
  13438. "used. If no @var{jobspec} is supplied, the @option{-a} option means to "
  13439. "remove or mark all jobs; the @option{-r} option without a @var{jobspec} "
  13440. "argument restricts operation to running jobs."
  13441. msgstr ""
  13442. #. type: btindex
  13443. #: ./bashref.texi:8118 ./bashref.texi:8119
  13444. #, no-wrap
  13445. msgid "suspend"
  13446. msgstr ""
  13447. #. type: example
  13448. #: ./bashref.texi:8122
  13449. #, no-wrap
  13450. msgid "suspend [-f]\n"
  13451. msgstr ""
  13452. #. type: table
  13453. #: ./bashref.texi:8128
  13454. msgid ""
  13455. "Suspend the execution of this shell until it receives a @code{SIGCONT} "
  13456. "signal. A login shell cannot be suspended; the @option{-f} option can be "
  13457. "used to override this and force the suspension."
  13458. msgstr ""
  13459. #. type: Plain text
  13460. #: ./bashref.texi:8133
  13461. msgid ""
  13462. "When job control is not active, the @code{kill} and @code{wait} builtins do "
  13463. "not accept @var{jobspec} arguments. They must be supplied process @sc{id}s."
  13464. msgstr ""
  13465. #. type: item
  13466. #: ./bashref.texi:8139
  13467. #, no-wrap
  13468. msgid "auto_resume"
  13469. msgstr ""
  13470. #. type: Plain text
  13471. #: ./bashref.texi:8156
  13472. msgid ""
  13473. "This variable controls how the shell interacts with the user and job "
  13474. "control. If this variable exists then single word simple commands without "
  13475. "redirections are treated as candidates for resumption of an existing job. "
  13476. "There is no ambiguity allowed; if there is more than one job beginning with "
  13477. "the string typed, then the most recently accessed job will be selected. The "
  13478. "name of a stopped job, in this context, is the command line used to start "
  13479. "it. If this variable is set to the value @samp{exact}, the string supplied "
  13480. "must match the name of a stopped job exactly; if set to @samp{substring}, "
  13481. "the string supplied needs to match a substring of the name of a stopped "
  13482. "job. The @samp{substring} value provides functionality analogous to the "
  13483. "@samp{%?} job @sc{id} (@pxref{Job Control Basics}). If set to any other "
  13484. "value, the supplied string must be a prefix of a stopped job's name; this "
  13485. "provides functionality analogous to the @samp{%} job @sc{id}."
  13486. msgstr ""
  13487. #. type: cindex
  13488. #: ./bashref.texi:8161
  13489. #, no-wrap
  13490. msgid "Readline, how to use"
  13491. msgstr ""
  13492. #. type: include
  13493. #: ./bashref.texi:8162
  13494. #, no-wrap
  13495. msgid "rluser.texi"
  13496. msgstr ""
  13497. #. type: cindex
  13498. #: ./bashref.texi:8163
  13499. #, no-wrap
  13500. msgid "History, how to use"
  13501. msgstr ""
  13502. #. type: include
  13503. #: ./bashref.texi:8164
  13504. #, no-wrap
  13505. msgid "hsuser.texi"
  13506. msgstr ""
  13507. #. type: Plain text
  13508. #: ./bashref.texi:8177
  13509. msgid ""
  13510. "This chapter provides basic instructions for installing Bash on the various "
  13511. "supported platforms. The distribution supports the @sc{gnu} operating "
  13512. "systems, nearly every version of Unix, and several non-Unix systems such as "
  13513. "BeOS and Interix. Other independent ports exist for @sc{ms-dos}, @sc{os/2}, "
  13514. "and Windows platforms."
  13515. msgstr ""
  13516. #. type: section
  13517. #: ./bashref.texi:8192 ./bashref.texi:8194 ./bashref.texi:8195
  13518. #, no-wrap
  13519. msgid "Basic Installation"
  13520. msgstr ""
  13521. #. type: menuentry
  13522. #: ./bashref.texi:8192
  13523. msgid "Installation instructions."
  13524. msgstr ""
  13525. #. type: section
  13526. #: ./bashref.texi:8192 ./bashref.texi:8290 ./bashref.texi:8291
  13527. #, no-wrap
  13528. msgid "Compilers and Options"
  13529. msgstr ""
  13530. #. type: menuentry
  13531. #: ./bashref.texi:8192
  13532. msgid "How to set special options for various systems."
  13533. msgstr ""
  13534. #. type: section
  13535. #: ./bashref.texi:8192 ./bashref.texi:8312 ./bashref.texi:8313
  13536. #, no-wrap
  13537. msgid "Compiling For Multiple Architectures"
  13538. msgstr ""
  13539. #. type: menuentry
  13540. #: ./bashref.texi:8192
  13541. msgid ""
  13542. "How to compile Bash for more than one kind of system from the same source "
  13543. "tree."
  13544. msgstr ""
  13545. #. type: section
  13546. #: ./bashref.texi:8192 ./bashref.texi:8349 ./bashref.texi:8350
  13547. #, no-wrap
  13548. msgid "Installation Names"
  13549. msgstr ""
  13550. #. type: menuentry
  13551. #: ./bashref.texi:8192
  13552. msgid "How to set the various paths used by the installation."
  13553. msgstr ""
  13554. #. type: section
  13555. #: ./bashref.texi:8192 ./bashref.texi:8366 ./bashref.texi:8367
  13556. #, no-wrap
  13557. msgid "Specifying the System Type"
  13558. msgstr ""
  13559. #. type: menuentry
  13560. #: ./bashref.texi:8192
  13561. msgid "How to configure Bash for a particular system."
  13562. msgstr ""
  13563. #. type: section
  13564. #: ./bashref.texi:8192 ./bashref.texi:8381 ./bashref.texi:8382
  13565. #, no-wrap
  13566. msgid "Sharing Defaults"
  13567. msgstr ""
  13568. #. type: menuentry
  13569. #: ./bashref.texi:8192
  13570. msgid "How to share default configuration values among GNU programs."
  13571. msgstr ""
  13572. #. type: section
  13573. #: ./bashref.texi:8192 ./bashref.texi:8394 ./bashref.texi:8395
  13574. #, no-wrap
  13575. msgid "Operation Controls"
  13576. msgstr ""
  13577. #. type: menuentry
  13578. #: ./bashref.texi:8192
  13579. msgid "Options recognized by the configuration program."
  13580. msgstr ""
  13581. #. type: section
  13582. #: ./bashref.texi:8192 ./bashref.texi:8428 ./bashref.texi:8429
  13583. #, no-wrap
  13584. msgid "Optional Features"
  13585. msgstr ""
  13586. #. type: menuentry
  13587. #: ./bashref.texi:8192
  13588. msgid "How to enable and disable optional features when building Bash."
  13589. msgstr ""
  13590. #. type: cindex
  13591. #: ./bashref.texi:8196
  13592. #, no-wrap
  13593. msgid "installation"
  13594. msgstr ""
  13595. #. type: cindex
  13596. #: ./bashref.texi:8197
  13597. #, no-wrap
  13598. msgid "configuration"
  13599. msgstr ""
  13600. #. type: cindex
  13601. #: ./bashref.texi:8198
  13602. #, no-wrap
  13603. msgid "Bash installation"
  13604. msgstr ""
  13605. #. type: cindex
  13606. #: ./bashref.texi:8199
  13607. #, no-wrap
  13608. msgid "Bash configuration"
  13609. msgstr ""
  13610. #. type: Plain text
  13611. #: ./bashref.texi:8202
  13612. msgid "These are installation instructions for Bash."
  13613. msgstr ""
  13614. #. type: Plain text
  13615. #: ./bashref.texi:8204
  13616. msgid "The simplest way to compile Bash is:"
  13617. msgstr ""
  13618. #. type: enumerate
  13619. #: ./bashref.texi:8212
  13620. msgid ""
  13621. "@code{cd} to the directory containing the source code and type "
  13622. "@samp{./configure} to configure Bash for your system. If you're using "
  13623. "@code{csh} on an old version of System V, you might need to type @samp{sh "
  13624. "./configure} instead to prevent @code{csh} from trying to execute "
  13625. "@code{configure} itself."
  13626. msgstr ""
  13627. #. type: enumerate
  13628. #: ./bashref.texi:8216
  13629. msgid ""
  13630. "Running @code{configure} takes some time. While running, it prints messages "
  13631. "telling which features it is checking for."
  13632. msgstr ""
  13633. #. type: enumerate
  13634. #: ./bashref.texi:8220
  13635. msgid ""
  13636. "Type @samp{make} to compile Bash and build the @code{bashbug} bug reporting "
  13637. "script."
  13638. msgstr ""
  13639. #. type: enumerate
  13640. #: ./bashref.texi:8223
  13641. msgid "Optionally, type @samp{make tests} to run the Bash test suite."
  13642. msgstr ""
  13643. #. type: enumerate
  13644. #: ./bashref.texi:8227
  13645. msgid ""
  13646. "Type @samp{make install} to install @code{bash} and @code{bashbug}. This "
  13647. "will also install the manual pages and Info file."
  13648. msgstr ""
  13649. #. type: Plain text
  13650. #: ./bashref.texi:8245
  13651. msgid ""
  13652. "The @code{configure} shell script attempts to guess correct values for "
  13653. "various system-dependent variables used during compilation. It uses those "
  13654. "values to create a @file{Makefile} in each directory of the package (the top "
  13655. "directory, the @file{builtins}, @file{doc}, and @file{support} directories, "
  13656. "each directory under @file{lib}, and several others). It also creates a "
  13657. "@file{config.h} file containing system-dependent definitions. Finally, it "
  13658. "creates a shell script named @code{config.status} that you can run in the "
  13659. "future to recreate the current configuration, a file @file{config.cache} "
  13660. "that saves the results of its tests to speed up reconfiguring, and a file "
  13661. "@file{config.log} containing compiler output (useful mainly for debugging "
  13662. "@code{configure}). If at some point @file{config.cache} contains results "
  13663. "you don't want to keep, you may remove or edit it."
  13664. msgstr ""
  13665. #. type: Plain text
  13666. #: ./bashref.texi:8248
  13667. msgid ""
  13668. "To find out more about the options and arguments that the @code{configure} "
  13669. "script understands, type"
  13670. msgstr ""
  13671. #. type: example
  13672. #: ./bashref.texi:8251
  13673. #, no-wrap
  13674. msgid "bash-4.2$ ./configure --help\n"
  13675. msgstr ""
  13676. #. type: Plain text
  13677. #: ./bashref.texi:8255
  13678. msgid "at the Bash prompt in your Bash source directory."
  13679. msgstr ""
  13680. #. type: Plain text
  13681. #: ./bashref.texi:8261
  13682. msgid ""
  13683. "If you want to build Bash in a directory separate from the source directory "
  13684. "-- to build for multiple architectures, for example -- just use the full "
  13685. "path to the configure script. The following commands will build bash in a "
  13686. "directory under @file{/usr/local/build} from the source code in "
  13687. "@file{/usr/local/src/bash-4.4}:"
  13688. msgstr ""
  13689. #. type: example
  13690. #: ./bashref.texi:8267
  13691. #, no-wrap
  13692. msgid ""
  13693. "mkdir /usr/local/build/bash-4.4\n"
  13694. "cd /usr/local/build/bash-4.4\n"
  13695. "bash /usr/local/src/bash-4.4/configure\n"
  13696. "make\n"
  13697. msgstr ""
  13698. #. type: Plain text
  13699. #: ./bashref.texi:8271
  13700. msgid ""
  13701. "See @ref{Compiling For Multiple Architectures} for more information about "
  13702. "building in a directory separate from the source."
  13703. msgstr ""
  13704. #. type: Plain text
  13705. #: ./bashref.texi:8277
  13706. msgid ""
  13707. "If you need to do unusual things to compile Bash, please try to figure out "
  13708. "how @code{configure} could check whether or not to do them, and mail diffs "
  13709. "or instructions to @email{bash-maintainers@@gnu.org} so they can be "
  13710. "considered for the next release."
  13711. msgstr ""
  13712. #. type: Plain text
  13713. #: ./bashref.texi:8284
  13714. msgid ""
  13715. "The file @file{configure.ac} is used to create @code{configure} by a program "
  13716. "called Autoconf. You only need @file{configure.ac} if you want to change it "
  13717. "or regenerate @code{configure} using a newer version of Autoconf. If you do "
  13718. "this, make sure you are using Autoconf version 2.50 or newer."
  13719. msgstr ""
  13720. #. type: Plain text
  13721. #: ./bashref.texi:8289
  13722. msgid ""
  13723. "You can remove the program binaries and object files from the source code "
  13724. "directory by typing @samp{make clean}. To also remove the files that "
  13725. "@code{configure} created (so you can compile Bash for a different kind of "
  13726. "computer), type @samp{make distclean}."
  13727. msgstr ""
  13728. #. type: Plain text
  13729. #: ./bashref.texi:8298
  13730. msgid ""
  13731. "Some systems require unusual options for compilation or linking that the "
  13732. "@code{configure} script does not know about. You can give @code{configure} "
  13733. "initial values for variables by setting them in the environment. Using a "
  13734. "Bourne-compatible shell, you can do that on the command line like this:"
  13735. msgstr ""
  13736. #. type: example
  13737. #: ./bashref.texi:8301
  13738. #, no-wrap
  13739. msgid "CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure\n"
  13740. msgstr ""
  13741. #. type: Plain text
  13742. #: ./bashref.texi:8304
  13743. msgid "On systems that have the @code{env} program, you can do it like this:"
  13744. msgstr ""
  13745. #. type: example
  13746. #: ./bashref.texi:8307
  13747. #, no-wrap
  13748. msgid "env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure\n"
  13749. msgstr ""
  13750. #. type: Plain text
  13751. #: ./bashref.texi:8311
  13752. msgid "The configuration process uses GCC to build Bash if it is available."
  13753. msgstr ""
  13754. #. type: Plain text
  13755. #: ./bashref.texi:8327
  13756. msgid ""
  13757. "You can compile Bash for more than one kind of computer at the same time, by "
  13758. "placing the object files for each architecture in their own directory. To "
  13759. "do this, you must use a version of @code{make} that supports the "
  13760. "@code{VPATH} variable, such as GNU @code{make}. @code{cd} to the directory "
  13761. "where you want the object files and executables to go and run the "
  13762. "@code{configure} script from the source directory (@pxref{Basic "
  13763. "Installation}). You may need to supply the @option{--srcdir=PATH} argument "
  13764. "to tell @code{configure} where the source files are. @code{configure} "
  13765. "automatically checks for the source code in the directory that "
  13766. "@code{configure} is in and in `..'."
  13767. msgstr ""
  13768. #. type: Plain text
  13769. #: ./bashref.texi:8333
  13770. msgid ""
  13771. "If you have to use a @code{make} that does not supports the @code{VPATH} "
  13772. "variable, you can compile Bash for one architecture at a time in the source "
  13773. "code directory. After you have installed Bash for one architecture, use "
  13774. "@samp{make distclean} before reconfiguring for another architecture."
  13775. msgstr ""
  13776. #. type: Plain text
  13777. #: ./bashref.texi:8339
  13778. msgid ""
  13779. "Alternatively, if your system supports symbolic links, you can use the "
  13780. "@file{support/mkclone} script to create a build tree which has symbolic "
  13781. "links back to each file in the source directory. Here's an example that "
  13782. "creates a build directory in the current directory from a source directory "
  13783. "@file{/usr/gnu/src/bash-2.0}:"
  13784. msgstr ""
  13785. #. type: example
  13786. #: ./bashref.texi:8342
  13787. #, no-wrap
  13788. msgid "bash /usr/gnu/src/bash-2.0/support/mkclone -s /usr/gnu/src/bash-2.0 .\n"
  13789. msgstr ""
  13790. #. type: Plain text
  13791. #: ./bashref.texi:8348
  13792. msgid ""
  13793. "The @code{mkclone} script requires Bash, so you must have already built Bash "
  13794. "for at least one architecture before you can create build directories for "
  13795. "other architectures."
  13796. msgstr ""
  13797. #. type: Plain text
  13798. #: ./bashref.texi:8358
  13799. msgid ""
  13800. "By default, @samp{make install} will install into @file{/usr/local/bin}, "
  13801. "@file{/usr/local/man}, etc. You can specify an installation prefix other "
  13802. "than @file{/usr/local} by giving @code{configure} the option "
  13803. "@option{--prefix=@var{PATH}}, or by specifying a value for the "
  13804. "@code{DESTDIR} @samp{make} variable when running @samp{make install}."
  13805. msgstr ""
  13806. #. type: Plain text
  13807. #: ./bashref.texi:8365
  13808. msgid ""
  13809. "You can specify separate installation prefixes for architecture-specific "
  13810. "files and architecture-independent files. If you give @code{configure} the "
  13811. "option @option{--exec-prefix=@var{PATH}}, @samp{make install} will use "
  13812. "@var{PATH} as the prefix for installing programs and libraries. "
  13813. "Documentation and other data files will still use the regular prefix."
  13814. msgstr ""
  13815. #. type: Plain text
  13816. #: ./bashref.texi:8377
  13817. msgid ""
  13818. "There may be some features @code{configure} can not figure out "
  13819. "automatically, but need to determine by the type of host Bash will run on. "
  13820. "Usually @code{configure} can figure that out, but if it prints a message "
  13821. "saying it can not guess the host type, give it the @option{--host=TYPE} "
  13822. "option. @samp{TYPE} can either be a short name for the system type, such as "
  13823. "@samp{sun4}, or a canonical name with three fields: "
  13824. "@samp{CPU-COMPANY-SYSTEM} (e.g., @samp{i386-unknown-freebsd4.2})."
  13825. msgstr ""
  13826. #. type: Plain text
  13827. #: ./bashref.texi:8380
  13828. msgid ""
  13829. "See the file @file{support/config.sub} for the possible values of each "
  13830. "field."
  13831. msgstr ""
  13832. #. type: Plain text
  13833. #: ./bashref.texi:8393
  13834. msgid ""
  13835. "If you want to set default values for @code{configure} scripts to share, you "
  13836. "can create a site shell script called @code{config.site} that gives default "
  13837. "values for variables like @code{CC}, @code{cache_file}, and @code{prefix}. "
  13838. "@code{configure} looks for @file{PREFIX/share/config.site} if it exists, "
  13839. "then @file{PREFIX/etc/config.site} if it exists. Or, you can set the "
  13840. "@code{CONFIG_SITE} environment variable to the location of the site script. "
  13841. "A warning: the Bash @code{configure} looks for a site script, but not all "
  13842. "@code{configure} scripts do."
  13843. msgstr ""
  13844. #. type: Plain text
  13845. #: ./bashref.texi:8399
  13846. msgid ""
  13847. "@code{configure} recognizes the following options to control how it "
  13848. "operates."
  13849. msgstr ""
  13850. #. type: item
  13851. #: ./bashref.texi:8402
  13852. #, no-wrap
  13853. msgid "--cache-file=@var{file}"
  13854. msgstr ""
  13855. #. type: table
  13856. #: ./bashref.texi:8407
  13857. msgid ""
  13858. "Use and save the results of the tests in @var{file} instead of "
  13859. "@file{./config.cache}. Set @var{file} to @file{/dev/null} to disable "
  13860. "caching, for debugging @code{configure}."
  13861. msgstr ""
  13862. #. type: table
  13863. #: ./bashref.texi:8410
  13864. msgid "Print a summary of the options to @code{configure}, and exit."
  13865. msgstr ""
  13866. #. type: item
  13867. #: ./bashref.texi:8411
  13868. #, no-wrap
  13869. msgid "--quiet"
  13870. msgstr ""
  13871. #. type: itemx
  13872. #: ./bashref.texi:8412
  13873. #, no-wrap
  13874. msgid "--silent"
  13875. msgstr ""
  13876. #. type: table
  13877. #: ./bashref.texi:8415
  13878. msgid "Do not print messages saying which checks are being made."
  13879. msgstr ""
  13880. #. type: item
  13881. #: ./bashref.texi:8416
  13882. #, no-wrap
  13883. msgid "--srcdir=@var{dir}"
  13884. msgstr ""
  13885. #. type: table
  13886. #: ./bashref.texi:8419
  13887. msgid ""
  13888. "Look for the Bash source code in directory @var{dir}. Usually "
  13889. "@code{configure} can determine that directory automatically."
  13890. msgstr ""
  13891. #. type: table
  13892. #: ./bashref.texi:8423
  13893. msgid ""
  13894. "Print the version of Autoconf used to generate the @code{configure} script, "
  13895. "and exit."
  13896. msgstr ""
  13897. #. type: Plain text
  13898. #: ./bashref.texi:8427
  13899. msgid ""
  13900. "@code{configure} also accepts some other, not widely used, boilerplate "
  13901. "options. @samp{configure --help} prints the complete list."
  13902. msgstr ""
  13903. #. type: Plain text
  13904. #: ./bashref.texi:8438
  13905. msgid ""
  13906. "The Bash @code{configure} has a number of @option{--enable-@var{feature}} "
  13907. "options, where @var{feature} indicates an optional part of Bash. There are "
  13908. "also several @option{--with-@var{package}} options, where @var{package} is "
  13909. "something like @samp{bash-malloc} or @samp{purify}. To turn off the default "
  13910. "use of a package, use @option{--without-@var{package}}. To configure Bash "
  13911. "without a feature that is enabled by default, use "
  13912. "@option{--disable-@var{feature}}."
  13913. msgstr ""
  13914. #. type: Plain text
  13915. #: ./bashref.texi:8441
  13916. msgid ""
  13917. "Here is a complete list of the @option{--enable-} and @option{--with-} "
  13918. "options that the Bash @code{configure} recognizes."
  13919. msgstr ""
  13920. #. type: item
  13921. #: ./bashref.texi:8443
  13922. #, no-wrap
  13923. msgid "--with-afs"
  13924. msgstr ""
  13925. #. type: table
  13926. #: ./bashref.texi:8445
  13927. msgid "Define if you are using the Andrew File System from Transarc."
  13928. msgstr ""
  13929. #. type: item
  13930. #: ./bashref.texi:8446
  13931. #, no-wrap
  13932. msgid "--with-bash-malloc"
  13933. msgstr ""
  13934. #. type: table
  13935. #: ./bashref.texi:8456
  13936. msgid ""
  13937. "Use the Bash version of @code{malloc} in the directory @file{lib/malloc}. "
  13938. "This is not the same @code{malloc} that appears in @sc{gnu} libc, but an "
  13939. "older version originally derived from the 4.2 @sc{bsd} @code{malloc}. This "
  13940. "@code{malloc} is very fast, but wastes some space on each allocation. This "
  13941. "option is enabled by default. The @file{NOTES} file contains a list of "
  13942. "systems for which this should be turned off, and @code{configure} disables "
  13943. "this option automatically for a number of systems."
  13944. msgstr ""
  13945. #. type: item
  13946. #: ./bashref.texi:8457
  13947. #, no-wrap
  13948. msgid "--with-curses"
  13949. msgstr ""
  13950. #. type: table
  13951. #: ./bashref.texi:8461
  13952. msgid ""
  13953. "Use the curses library instead of the termcap library. This should be "
  13954. "supplied if your system has an inadequate or incomplete termcap database."
  13955. msgstr ""
  13956. #. type: item
  13957. #: ./bashref.texi:8462
  13958. #, no-wrap
  13959. msgid "--with-gnu-malloc"
  13960. msgstr ""
  13961. #. type: table
  13962. #: ./bashref.texi:8464
  13963. msgid "A synonym for @code{--with-bash-malloc}."
  13964. msgstr ""
  13965. #. type: item
  13966. #: ./bashref.texi:8465
  13967. #, no-wrap
  13968. msgid "--with-installed-readline[=@var{PREFIX}]"
  13969. msgstr ""
  13970. #. type: table
  13971. #: ./bashref.texi:8480
  13972. msgid ""
  13973. "Define this to make Bash link with a locally-installed version of Readline "
  13974. "rather than the version in @file{lib/readline}. This works only with "
  13975. "Readline 5.0 and later versions. If @var{PREFIX} is @code{yes} or not "
  13976. "supplied, @code{configure} uses the values of the make variables "
  13977. "@code{includedir} and @code{libdir}, which are subdirectories of "
  13978. "@code{prefix} by default, to find the installed version of Readline if it is "
  13979. "not in the standard system include and library directories. If @var{PREFIX} "
  13980. "is @code{no}, Bash links with the version in @file{lib/readline}. If "
  13981. "@var{PREFIX} is set to any other value, @code{configure} treats it as a "
  13982. "directory pathname and looks for the installed version of Readline in "
  13983. "subdirectories of that directory (include files in "
  13984. "@var{PREFIX}/@code{include} and the library in @var{PREFIX}/@code{lib})."
  13985. msgstr ""
  13986. #. type: item
  13987. #: ./bashref.texi:8481
  13988. #, no-wrap
  13989. msgid "--with-purify"
  13990. msgstr ""
  13991. #. type: table
  13992. #: ./bashref.texi:8484
  13993. msgid ""
  13994. "Define this to use the Purify memory allocation checker from Rational "
  13995. "Software."
  13996. msgstr ""
  13997. #. type: item
  13998. #: ./bashref.texi:8485
  13999. #, no-wrap
  14000. msgid "--enable-minimal-config"
  14001. msgstr ""
  14002. #. type: table
  14003. #: ./bashref.texi:8488
  14004. msgid ""
  14005. "This produces a shell with minimal features, close to the historical Bourne "
  14006. "shell."
  14007. msgstr ""
  14008. #. type: Plain text
  14009. #: ./bashref.texi:8492
  14010. msgid ""
  14011. "There are several @option{--enable-} options that alter how Bash is compiled "
  14012. "and linked, rather than changing run-time features."
  14013. msgstr ""
  14014. #. type: item
  14015. #: ./bashref.texi:8494
  14016. #, no-wrap
  14017. msgid "--enable-largefile"
  14018. msgstr ""
  14019. #. type: table
  14020. #: ./bashref.texi:8499
  14021. msgid ""
  14022. "Enable support for "
  14023. "@uref{http://www.unix.org/version2/whatsnew/lfs20mar.html, large files} if "
  14024. "the operating system requires special compiler options to build programs "
  14025. "which can access large files. This is enabled by default, if the operating "
  14026. "system provides large file support."
  14027. msgstr ""
  14028. #. type: item
  14029. #: ./bashref.texi:8500
  14030. #, no-wrap
  14031. msgid "--enable-profiling"
  14032. msgstr ""
  14033. #. type: table
  14034. #: ./bashref.texi:8503
  14035. msgid ""
  14036. "This builds a Bash binary that produces profiling information to be "
  14037. "processed by @code{gprof} each time it is executed."
  14038. msgstr ""
  14039. #. type: item
  14040. #: ./bashref.texi:8504
  14041. #, no-wrap
  14042. msgid "--enable-static-link"
  14043. msgstr ""
  14044. #. type: table
  14045. #: ./bashref.texi:8507
  14046. msgid ""
  14047. "This causes Bash to be linked statically, if @code{gcc} is being used. This "
  14048. "could be used to build a version to use as root's shell."
  14049. msgstr ""
  14050. #. type: Plain text
  14051. #: ./bashref.texi:8512
  14052. msgid ""
  14053. "The @samp{minimal-config} option can be used to disable all of the following "
  14054. "options, but it is processed first, so individual options may be enabled "
  14055. "using @samp{enable-@var{feature}}."
  14056. msgstr ""
  14057. #. type: Plain text
  14058. #: ./bashref.texi:8518
  14059. msgid ""
  14060. "All of the following options except for @samp{disabled-builtins}, "
  14061. "@samp{direxpand-default}, and @samp{xpg-echo-default} are enabled by "
  14062. "default, unless the operating system does not provide the necessary support."
  14063. msgstr ""
  14064. #. type: item
  14065. #: ./bashref.texi:8520
  14066. #, no-wrap
  14067. msgid "--enable-alias"
  14068. msgstr ""
  14069. #. type: table
  14070. #: ./bashref.texi:8523
  14071. msgid ""
  14072. "Allow alias expansion and include the @code{alias} and @code{unalias} "
  14073. "builtins (@pxref{Aliases})."
  14074. msgstr ""
  14075. #. type: item
  14076. #: ./bashref.texi:8524
  14077. #, no-wrap
  14078. msgid "--enable-arith-for-command"
  14079. msgstr ""
  14080. #. type: table
  14081. #: ./bashref.texi:8528
  14082. msgid ""
  14083. "Include support for the alternate form of the @code{for} command that "
  14084. "behaves like the C language @code{for} statement (@pxref{Looping "
  14085. "Constructs})."
  14086. msgstr ""
  14087. #. type: item
  14088. #: ./bashref.texi:8529
  14089. #, no-wrap
  14090. msgid "--enable-array-variables"
  14091. msgstr ""
  14092. #. type: table
  14093. #: ./bashref.texi:8532
  14094. msgid "Include support for one-dimensional array shell variables (@pxref{Arrays})."
  14095. msgstr ""
  14096. #. type: item
  14097. #: ./bashref.texi:8533
  14098. #, no-wrap
  14099. msgid "--enable-bang-history"
  14100. msgstr ""
  14101. #. type: table
  14102. #: ./bashref.texi:8536
  14103. msgid ""
  14104. "Include support for @code{csh}-like history substitution (@pxref{History "
  14105. "Interaction})."
  14106. msgstr ""
  14107. #. type: item
  14108. #: ./bashref.texi:8537
  14109. #, no-wrap
  14110. msgid "--enable-brace-expansion"
  14111. msgstr ""
  14112. #. type: table
  14113. #: ./bashref.texi:8541
  14114. msgid ""
  14115. "Include @code{csh}-like brace expansion ( @code{b@{a,b@}c} @expansion{} "
  14116. "@code{bac bbc} ). See @ref{Brace Expansion}, for a complete description."
  14117. msgstr ""
  14118. #. type: item
  14119. #: ./bashref.texi:8542
  14120. #, no-wrap
  14121. msgid "--enable-casemod-attributes"
  14122. msgstr ""
  14123. #. type: table
  14124. #: ./bashref.texi:8546
  14125. msgid ""
  14126. "Include support for case-modifying attributes in the @code{declare} builtin "
  14127. "and assignment statements. Variables with the @var{uppercase} attribute, "
  14128. "for example, will have their values converted to uppercase upon assignment."
  14129. msgstr ""
  14130. #. type: item
  14131. #: ./bashref.texi:8547
  14132. #, no-wrap
  14133. msgid "--enable-casemod-expansion"
  14134. msgstr ""
  14135. #. type: table
  14136. #: ./bashref.texi:8549
  14137. msgid "Include support for case-modifying word expansions."
  14138. msgstr ""
  14139. #. type: item
  14140. #: ./bashref.texi:8550
  14141. #, no-wrap
  14142. msgid "--enable-command-timing"
  14143. msgstr ""
  14144. #. type: table
  14145. #: ./bashref.texi:8555
  14146. msgid ""
  14147. "Include support for recognizing @code{time} as a reserved word and for "
  14148. "displaying timing statistics for the pipeline following @code{time} "
  14149. "(@pxref{Pipelines}). This allows pipelines as well as shell builtins and "
  14150. "functions to be timed."
  14151. msgstr ""
  14152. #. type: item
  14153. #: ./bashref.texi:8556
  14154. #, no-wrap
  14155. msgid "--enable-cond-command"
  14156. msgstr ""
  14157. #. type: table
  14158. #: ./bashref.texi:8559
  14159. msgid ""
  14160. "Include support for the @code{[[} conditional command. (@pxref{Conditional "
  14161. "Constructs})."
  14162. msgstr ""
  14163. #. type: item
  14164. #: ./bashref.texi:8560
  14165. #, no-wrap
  14166. msgid "--enable-cond-regexp"
  14167. msgstr ""
  14168. #. type: table
  14169. #: ./bashref.texi:8564
  14170. msgid ""
  14171. "Include support for matching @sc{posix} regular expressions using the "
  14172. "@samp{=~} binary operator in the @code{[[} conditional command. "
  14173. "(@pxref{Conditional Constructs})."
  14174. msgstr ""
  14175. #. type: item
  14176. #: ./bashref.texi:8565
  14177. #, no-wrap
  14178. msgid "--enable-coprocesses"
  14179. msgstr ""
  14180. #. type: table
  14181. #: ./bashref.texi:8568
  14182. msgid ""
  14183. "Include support for coprocesses and the @code{coproc} reserved word "
  14184. "(@pxref{Pipelines})."
  14185. msgstr ""
  14186. #. type: item
  14187. #: ./bashref.texi:8569
  14188. #, no-wrap
  14189. msgid "--enable-debugger"
  14190. msgstr ""
  14191. #. type: table
  14192. #: ./bashref.texi:8571
  14193. msgid "Include support for the bash debugger (distributed separately)."
  14194. msgstr ""
  14195. #. type: item
  14196. #: ./bashref.texi:8572
  14197. #, no-wrap
  14198. msgid "--enable-dev-fd-stat-broken"
  14199. msgstr ""
  14200. #. type: table
  14201. #: ./bashref.texi:8577
  14202. msgid ""
  14203. "If calling @code{stat} on /dev/fd/@var{N} returns different results than "
  14204. "calling @code{fstat} on file descriptor @var{N}, supply this option to "
  14205. "enable a workaround. This has implications for conditional commands that "
  14206. "test file attributes."
  14207. msgstr ""
  14208. #. type: item
  14209. #: ./bashref.texi:8578
  14210. #, no-wrap
  14211. msgid "--enable-direxpand-default"
  14212. msgstr ""
  14213. #. type: table
  14214. #: ./bashref.texi:8582
  14215. msgid ""
  14216. "Cause the @code{direxpand} shell option (@pxref{The Shopt Builtin}) to be "
  14217. "enabled by default when the shell starts. It is normally disabled by "
  14218. "default."
  14219. msgstr ""
  14220. #. type: item
  14221. #: ./bashref.texi:8583
  14222. #, no-wrap
  14223. msgid "--enable-directory-stack"
  14224. msgstr ""
  14225. #. type: table
  14226. #: ./bashref.texi:8587
  14227. msgid ""
  14228. "Include support for a @code{csh}-like directory stack and the @code{pushd}, "
  14229. "@code{popd}, and @code{dirs} builtins (@pxref{The Directory Stack})."
  14230. msgstr ""
  14231. #. type: item
  14232. #: ./bashref.texi:8588
  14233. #, no-wrap
  14234. msgid "--enable-disabled-builtins"
  14235. msgstr ""
  14236. #. type: table
  14237. #: ./bashref.texi:8593
  14238. msgid ""
  14239. "Allow builtin commands to be invoked via @samp{builtin xxx} even after "
  14240. "@code{xxx} has been disabled using @samp{enable -n xxx}. See @ref{Bash "
  14241. "Builtins}, for details of the @code{builtin} and @code{enable} builtin "
  14242. "commands."
  14243. msgstr ""
  14244. #. type: item
  14245. #: ./bashref.texi:8594
  14246. #, no-wrap
  14247. msgid "--enable-dparen-arithmetic"
  14248. msgstr ""
  14249. #. type: table
  14250. #: ./bashref.texi:8597
  14251. msgid ""
  14252. "Include support for the @code{((@dots{}))} command (@pxref{Conditional "
  14253. "Constructs})."
  14254. msgstr ""
  14255. #. type: item
  14256. #: ./bashref.texi:8598
  14257. #, no-wrap
  14258. msgid "--enable-extended-glob"
  14259. msgstr ""
  14260. #. type: table
  14261. #: ./bashref.texi:8601
  14262. msgid ""
  14263. "Include support for the extended pattern matching features described above "
  14264. "under @ref{Pattern Matching}."
  14265. msgstr ""
  14266. #. type: item
  14267. #: ./bashref.texi:8602
  14268. #, no-wrap
  14269. msgid "--enable-extended-glob-default"
  14270. msgstr ""
  14271. #. type: table
  14272. #: ./bashref.texi:8605
  14273. msgid ""
  14274. "Set the default value of the @var{extglob} shell option described above "
  14275. "under @ref{The Shopt Builtin} to be enabled."
  14276. msgstr ""
  14277. #. type: item
  14278. #: ./bashref.texi:8606
  14279. #, no-wrap
  14280. msgid "--enable-function-import"
  14281. msgstr ""
  14282. #. type: table
  14283. #: ./bashref.texi:8610
  14284. msgid ""
  14285. "Include support for importing function definitions exported by another "
  14286. "instance of the shell from the environment. This option is enabled by "
  14287. "default."
  14288. msgstr ""
  14289. #. type: item
  14290. #: ./bashref.texi:8611
  14291. #, no-wrap
  14292. msgid "--enable-glob-asciirange-default"
  14293. msgstr ""
  14294. #. type: table
  14295. #: ./bashref.texi:8616
  14296. msgid ""
  14297. "Set the default value of the @var{globasciiranges} shell option described "
  14298. "above under @ref{The Shopt Builtin} to be enabled. This controls the "
  14299. "behavior of character ranges when used in pattern matching bracket "
  14300. "expressions."
  14301. msgstr ""
  14302. #. type: item
  14303. #: ./bashref.texi:8617
  14304. #, no-wrap
  14305. msgid "--enable-help-builtin"
  14306. msgstr ""
  14307. #. type: table
  14308. #: ./bashref.texi:8620
  14309. msgid ""
  14310. "Include the @code{help} builtin, which displays help on shell builtins and "
  14311. "variables (@pxref{Bash Builtins})."
  14312. msgstr ""
  14313. #. type: item
  14314. #: ./bashref.texi:8621
  14315. #, no-wrap
  14316. msgid "--enable-history"
  14317. msgstr ""
  14318. #. type: table
  14319. #: ./bashref.texi:8624
  14320. msgid ""
  14321. "Include command history and the @code{fc} and @code{history} builtin "
  14322. "commands (@pxref{Bash History Facilities})."
  14323. msgstr ""
  14324. #. type: item
  14325. #: ./bashref.texi:8625
  14326. #, no-wrap
  14327. msgid "--enable-job-control"
  14328. msgstr ""
  14329. #. type: table
  14330. #: ./bashref.texi:8628
  14331. msgid ""
  14332. "This enables the job control features (@pxref{Job Control}), if the "
  14333. "operating system supports them."
  14334. msgstr ""
  14335. #. type: item
  14336. #: ./bashref.texi:8629
  14337. #, no-wrap
  14338. msgid "--enable-multibyte"
  14339. msgstr ""
  14340. #. type: table
  14341. #: ./bashref.texi:8632
  14342. msgid ""
  14343. "This enables support for multibyte characters if the operating system "
  14344. "provides the necessary support."
  14345. msgstr ""
  14346. #. type: item
  14347. #: ./bashref.texi:8633
  14348. #, no-wrap
  14349. msgid "--enable-net-redirections"
  14350. msgstr ""
  14351. #. type: table
  14352. #: ./bashref.texi:8638
  14353. msgid ""
  14354. "This enables the special handling of filenames of the form "
  14355. "@code{/dev/tcp/@var{host}/@var{port}} and "
  14356. "@code{/dev/udp/@var{host}/@var{port}} when used in redirections "
  14357. "(@pxref{Redirections})."
  14358. msgstr ""
  14359. #. type: item
  14360. #: ./bashref.texi:8639
  14361. #, no-wrap
  14362. msgid "--enable-process-substitution"
  14363. msgstr ""
  14364. #. type: table
  14365. #: ./bashref.texi:8642
  14366. msgid ""
  14367. "This enables process substitution (@pxref{Process Substitution}) if the "
  14368. "operating system provides the necessary support."
  14369. msgstr ""
  14370. #. type: item
  14371. #: ./bashref.texi:8643
  14372. #, no-wrap
  14373. msgid "--enable-progcomp"
  14374. msgstr ""
  14375. #. type: table
  14376. #: ./bashref.texi:8647
  14377. msgid ""
  14378. "Enable the programmable completion facilities (@pxref{Programmable "
  14379. "Completion}). If Readline is not enabled, this option has no effect."
  14380. msgstr ""
  14381. #. type: item
  14382. #: ./bashref.texi:8648
  14383. #, no-wrap
  14384. msgid "--enable-prompt-string-decoding"
  14385. msgstr ""
  14386. #. type: table
  14387. #: ./bashref.texi:8653
  14388. msgid ""
  14389. "Turn on the interpretation of a number of backslash-escaped characters in "
  14390. "the @env{$PS0}, @env{$PS1}, @env{$PS2}, and @env{$PS4} prompt strings. See "
  14391. "@ref{Controlling the Prompt}, for a complete list of prompt string escape "
  14392. "sequences."
  14393. msgstr ""
  14394. #. type: item
  14395. #: ./bashref.texi:8654
  14396. #, no-wrap
  14397. msgid "--enable-readline"
  14398. msgstr ""
  14399. #. type: table
  14400. #: ./bashref.texi:8657
  14401. msgid ""
  14402. "Include support for command-line editing and history with the Bash version "
  14403. "of the Readline library (@pxref{Command Line Editing})."
  14404. msgstr ""
  14405. #. type: item
  14406. #: ./bashref.texi:8658
  14407. #, no-wrap
  14408. msgid "--enable-restricted"
  14409. msgstr ""
  14410. #. type: table
  14411. #: ./bashref.texi:8662
  14412. msgid ""
  14413. "Include support for a @dfn{restricted shell}. If this is enabled, Bash, "
  14414. "when called as @code{rbash}, enters a restricted mode. See @ref{The "
  14415. "Restricted Shell}, for a description of restricted mode."
  14416. msgstr ""
  14417. #. type: item
  14418. #: ./bashref.texi:8663
  14419. #, no-wrap
  14420. msgid "--enable-select"
  14421. msgstr ""
  14422. #. type: table
  14423. #: ./bashref.texi:8666
  14424. msgid ""
  14425. "Include the @code{select} compound command, which allows the generation of "
  14426. "simple menus (@pxref{Conditional Constructs})."
  14427. msgstr ""
  14428. #. type: item
  14429. #: ./bashref.texi:8667
  14430. #, no-wrap
  14431. msgid "--enable-separate-helpfiles"
  14432. msgstr ""
  14433. #. type: table
  14434. #: ./bashref.texi:8670
  14435. msgid ""
  14436. "Use external files for the documentation displayed by the @code{help} "
  14437. "builtin instead of storing the text internally."
  14438. msgstr ""
  14439. #. type: item
  14440. #: ./bashref.texi:8671
  14441. #, no-wrap
  14442. msgid "--enable-single-help-strings"
  14443. msgstr ""
  14444. #. type: table
  14445. #: ./bashref.texi:8676
  14446. msgid ""
  14447. "Store the text displayed by the @code{help} builtin as a single string for "
  14448. "each help topic. This aids in translating the text to different languages. "
  14449. "You may need to disable this if your compiler cannot handle very long string "
  14450. "literals."
  14451. msgstr ""
  14452. #. type: item
  14453. #: ./bashref.texi:8677
  14454. #, no-wrap
  14455. msgid "--enable-strict-posix-default"
  14456. msgstr ""
  14457. #. type: table
  14458. #: ./bashref.texi:8679
  14459. msgid "Make Bash @sc{posix}-conformant by default (@pxref{Bash POSIX Mode})."
  14460. msgstr ""
  14461. #. type: item
  14462. #: ./bashref.texi:8680
  14463. #, no-wrap
  14464. msgid "--enable-usg-echo-default"
  14465. msgstr ""
  14466. #. type: table
  14467. #: ./bashref.texi:8682
  14468. msgid "A synonym for @code{--enable-xpg-echo-default}."
  14469. msgstr ""
  14470. #. type: item
  14471. #: ./bashref.texi:8683
  14472. #, no-wrap
  14473. msgid "--enable-xpg-echo-default"
  14474. msgstr ""
  14475. #. type: table
  14476. #: ./bashref.texi:8691
  14477. msgid ""
  14478. "Make the @code{echo} builtin expand backslash-escaped characters by default, "
  14479. "without requiring the @option{-e} option. This sets the default value of "
  14480. "the @code{xpg_echo} shell option to @code{on}, which makes the Bash "
  14481. "@code{echo} behave more like the version specified in the Single Unix "
  14482. "Specification, version 3. @xref{Bash Builtins}, for a description of the "
  14483. "escape sequences that @code{echo} recognizes."
  14484. msgstr ""
  14485. #. type: Plain text
  14486. #: ./bashref.texi:8700
  14487. msgid ""
  14488. "The file @file{config-top.h} contains C Preprocessor @samp{#define} "
  14489. "statements for options which are not settable from @code{configure}. Some "
  14490. "of these are not meant to be changed; beware of the consequences if you do. "
  14491. "Read the comments associated with each definition for more information about "
  14492. "its effect."
  14493. msgstr ""
  14494. #. type: Plain text
  14495. #: ./bashref.texi:8710
  14496. msgid ""
  14497. "Please report all bugs you find in Bash. But first, you should make sure "
  14498. "that it really is a bug, and that it appears in the latest version of Bash. "
  14499. "The latest version of Bash is always available for FTP from "
  14500. "@uref{ftp://ftp.gnu.org/pub/gnu/bash/}."
  14501. msgstr ""
  14502. #. type: Plain text
  14503. #: ./bashref.texi:8717
  14504. msgid ""
  14505. "Once you have determined that a bug actually exists, use the @code{bashbug} "
  14506. "command to submit a bug report. If you have a fix, you are encouraged to "
  14507. "mail that as well! Suggestions and `philosophical' bug reports may be mailed "
  14508. "to @email{bug-bash@@gnu.org} or posted to the Usenet newsgroup "
  14509. "@code{gnu.bash.bug}."
  14510. msgstr ""
  14511. #. type: Plain text
  14512. #: ./bashref.texi:8719
  14513. msgid "All bug reports should include:"
  14514. msgstr ""
  14515. #. type: itemize
  14516. #: ./bashref.texi:8722
  14517. msgid "The version number of Bash."
  14518. msgstr ""
  14519. #. type: itemize
  14520. #: ./bashref.texi:8724
  14521. msgid "The hardware and operating system."
  14522. msgstr ""
  14523. #. type: itemize
  14524. #: ./bashref.texi:8726
  14525. msgid "The compiler used to compile Bash."
  14526. msgstr ""
  14527. #. type: itemize
  14528. #: ./bashref.texi:8728
  14529. msgid "A description of the bug behaviour."
  14530. msgstr ""
  14531. #. type: itemize
  14532. #: ./bashref.texi:8731
  14533. msgid ""
  14534. "A short script or `recipe' which exercises the bug and may be used to "
  14535. "reproduce it."
  14536. msgstr ""
  14537. #. type: Plain text
  14538. #: ./bashref.texi:8736
  14539. msgid ""
  14540. "@code{bashbug} inserts the first three items automatically into the template "
  14541. "it provides for filing a bug report."
  14542. msgstr ""
  14543. #. type: Plain text
  14544. #: ./bashref.texi:8739
  14545. msgid "Please send all reports concerning this manual to @email{bug-bash@@gnu.org}."
  14546. msgstr ""
  14547. #. type: Plain text
  14548. #: ./bashref.texi:8753
  14549. msgid ""
  14550. "Bash implements essentially the same grammar, parameter and variable "
  14551. "expansion, redirection, and quoting as the Bourne Shell. Bash uses the "
  14552. "@sc{posix} standard as the specification of how these features are to be "
  14553. "implemented. There are some differences between the traditional Bourne "
  14554. "shell and Bash; this section quickly details the differences of "
  14555. "significance. A number of these differences are explained in greater depth "
  14556. "in previous sections. This section uses the version of @code{sh} included "
  14557. "in SVR4.2 (the last version of the historical Bourne shell) as the baseline "
  14558. "reference."
  14559. msgstr ""
  14560. #. type: itemize
  14561. #: ./bashref.texi:8759
  14562. msgid ""
  14563. "Bash is @sc{posix}-conformant, even where the @sc{posix} specification "
  14564. "differs from traditional @code{sh} behavior (@pxref{Bash POSIX Mode})."
  14565. msgstr ""
  14566. #. type: itemize
  14567. #: ./bashref.texi:8762
  14568. msgid "Bash has multi-character invocation options (@pxref{Invoking Bash})."
  14569. msgstr ""
  14570. #. type: itemize
  14571. #: ./bashref.texi:8766
  14572. msgid ""
  14573. "Bash has command-line editing (@pxref{Command Line Editing}) and the "
  14574. "@code{bind} builtin."
  14575. msgstr ""
  14576. #. type: itemize
  14577. #: ./bashref.texi:8772
  14578. msgid ""
  14579. "Bash provides a programmable word completion mechanism (@pxref{Programmable "
  14580. "Completion}), and builtin commands @code{complete}, @code{compgen}, and "
  14581. "@code{compopt}, to manipulate it."
  14582. msgstr ""
  14583. #. type: itemize
  14584. #: ./bashref.texi:8778
  14585. msgid ""
  14586. "Bash has command history (@pxref{Bash History Facilities}) and the "
  14587. "@code{history} and @code{fc} builtins to manipulate it. The Bash history "
  14588. "list maintains timestamp information and uses the value of the "
  14589. "@code{HISTTIMEFORMAT} variable to display it."
  14590. msgstr ""
  14591. #. type: itemize
  14592. #: ./bashref.texi:8782
  14593. msgid ""
  14594. "Bash implements @code{csh}-like history expansion (@pxref{History "
  14595. "Interaction})."
  14596. msgstr ""
  14597. #. type: itemize
  14598. #: ./bashref.texi:8788
  14599. msgid ""
  14600. "Bash has one-dimensional array variables (@pxref{Arrays}), and the "
  14601. "appropriate variable expansions and assignment syntax to use them. Several "
  14602. "of the Bash builtins take options to act on arrays. Bash provides a number "
  14603. "of built-in array variables."
  14604. msgstr ""
  14605. #. type: itemize
  14606. #: ./bashref.texi:8793
  14607. msgid ""
  14608. "The @code{$'@dots{}'} quoting syntax, which expands ANSI-C backslash-escaped "
  14609. "characters in the text between the single quotes, is supported "
  14610. "(@pxref{ANSI-C Quoting})."
  14611. msgstr ""
  14612. #. type: itemize
  14613. #: ./bashref.texi:8800
  14614. msgid ""
  14615. "Bash supports the @code{$\"@dots{}\"} quoting syntax to do locale-specific "
  14616. "translation of the characters between the double quotes. The @option{-D}, "
  14617. "@option{--dump-strings}, and @option{--dump-po-strings} invocation options "
  14618. "list the translatable strings found in a script (@pxref{Locale "
  14619. "Translation})."
  14620. msgstr ""
  14621. #. type: itemize
  14622. #: ./bashref.texi:8807
  14623. msgid ""
  14624. "Bash implements the @code{!} keyword to negate the return value of a "
  14625. "pipeline (@pxref{Pipelines}). Very useful when an @code{if} statement needs "
  14626. "to act only if a test fails. The Bash @samp{-o pipefail} option to "
  14627. "@code{set} will cause a pipeline to return a failure status if any command "
  14628. "fails."
  14629. msgstr ""
  14630. #. type: itemize
  14631. #: ./bashref.texi:8812
  14632. msgid ""
  14633. "Bash has the @code{time} reserved word and command timing "
  14634. "(@pxref{Pipelines}). The display of the timing statistics may be controlled "
  14635. "with the @env{TIMEFORMAT} variable."
  14636. msgstr ""
  14637. #. type: itemize
  14638. #: ./bashref.texi:8816
  14639. msgid ""
  14640. "Bash implements the @code{for (( @var{expr1} ; @var{expr2} ; @var{expr3} ))} "
  14641. "arithmetic for command, similar to the C language (@pxref{Looping "
  14642. "Constructs})."
  14643. msgstr ""
  14644. #. type: itemize
  14645. #: ./bashref.texi:8820
  14646. msgid ""
  14647. "Bash includes the @code{select} compound command, which allows the "
  14648. "generation of simple menus (@pxref{Conditional Constructs})."
  14649. msgstr ""
  14650. #. type: itemize
  14651. #: ./bashref.texi:8825
  14652. msgid ""
  14653. "Bash includes the @code{[[} compound command, which makes conditional "
  14654. "testing part of the shell grammar (@pxref{Conditional Constructs}), "
  14655. "including optional regular expression matching."
  14656. msgstr ""
  14657. #. type: itemize
  14658. #: ./bashref.texi:8829
  14659. msgid ""
  14660. "Bash provides optional case-insensitive matching for the @code{case} and "
  14661. "@code{[[} constructs."
  14662. msgstr ""
  14663. #. type: itemize
  14664. #: ./bashref.texi:8833
  14665. msgid ""
  14666. "Bash includes brace expansion (@pxref{Brace Expansion}) and tilde expansion "
  14667. "(@pxref{Tilde Expansion})."
  14668. msgstr ""
  14669. #. type: itemize
  14670. #: ./bashref.texi:8837
  14671. msgid ""
  14672. "Bash implements command aliases and the @code{alias} and @code{unalias} "
  14673. "builtins (@pxref{Aliases})."
  14674. msgstr ""
  14675. #. type: itemize
  14676. #: ./bashref.texi:8842
  14677. msgid ""
  14678. "Bash provides shell arithmetic, the @code{((} compound command "
  14679. "(@pxref{Conditional Constructs}), and arithmetic expansion (@pxref{Shell "
  14680. "Arithmetic})."
  14681. msgstr ""
  14682. #. type: itemize
  14683. #: ./bashref.texi:8848
  14684. msgid ""
  14685. "Variables present in the shell's initial environment are automatically "
  14686. "exported to child processes. The Bourne shell does not normally do this "
  14687. "unless the variables are explicitly marked using the @code{export} command."
  14688. msgstr ""
  14689. #. type: itemize
  14690. #: ./bashref.texi:8852
  14691. msgid ""
  14692. "Bash supports the @samp{+=} assignment operator, which appends to the value "
  14693. "of the variable named on the left hand side."
  14694. msgstr ""
  14695. #. type: itemize
  14696. #: ./bashref.texi:8857
  14697. msgid ""
  14698. "Bash includes the @sc{posix} pattern removal @samp{%}, @samp{#}, @samp{%%} "
  14699. "and @samp{##} expansions to remove leading or trailing substrings from "
  14700. "variable values (@pxref{Shell Parameter Expansion})."
  14701. msgstr ""
  14702. #. type: itemize
  14703. #: ./bashref.texi:8861
  14704. msgid ""
  14705. "The expansion @code{$@{#xx@}}, which returns the length of @code{$@{xx@}}, "
  14706. "is supported (@pxref{Shell Parameter Expansion})."
  14707. msgstr ""
  14708. #. type: itemize
  14709. #: ./bashref.texi:8867
  14710. msgid ""
  14711. "The expansion @code{$@{var:}@var{offset}@code{[:}@var{length}@code{]@}}, "
  14712. "which expands to the substring of @code{var}'s value of length @var{length}, "
  14713. "beginning at @var{offset}, is present (@pxref{Shell Parameter Expansion})."
  14714. msgstr ""
  14715. #. type: itemize
  14716. #: ./bashref.texi:8873
  14717. msgid ""
  14718. "The expansion "
  14719. "@code{$@{var/[/]}@var{pattern}@code{[/}@var{replacement}@code{]@}}, which "
  14720. "matches @var{pattern} and replaces it with @var{replacement} in the value of "
  14721. "@code{var}, is available (@pxref{Shell Parameter Expansion})."
  14722. msgstr ""
  14723. #. type: itemize
  14724. #: ./bashref.texi:8878
  14725. msgid ""
  14726. "The expansion @code{$@{!@var{prefix}*@}} expansion, which expands to the "
  14727. "names of all shell variables whose names begin with @var{prefix}, is "
  14728. "available (@pxref{Shell Parameter Expansion})."
  14729. msgstr ""
  14730. #. type: itemize
  14731. #: ./bashref.texi:8882
  14732. msgid ""
  14733. "Bash has @var{indirect} variable expansion using @code{$@{!word@}} "
  14734. "(@pxref{Shell Parameter Expansion})."
  14735. msgstr ""
  14736. #. type: itemize
  14737. #: ./bashref.texi:8886
  14738. msgid ""
  14739. "Bash can expand positional parameters beyond @code{$9} using "
  14740. "@code{$@{@var{num}@}}."
  14741. msgstr ""
  14742. #. type: itemize
  14743. #: ./bashref.texi:8892
  14744. msgid ""
  14745. "The @sc{posix} @code{$()} form of command substitution is implemented "
  14746. "(@pxref{Command Substitution}), and preferred to the Bourne shell's "
  14747. "@code{``} (which is also implemented for backwards compatibility)."
  14748. msgstr ""
  14749. #. type: itemize
  14750. #: ./bashref.texi:8895
  14751. msgid "Bash has process substitution (@pxref{Process Substitution})."
  14752. msgstr ""
  14753. #. type: itemize
  14754. #: ./bashref.texi:8903
  14755. msgid ""
  14756. "Bash automatically assigns variables that provide information about the "
  14757. "current user (@env{UID}, @env{EUID}, and @env{GROUPS}), the current host "
  14758. "(@env{HOSTTYPE}, @env{OSTYPE}, @env{MACHTYPE}, and @env{HOSTNAME}), and the "
  14759. "instance of Bash that is running (@env{BASH}, @env{BASH_VERSION}, and "
  14760. "@env{BASH_VERSINFO}). @xref{Bash Variables}, for details."
  14761. msgstr ""
  14762. #. type: itemize
  14763. #: ./bashref.texi:8908
  14764. msgid ""
  14765. "The @env{IFS} variable is used to split only the results of expansion, not "
  14766. "all words (@pxref{Word Splitting}). This closes a longstanding shell "
  14767. "security hole."
  14768. msgstr ""
  14769. #. type: itemize
  14770. #: ./bashref.texi:8913
  14771. msgid ""
  14772. "The filename expansion bracket expression code uses @samp{!} and @samp{^} to "
  14773. "negate the set of characters between the brackets. The Bourne shell uses "
  14774. "only @samp{!}."
  14775. msgstr ""
  14776. #. type: itemize
  14777. #: ./bashref.texi:8918
  14778. msgid ""
  14779. "Bash implements the full set of @sc{posix} filename expansion operators, "
  14780. "including @var{character classes}, @var{equivalence classes}, and "
  14781. "@var{collating symbols} (@pxref{Filename Expansion})."
  14782. msgstr ""
  14783. #. type: itemize
  14784. #: ./bashref.texi:8922
  14785. msgid ""
  14786. "Bash implements extended pattern matching features when the @code{extglob} "
  14787. "shell option is enabled (@pxref{Pattern Matching})."
  14788. msgstr ""
  14789. #. type: itemize
  14790. #: ./bashref.texi:8926
  14791. msgid ""
  14792. "It is possible to have a variable and a function with the same name; "
  14793. "@code{sh} does not separate the two name spaces."
  14794. msgstr ""
  14795. #. type: itemize
  14796. #: ./bashref.texi:8931
  14797. msgid ""
  14798. "Bash functions are permitted to have local variables using the @code{local} "
  14799. "builtin, and thus useful recursive functions may be written (@pxref{Bash "
  14800. "Builtins})."
  14801. msgstr ""
  14802. #. type: itemize
  14803. #: ./bashref.texi:8938
  14804. msgid ""
  14805. "Variable assignments preceding commands affect only that command, even "
  14806. "builtins and functions (@pxref{Environment}). In @code{sh}, all variable "
  14807. "assignments preceding commands are global unless the command is executed "
  14808. "from the file system."
  14809. msgstr ""
  14810. #. type: itemize
  14811. #: ./bashref.texi:8942
  14812. msgid ""
  14813. "Bash performs filename expansion on filenames specified as operands to input "
  14814. "and output redirection operators (@pxref{Redirections})."
  14815. msgstr ""
  14816. #. type: itemize
  14817. #: ./bashref.texi:8948
  14818. msgid ""
  14819. "Bash contains the @samp{<>} redirection operator, allowing a file to be "
  14820. "opened for both reading and writing, and the @samp{&>} redirection operator, "
  14821. "for directing standard output and standard error to the same file "
  14822. "(@pxref{Redirections})."
  14823. msgstr ""
  14824. #. type: itemize
  14825. #: ./bashref.texi:8952
  14826. msgid ""
  14827. "Bash includes the @samp{<<<} redirection operator, allowing a string to be "
  14828. "used as the standard input to a command."
  14829. msgstr ""
  14830. #. type: itemize
  14831. #: ./bashref.texi:8956
  14832. msgid ""
  14833. "Bash implements the @samp{[n]<&@var{word}} and @samp{[n]>&@var{word}} "
  14834. "redirection operators, which move one file descriptor to another."
  14835. msgstr ""
  14836. #. type: itemize
  14837. #: ./bashref.texi:8960
  14838. msgid ""
  14839. "Bash treats a number of filenames specially when they are used in "
  14840. "redirection operators (@pxref{Redirections})."
  14841. msgstr ""
  14842. #. type: itemize
  14843. #: ./bashref.texi:8964
  14844. msgid ""
  14845. "Bash can open network connections to arbitrary machines and services with "
  14846. "the redirection operators (@pxref{Redirections})."
  14847. msgstr ""
  14848. #. type: itemize
  14849. #: ./bashref.texi:8969
  14850. msgid ""
  14851. "The @code{noclobber} option is available to avoid overwriting existing files "
  14852. "with output redirection (@pxref{The Set Builtin}). The @samp{>|} "
  14853. "redirection operator may be used to override @code{noclobber}."
  14854. msgstr ""
  14855. #. type: itemize
  14856. #: ./bashref.texi:8974
  14857. msgid ""
  14858. "The Bash @code{cd} and @code{pwd} builtins (@pxref{Bourne Shell Builtins}) "
  14859. "each take @option{-L} and @option{-P} options to switch between logical and "
  14860. "physical modes."
  14861. msgstr ""
  14862. #. type: itemize
  14863. #: ./bashref.texi:8979
  14864. msgid ""
  14865. "Bash allows a function to override a builtin with the same name, and "
  14866. "provides access to that builtin's functionality within the function via the "
  14867. "@code{builtin} and @code{command} builtins (@pxref{Bash Builtins})."
  14868. msgstr ""
  14869. #. type: itemize
  14870. #: ./bashref.texi:8983
  14871. msgid ""
  14872. "The @code{command} builtin allows selective disabling of functions when "
  14873. "command lookup is performed (@pxref{Bash Builtins})."
  14874. msgstr ""
  14875. #. type: itemize
  14876. #: ./bashref.texi:8987
  14877. msgid ""
  14878. "Individual builtins may be enabled or disabled using the @code{enable} "
  14879. "builtin (@pxref{Bash Builtins})."
  14880. msgstr ""
  14881. #. type: itemize
  14882. #: ./bashref.texi:8993
  14883. msgid ""
  14884. "The Bash @code{exec} builtin takes additional options that allow users to "
  14885. "control the contents of the environment passed to the executed command, and "
  14886. "what the zeroth argument to the command is to be (@pxref{Bourne Shell "
  14887. "Builtins})."
  14888. msgstr ""
  14889. #. type: itemize
  14890. #: ./bashref.texi:8997
  14891. msgid ""
  14892. "Shell functions may be exported to children via the environment using "
  14893. "@code{export -f} (@pxref{Shell Functions})."
  14894. msgstr ""
  14895. #. type: itemize
  14896. #: ./bashref.texi:9005
  14897. msgid ""
  14898. "The Bash @code{export}, @code{readonly}, and @code{declare} builtins can "
  14899. "take a @option{-f} option to act on shell functions, a @option{-p} option to "
  14900. "display variables with various attributes set in a format that can be used "
  14901. "as shell input, a @option{-n} option to remove various variable attributes, "
  14902. "and @samp{name=value} arguments to set variable attributes and values "
  14903. "simultaneously."
  14904. msgstr ""
  14905. #. type: itemize
  14906. #: ./bashref.texi:9011
  14907. msgid ""
  14908. "The Bash @code{hash} builtin allows a name to be associated with an "
  14909. "arbitrary filename, even when that filename cannot be found by searching the "
  14910. "@env{$PATH}, using @samp{hash -p} (@pxref{Bourne Shell Builtins})."
  14911. msgstr ""
  14912. #. type: itemize
  14913. #: ./bashref.texi:9015
  14914. msgid ""
  14915. "Bash includes a @code{help} builtin for quick reference to shell facilities "
  14916. "(@pxref{Bash Builtins})."
  14917. msgstr ""
  14918. #. type: itemize
  14919. #: ./bashref.texi:9019
  14920. msgid ""
  14921. "The @code{printf} builtin is available to display formatted output "
  14922. "(@pxref{Bash Builtins})."
  14923. msgstr ""
  14924. #. type: itemize
  14925. #: ./bashref.texi:9035
  14926. msgid ""
  14927. "The Bash @code{read} builtin (@pxref{Bash Builtins}) will read a line "
  14928. "ending in @samp{\\} with the @option{-r} option, and will use the "
  14929. "@env{REPLY} variable as a default if no non-option arguments are supplied. "
  14930. "The Bash @code{read} builtin also accepts a prompt string with the "
  14931. "@option{-p} option and will use Readline to obtain the line when given the "
  14932. "@option{-e} option. The @code{read} builtin also has additional options to "
  14933. "control input: the @option{-s} option will turn off echoing of input "
  14934. "characters as they are read, the @option{-t} option will allow @code{read} "
  14935. "to time out if input does not arrive within a specified number of seconds, "
  14936. "the @option{-n} option will allow reading only a specified number of "
  14937. "characters rather than a full line, and the @option{-d} option will read "
  14938. "until a particular character rather than newline."
  14939. msgstr ""
  14940. #. type: itemize
  14941. #: ./bashref.texi:9040
  14942. msgid ""
  14943. "The @code{return} builtin may be used to abort execution of scripts executed "
  14944. "with the @code{.} or @code{source} builtins (@pxref{Bourne Shell Builtins})."
  14945. msgstr ""
  14946. #. type: itemize
  14947. #: ./bashref.texi:9045
  14948. msgid ""
  14949. "Bash includes the @code{shopt} builtin, for finer control of shell optional "
  14950. "capabilities (@pxref{The Shopt Builtin}), and allows these options to be set "
  14951. "and unset at shell invocation (@pxref{Invoking Bash})."
  14952. msgstr ""
  14953. #. type: itemize
  14954. #: ./bashref.texi:9049
  14955. msgid ""
  14956. "Bash has much more optional behavior controllable with the @code{set} "
  14957. "builtin (@pxref{The Set Builtin})."
  14958. msgstr ""
  14959. #. type: itemize
  14960. #: ./bashref.texi:9054
  14961. msgid ""
  14962. "The @samp{-x} (@option{xtrace}) option displays commands other than simple "
  14963. "commands when performing an execution trace (@pxref{The Set Builtin})."
  14964. msgstr ""
  14965. #. type: itemize
  14966. #: ./bashref.texi:9059
  14967. msgid ""
  14968. "The @code{test} builtin (@pxref{Bourne Shell Builtins}) is slightly "
  14969. "different, as it implements the @sc{posix} algorithm, which specifies the "
  14970. "behavior based on the number of arguments."
  14971. msgstr ""
  14972. #. type: itemize
  14973. #: ./bashref.texi:9065
  14974. msgid ""
  14975. "Bash includes the @code{caller} builtin, which displays the context of any "
  14976. "active subroutine call (a shell function or a script executed with the "
  14977. "@code{.} or @code{source} builtins). This supports the bash debugger."
  14978. msgstr ""
  14979. #. type: itemize
  14980. #: ./bashref.texi:9078
  14981. msgid ""
  14982. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows a "
  14983. "@code{DEBUG} pseudo-signal specification, similar to @code{EXIT}. Commands "
  14984. "specified with a @code{DEBUG} trap are executed before every simple command, "
  14985. "@code{for} command, @code{case} command, @code{select} command, every "
  14986. "arithmetic @code{for} command, and before the first command executes in a "
  14987. "shell function. The @code{DEBUG} trap is not inherited by shell functions "
  14988. "unless the function has been given the @code{trace} attribute or the "
  14989. "@code{functrace} option has been enabled using the @code{shopt} builtin. "
  14990. "The @code{extdebug} shell option has additional effects on the @code{DEBUG} "
  14991. "trap."
  14992. msgstr ""
  14993. #. type: itemize
  14994. #: ./bashref.texi:9085
  14995. msgid ""
  14996. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows an @code{ERR} "
  14997. "pseudo-signal specification, similar to @code{EXIT} and @code{DEBUG}. "
  14998. "Commands specified with an @code{ERR} trap are executed after a simple "
  14999. "command fails, with a few exceptions. The @code{ERR} trap is not inherited "
  15000. "by shell functions unless the @code{-o errtrace} option to the @code{set} "
  15001. "builtin is enabled."
  15002. msgstr ""
  15003. #. type: itemize
  15004. #: ./bashref.texi:9095
  15005. msgid ""
  15006. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows a "
  15007. "@code{RETURN} pseudo-signal specification, similar to @code{EXIT} and "
  15008. "@code{DEBUG}. Commands specified with an @code{RETURN} trap are executed "
  15009. "before execution resumes after a shell function or a shell script executed "
  15010. "with @code{.} or @code{source} returns. The @code{RETURN} trap is not "
  15011. "inherited by shell functions unless the function has been given the "
  15012. "@code{trace} attribute or the @code{functrace} option has been enabled using "
  15013. "the @code{shopt} builtin."
  15014. msgstr ""
  15015. #. type: itemize
  15016. #: ./bashref.texi:9099
  15017. msgid ""
  15018. "The Bash @code{type} builtin is more extensive and gives more information "
  15019. "about the names it finds (@pxref{Bash Builtins})."
  15020. msgstr ""
  15021. #. type: itemize
  15022. #: ./bashref.texi:9104
  15023. msgid ""
  15024. "The Bash @code{umask} builtin permits a @option{-p} option to cause the "
  15025. "output to be displayed in the form of a @code{umask} command that may be "
  15026. "reused as input (@pxref{Bourne Shell Builtins})."
  15027. msgstr ""
  15028. #. type: itemize
  15029. #: ./bashref.texi:9111
  15030. msgid ""
  15031. "Bash implements a @code{csh}-like directory stack, and provides the "
  15032. "@code{pushd}, @code{popd}, and @code{dirs} builtins to manipulate it "
  15033. "(@pxref{The Directory Stack}). Bash also makes the directory stack visible "
  15034. "as the value of the @env{DIRSTACK} shell variable."
  15035. msgstr ""
  15036. #. type: itemize
  15037. #: ./bashref.texi:9115
  15038. msgid ""
  15039. "Bash interprets special backslash-escaped characters in the prompt strings "
  15040. "when interactive (@pxref{Controlling the Prompt})."
  15041. msgstr ""
  15042. #. type: itemize
  15043. #: ./bashref.texi:9119
  15044. msgid ""
  15045. "The Bash restricted mode is more useful (@pxref{The Restricted Shell}); the "
  15046. "SVR4.2 shell restricted mode is too limited."
  15047. msgstr ""
  15048. #. type: itemize
  15049. #: ./bashref.texi:9125
  15050. msgid ""
  15051. "The @code{disown} builtin can remove a job from the internal shell job table "
  15052. "(@pxref{Job Control Builtins}) or suppress the sending of @code{SIGHUP} to a "
  15053. "job when the shell exits as the result of a @code{SIGHUP}."
  15054. msgstr ""
  15055. #. type: itemize
  15056. #: ./bashref.texi:9129
  15057. msgid ""
  15058. "Bash includes a number of features to support a separate debugger for shell "
  15059. "scripts."
  15060. msgstr ""
  15061. #. type: itemize
  15062. #: ./bashref.texi:9133
  15063. msgid ""
  15064. "The SVR4.2 shell has two privilege-related builtins (@code{mldmode} and "
  15065. "@code{priv}) not present in Bash."
  15066. msgstr ""
  15067. #. type: itemize
  15068. #: ./bashref.texi:9136
  15069. msgid "Bash does not have the @code{stop} or @code{newgrp} builtins."
  15070. msgstr ""
  15071. #. type: itemize
  15072. #: ./bashref.texi:9139
  15073. msgid "Bash does not use the @env{SHACCT} variable or perform shell accounting."
  15074. msgstr ""
  15075. #. type: itemize
  15076. #: ./bashref.texi:9143
  15077. msgid ""
  15078. "The SVR4.2 @code{sh} uses a @env{TIMEOUT} variable like Bash uses "
  15079. "@env{TMOUT}."
  15080. msgstr ""
  15081. #. type: Plain text
  15082. #: ./bashref.texi:9148
  15083. msgid "More features unique to Bash may be found in @ref{Bash Features}."
  15084. msgstr ""
  15085. #. type: appendixsec
  15086. #: ./bashref.texi:9150
  15087. #, no-wrap
  15088. msgid "Implementation Differences From The SVR4.2 Shell"
  15089. msgstr ""
  15090. #. type: Plain text
  15091. #: ./bashref.texi:9154
  15092. msgid ""
  15093. "Since Bash is a completely new implementation, it does not suffer from many "
  15094. "of the limitations of the SVR4.2 shell. For instance:"
  15095. msgstr ""
  15096. #. type: itemize
  15097. #: ./bashref.texi:9161
  15098. msgid ""
  15099. "Bash does not fork a subshell when redirecting into or out of a shell "
  15100. "control structure such as an @code{if} or @code{while} statement."
  15101. msgstr ""
  15102. #. type: itemize
  15103. #: ./bashref.texi:9166
  15104. msgid ""
  15105. "Bash does not allow unbalanced quotes. The SVR4.2 shell will silently "
  15106. "insert a needed closing quote at @code{EOF} under certain circumstances. "
  15107. "This can be the cause of some hard-to-find errors."
  15108. msgstr ""
  15109. #. type: itemize
  15110. #: ./bashref.texi:9172
  15111. msgid ""
  15112. "The SVR4.2 shell uses a baroque memory management scheme based on trapping "
  15113. "@code{SIGSEGV}. If the shell is started from a process with @code{SIGSEGV} "
  15114. "blocked (e.g., by using the @code{system()} C library function call), it "
  15115. "misbehaves badly."
  15116. msgstr ""
  15117. #. type: itemize
  15118. #: ./bashref.texi:9179
  15119. msgid ""
  15120. "In a questionable attempt at security, the SVR4.2 shell, when invoked "
  15121. "without the @option{-p} option, will alter its real and effective @sc{uid} "
  15122. "and @sc{gid} if they are less than some magic threshold value, commonly "
  15123. "100. This can lead to unexpected results."
  15124. msgstr ""
  15125. #. type: itemize
  15126. #: ./bashref.texi:9183
  15127. msgid ""
  15128. "The SVR4.2 shell does not allow users to trap @code{SIGSEGV}, "
  15129. "@code{SIGALRM}, or @code{SIGCHLD}."
  15130. msgstr ""
  15131. #. type: itemize
  15132. #: ./bashref.texi:9187
  15133. msgid ""
  15134. "The SVR4.2 shell does not allow the @env{IFS}, @env{MAILCHECK}, @env{PATH}, "
  15135. "@env{PS1}, or @env{PS2} variables to be unset."
  15136. msgstr ""
  15137. #. type: itemize
  15138. #: ./bashref.texi:9191
  15139. msgid "The SVR4.2 shell treats @samp{^} as the undocumented equivalent of @samp{|}."
  15140. msgstr ""
  15141. #. type: itemize
  15142. #: ./bashref.texi:9197
  15143. msgid ""
  15144. "Bash allows multiple option arguments when it is invoked (@code{-x -v}); the "
  15145. "SVR4.2 shell allows only one option argument (@code{-xv}). In fact, some "
  15146. "versions of the shell dump core if the second argument begins with a "
  15147. "@samp{-}."
  15148. msgstr ""
  15149. #. type: itemize
  15150. #: ./bashref.texi:9202
  15151. msgid ""
  15152. "The SVR4.2 shell exits a script if any builtin fails; Bash exits a script "
  15153. "only if one of the @sc{posix} special builtins fails, and only for certain "
  15154. "failures, as enumerated in the @sc{posix} standard."
  15155. msgstr ""
  15156. #. type: itemize
  15157. #: ./bashref.texi:9206
  15158. msgid ""
  15159. "The SVR4.2 shell behaves differently when invoked as @code{jsh} (it turns on "
  15160. "job control)."
  15161. msgstr ""
  15162. #. type: include
  15163. #: ./bashref.texi:9211
  15164. #, no-wrap
  15165. msgid "fdl.texi"
  15166. msgstr ""
  15167. #. type: node
  15168. #: ./bashref.texi:9224 ./bashref.texi:9226
  15169. #, no-wrap
  15170. msgid "Builtin Index"
  15171. msgstr ""
  15172. #. type: menuentry
  15173. #: ./bashref.texi:9224
  15174. msgid "Index of Bash builtin commands."
  15175. msgstr ""
  15176. #. type: node
  15177. #: ./bashref.texi:9224 ./bashref.texi:9230
  15178. #, no-wrap
  15179. msgid "Reserved Word Index"
  15180. msgstr ""
  15181. #. type: menuentry
  15182. #: ./bashref.texi:9224
  15183. msgid "Index of Bash reserved words."
  15184. msgstr ""
  15185. #. type: node
  15186. #: ./bashref.texi:9224 ./bashref.texi:9234
  15187. #, no-wrap
  15188. msgid "Variable Index"
  15189. msgstr ""
  15190. #. type: menuentry
  15191. #: ./bashref.texi:9224
  15192. msgid "Quick reference helps you find the variable you want."
  15193. msgstr ""
  15194. #. type: appendixsec
  15195. #: ./bashref.texi:9224 ./bashref.texi:9238 ./bashref.texi:9239
  15196. #, no-wrap
  15197. msgid "Function Index"
  15198. msgstr ""
  15199. #. type: menuentry
  15200. #: ./bashref.texi:9224
  15201. msgid "Index of bindable Readline functions."
  15202. msgstr ""
  15203. #. type: appendixsec
  15204. #: ./bashref.texi:9224 ./bashref.texi:9242 ./bashref.texi:9243
  15205. #, no-wrap
  15206. msgid "Concept Index"
  15207. msgstr ""
  15208. #. type: menuentry
  15209. #: ./bashref.texi:9224
  15210. msgid "General index for concepts described in this manual."
  15211. msgstr ""
  15212. #. type: appendixsec
  15213. #: ./bashref.texi:9227
  15214. #, no-wrap
  15215. msgid "Index of Shell Builtin Commands"
  15216. msgstr ""
  15217. #. type: appendixsec
  15218. #: ./bashref.texi:9231
  15219. #, no-wrap
  15220. msgid "Index of Shell Reserved Words"
  15221. msgstr ""
  15222. #. type: appendixsec
  15223. #: ./bashref.texi:9235
  15224. #, no-wrap
  15225. msgid "Parameter and Variable Index"
  15226. msgstr ""