bashref.pot 468 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) YEAR Free Software Foundation, Inc.
  3. # This file is distributed under the same license as the PACKAGE package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: PACKAGE VERSION\n"
  10. "POT-Creation-Date: 2018-01-24 17:11+0100\n"
  11. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13. "Language-Team: LANGUAGE <LL@li.org>\n"
  14. "Language: \n"
  15. "MIME-Version: 1.0\n"
  16. "Content-Type: text/plain; charset=CHARSET\n"
  17. "Content-Transfer-Encoding: 8bit\n"
  18. #. type: 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--2016 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:6157 ./bashref.texi:6158
  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:3229 ./bashref.texi:3230
  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:5377 ./bashref.texi:5378
  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:7622 ./bashref.texi:7623
  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:7918 ./bashref.texi:7919
  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:8427 ./bashref.texi:8428
  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:8466 ./bashref.texi:8467
  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:8934 ./bashref.texi:8935
  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:8939 ./bashref.texi:8940
  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:3943 ./bashref.texi:3944
  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:3086
  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:7638
  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:5348
  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:1323 ./bashref.texi:1324
  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:1450 ./bashref.texi:1451
  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:1661 ./bashref.texi:1662
  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:2543 ./bashref.texi:2544
  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:2832 ./bashref.texi:2833
  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:3168 ./bashref.texi:3169
  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:4132 ./bashref.texi:7192
  922. #, no-wrap
  923. msgid "\\a"
  924. msgstr ""
  925. #. type: table
  926. #: ./bashref.texi:486 ./bashref.texi:4134
  927. msgid "alert (bell)"
  928. msgstr ""
  929. #. type: item
  930. #: ./bashref.texi:486 ./bashref.texi:4134
  931. #, no-wrap
  932. msgid "\\b"
  933. msgstr ""
  934. #. type: table
  935. #: ./bashref.texi:488 ./bashref.texi:4136
  936. msgid "backspace"
  937. msgstr ""
  938. #. type: item
  939. #: ./bashref.texi:488 ./bashref.texi:4138 ./bashref.texi:7200
  940. #, no-wrap
  941. msgid "\\e"
  942. msgstr ""
  943. #. type: itemx
  944. #: ./bashref.texi:489 ./bashref.texi:4139
  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:4141
  954. #, no-wrap
  955. msgid "\\f"
  956. msgstr ""
  957. #. type: table
  958. #: ./bashref.texi:493 ./bashref.texi:4143
  959. msgid "form feed"
  960. msgstr ""
  961. #. type: item
  962. #: ./bashref.texi:493 ./bashref.texi:4143 ./bashref.texi:7210
  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:4145 ./bashref.texi:7212
  972. #, no-wrap
  973. msgid "\\r"
  974. msgstr ""
  975. #. type: table
  976. #: ./bashref.texi:497 ./bashref.texi:4147
  977. msgid "carriage return"
  978. msgstr ""
  979. #. type: item
  980. #: ./bashref.texi:497 ./bashref.texi:4147 ./bashref.texi:7217
  981. #, no-wrap
  982. msgid "\\t"
  983. msgstr ""
  984. #. type: table
  985. #: ./bashref.texi:499 ./bashref.texi:4149
  986. msgid "horizontal tab"
  987. msgstr ""
  988. #. type: item
  989. #: ./bashref.texi:499 ./bashref.texi:4149 ./bashref.texi:7227
  990. #, no-wrap
  991. msgid "\\v"
  992. msgstr ""
  993. #. type: table
  994. #: ./bashref.texi:501 ./bashref.texi:4151
  995. msgid "vertical tab"
  996. msgstr ""
  997. #. type: item
  998. #: ./bashref.texi:501 ./bashref.texi:4151 ./bashref.texi:7244
  999. #, no-wrap
  1000. msgid "\\\\"
  1001. msgstr ""
  1002. #. type: table
  1003. #: ./bashref.texi:503 ./bashref.texi:4153
  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:7242
  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 digits)"
  1043. msgstr ""
  1044. #. type: item
  1045. #: ./bashref.texi:512 ./bashref.texi:4156
  1046. #, no-wrap
  1047. msgid "\\x@var{HH}"
  1048. msgstr ""
  1049. #. type: table
  1050. #: ./bashref.texi:515 ./bashref.texi:4159
  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:4159
  1057. #, no-wrap
  1058. msgid "\\u@var{HHHH}"
  1059. msgstr ""
  1060. #. type: table
  1061. #: ./bashref.texi:518 ./bashref.texi:4162
  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:4162
  1068. #, no-wrap
  1069. msgid "\\U@var{HHHHHHHH}"
  1070. msgstr ""
  1071. #. type: table
  1072. #: ./bashref.texi:521 ./bashref.texi:4165
  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:5947
  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:676
  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:732 ./bashref.texi:733
  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:1165 ./bashref.texi:1166
  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:1211 ./bashref.texi:1212
  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:1632
  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:675
  1352. msgid ""
  1353. "Each command in a pipeline is executed in its own subshell (@pxref{Command "
  1354. "Execution Environment}). The exit status of a pipeline is the exit status "
  1355. "of the last command in the pipeline, unless the @code{pipefail} option is "
  1356. "enabled (@pxref{The Set Builtin}). If @code{pipefail} is enabled, the "
  1357. "pipeline's return status is the value of the last (rightmost) command to "
  1358. "exit with a non-zero status, or zero if all commands exit successfully. If "
  1359. "the reserved word @samp{!} precedes the pipeline, the exit status is the "
  1360. "logical negation of the exit status as described above. The shell waits for "
  1361. "all commands in the pipeline to terminate before returning a value."
  1362. msgstr ""
  1363. #. type: subsection
  1364. #: ./bashref.texi:677
  1365. #, no-wrap
  1366. msgid "Lists of Commands"
  1367. msgstr ""
  1368. #. type: cindex
  1369. #: ./bashref.texi:678
  1370. #, no-wrap
  1371. msgid "commands, lists"
  1372. msgstr ""
  1373. #. type: Plain text
  1374. #: ./bashref.texi:684
  1375. msgid ""
  1376. "A @code{list} is a sequence of one or more pipelines separated by one of the "
  1377. "operators @samp{;}, @samp{&}, @samp{&&}, or @samp{||}, and optionally "
  1378. "terminated by one of @samp{;}, @samp{&}, or a @code{newline}."
  1379. msgstr ""
  1380. #. type: Plain text
  1381. #: ./bashref.texi:688
  1382. msgid ""
  1383. "Of these list operators, @samp{&&} and @samp{||} have equal precedence, "
  1384. "followed by @samp{;} and @samp{&}, which have equal precedence."
  1385. msgstr ""
  1386. #. type: Plain text
  1387. #: ./bashref.texi:691
  1388. msgid ""
  1389. "A sequence of one or more newlines may appear in a @code{list} to delimit "
  1390. "commands, equivalent to a semicolon."
  1391. msgstr ""
  1392. #. type: Plain text
  1393. #: ./bashref.texi:700
  1394. msgid ""
  1395. "If a command is terminated by the control operator @samp{&}, the shell "
  1396. "executes the command asynchronously in a subshell. This is known as "
  1397. "executing the command in the @var{background}. The shell does not wait for "
  1398. "the command to finish, and the return status is 0 (true). When job control "
  1399. "is not active (@pxref{Job Control}), the standard input for asynchronous "
  1400. "commands, in the absence of any explicit redirections, is redirected from "
  1401. "@code{/dev/null}."
  1402. msgstr ""
  1403. #. type: Plain text
  1404. #: ./bashref.texi:704
  1405. msgid ""
  1406. "Commands separated by a @samp{;} are executed sequentially; the shell waits "
  1407. "for each command to terminate in turn. The return status is the exit status "
  1408. "of the last command executed."
  1409. msgstr ""
  1410. #. type: Plain text
  1411. #: ./bashref.texi:709
  1412. msgid ""
  1413. "@sc{and} and @sc{or} lists are sequences of one or more pipelines separated "
  1414. "by the control operators @samp{&&} and @samp{||}, respectively. @sc{and} "
  1415. "and @sc{or} lists are executed with left associativity."
  1416. msgstr ""
  1417. #. type: Plain text
  1418. #: ./bashref.texi:711
  1419. msgid "An @sc{and} list has the form"
  1420. msgstr ""
  1421. #. type: example
  1422. #: ./bashref.texi:713
  1423. #, no-wrap
  1424. msgid "@var{command1} && @var{command2}\n"
  1425. msgstr ""
  1426. #. type: Plain text
  1427. #: ./bashref.texi:718
  1428. msgid ""
  1429. "@var{command2} is executed if, and only if, @var{command1} returns an exit "
  1430. "status of zero."
  1431. msgstr ""
  1432. #. type: Plain text
  1433. #: ./bashref.texi:720
  1434. msgid "An @sc{or} list has the form"
  1435. msgstr ""
  1436. #. type: example
  1437. #: ./bashref.texi:722
  1438. #, no-wrap
  1439. msgid "@var{command1} || @var{command2}\n"
  1440. msgstr ""
  1441. #. type: Plain text
  1442. #: ./bashref.texi:727
  1443. msgid ""
  1444. "@var{command2} is executed if, and only if, @var{command1} returns a "
  1445. "non-zero exit status."
  1446. msgstr ""
  1447. #. type: Plain text
  1448. #: ./bashref.texi:731
  1449. msgid ""
  1450. "The return status of @sc{and} and @sc{or} lists is the exit status of the "
  1451. "last command executed in the list."
  1452. msgstr ""
  1453. #. type: cindex
  1454. #: ./bashref.texi:734
  1455. #, no-wrap
  1456. msgid "commands, compound"
  1457. msgstr ""
  1458. #. type: subsubsection
  1459. #: ./bashref.texi:740 ./bashref.texi:755 ./bashref.texi:756
  1460. #, no-wrap
  1461. msgid "Looping Constructs"
  1462. msgstr ""
  1463. #. type: menuentry
  1464. #: ./bashref.texi:740
  1465. msgid "Shell commands for iterative action."
  1466. msgstr ""
  1467. #. type: subsubsection
  1468. #: ./bashref.texi:740 ./bashref.texi:831 ./bashref.texi:832
  1469. #, no-wrap
  1470. msgid "Conditional Constructs"
  1471. msgstr ""
  1472. #. type: menuentry
  1473. #: ./bashref.texi:740
  1474. msgid "Shell commands for conditional execution."
  1475. msgstr ""
  1476. #. type: node
  1477. #: ./bashref.texi:740 ./bashref.texi:1121
  1478. #, no-wrap
  1479. msgid "Command Grouping"
  1480. msgstr ""
  1481. #. type: menuentry
  1482. #: ./bashref.texi:740
  1483. msgid "Ways to group commands."
  1484. msgstr ""
  1485. #. type: Plain text
  1486. #: ./bashref.texi:747
  1487. msgid ""
  1488. "Compound commands are the shell programming constructs. Each construct "
  1489. "begins with a reserved word or control operator and is terminated by a "
  1490. "corresponding reserved word or operator. Any redirections "
  1491. "(@pxref{Redirections}) associated with a compound command apply to all "
  1492. "commands within that compound command unless explicitly overridden."
  1493. msgstr ""
  1494. #. type: Plain text
  1495. #: ./bashref.texi:751
  1496. msgid ""
  1497. "In most cases a list of commands in a compound command's description may be "
  1498. "separated from the rest of the command by one or more newlines, and may be "
  1499. "followed by a newline in place of a semicolon."
  1500. msgstr ""
  1501. #. type: Plain text
  1502. #: ./bashref.texi:754
  1503. msgid ""
  1504. "Bash provides looping constructs, conditional commands, and mechanisms to "
  1505. "group commands and execute them as a unit."
  1506. msgstr ""
  1507. #. type: cindex
  1508. #: ./bashref.texi:757
  1509. #, no-wrap
  1510. msgid "commands, looping"
  1511. msgstr ""
  1512. #. type: Plain text
  1513. #: ./bashref.texi:760
  1514. msgid "Bash supports the following looping constructs."
  1515. msgstr ""
  1516. #. type: Plain text
  1517. #: ./bashref.texi:763
  1518. msgid ""
  1519. "Note that wherever a @samp{;} appears in the description of a command's "
  1520. "syntax, it may be replaced with one or more newlines."
  1521. msgstr ""
  1522. #. type: rwindex
  1523. #: ./bashref.texi:765 ./bashref.texi:766
  1524. #, no-wrap
  1525. msgid "until"
  1526. msgstr ""
  1527. #. type: rwindex
  1528. #: ./bashref.texi:767
  1529. #, no-wrap
  1530. msgid "do"
  1531. msgstr ""
  1532. #. type: rwindex
  1533. #: ./bashref.texi:768
  1534. #, no-wrap
  1535. msgid "done"
  1536. msgstr ""
  1537. #. type: table
  1538. #: ./bashref.texi:770
  1539. msgid "The syntax of the @code{until} command is:"
  1540. msgstr ""
  1541. #. type: example
  1542. #: ./bashref.texi:773
  1543. #, no-wrap
  1544. msgid "until @var{test-commands}; do @var{consequent-commands}; done\n"
  1545. msgstr ""
  1546. #. type: table
  1547. #: ./bashref.texi:779
  1548. msgid ""
  1549. "Execute @var{consequent-commands} as long as @var{test-commands} has an exit "
  1550. "status which is not zero. The return status is the exit status of the last "
  1551. "command executed in @var{consequent-commands}, or zero if none was executed."
  1552. msgstr ""
  1553. #. type: rwindex
  1554. #: ./bashref.texi:780 ./bashref.texi:781
  1555. #, no-wrap
  1556. msgid "while"
  1557. msgstr ""
  1558. #. type: table
  1559. #: ./bashref.texi:783
  1560. msgid "The syntax of the @code{while} command is:"
  1561. msgstr ""
  1562. #. type: example
  1563. #: ./bashref.texi:786
  1564. #, no-wrap
  1565. msgid "while @var{test-commands}; do @var{consequent-commands}; done\n"
  1566. msgstr ""
  1567. #. type: table
  1568. #: ./bashref.texi:792
  1569. msgid ""
  1570. "Execute @var{consequent-commands} as long as @var{test-commands} has an exit "
  1571. "status of zero. The return status is the exit status of the last command "
  1572. "executed in @var{consequent-commands}, or zero if none was executed."
  1573. msgstr ""
  1574. #. type: rwindex
  1575. #: ./bashref.texi:793 ./bashref.texi:794
  1576. #, no-wrap
  1577. msgid "for"
  1578. msgstr ""
  1579. #. type: table
  1580. #: ./bashref.texi:796
  1581. msgid "The syntax of the @code{for} command is:"
  1582. msgstr ""
  1583. #. type: example
  1584. #: ./bashref.texi:799
  1585. #, no-wrap
  1586. msgid "for @var{name} [ [in [@var{words} @dots{}] ] ; ] do @var{commands}; done\n"
  1587. msgstr ""
  1588. #. type: table
  1589. #: ./bashref.texi:810
  1590. msgid ""
  1591. "Expand @var{words}, and execute @var{commands} once for each member in the "
  1592. "resultant list, with @var{name} bound to the current member. If @samp{in "
  1593. "@var{words}} is not present, the @code{for} command executes the "
  1594. "@var{commands} once for each positional parameter that is set, as if "
  1595. "@samp{in \"$@@\"} had been specified (@pxref{Special Parameters}). The "
  1596. "return status is the exit status of the last command that executes. If "
  1597. "there are no items in the expansion of @var{words}, no commands are "
  1598. "executed, and the return status is zero."
  1599. msgstr ""
  1600. #. type: table
  1601. #: ./bashref.texi:812
  1602. msgid "An alternate form of the @code{for} command is also supported:"
  1603. msgstr ""
  1604. #. type: example
  1605. #: ./bashref.texi:815
  1606. #, no-wrap
  1607. msgid ""
  1608. "for (( @var{expr1} ; @var{expr2} ; @var{expr3} )) ; do @var{commands} ; "
  1609. "done\n"
  1610. msgstr ""
  1611. #. type: table
  1612. #: ./bashref.texi:826
  1613. msgid ""
  1614. "First, the arithmetic expression @var{expr1} is evaluated according to the "
  1615. "rules described below (@pxref{Shell Arithmetic}). The arithmetic expression "
  1616. "@var{expr2} is then evaluated repeatedly until it evaluates to zero. Each "
  1617. "time @var{expr2} evaluates to a non-zero value, @var{commands} are executed "
  1618. "and the arithmetic expression @var{expr3} is evaluated. If any expression "
  1619. "is omitted, it behaves as if it evaluates to 1. The return value is the "
  1620. "exit status of the last command in @var{commands} that is executed, or false "
  1621. "if any of the expressions is invalid."
  1622. msgstr ""
  1623. #. type: Plain text
  1624. #: ./bashref.texi:830
  1625. msgid ""
  1626. "The @code{break} and @code{continue} builtins (@pxref{Bourne Shell "
  1627. "Builtins}) may be used to control loop execution."
  1628. msgstr ""
  1629. #. type: cindex
  1630. #: ./bashref.texi:833
  1631. #, no-wrap
  1632. msgid "commands, conditional"
  1633. msgstr ""
  1634. #. type: rwindex
  1635. #: ./bashref.texi:836 ./bashref.texi:837
  1636. #, no-wrap
  1637. msgid "if"
  1638. msgstr ""
  1639. #. type: rwindex
  1640. #: ./bashref.texi:838
  1641. #, no-wrap
  1642. msgid "then"
  1643. msgstr ""
  1644. #. type: rwindex
  1645. #: ./bashref.texi:839
  1646. #, no-wrap
  1647. msgid "else"
  1648. msgstr ""
  1649. #. type: rwindex
  1650. #: ./bashref.texi:840
  1651. #, no-wrap
  1652. msgid "elif"
  1653. msgstr ""
  1654. #. type: rwindex
  1655. #: ./bashref.texi:841
  1656. #, no-wrap
  1657. msgid "fi"
  1658. msgstr ""
  1659. #. type: table
  1660. #: ./bashref.texi:843
  1661. msgid "The syntax of the @code{if} command is:"
  1662. msgstr ""
  1663. #. type: example
  1664. #: ./bashref.texi:851
  1665. #, no-wrap
  1666. msgid ""
  1667. "if @var{test-commands}; then\n"
  1668. " @var{consequent-commands};\n"
  1669. "[elif @var{more-test-commands}; then\n"
  1670. " @var{more-consequents};]\n"
  1671. "[else @var{alternate-consequents};]\n"
  1672. "fi\n"
  1673. msgstr ""
  1674. #. type: table
  1675. #: ./bashref.texi:864
  1676. msgid ""
  1677. "The @var{test-commands} list is executed, and if its return status is zero, "
  1678. "the @var{consequent-commands} list is executed. If @var{test-commands} "
  1679. "returns a non-zero status, each @code{elif} list is executed in turn, and if "
  1680. "its exit status is zero, the corresponding @var{more-consequents} is "
  1681. "executed and the command completes. If @samp{else "
  1682. "@var{alternate-consequents}} is present, and the final command in the final "
  1683. "@code{if} or @code{elif} clause has a non-zero exit status, then "
  1684. "@var{alternate-consequents} is executed. The return status is the exit "
  1685. "status of the last command executed, or zero if no condition tested true."
  1686. msgstr ""
  1687. #. type: rwindex
  1688. #: ./bashref.texi:865 ./bashref.texi:866
  1689. #, no-wrap
  1690. msgid "case"
  1691. msgstr ""
  1692. #. type: rwindex
  1693. #: ./bashref.texi:867
  1694. #, no-wrap
  1695. msgid "in"
  1696. msgstr ""
  1697. #. type: rwindex
  1698. #: ./bashref.texi:868
  1699. #, no-wrap
  1700. msgid "esac"
  1701. msgstr ""
  1702. #. type: table
  1703. #: ./bashref.texi:870
  1704. msgid "The syntax of the @code{case} command is:"
  1705. msgstr ""
  1706. #. type: example
  1707. #: ./bashref.texi:873
  1708. #, no-wrap
  1709. msgid ""
  1710. "case @var{word} in [ [(] @var{pattern} [| @var{pattern}]@dots{}) "
  1711. "@var{command-list} ;;]@dots{} esac\n"
  1712. msgstr ""
  1713. #. type: table
  1714. #: ./bashref.texi:885
  1715. msgid ""
  1716. "@code{case} will selectively execute the @var{command-list} corresponding to "
  1717. "the first @var{pattern} that matches @var{word}. If the @code{nocasematch} "
  1718. "shell option (see the description of @code{shopt} in @ref{The Shopt "
  1719. "Builtin}) is enabled, the match is performed without regard to the case of "
  1720. "alphabetic characters. The @samp{|} is used to separate multiple patterns, "
  1721. "and the @samp{)} operator terminates a pattern list. A list of patterns and "
  1722. "an associated command-list is known as a @var{clause}."
  1723. msgstr ""
  1724. #. type: table
  1725. #: ./bashref.texi:891
  1726. msgid ""
  1727. "Each clause must be terminated with @samp{;;}, @samp{;&}, or @samp{;;&}. "
  1728. "The @var{word} undergoes tilde expansion, parameter expansion, command "
  1729. "substitution, arithmetic expansion, and quote removal before matching is "
  1730. "attempted. Each @var{pattern} undergoes tilde expansion, parameter "
  1731. "expansion, command substitution, and arithmetic expansion."
  1732. msgstr ""
  1733. #. type: table
  1734. #: ./bashref.texi:898
  1735. msgid ""
  1736. "There may be an arbitrary number of @code{case} clauses, each terminated by "
  1737. "a @samp{;;}, @samp{;&}, or @samp{;;&}. The first pattern that matches "
  1738. "determines the command-list that is executed. It's a common idiom to use "
  1739. "@samp{*} as the final pattern to define the default case, since that pattern "
  1740. "will always match."
  1741. msgstr ""
  1742. #. type: table
  1743. #: ./bashref.texi:901
  1744. msgid ""
  1745. "Here is an example using @code{case} in a script that could be used to "
  1746. "describe one interesting feature of an animal:"
  1747. msgstr ""
  1748. #. type: example
  1749. #: ./bashref.texi:912
  1750. #, no-wrap
  1751. msgid ""
  1752. "echo -n \"Enter the name of an animal: \"\n"
  1753. "read ANIMAL\n"
  1754. "echo -n \"The $ANIMAL has \"\n"
  1755. "case $ANIMAL in\n"
  1756. " horse | dog | cat) echo -n \"four\";;\n"
  1757. " man | kangaroo ) echo -n \"two\";;\n"
  1758. " *) echo -n \"an unknown number of\";;\n"
  1759. "esac\n"
  1760. "echo \" legs.\"\n"
  1761. msgstr ""
  1762. #. type: table
  1763. #: ./bashref.texi:923
  1764. msgid ""
  1765. "If the @samp{;;} operator is used, no subsequent matches are attempted after "
  1766. "the first pattern match. Using @samp{;&} in place of @samp{;;} causes "
  1767. "execution to continue with the @var{command-list} associated with the next "
  1768. "clause, if any. Using @samp{;;&} in place of @samp{;;} causes the shell to "
  1769. "test the patterns in the next clause, if any, and execute any associated "
  1770. "@var{command-list} on a successful match."
  1771. msgstr ""
  1772. #. type: table
  1773. #: ./bashref.texi:926
  1774. msgid ""
  1775. "The return status is zero if no @var{pattern} is matched. Otherwise, the "
  1776. "return status is the exit status of the @var{command-list} executed."
  1777. msgstr ""
  1778. #. type: rwindex
  1779. #: ./bashref.texi:927 ./bashref.texi:928
  1780. #, no-wrap
  1781. msgid "select"
  1782. msgstr ""
  1783. #. type: table
  1784. #: ./bashref.texi:932
  1785. msgid ""
  1786. "The @code{select} construct allows the easy generation of menus. It has "
  1787. "almost the same syntax as the @code{for} command:"
  1788. msgstr ""
  1789. #. type: example
  1790. #: ./bashref.texi:935
  1791. #, no-wrap
  1792. msgid "select @var{name} [in @var{words} @dots{}]; do @var{commands}; done\n"
  1793. msgstr ""
  1794. #. type: table
  1795. #: ./bashref.texi:950
  1796. msgid ""
  1797. "The list of words following @code{in} is expanded, generating a list of "
  1798. "items. The set of expanded words is printed on the standard error output "
  1799. "stream, each preceded by a number. If the @samp{in @var{words}} is omitted, "
  1800. "the positional parameters are printed, as if @samp{in \"$@@\"} had been "
  1801. "specified. The @env{PS3} prompt is then displayed and a line is read from "
  1802. "the standard input. If the line consists of a number corresponding to one "
  1803. "of the displayed words, then the value of @var{name} is set to that word. "
  1804. "If the line is empty, the words and prompt are displayed again. If "
  1805. "@code{EOF} is read, the @code{select} command completes. Any other value "
  1806. "read causes @var{name} to be set to null. The line read is saved in the "
  1807. "variable @env{REPLY}."
  1808. msgstr ""
  1809. #. type: table
  1810. #: ./bashref.texi:954
  1811. msgid ""
  1812. "The @var{commands} are executed after each selection until a @code{break} "
  1813. "command is executed, at which point the @code{select} command completes."
  1814. msgstr ""
  1815. #. type: table
  1816. #: ./bashref.texi:958
  1817. msgid ""
  1818. "Here is an example that allows the user to pick a filename from the current "
  1819. "directory, and displays the name and index of the file selected."
  1820. msgstr ""
  1821. #. type: example
  1822. #: ./bashref.texi:965
  1823. #, no-wrap
  1824. msgid ""
  1825. "select fname in *;\n"
  1826. "do\n"
  1827. "\techo you picked $fname \\($REPLY\\)\n"
  1828. "\tbreak;\n"
  1829. "done\n"
  1830. msgstr ""
  1831. #. type: item
  1832. #: ./bashref.texi:967
  1833. #, no-wrap
  1834. msgid "((@dots{}))"
  1835. msgstr ""
  1836. #. type: example
  1837. #: ./bashref.texi:970
  1838. #, no-wrap
  1839. msgid "(( @var{expression} ))\n"
  1840. msgstr ""
  1841. #. type: table
  1842. #: ./bashref.texi:976
  1843. msgid ""
  1844. "The arithmetic @var{expression} is evaluated according to the rules "
  1845. "described below (@pxref{Shell Arithmetic}). If the value of the expression "
  1846. "is non-zero, the return status is 0; otherwise the return status is 1. This "
  1847. "is exactly equivalent to"
  1848. msgstr ""
  1849. #. type: example
  1850. #: ./bashref.texi:978
  1851. #, no-wrap
  1852. msgid "let \"@var{expression}\"\n"
  1853. msgstr ""
  1854. #. type: table
  1855. #: ./bashref.texi:981
  1856. msgid "@xref{Bash Builtins}, for a full description of the @code{let} builtin."
  1857. msgstr ""
  1858. #. type: item
  1859. #: ./bashref.texi:982
  1860. #, no-wrap
  1861. msgid "[[@dots{}]]"
  1862. msgstr ""
  1863. #. type: rwindex
  1864. #: ./bashref.texi:983
  1865. #, no-wrap
  1866. msgid "[["
  1867. msgstr ""
  1868. #. type: rwindex
  1869. #: ./bashref.texi:984
  1870. #, no-wrap
  1871. msgid "]]"
  1872. msgstr ""
  1873. #. type: example
  1874. #: ./bashref.texi:987
  1875. #, no-wrap
  1876. msgid "[[ @var{expression} ]]\n"
  1877. msgstr ""
  1878. #. type: table
  1879. #: ./bashref.texi:999
  1880. msgid ""
  1881. "Return a status of 0 or 1 depending on the evaluation of the conditional "
  1882. "expression @var{expression}. Expressions are composed of the primaries "
  1883. "described below in @ref{Bash Conditional Expressions}. Word splitting and "
  1884. "filename expansion are not performed on the words between the @code{[[} and "
  1885. "@code{]]}; tilde expansion, parameter and variable expansion, arithmetic "
  1886. "expansion, command substitution, process substitution, and quote removal are "
  1887. "performed. Conditional operators such as @samp{-f} must be unquoted to be "
  1888. "recognized as primaries."
  1889. msgstr ""
  1890. #. type: table
  1891. #: ./bashref.texi:1002
  1892. msgid ""
  1893. "When used with @code{[[}, the @samp{<} and @samp{>} operators sort "
  1894. "lexicographically using the current locale."
  1895. msgstr ""
  1896. #. type: table
  1897. #: ./bashref.texi:1016
  1898. msgid ""
  1899. "When the @samp{==} and @samp{!=} operators are used, the string to the right "
  1900. "of the operator is considered a pattern and matched according to the rules "
  1901. "described below in @ref{Pattern Matching}, as if the @code{extglob} shell "
  1902. "option were enabled. The @samp{=} operator is identical to @samp{==}. If "
  1903. "the @code{nocasematch} shell option (see the description of @code{shopt} in "
  1904. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  1905. "to the case of alphabetic characters. The return value is 0 if the string "
  1906. "matches (@samp{==}) or does not match (@samp{!=})the pattern, and 1 "
  1907. "otherwise. Any part of the pattern may be quoted to force the quoted "
  1908. "portion to be matched as a string."
  1909. msgstr ""
  1910. #. type: table
  1911. #: ./bashref.texi:1041
  1912. msgid ""
  1913. "An additional binary operator, @samp{=~}, is available, with the same "
  1914. "precedence as @samp{==} and @samp{!=}. When it is used, the string to the "
  1915. "right of the operator is considered an extended regular expression and "
  1916. "matched accordingly (as in @i{regex}3)). The return value is 0 if the "
  1917. "string matches the pattern, and 1 otherwise. If the regular expression is "
  1918. "syntactically incorrect, the conditional expression's return value is 2. If "
  1919. "the @code{nocasematch} shell option (see the description of @code{shopt} in "
  1920. "@ref{The Shopt Builtin}) is enabled, the match is performed without regard "
  1921. "to the case of alphabetic characters. Any part of the pattern may be quoted "
  1922. "to force the quoted portion to be matched as a string. Bracket expressions "
  1923. "in regular expressions must be treated carefully, since normal quoting "
  1924. "characters lose their meanings between brackets. If the pattern is stored "
  1925. "in a shell variable, quoting the variable expansion forces the entire "
  1926. "pattern to be matched as a string. Substrings matched by parenthesized "
  1927. "subexpressions within the regular expression are saved in the array variable "
  1928. "@code{BASH_REMATCH}. The element of @code{BASH_REMATCH} with index 0 is the "
  1929. "portion of the string matching the entire regular expression. The element "
  1930. "of @code{BASH_REMATCH} with index @var{n} is the portion of the string "
  1931. "matching the @var{n}th parenthesized subexpression."
  1932. msgstr ""
  1933. #. type: table
  1934. #: ./bashref.texi:1047
  1935. msgid ""
  1936. "For example, the following will match a line (stored in the shell variable "
  1937. "@var{line}) if there is a sequence of characters in the value consisting of "
  1938. "any number, including zero, of space characters, zero or one instances of "
  1939. "@samp{a}, then a @samp{b}:"
  1940. msgstr ""
  1941. #. type: example
  1942. #: ./bashref.texi:1049
  1943. #, no-wrap
  1944. msgid "[[ $line =~ [[:space:]]*(a)?b ]]\n"
  1945. msgstr ""
  1946. #. type: table
  1947. #: ./bashref.texi:1054
  1948. msgid ""
  1949. "That means values like @samp{aab} and @samp{ aaaaaab} will match, as will a "
  1950. "line containing a @samp{b} anywhere in its value."
  1951. msgstr ""
  1952. #. type: table
  1953. #: ./bashref.texi:1063
  1954. msgid ""
  1955. "Storing the regular expression in a shell variable is often a useful way to "
  1956. "avoid problems with quoting characters that are special to the shell. It is "
  1957. "sometimes difficult to specify a regular expression literally without using "
  1958. "quotes, or to keep track of the quoting used by regular expressions while "
  1959. "paying attention to the shell's quote removal. Using a shell variable to "
  1960. "store the pattern decreases these problems. For example, the following is "
  1961. "equivalent to the above:"
  1962. msgstr ""
  1963. #. type: example
  1964. #: ./bashref.texi:1066
  1965. #, no-wrap
  1966. msgid ""
  1967. "pattern='[[:space:]]*(a)?b'\n"
  1968. "[[ $line =~ $pattern ]]\n"
  1969. msgstr ""
  1970. #. type: table
  1971. #: ./bashref.texi:1078
  1972. msgid ""
  1973. "If you want to match a character that's special to the regular expression "
  1974. "grammar, it has to be quoted to remove its special meaning. This means that "
  1975. "in the pattern @samp{xxx.txt}, the @samp{.} matches any character in the "
  1976. "string (its usual regular expression meaning), but in the pattern "
  1977. "@samp{\"xxx.txt\"} it can only match a literal @samp{.}. Shell programmers "
  1978. "should take special care with backslashes, since backslashes are used both "
  1979. "by the shell and regular expressions to remove the special meaning from the "
  1980. "following character. The following two sets of commands are @emph{not} "
  1981. "equivalent:"
  1982. msgstr ""
  1983. #. type: example
  1984. #: ./bashref.texi:1080
  1985. #, no-wrap
  1986. msgid ""
  1987. "pattern='\\.'\n"
  1988. "\n"
  1989. msgstr ""
  1990. #. type: example
  1991. #: ./bashref.texi:1083
  1992. #, no-wrap
  1993. msgid ""
  1994. "[[ . =~ $pattern ]]\n"
  1995. "[[ . =~ \\. ]]\n"
  1996. "\n"
  1997. msgstr ""
  1998. #. type: example
  1999. #: ./bashref.texi:1086
  2000. #, no-wrap
  2001. msgid ""
  2002. "[[ . =~ \"$pattern\" ]]\n"
  2003. "[[ . =~ '\\.' ]]\n"
  2004. msgstr ""
  2005. #. type: table
  2006. #: ./bashref.texi:1096
  2007. msgid ""
  2008. "The first two matches will succeed, but the second two will not, because in "
  2009. "the second two the backslash will be part of the pattern to be matched. In "
  2010. "the first two examples, the backslash removes the special meaning from "
  2011. "@samp{.}, so the literal @samp{.} matches. If the string in the first "
  2012. "examples were anything other than @samp{.}, say @samp{a}, the pattern would "
  2013. "not match, because the quoted @samp{.} in the pattern loses its special "
  2014. "meaning of matching any single character."
  2015. msgstr ""
  2016. #. type: table
  2017. #: ./bashref.texi:1099
  2018. msgid ""
  2019. "Expressions may be combined using the following operators, listed in "
  2020. "decreasing order of precedence:"
  2021. msgstr ""
  2022. #. type: item
  2023. #: ./bashref.texi:1101
  2024. #, no-wrap
  2025. msgid "( @var{expression} )"
  2026. msgstr ""
  2027. #. type: table
  2028. #: ./bashref.texi:1104
  2029. msgid ""
  2030. "Returns the value of @var{expression}. This may be used to override the "
  2031. "normal precedence of operators."
  2032. msgstr ""
  2033. #. type: item
  2034. #: ./bashref.texi:1105
  2035. #, no-wrap
  2036. msgid "! @var{expression}"
  2037. msgstr ""
  2038. #. type: table
  2039. #: ./bashref.texi:1107
  2040. msgid "True if @var{expression} is false."
  2041. msgstr ""
  2042. #. type: item
  2043. #: ./bashref.texi:1108
  2044. #, no-wrap
  2045. msgid "@var{expression1} && @var{expression2}"
  2046. msgstr ""
  2047. #. type: table
  2048. #: ./bashref.texi:1110
  2049. msgid "True if both @var{expression1} and @var{expression2} are true."
  2050. msgstr ""
  2051. #. type: item
  2052. #: ./bashref.texi:1111
  2053. #, no-wrap
  2054. msgid "@var{expression1} || @var{expression2}"
  2055. msgstr ""
  2056. #. type: table
  2057. #: ./bashref.texi:1113
  2058. msgid "True if either @var{expression1} or @var{expression2} is true."
  2059. msgstr ""
  2060. #. type: table
  2061. #: ./bashref.texi:1119
  2062. msgid ""
  2063. "The @code{&&} and @code{||} operators do not evaluate @var{expression2} if "
  2064. "the value of @var{expression1} is sufficient to determine the return value "
  2065. "of the entire conditional expression."
  2066. msgstr ""
  2067. #. type: subsubsection
  2068. #: ./bashref.texi:1122
  2069. #, no-wrap
  2070. msgid "Grouping Commands"
  2071. msgstr ""
  2072. #. type: cindex
  2073. #: ./bashref.texi:1123
  2074. #, no-wrap
  2075. msgid "commands, grouping"
  2076. msgstr ""
  2077. #. type: Plain text
  2078. #: ./bashref.texi:1129
  2079. msgid ""
  2080. "Bash provides two ways to group a list of commands to be executed as a "
  2081. "unit. When commands are grouped, redirections may be applied to the entire "
  2082. "command list. For example, the output of all the commands in the list may "
  2083. "be redirected to a single stream."
  2084. msgstr ""
  2085. #. type: item
  2086. #: ./bashref.texi:1131
  2087. #, no-wrap
  2088. msgid "()"
  2089. msgstr ""
  2090. #. type: example
  2091. #: ./bashref.texi:1134
  2092. #, no-wrap
  2093. msgid "( @var{list} )\n"
  2094. msgstr ""
  2095. #. type: table
  2096. #: ./bashref.texi:1141
  2097. msgid ""
  2098. "Placing a list of commands between parentheses causes a subshell environment "
  2099. "to be created (@pxref{Command Execution Environment}), and each of the "
  2100. "commands in @var{list} to be executed in that subshell. Since the "
  2101. "@var{list} is executed in a subshell, variable assignments do not remain in "
  2102. "effect after the subshell completes."
  2103. msgstr ""
  2104. #. type: item
  2105. #: ./bashref.texi:1142
  2106. #, no-wrap
  2107. msgid "@{@}"
  2108. msgstr ""
  2109. #. type: rwindex
  2110. #: ./bashref.texi:1143
  2111. #, no-wrap
  2112. msgid "@{"
  2113. msgstr ""
  2114. #. type: rwindex
  2115. #: ./bashref.texi:1144
  2116. #, no-wrap
  2117. msgid "@}"
  2118. msgstr ""
  2119. #. type: example
  2120. #: ./bashref.texi:1147
  2121. #, no-wrap
  2122. msgid "@{ @var{list}; @}\n"
  2123. msgstr ""
  2124. #. type: table
  2125. #: ./bashref.texi:1152
  2126. msgid ""
  2127. "Placing a list of commands between curly braces causes the list to be "
  2128. "executed in the current shell context. No subshell is created. The "
  2129. "semicolon (or newline) following @var{list} is required."
  2130. msgstr ""
  2131. #. type: Plain text
  2132. #: ./bashref.texi:1161
  2133. msgid ""
  2134. "In addition to the creation of a subshell, there is a subtle difference "
  2135. "between these two constructs due to historical reasons. The braces are "
  2136. "@code{reserved words}, so they must be separated from the @var{list} by "
  2137. "@code{blank}s or other shell metacharacters. The parentheses are "
  2138. "@code{operators}, and are recognized as separate tokens by the shell even if "
  2139. "they are not separated from the @var{list} by whitespace."
  2140. msgstr ""
  2141. #. type: Plain text
  2142. #: ./bashref.texi:1164
  2143. msgid ""
  2144. "The exit status of both of these constructs is the exit status of "
  2145. "@var{list}."
  2146. msgstr ""
  2147. #. type: cindex
  2148. #: ./bashref.texi:1167
  2149. #, no-wrap
  2150. msgid "coprocess"
  2151. msgstr ""
  2152. #. type: Plain text
  2153. #: ./bashref.texi:1174
  2154. msgid ""
  2155. "A @code{coprocess} is a shell command preceded by the @code{coproc} reserved "
  2156. "word. A coprocess is executed asynchronously in a subshell, as if the "
  2157. "command had been terminated with the @samp{&} control operator, with a "
  2158. "two-way pipe established between the executing shell and the coprocess."
  2159. msgstr ""
  2160. #. type: Plain text
  2161. #: ./bashref.texi:1176
  2162. msgid "The format for a coprocess is:"
  2163. msgstr ""
  2164. #. type: example
  2165. #: ./bashref.texi:1178
  2166. #, no-wrap
  2167. msgid "coproc [@var{NAME}] @var{command} [@var{redirections}]\n"
  2168. msgstr ""
  2169. #. type: Plain text
  2170. #: ./bashref.texi:1186
  2171. msgid ""
  2172. "This creates a coprocess named @var{NAME}. If @var{NAME} is not supplied, "
  2173. "the default name is @var{COPROC}. @var{NAME} must not be supplied if "
  2174. "@var{command} is a simple command (@pxref{Simple Commands}); otherwise, it "
  2175. "is interpreted as the first word of the simple command."
  2176. msgstr ""
  2177. #. type: Plain text
  2178. #: ./bashref.texi:1201
  2179. msgid ""
  2180. "When the coprocess is executed, the shell creates an array variable "
  2181. "(@pxref{Arrays}) named @env{NAME} in the context of the executing shell. "
  2182. "The standard output of @var{command} is connected via a pipe to a file "
  2183. "descriptor in the executing shell, and that file descriptor is assigned to "
  2184. "@env{NAME}[0]. The standard input of @var{command} is connected via a pipe "
  2185. "to a file descriptor in the executing shell, and that file descriptor is "
  2186. "assigned to @env{NAME}[1]. This pipe is established before any redirections "
  2187. "specified by the command (@pxref{Redirections}). The file descriptors can "
  2188. "be utilized as arguments to shell commands and redirections using standard "
  2189. "word expansions. The file descriptors are not available in subshells."
  2190. msgstr ""
  2191. #. type: Plain text
  2192. #: ./bashref.texi:1206
  2193. msgid ""
  2194. "The process ID of the shell spawned to execute the coprocess is available as "
  2195. "the value of the variable @env{NAME}_PID. The @code{wait} builtin command "
  2196. "may be used to wait for the coprocess to terminate."
  2197. msgstr ""
  2198. #. type: Plain text
  2199. #: ./bashref.texi:1210
  2200. msgid ""
  2201. "Since the coprocess is created as an asynchronous command, the @code{coproc} "
  2202. "command always returns success. The return status of a coprocess is the "
  2203. "exit status of @var{command}."
  2204. msgstr ""
  2205. #. type: Plain text
  2206. #: ./bashref.texi:1216
  2207. msgid ""
  2208. "There are ways to run commands in parallel that are not built into Bash. "
  2209. "GNU Parallel is a tool to do just that."
  2210. msgstr ""
  2211. #. type: Plain text
  2212. #: ./bashref.texi:1224
  2213. msgid ""
  2214. "GNU Parallel, as its name suggests, can be used to build and run commands in "
  2215. "parallel. You may run the same command with different arguments, whether "
  2216. "they are filenames, usernames, hostnames, or lines read from files. GNU "
  2217. "Parallel provides shorthand references to many of the most common operations "
  2218. "(input lines, various portions of the input line, different ways to specify "
  2219. "the input source, and so on). Parallel can replace @code{xargs} or feed "
  2220. "commands from its input sources to several different instances of Bash."
  2221. msgstr ""
  2222. #. type: Plain text
  2223. #: ./bashref.texi:1227
  2224. msgid ""
  2225. "For a complete description, refer to the GNU Parallel documentation. A few "
  2226. "examples should provide a brief introduction to its use."
  2227. msgstr ""
  2228. #. type: Plain text
  2229. #: ./bashref.texi:1230
  2230. msgid ""
  2231. "For example, it is easy to replace @code{xargs} to gzip all html files in "
  2232. "the current directory and its subdirectories:"
  2233. msgstr ""
  2234. #. type: example
  2235. #: ./bashref.texi:1232
  2236. #, no-wrap
  2237. msgid "find . -type f -name '*.html' -print | parallel gzip\n"
  2238. msgstr ""
  2239. #. type: Plain text
  2240. #: ./bashref.texi:1236
  2241. msgid ""
  2242. "If you need to protect special characters such as newlines in file names, "
  2243. "use find's @option{-print0} option and parallel's @option{-0} option."
  2244. msgstr ""
  2245. #. type: Plain text
  2246. #: ./bashref.texi:1239
  2247. msgid ""
  2248. "You can use Parallel to move files from the current directory when the "
  2249. "number of files is too large to process with one @code{mv} invocation:"
  2250. msgstr ""
  2251. #. type: example
  2252. #: ./bashref.texi:1241
  2253. #, no-wrap
  2254. msgid "ls | parallel mv @{@} destdir\n"
  2255. msgstr ""
  2256. #. type: Plain text
  2257. #: ./bashref.texi:1247
  2258. msgid ""
  2259. "As you can see, the @{@} is replaced with each line read from standard "
  2260. "input. While using @code{ls} will work in most instances, it is not "
  2261. "sufficient to deal with all filenames. If you need to accommodate special "
  2262. "characters in filenames, you can use"
  2263. msgstr ""
  2264. #. type: example
  2265. #: ./bashref.texi:1250
  2266. #, no-wrap
  2267. msgid "find . -depth 1 \\! -name '.*' -print0 | parallel -0 mv @{@} destdir\n"
  2268. msgstr ""
  2269. #. type: Plain text
  2270. #: ./bashref.texi:1254
  2271. msgid "as alluded to above."
  2272. msgstr ""
  2273. #. type: Plain text
  2274. #: ./bashref.texi:1258
  2275. msgid ""
  2276. "This will run as many @code{mv} commands as there are files in the current "
  2277. "directory. You can emulate a parallel @code{xargs} by adding the "
  2278. "@option{-X} option:"
  2279. msgstr ""
  2280. #. type: example
  2281. #: ./bashref.texi:1260
  2282. #, no-wrap
  2283. msgid "find . -depth 1 \\! -name '.*' -print0 | parallel -0 -X mv @{@} destdir\n"
  2284. msgstr ""
  2285. #. type: Plain text
  2286. #: ./bashref.texi:1264
  2287. msgid ""
  2288. "GNU Parallel can replace certain common idioms that operate on lines read "
  2289. "from a file (in this case, filenames listed one per line):"
  2290. msgstr ""
  2291. #. type: example
  2292. #: ./bashref.texi:1269
  2293. #, no-wrap
  2294. msgid ""
  2295. "\twhile IFS= read -r x; do\n"
  2296. "\t\tdo-something1 \"$x\" \"config-$x\"\n"
  2297. "\t\tdo-something2 < \"$x\"\n"
  2298. "\tdone < file | process-output\n"
  2299. msgstr ""
  2300. #. type: Plain text
  2301. #: ./bashref.texi:1273
  2302. msgid "with a more compact syntax reminiscent of lambdas:"
  2303. msgstr ""
  2304. #. type: example
  2305. #: ./bashref.texi:1275
  2306. #, no-wrap
  2307. msgid ""
  2308. "cat list | parallel \"do-something1 @{@} config-@{@} ; do-something2 < "
  2309. "@{@}\" | process-output\n"
  2310. msgstr ""
  2311. #. type: Plain text
  2312. #: ./bashref.texi:1279
  2313. msgid ""
  2314. "Parallel provides a built-in mechanism to remove filename extensions, which "
  2315. "lends itself to batch file transformations or renaming:"
  2316. msgstr ""
  2317. #. type: example
  2318. #: ./bashref.texi:1281
  2319. #, no-wrap
  2320. msgid "ls *.gz | parallel -j+0 \"zcat @{@} | bzip2 >@{.@}.bz2 && rm @{@}\"\n"
  2321. msgstr ""
  2322. #. type: Plain text
  2323. #: ./bashref.texi:1289
  2324. msgid ""
  2325. "This will recompress all files in the current directory with names ending in "
  2326. ".gz using bzip2, running one job per CPU (-j+0) in parallel. (We use "
  2327. "@code{ls} for brevity here; using @code{find} as above is more robust in the "
  2328. "face of filenames containing unexpected characters.) Parallel can take "
  2329. "arguments from the command line; the above can also be written as"
  2330. msgstr ""
  2331. #. type: example
  2332. #: ./bashref.texi:1292
  2333. #, no-wrap
  2334. msgid "parallel \"zcat @{@} | bzip2 >@{.@}.bz2 && rm @{@}\" ::: *.gz\n"
  2335. msgstr ""
  2336. #. type: Plain text
  2337. #: ./bashref.texi:1296
  2338. msgid ""
  2339. "If a command generates output, you may want to preserve the input order in "
  2340. "the output. For instance, the following command"
  2341. msgstr ""
  2342. #. type: example
  2343. #: ./bashref.texi:1298
  2344. #, no-wrap
  2345. msgid ""
  2346. "@{ echo foss.org.my ; echo debian.org; echo freenetproject.org; @} | "
  2347. "parallel traceroute\n"
  2348. msgstr ""
  2349. #. type: Plain text
  2350. #: ./bashref.texi:1302
  2351. msgid ""
  2352. "will display as output the traceroute invocation that finishes first. "
  2353. "Adding the @option{-k} option"
  2354. msgstr ""
  2355. #. type: example
  2356. #: ./bashref.texi:1304
  2357. #, no-wrap
  2358. msgid ""
  2359. "@{ echo foss.org.my ; echo debian.org; echo freenetproject.org; @} | "
  2360. "parallel -k traceroute\n"
  2361. msgstr ""
  2362. #. type: Plain text
  2363. #: ./bashref.texi:1307
  2364. msgid ""
  2365. "will ensure that the output of @code{traceroute foss.org.my} is displayed "
  2366. "first."
  2367. msgstr ""
  2368. #. type: Plain text
  2369. #: ./bashref.texi:1314
  2370. msgid ""
  2371. "Finally, Parallel can be used to run a sequence of shell commands in "
  2372. "parallel, similar to @samp{cat file | bash}. It is not uncommon to take a "
  2373. "list of filenames, create a series of shell commands to operate on them, and "
  2374. "feed that list of commnds to a shell. Parallel can speed this up. Assuming "
  2375. "that @file{file} contains a list of shell commands, one per line,"
  2376. msgstr ""
  2377. #. type: example
  2378. #: ./bashref.texi:1317
  2379. #, no-wrap
  2380. msgid "parallel -j 10 < file\n"
  2381. msgstr ""
  2382. #. type: Plain text
  2383. #: ./bashref.texi:1322
  2384. msgid ""
  2385. "will evaluate the commands using the shell (since no explicit command is "
  2386. "supplied as an argument), in blocks of ten shell jobs at a time."
  2387. msgstr ""
  2388. #. type: cindex
  2389. #: ./bashref.texi:1325
  2390. #, no-wrap
  2391. msgid "shell function"
  2392. msgstr ""
  2393. #. type: cindex
  2394. #: ./bashref.texi:1326
  2395. #, no-wrap
  2396. msgid "functions, shell"
  2397. msgstr ""
  2398. #. type: Plain text
  2399. #: ./bashref.texi:1335
  2400. msgid ""
  2401. "Shell functions are a way to group commands for later execution using a "
  2402. "single name for the group. They are executed just like a \"regular\" "
  2403. "command. When the name of a shell function is used as a simple command "
  2404. "name, the list of commands associated with that function name is executed. "
  2405. "Shell functions are executed in the current shell context; no new process is "
  2406. "created to interpret them."
  2407. msgstr ""
  2408. #. type: Plain text
  2409. #: ./bashref.texi:1337
  2410. msgid "Functions are declared using this syntax:"
  2411. msgstr ""
  2412. #. type: rwindex
  2413. #: ./bashref.texi:1337
  2414. #, no-wrap
  2415. msgid "function"
  2416. msgstr ""
  2417. #. type: example
  2418. #: ./bashref.texi:1340
  2419. #, no-wrap
  2420. msgid "@var{name} () @var{compound-command} [ @var{redirections} ]\n"
  2421. msgstr ""
  2422. #. type: Plain text
  2423. #: ./bashref.texi:1343 ./bashref.texi:1788 ./bashref.texi:2253 ./bashref.texi:2316
  2424. msgid "or"
  2425. msgstr ""
  2426. #. type: example
  2427. #: ./bashref.texi:1346
  2428. #, no-wrap
  2429. msgid "function @var{name} [()] @var{compound-command} [ @var{redirections} ]\n"
  2430. msgstr ""
  2431. #. type: Plain text
  2432. #: ./bashref.texi:1365
  2433. msgid ""
  2434. "This defines a shell function named @var{name}. The reserved word "
  2435. "@code{function} is optional. If the @code{function} reserved word is "
  2436. "supplied, the parentheses are optional. The @var{body} of the function is "
  2437. "the compound command @var{compound-command} (@pxref{Compound Commands}). "
  2438. "That command is usually a @var{list} enclosed between @{ and @}, but may be "
  2439. "any compound command listed above, with one exception: If the "
  2440. "@code{function} reserved word is used, but the parentheses are not supplied, "
  2441. "the braces are required. @var{compound-command} is executed whenever "
  2442. "@var{name} is specified as the name of a command. When the shell is in "
  2443. "@sc{posix} mode (@pxref{Bash POSIX Mode}), @var{name} may not be the same as "
  2444. "one of the special builtins (@pxref{Special Builtins}). Any redirections "
  2445. "(@pxref{Redirections}) associated with the shell function are performed when "
  2446. "the function is executed."
  2447. msgstr ""
  2448. #. type: Plain text
  2449. #: ./bashref.texi:1368
  2450. msgid ""
  2451. "A function definition may be deleted using the @option{-f} option to the "
  2452. "@code{unset} builtin (@pxref{Bourne Shell Builtins})."
  2453. msgstr ""
  2454. #. type: Plain text
  2455. #: ./bashref.texi:1373
  2456. msgid ""
  2457. "The exit status of a function definition is zero unless a syntax error "
  2458. "occurs or a readonly function with the same name already exists. When "
  2459. "executed, the exit status of a function is the exit status of the last "
  2460. "command executed in the body."
  2461. msgstr ""
  2462. #. type: Plain text
  2463. #: ./bashref.texi:1382
  2464. msgid ""
  2465. "Note that for historical reasons, in the most common usage the curly braces "
  2466. "that surround the body of the function must be separated from the body by "
  2467. "@code{blank}s or newlines. This is because the braces are reserved words "
  2468. "and are only recognized as such when they are separated from the command "
  2469. "list by whitespace or another shell metacharacter. Also, when using the "
  2470. "braces, the @var{list} must be terminated by a semicolon, a @samp{&}, or a "
  2471. "newline."
  2472. msgstr ""
  2473. #. type: Plain text
  2474. #: ./bashref.texi:1391
  2475. msgid ""
  2476. "When a function is executed, the arguments to the function become the "
  2477. "positional parameters during its execution (@pxref{Positional Parameters}). "
  2478. "The special parameter @samp{#} that expands to the number of positional "
  2479. "parameters is updated to reflect the change. Special parameter @code{0} is "
  2480. "unchanged. The first element of the @env{FUNCNAME} variable is set to the "
  2481. "name of the function while the function is executing."
  2482. msgstr ""
  2483. #. type: Plain text
  2484. #: ./bashref.texi:1405
  2485. msgid ""
  2486. "All other aspects of the shell execution environment are identical between a "
  2487. "function and its caller with these exceptions: the @env{DEBUG} and "
  2488. "@env{RETURN} traps are not inherited unless the function has been given the "
  2489. "@code{trace} attribute using the @code{declare} builtin or the @code{-o "
  2490. "functrace} option has been enabled with the @code{set} builtin, (in which "
  2491. "case all functions inherit the @env{DEBUG} and @env{RETURN} traps), and the "
  2492. "@env{ERR} trap is not inherited unless the @code{-o errtrace} shell option "
  2493. "has been enabled. @xref{Bourne Shell Builtins}, for the description of the "
  2494. "@code{trap} builtin."
  2495. msgstr ""
  2496. #. type: Plain text
  2497. #: ./bashref.texi:1410
  2498. msgid ""
  2499. "The @env{FUNCNEST} variable, if set to a numeric value greater than 0, "
  2500. "defines a maximum function nesting level. Function invocations that exceed "
  2501. "the limit cause the entire command to abort."
  2502. msgstr ""
  2503. #. type: Plain text
  2504. #: ./bashref.texi:1424
  2505. msgid ""
  2506. "If the builtin command @code{return} is executed in a function, the function "
  2507. "completes and execution resumes with the next command after the function "
  2508. "call. Any command associated with the @code{RETURN} trap is executed before "
  2509. "execution resumes. When a function completes, the values of the positional "
  2510. "parameters and the special parameter @samp{#} are restored to the values "
  2511. "they had prior to the function's execution. If a numeric argument is given "
  2512. "to @code{return}, that is the function's return status; otherwise the "
  2513. "function's return status is the exit status of the last command executed "
  2514. "before the @code{return}."
  2515. msgstr ""
  2516. #. type: Plain text
  2517. #: ./bashref.texi:1428
  2518. msgid ""
  2519. "Variables local to the function may be declared with the @code{local} "
  2520. "builtin. These variables are visible only to the function and the commands "
  2521. "it invokes."
  2522. msgstr ""
  2523. #. type: Plain text
  2524. #: ./bashref.texi:1444
  2525. msgid ""
  2526. "Function names and definitions may be listed with the @option{-f} option to "
  2527. "the @code{declare} (@code{typeset}) builtin command (@pxref{Bash "
  2528. "Builtins}). The @option{-F} option to @code{declare} or @code{typeset} will "
  2529. "list the function names only (and optionally the source file and line "
  2530. "number, if the @code{extdebug} shell option is enabled). Functions may be "
  2531. "exported so that subshells automatically have them defined with the "
  2532. "@option{-f} option to the @code{export} builtin (@pxref{Bourne Shell "
  2533. "Builtins}). Note that shell functions and variables with the same name may "
  2534. "result in multiple identically-named entries in the environment passed to "
  2535. "the shell's children. Care should be taken in cases where this may cause a "
  2536. "problem."
  2537. msgstr ""
  2538. #. type: Plain text
  2539. #: ./bashref.texi:1449
  2540. msgid ""
  2541. "Functions may be recursive. The @code{FUNCNEST} variable may be used to "
  2542. "limit the depth of the function call stack and restrict the number of "
  2543. "function invocations. By default, no limit is placed on the number of "
  2544. "recursive calls."
  2545. msgstr ""
  2546. #. type: cindex
  2547. #: ./bashref.texi:1452
  2548. #, no-wrap
  2549. msgid "parameters"
  2550. msgstr ""
  2551. #. type: cindex
  2552. #: ./bashref.texi:1453
  2553. #, no-wrap
  2554. msgid "variable, shell"
  2555. msgstr ""
  2556. #. type: cindex
  2557. #: ./bashref.texi:1454
  2558. #, no-wrap
  2559. msgid "shell variable"
  2560. msgstr ""
  2561. #. type: subsection
  2562. #: ./bashref.texi:1459 ./bashref.texi:1551 ./bashref.texi:1552
  2563. #, no-wrap
  2564. msgid "Positional Parameters"
  2565. msgstr ""
  2566. #. type: menuentry
  2567. #: ./bashref.texi:1459
  2568. msgid "The shell's command-line arguments."
  2569. msgstr ""
  2570. #. type: subsection
  2571. #: ./bashref.texi:1459 ./bashref.texi:1571 ./bashref.texi:1572
  2572. #, no-wrap
  2573. msgid "Special Parameters"
  2574. msgstr ""
  2575. #. type: menuentry
  2576. #: ./bashref.texi:1459
  2577. msgid "Parameters denoted by special characters."
  2578. msgstr ""
  2579. #. type: Plain text
  2580. #: ./bashref.texi:1468
  2581. msgid ""
  2582. "A @var{parameter} is an entity that stores values. It can be a @code{name}, "
  2583. "a number, or one of the special characters listed below. A @var{variable} "
  2584. "is a parameter denoted by a @code{name}. A variable has a @var{value} and "
  2585. "zero or more @var{attributes}. Attributes are assigned using the "
  2586. "@code{declare} builtin command (see the description of the @code{declare} "
  2587. "builtin in @ref{Bash Builtins})."
  2588. msgstr ""
  2589. #. type: Plain text
  2590. #: ./bashref.texi:1472
  2591. msgid ""
  2592. "A parameter is set if it has been assigned a value. The null string is a "
  2593. "valid value. Once a variable is set, it may be unset only by using the "
  2594. "@code{unset} builtin command."
  2595. msgstr ""
  2596. #. type: Plain text
  2597. #: ./bashref.texi:1474
  2598. msgid "A variable may be assigned to by a statement of the form"
  2599. msgstr ""
  2600. #. type: example
  2601. #: ./bashref.texi:1476
  2602. #, no-wrap
  2603. msgid "@var{name}=[@var{value}]\n"
  2604. msgstr ""
  2605. #. type: Plain text
  2606. #: ./bashref.texi:1496
  2607. msgid ""
  2608. "If @var{value} is not given, the variable is assigned the null string. All "
  2609. "@var{value}s undergo tilde expansion, parameter and variable expansion, "
  2610. "command substitution, arithmetic expansion, and quote removal (detailed "
  2611. "below). If the variable has its @code{integer} attribute set, then "
  2612. "@var{value} is evaluated as an arithmetic expression even if the "
  2613. "@code{$((@dots{}))} expansion is not used (@pxref{Arithmetic Expansion}). "
  2614. "Word splitting is not performed, with the exception of @code{\"$@@\"} as "
  2615. "explained below. Filename expansion is not performed. Assignment "
  2616. "statements may also appear as arguments to the @code{alias}, @code{declare}, "
  2617. "@code{typeset}, @code{export}, @code{readonly}, and @code{local} builtin "
  2618. "commands (@var{declaration} commands). When in @sc{posix} mode (@pxref{Bash "
  2619. "POSIX Mode}), these builtins may appear in a command after one or more "
  2620. "instances of the @code{command} builtin and retain these assignment "
  2621. "statement properties."
  2622. msgstr ""
  2623. #. type: Plain text
  2624. #: ./bashref.texi:1514
  2625. msgid ""
  2626. "In the context where an assignment statement is assigning a value to a shell "
  2627. "variable or array index (@pxref{Arrays}), the @samp{+=} operator can be used "
  2628. "to append to or add to the variable's previous value. This includes "
  2629. "arguments to builtin commands such as @code{declare} that accept assignment "
  2630. "statements (@var{declaration} commands). When @samp{+=} is applied to a "
  2631. "variable for which the @var{integer} attribute has been set, @var{value} is "
  2632. "evaluated as an arithmetic expression and added to the variable's current "
  2633. "value, which is also evaluated. When @samp{+=} is applied to an array "
  2634. "variable using compound assignment (@pxref{Arrays}), the variable's value is "
  2635. "not unset (as it is when using @samp{=}), and new values are appended to the "
  2636. "array beginning at one greater than the array's maximum index (for indexed "
  2637. "arrays), or added as additional key-value pairs in an associative array. "
  2638. "When applied to a string-valued variable, @var{value} is expanded and "
  2639. "appended to the variable's value."
  2640. msgstr ""
  2641. #. type: Plain text
  2642. #: ./bashref.texi:1529
  2643. msgid ""
  2644. "A variable can be assigned the @var{nameref} attribute using the @option{-n} "
  2645. "option to the @code{declare} or @code{local} builtin commands (@pxref{Bash "
  2646. "Builtins}) to create a @var{nameref}, or a reference to another variable. "
  2647. "This allows variables to be manipulated indirectly. Whenever the nameref "
  2648. "variable is referenced, assigned to, unset, or has its attributes modified "
  2649. "(other than using or changing the nameref attribute itself), the operation "
  2650. "is actually performed on the variable specified by the nameref variable's "
  2651. "value. A nameref is commonly used within shell functions to refer to a "
  2652. "variable whose name is passed as an argument to the function. For instance, "
  2653. "if a variable name is passed to a shell function as its first argument, "
  2654. "running"
  2655. msgstr ""
  2656. #. type: example
  2657. #: ./bashref.texi:1531
  2658. #, no-wrap
  2659. msgid "declare -n ref=$1\n"
  2660. msgstr ""
  2661. #. type: Plain text
  2662. #: ./bashref.texi:1538
  2663. msgid ""
  2664. "inside the function creates a nameref variable @var{ref} whose value is the "
  2665. "variable name passed as the first argument. References and assignments to "
  2666. "@var{ref}, and changes to its attributes, are treated as references, "
  2667. "assignments, and attribute modifications to the variable whose name was "
  2668. "passed as @code{$1}."
  2669. msgstr ""
  2670. #. type: Plain text
  2671. #: ./bashref.texi:1550
  2672. msgid ""
  2673. "If the control variable in a @code{for} loop has the nameref attribute, the "
  2674. "list of words can be a list of shell variables, and a name reference will be "
  2675. "established for each word in the list, in turn, when the loop is executed. "
  2676. "Array variables cannot be given the nameref attribute. However, nameref "
  2677. "variables can reference array variables and subscripted array variables. "
  2678. "Namerefs can be unset using the @option{-n} option to the @code{unset} "
  2679. "builtin (@pxref{Bourne Shell Builtins}). Otherwise, if @code{unset} is "
  2680. "executed with the name of a nameref variable as an argument, the variable "
  2681. "referenced by the nameref variable will be unset."
  2682. msgstr ""
  2683. #. type: cindex
  2684. #: ./bashref.texi:1553
  2685. #, no-wrap
  2686. msgid "parameters, positional"
  2687. msgstr ""
  2688. #. type: Plain text
  2689. #: ./bashref.texi:1567
  2690. msgid ""
  2691. "A @var{positional parameter} is a parameter denoted by one or more digits, "
  2692. "other than the single digit @code{0}. Positional parameters are assigned "
  2693. "from the shell's arguments when it is invoked, and may be reassigned using "
  2694. "the @code{set} builtin command. Positional parameter @code{N} may be "
  2695. "referenced as @code{$@{N@}}, or as @code{$N} when @code{N} consists of a "
  2696. "single digit. Positional parameters may not be assigned to with assignment "
  2697. "statements. The @code{set} and @code{shift} builtins are used to set and "
  2698. "unset them (@pxref{Shell Builtin Commands}). The positional parameters are "
  2699. "temporarily replaced when a shell function is executed (@pxref{Shell "
  2700. "Functions})."
  2701. msgstr ""
  2702. #. type: Plain text
  2703. #: ./bashref.texi:1570
  2704. msgid ""
  2705. "When a positional parameter consisting of more than a single digit is "
  2706. "expanded, it must be enclosed in braces."
  2707. msgstr ""
  2708. #. type: cindex
  2709. #: ./bashref.texi:1573
  2710. #, no-wrap
  2711. msgid "parameters, special"
  2712. msgstr ""
  2713. #. type: Plain text
  2714. #: ./bashref.texi:1577
  2715. msgid ""
  2716. "The shell treats several parameters specially. These parameters may only be "
  2717. "referenced; assignment to them is not allowed."
  2718. msgstr ""
  2719. #. type: Plain text
  2720. #: ./bashref.texi:1579 ./bashref.texi:5396 ./bashref.texi:5461 ./bashref.texi:7888
  2721. msgid "@vtable @code"
  2722. msgstr ""
  2723. #. type: item
  2724. #: ./bashref.texi:1580 ./bashref.texi:2456
  2725. #, no-wrap
  2726. msgid "*"
  2727. msgstr ""
  2728. #. type: vindex
  2729. #: ./bashref.texi:1581
  2730. #, no-wrap
  2731. msgid "$*"
  2732. msgstr ""
  2733. #. type: Plain text
  2734. #: ./bashref.texi:1596
  2735. msgid ""
  2736. "($*) Expands to the positional parameters, starting from one. When the "
  2737. "expansion is not within double quotes, each positional parameter expands to "
  2738. "a separate word. In contexts where it is performed, those words are subject "
  2739. "to further word splitting and pathname expansion. When the expansion occurs "
  2740. "within double quotes, it expands to a single word with the value of each "
  2741. "parameter separated by the first character of the @env{IFS} special "
  2742. "variable. That is, @code{\"$*\"} is equivalent to "
  2743. "@code{\"$1@var{c}$2@var{c}@dots{}\"}, where @var{c} is the first character "
  2744. "of the value of the @code{IFS} variable. If @env{IFS} is unset, the "
  2745. "parameters are separated by spaces. If @env{IFS} is null, the parameters "
  2746. "are joined without intervening separators."
  2747. msgstr ""
  2748. #. type: item
  2749. #: ./bashref.texi:1597
  2750. #, no-wrap
  2751. msgid "@@"
  2752. msgstr ""
  2753. #. type: vindex
  2754. #: ./bashref.texi:1598
  2755. #, no-wrap
  2756. msgid "$@@"
  2757. msgstr ""
  2758. #. type: Plain text
  2759. #: ./bashref.texi:1610
  2760. msgid ""
  2761. "($@@) Expands to the positional parameters, starting from one. When the "
  2762. "expansion occurs within double quotes, each parameter expands to a separate "
  2763. "word. That is, @code{\"$@@\"} is equivalent to @code{\"$1\" \"$2\" "
  2764. "@dots{}}. If the double-quoted expansion occurs within a word, the "
  2765. "expansion of the first parameter is joined with the beginning part of the "
  2766. "original word, and the expansion of the last parameter is joined with the "
  2767. "last part of the original word. When there are no positional parameters, "
  2768. "@code{\"$@@\"} and @code{$@@} expand to nothing (i.e., they are removed)."
  2769. msgstr ""
  2770. #. type: item
  2771. #: ./bashref.texi:1611
  2772. #, no-wrap
  2773. msgid "#"
  2774. msgstr ""
  2775. #. type: vindex
  2776. #: ./bashref.texi:1612
  2777. #, no-wrap
  2778. msgid "$#"
  2779. msgstr ""
  2780. #. type: Plain text
  2781. #: ./bashref.texi:1614
  2782. msgid "($#) Expands to the number of positional parameters in decimal."
  2783. msgstr ""
  2784. #. type: item
  2785. #: ./bashref.texi:1615 ./bashref.texi:2464
  2786. #, no-wrap
  2787. msgid "?"
  2788. msgstr ""
  2789. #. type: vindex
  2790. #: ./bashref.texi:1616
  2791. #, no-wrap
  2792. msgid "$?"
  2793. msgstr ""
  2794. #. type: Plain text
  2795. #: ./bashref.texi:1619
  2796. msgid ""
  2797. "($?) Expands to the exit status of the most recently executed foreground "
  2798. "pipeline."
  2799. msgstr ""
  2800. #. type: item
  2801. #: ./bashref.texi:1620 ./bashref.texi:4939
  2802. #, no-wrap
  2803. msgid "-"
  2804. msgstr ""
  2805. #. type: vindex
  2806. #: ./bashref.texi:1621
  2807. #, no-wrap
  2808. msgid "$-"
  2809. msgstr ""
  2810. #. type: Plain text
  2811. #: ./bashref.texi:1626
  2812. msgid ""
  2813. "($-, a hyphen.) Expands to the current option flags as specified upon "
  2814. "invocation, by the @code{set} builtin command, or those set by the shell "
  2815. "itself (such as the @option{-i} option)."
  2816. msgstr ""
  2817. #. type: item
  2818. #: ./bashref.texi:1627
  2819. #, no-wrap
  2820. msgid "$"
  2821. msgstr ""
  2822. #. type: vindex
  2823. #: ./bashref.texi:1628
  2824. #, no-wrap
  2825. msgid "$$"
  2826. msgstr ""
  2827. #. type: Plain text
  2828. #: ./bashref.texi:1631
  2829. msgid ""
  2830. "($$) Expands to the process @sc{id} of the shell. In a @code{()} subshell, "
  2831. "it expands to the process @sc{id} of the invoking shell, not the subshell."
  2832. msgstr ""
  2833. #. type: vindex
  2834. #: ./bashref.texi:1633
  2835. #, no-wrap
  2836. msgid "$!"
  2837. msgstr ""
  2838. #. type: Plain text
  2839. #: ./bashref.texi:1637
  2840. msgid ""
  2841. "($!) Expands to the process @sc{id} of the job most recently placed into the "
  2842. "background, whether executed as an asynchronous command or using the "
  2843. "@code{bg} builtin (@pxref{Job Control Builtins})."
  2844. msgstr ""
  2845. #. type: item
  2846. #: ./bashref.texi:1638
  2847. #, no-wrap
  2848. msgid "0"
  2849. msgstr ""
  2850. #. type: vindex
  2851. #: ./bashref.texi:1639
  2852. #, no-wrap
  2853. msgid "$0"
  2854. msgstr ""
  2855. #. type: Plain text
  2856. #: ./bashref.texi:1647
  2857. msgid ""
  2858. "($0) Expands to the name of the shell or shell script. This is set at shell "
  2859. "initialization. If Bash is invoked with a file of commands (@pxref{Shell "
  2860. "Scripts}), @code{$0} is set to the name of that file. If Bash is started "
  2861. "with the @option{-c} option (@pxref{Invoking Bash}), then @code{$0} is set "
  2862. "to the first argument after the string to be executed, if one is present. "
  2863. "Otherwise, it is set to the filename used to invoke Bash, as given by "
  2864. "argument zero."
  2865. msgstr ""
  2866. #. type: item
  2867. #: ./bashref.texi:1648
  2868. #, no-wrap
  2869. msgid "_"
  2870. msgstr ""
  2871. #. type: vindex
  2872. #: ./bashref.texi:1649
  2873. #, no-wrap
  2874. msgid "$_"
  2875. msgstr ""
  2876. #. type: Plain text
  2877. #: ./bashref.texi:1659
  2878. msgid ""
  2879. "($_, an underscore.) At shell startup, set to the absolute pathname used to "
  2880. "invoke the shell or shell script being executed as passed in the environment "
  2881. "or argument list. Subsequently, expands to the last argument to the "
  2882. "previous command, after expansion. Also set to the full pathname used to "
  2883. "invoke each command executed and placed in the environment exported to that "
  2884. "command. When checking mail, this parameter holds the name of the mail "
  2885. "file."
  2886. msgstr ""
  2887. #. type: cindex
  2888. #: ./bashref.texi:1663
  2889. #, no-wrap
  2890. msgid "expansion"
  2891. msgstr ""
  2892. #. type: Plain text
  2893. #: ./bashref.texi:1667
  2894. msgid ""
  2895. "Expansion is performed on the command line after it has been split into "
  2896. "@code{token}s. There are seven kinds of expansion performed:"
  2897. msgstr ""
  2898. #. type: cindex
  2899. #: ./bashref.texi:1669 ./bashref.texi:1722
  2900. #, no-wrap
  2901. msgid "brace expansion"
  2902. msgstr ""
  2903. #. type: cindex
  2904. #: ./bashref.texi:1670 ./bashref.texi:1794
  2905. #, no-wrap
  2906. msgid "tilde expansion"
  2907. msgstr ""
  2908. #. type: item
  2909. #: ./bashref.texi:1671
  2910. #, no-wrap
  2911. msgid "parameter and variable expansion"
  2912. msgstr ""
  2913. #. type: cindex
  2914. #: ./bashref.texi:1672 ./bashref.texi:2243
  2915. #, no-wrap
  2916. msgid "command substitution"
  2917. msgstr ""
  2918. #. type: cindex
  2919. #: ./bashref.texi:1673 ./bashref.texi:2283
  2920. #, no-wrap
  2921. msgid "arithmetic expansion"
  2922. msgstr ""
  2923. #. type: cindex
  2924. #: ./bashref.texi:1674 ./bashref.texi:2341
  2925. #, no-wrap
  2926. msgid "word splitting"
  2927. msgstr ""
  2928. #. type: cindex
  2929. #: ./bashref.texi:1675 ./bashref.texi:2390
  2930. #, no-wrap
  2931. msgid "filename expansion"
  2932. msgstr ""
  2933. #. type: subsection
  2934. #: ./bashref.texi:1691 ./bashref.texi:1720 ./bashref.texi:1721
  2935. #, no-wrap
  2936. msgid "Brace Expansion"
  2937. msgstr ""
  2938. #. type: menuentry
  2939. #: ./bashref.texi:1691
  2940. msgid "Expansion of expressions within braces."
  2941. msgstr ""
  2942. #. type: subsection
  2943. #: ./bashref.texi:1691 ./bashref.texi:1792 ./bashref.texi:1793
  2944. #, no-wrap
  2945. msgid "Tilde Expansion"
  2946. msgstr ""
  2947. #. type: menuentry
  2948. #: ./bashref.texi:1691
  2949. msgid "Expansion of the ~ character."
  2950. msgstr ""
  2951. #. type: subsection
  2952. #: ./bashref.texi:1691 ./bashref.texi:1862 ./bashref.texi:1863
  2953. #, no-wrap
  2954. msgid "Shell Parameter Expansion"
  2955. msgstr ""
  2956. #. type: menuentry
  2957. #: ./bashref.texi:1691
  2958. msgid "How Bash expands variables to their values."
  2959. msgstr ""
  2960. #. type: subsection
  2961. #: ./bashref.texi:1691 ./bashref.texi:2241 ./bashref.texi:2242
  2962. #, no-wrap
  2963. msgid "Command Substitution"
  2964. msgstr ""
  2965. #. type: menuentry
  2966. #: ./bashref.texi:1691
  2967. msgid "Using the output of a command as an argument."
  2968. msgstr ""
  2969. #. type: subsection
  2970. #: ./bashref.texi:1691 ./bashref.texi:2280 ./bashref.texi:2281
  2971. #, no-wrap
  2972. msgid "Arithmetic Expansion"
  2973. msgstr ""
  2974. #. type: menuentry
  2975. #: ./bashref.texi:1691
  2976. msgid "How to use arithmetic in shell expansions."
  2977. msgstr ""
  2978. #. type: subsection
  2979. #: ./bashref.texi:1691 ./bashref.texi:2304 ./bashref.texi:2305
  2980. #, no-wrap
  2981. msgid "Process Substitution"
  2982. msgstr ""
  2983. #. type: menuentry
  2984. #: ./bashref.texi:1691
  2985. msgid "A way to write and read to and from a command."
  2986. msgstr ""
  2987. #. type: subsection
  2988. #: ./bashref.texi:1691 ./bashref.texi:2339 ./bashref.texi:2340
  2989. #, no-wrap
  2990. msgid "Word Splitting"
  2991. msgstr ""
  2992. #. type: menuentry
  2993. #: ./bashref.texi:1691
  2994. msgid "How the results of expansion are split into separate arguments."
  2995. msgstr ""
  2996. #. type: subsection
  2997. #: ./bashref.texi:1691 ./bashref.texi:2383 ./bashref.texi:2384
  2998. #, no-wrap
  2999. msgid "Filename Expansion"
  3000. msgstr ""
  3001. #. type: menuentry
  3002. #: ./bashref.texi:1691
  3003. msgid "A shorthand for specifying filenames matching patterns."
  3004. msgstr ""
  3005. #. type: subsection
  3006. #: ./bashref.texi:1691 ./bashref.texi:2536 ./bashref.texi:2537
  3007. #, no-wrap
  3008. msgid "Quote Removal"
  3009. msgstr ""
  3010. #. type: menuentry
  3011. #: ./bashref.texi:1691
  3012. msgid "How and when quote characters are removed from words."
  3013. msgstr ""
  3014. #. type: Plain text
  3015. #: ./bashref.texi:1699
  3016. msgid ""
  3017. "The order of expansions is: brace expansion; tilde expansion, parameter and "
  3018. "variable expansion, arithmetic expansion, and command substitution (done in "
  3019. "a left-to-right fashion); word splitting; and filename expansion."
  3020. msgstr ""
  3021. #. type: Plain text
  3022. #: ./bashref.texi:1705
  3023. msgid ""
  3024. "On systems that can support it, there is an additional expansion available: "
  3025. "@var{process substitution}. This is performed at the same time as tilde, "
  3026. "parameter, variable, and arithmetic expansion and command substitution."
  3027. msgstr ""
  3028. #. type: Plain text
  3029. #: ./bashref.texi:1709
  3030. msgid ""
  3031. "After these expansions are performed, quote characters present in the "
  3032. "original word are removed unless they have been quoted themselves "
  3033. "(@var{quote removal})."
  3034. msgstr ""
  3035. #. type: Plain text
  3036. #: ./bashref.texi:1716
  3037. msgid ""
  3038. "Only brace expansion, word splitting, and filename expansion can change the "
  3039. "number of words of the expansion; other expansions expand a single word to a "
  3040. "single word. The only exceptions to this are the expansions of "
  3041. "@code{\"$@@\"} (@pxref{Special Parameters}) and "
  3042. "@code{\"$@{@var{name}[@@]@}\"} (@pxref{Arrays})."
  3043. msgstr ""
  3044. #. type: Plain text
  3045. #: ./bashref.texi:1719
  3046. msgid ""
  3047. "After all expansions, @code{quote removal} (@pxref{Quote Removal}) is "
  3048. "performed."
  3049. msgstr ""
  3050. #. type: cindex
  3051. #: ./bashref.texi:1723
  3052. #, no-wrap
  3053. msgid "expansion, brace"
  3054. msgstr ""
  3055. #. type: Plain text
  3056. #: ./bashref.texi:1736
  3057. msgid ""
  3058. "Brace expansion is a mechanism by which arbitrary strings may be generated. "
  3059. "This mechanism is similar to @var{filename expansion} (@pxref{Filename "
  3060. "Expansion}), but the filenames generated need not exist. Patterns to be "
  3061. "brace expanded take the form of an optional @var{preamble}, followed by "
  3062. "either a series of comma-separated strings or a sequence expression between "
  3063. "a pair of braces, followed by an optional @var{postscript}. The preamble is "
  3064. "prefixed to each string contained within the braces, and the postscript is "
  3065. "then appended to each resulting string, expanding left to right."
  3066. msgstr ""
  3067. #. type: Plain text
  3068. #: ./bashref.texi:1741
  3069. msgid ""
  3070. "Brace expansions may be nested. The results of each expanded string are not "
  3071. "sorted; left to right order is preserved. For example,"
  3072. msgstr ""
  3073. #. type: example
  3074. #: ./bashref.texi:1744
  3075. #, no-wrap
  3076. msgid ""
  3077. "bash$ echo a@{d,c,b@}e\n"
  3078. "ade ace abe\n"
  3079. msgstr ""
  3080. #. type: Plain text
  3081. #: ./bashref.texi:1762
  3082. msgid ""
  3083. "A sequence expression takes the form "
  3084. "@code{@{@var{x}..@var{y}[..@var{incr}]@}}, where @var{x} and @var{y} are "
  3085. "either integers or single characters, and @var{incr}, an optional increment, "
  3086. "is an integer. When integers are supplied, the expression expands to each "
  3087. "number between @var{x} and @var{y}, inclusive. Supplied integers may be "
  3088. "prefixed with @samp{0} to force each term to have the same width. When "
  3089. "either @var{x} or @var{y} begins with a zero, the shell attempts to force "
  3090. "all generated terms to contain the same number of digits, zero-padding where "
  3091. "necessary. When characters are supplied, the expression expands to each "
  3092. "character lexicographically between @var{x} and @var{y}, inclusive, using "
  3093. "the default C locale. Note that both @var{x} and @var{y} must be of the "
  3094. "same type. When the increment is supplied, it is used as the difference "
  3095. "between each term. The default increment is 1 or -1 as appropriate."
  3096. msgstr ""
  3097. #. type: Plain text
  3098. #: ./bashref.texi:1770
  3099. msgid ""
  3100. "Brace expansion is performed before any other expansions, and any characters "
  3101. "special to other expansions are preserved in the result. It is strictly "
  3102. "textual. Bash does not apply any syntactic interpretation to the context of "
  3103. "the expansion or the text between the braces. To avoid conflicts with "
  3104. "parameter expansion, the string @samp{$@{} is not considered eligible for "
  3105. "brace expansion."
  3106. msgstr ""
  3107. #. type: Plain text
  3108. #: ./bashref.texi:1775
  3109. msgid ""
  3110. "A correctly-formed brace expansion must contain unquoted opening and closing "
  3111. "braces, and at least one unquoted comma or a valid sequence expression. Any "
  3112. "incorrectly formed brace expansion is left unchanged."
  3113. msgstr ""
  3114. #. type: Plain text
  3115. #: ./bashref.texi:1780
  3116. msgid ""
  3117. "A @{ or @samp{,} may be quoted with a backslash to prevent its being "
  3118. "considered part of a brace expression. To avoid conflicts with parameter "
  3119. "expansion, the string @samp{$@{} is not considered eligible for brace "
  3120. "expansion."
  3121. msgstr ""
  3122. #. type: Plain text
  3123. #: ./bashref.texi:1784
  3124. msgid ""
  3125. "This construct is typically used as shorthand when the common prefix of the "
  3126. "strings to be generated is longer than in the above example:"
  3127. msgstr ""
  3128. #. type: example
  3129. #: ./bashref.texi:1786
  3130. #, no-wrap
  3131. msgid "mkdir /usr/local/src/bash/@{old,new,dist,bugs@}\n"
  3132. msgstr ""
  3133. #. type: example
  3134. #: ./bashref.texi:1790
  3135. #, no-wrap
  3136. msgid "chown root /usr/@{ucb/@{ex,edit@},lib/@{ex?.?*,how_ex@}@}\n"
  3137. msgstr ""
  3138. #. type: cindex
  3139. #: ./bashref.texi:1795
  3140. #, no-wrap
  3141. msgid "expansion, tilde"
  3142. msgstr ""
  3143. #. type: Plain text
  3144. #: ./bashref.texi:1809
  3145. msgid ""
  3146. "If a word begins with an unquoted tilde character (@samp{~}), all of the "
  3147. "characters up to the first unquoted slash (or all characters, if there is no "
  3148. "unquoted slash) are considered a @var{tilde-prefix}. If none of the "
  3149. "characters in the tilde-prefix are quoted, the characters in the "
  3150. "tilde-prefix following the tilde are treated as a possible @var{login "
  3151. "name}. If this login name is the null string, the tilde is replaced with "
  3152. "the value of the @env{HOME} shell variable. If @env{HOME} is unset, the "
  3153. "home directory of the user executing the shell is substituted instead. "
  3154. "Otherwise, the tilde-prefix is replaced with the home directory associated "
  3155. "with the specified login name."
  3156. msgstr ""
  3157. #. type: Plain text
  3158. #: ./bashref.texi:1814
  3159. msgid ""
  3160. "If the tilde-prefix is @samp{~+}, the value of the shell variable @env{PWD} "
  3161. "replaces the tilde-prefix. If the tilde-prefix is @samp{~-}, the value of "
  3162. "the shell variable @env{OLDPWD}, if it is set, is substituted."
  3163. msgstr ""
  3164. #. type: Plain text
  3165. #: ./bashref.texi:1823
  3166. msgid ""
  3167. "If the characters following the tilde in the tilde-prefix consist of a "
  3168. "number @var{N}, optionally prefixed by a @samp{+} or a @samp{-}, the "
  3169. "tilde-prefix is replaced with the corresponding element from the directory "
  3170. "stack, as it would be displayed by the @code{dirs} builtin invoked with the "
  3171. "characters following tilde in the tilde-prefix as an argument (@pxref{The "
  3172. "Directory Stack}). If the tilde-prefix, sans the tilde, consists of a "
  3173. "number without a leading @samp{+} or @samp{-}, @samp{+} is assumed."
  3174. msgstr ""
  3175. #. type: Plain text
  3176. #: ./bashref.texi:1826
  3177. msgid ""
  3178. "If the login name is invalid, or the tilde expansion fails, the word is left "
  3179. "unchanged."
  3180. msgstr ""
  3181. #. type: Plain text
  3182. #: ./bashref.texi:1833
  3183. msgid ""
  3184. "Each variable assignment is checked for unquoted tilde-prefixes immediately "
  3185. "following a @samp{:} or the first @samp{=}. In these cases, tilde expansion "
  3186. "is also performed. Consequently, one may use filenames with tildes in "
  3187. "assignments to @env{PATH}, @env{MAILPATH}, and @env{CDPATH}, and the shell "
  3188. "assigns the expanded value."
  3189. msgstr ""
  3190. #. type: Plain text
  3191. #: ./bashref.texi:1835
  3192. msgid "The following table shows how Bash treats unquoted tilde-prefixes:"
  3193. msgstr ""
  3194. #. type: item
  3195. #: ./bashref.texi:1837
  3196. #, no-wrap
  3197. msgid "~"
  3198. msgstr ""
  3199. #. type: table
  3200. #: ./bashref.texi:1839
  3201. msgid "The value of @code{$HOME}"
  3202. msgstr ""
  3203. #. type: item
  3204. #: ./bashref.texi:1839
  3205. #, no-wrap
  3206. msgid "~/foo"
  3207. msgstr ""
  3208. #. type: file{#1}
  3209. #: ./bashref.texi:1841
  3210. msgid "$HOME/foo"
  3211. msgstr ""
  3212. #. type: item
  3213. #: ./bashref.texi:1842
  3214. #, no-wrap
  3215. msgid "~fred/foo"
  3216. msgstr ""
  3217. #. type: table
  3218. #: ./bashref.texi:1845
  3219. msgid "The subdirectory @code{foo} of the home directory of the user @code{fred}"
  3220. msgstr ""
  3221. #. type: item
  3222. #: ./bashref.texi:1846
  3223. #, no-wrap
  3224. msgid "~+/foo"
  3225. msgstr ""
  3226. #. type: file{#1}
  3227. #: ./bashref.texi:1848
  3228. msgid "$PWD/foo"
  3229. msgstr ""
  3230. #. type: item
  3231. #: ./bashref.texi:1849
  3232. #, no-wrap
  3233. msgid "~-/foo"
  3234. msgstr ""
  3235. #. type: file{#1}
  3236. #: ./bashref.texi:1851
  3237. msgid "$@{OLDPWD-'~-'@}/foo"
  3238. msgstr ""
  3239. #. type: item
  3240. #: ./bashref.texi:1852
  3241. #, no-wrap
  3242. msgid "~@var{N}"
  3243. msgstr ""
  3244. #. type: table
  3245. #: ./bashref.texi:1854 ./bashref.texi:1857
  3246. msgid "The string that would be displayed by @samp{dirs +@var{N}}"
  3247. msgstr ""
  3248. #. type: item
  3249. #: ./bashref.texi:1855
  3250. #, no-wrap
  3251. msgid "~+@var{N}"
  3252. msgstr ""
  3253. #. type: item
  3254. #: ./bashref.texi:1858
  3255. #, no-wrap
  3256. msgid "~-@var{N}"
  3257. msgstr ""
  3258. #. type: table
  3259. #: ./bashref.texi:1860
  3260. msgid "The string that would be displayed by @samp{dirs -@var{N}}"
  3261. msgstr ""
  3262. #. type: cindex
  3263. #: ./bashref.texi:1864
  3264. #, no-wrap
  3265. msgid "parameter expansion"
  3266. msgstr ""
  3267. #. type: cindex
  3268. #: ./bashref.texi:1865
  3269. #, no-wrap
  3270. msgid "expansion, parameter"
  3271. msgstr ""
  3272. #. type: Plain text
  3273. #: ./bashref.texi:1873
  3274. msgid ""
  3275. "The @samp{$} character introduces parameter expansion, command substitution, "
  3276. "or arithmetic expansion. The parameter name or symbol to be expanded may be "
  3277. "enclosed in braces, which are optional but serve to protect the variable to "
  3278. "be expanded from characters immediately following it which could be "
  3279. "interpreted as part of the name."
  3280. msgstr ""
  3281. #. type: Plain text
  3282. #: ./bashref.texi:1878
  3283. msgid ""
  3284. "When braces are used, the matching ending brace is the first @samp{@}} not "
  3285. "escaped by a backslash or within a quoted string, and not within an embedded "
  3286. "arithmetic expansion, command substitution, or parameter expansion."
  3287. msgstr ""
  3288. #. type: Plain text
  3289. #: ./bashref.texi:1887
  3290. msgid ""
  3291. "The basic form of parameter expansion is $@{@var{parameter}@}. The value of "
  3292. "@var{parameter} is substituted. The @var{parameter} is a shell parameter as "
  3293. "described above (@pxref{Shell Parameters}) or an array reference "
  3294. "(@pxref{Arrays}). The braces are required when @var{parameter} is a "
  3295. "positional parameter with more than one digit, or when @var{parameter} is "
  3296. "followed by a character that is not to be interpreted as part of its name."
  3297. msgstr ""
  3298. #. type: Plain text
  3299. #: ./bashref.texi:1904
  3300. msgid ""
  3301. "If the first character of @var{parameter} is an exclamation point (!), and "
  3302. "@var{parameter} is not a @var{nameref}, it introduces a level of variable "
  3303. "indirection. Bash uses the value of the variable formed from the rest of "
  3304. "@var{parameter} as the name of the variable; this variable is then expanded "
  3305. "and that value is used in the rest of the substitution, rather than the "
  3306. "value of @var{parameter} itself. This is known as @code{indirect "
  3307. "expansion}. If @var{parameter} is a nameref, this expands to the name of "
  3308. "the variable referenced by @var{parameter} instead of performing the "
  3309. "complete indirect expansion. The exceptions to this are the expansions of "
  3310. "$@{!@var{prefix}*@} and $@{!@var{name}[@@]@} described below. The "
  3311. "exclamation point must immediately follow the left brace in order to "
  3312. "introduce indirection."
  3313. msgstr ""
  3314. #. type: Plain text
  3315. #: ./bashref.texi:1907
  3316. msgid ""
  3317. "In each of the cases below, @var{word} is subject to tilde expansion, "
  3318. "parameter expansion, command substitution, and arithmetic expansion."
  3319. msgstr ""
  3320. #. type: Plain text
  3321. #: ./bashref.texi:1914
  3322. msgid ""
  3323. "When not performing substring expansion, using the form described below "
  3324. "(e.g., @samp{:-}), Bash tests for a parameter that is unset or null. "
  3325. "Omitting the colon results in a test only for a parameter that is unset. "
  3326. "Put another way, if the colon is included, the operator tests for both "
  3327. "@var{parameter}'s existence and that its value is not null; if the colon is "
  3328. "omitted, the operator tests only for existence."
  3329. msgstr ""
  3330. #. type: item
  3331. #: ./bashref.texi:1917
  3332. #, no-wrap
  3333. msgid "$@{@var{parameter}:@minus{}@var{word}@}"
  3334. msgstr ""
  3335. #. type: table
  3336. #: ./bashref.texi:1921
  3337. msgid ""
  3338. "If @var{parameter} is unset or null, the expansion of @var{word} is "
  3339. "substituted. Otherwise, the value of @var{parameter} is substituted."
  3340. msgstr ""
  3341. #. type: item
  3342. #: ./bashref.texi:1922
  3343. #, no-wrap
  3344. msgid "$@{@var{parameter}:=@var{word}@}"
  3345. msgstr ""
  3346. #. type: table
  3347. #: ./bashref.texi:1929
  3348. msgid ""
  3349. "If @var{parameter} is unset or null, the expansion of @var{word} is assigned "
  3350. "to @var{parameter}. The value of @var{parameter} is then substituted. "
  3351. "Positional parameters and special parameters may not be assigned to in this "
  3352. "way."
  3353. msgstr ""
  3354. #. type: item
  3355. #: ./bashref.texi:1930
  3356. #, no-wrap
  3357. msgid "$@{@var{parameter}:?@var{word}@}"
  3358. msgstr ""
  3359. #. type: table
  3360. #: ./bashref.texi:1937
  3361. msgid ""
  3362. "If @var{parameter} is null or unset, the expansion of @var{word} (or a "
  3363. "message to that effect if @var{word} is not present) is written to the "
  3364. "standard error and the shell, if it is not interactive, exits. Otherwise, "
  3365. "the value of @var{parameter} is substituted."
  3366. msgstr ""
  3367. #. type: item
  3368. #: ./bashref.texi:1938
  3369. #, no-wrap
  3370. msgid "$@{@var{parameter}:+@var{word}@}"
  3371. msgstr ""
  3372. #. type: table
  3373. #: ./bashref.texi:1942
  3374. msgid ""
  3375. "If @var{parameter} is null or unset, nothing is substituted, otherwise the "
  3376. "expansion of @var{word} is substituted."
  3377. msgstr ""
  3378. #. type: item
  3379. #: ./bashref.texi:1943
  3380. #, no-wrap
  3381. msgid "$@{@var{parameter}:@var{offset}@}"
  3382. msgstr ""
  3383. #. type: itemx
  3384. #: ./bashref.texi:1944
  3385. #, no-wrap
  3386. msgid "$@{@var{parameter}:@var{offset}:@var{length}@}"
  3387. msgstr ""
  3388. #. type: table
  3389. #: ./bashref.texi:1956
  3390. msgid ""
  3391. "This is referred to as Substring Expansion. It expands to up to "
  3392. "@var{length} characters of the value of @var{parameter} starting at the "
  3393. "character specified by @var{offset}. If @var{parameter} is @samp{@@}, an "
  3394. "indexed array subscripted by @samp{@@} or @samp{*}, or an associative array "
  3395. "name, the results differ as described below. If @var{length} is omitted, it "
  3396. "expands to the substring of the value of @var{parameter} starting at the "
  3397. "character specified by @var{offset} and extending to the end of the value. "
  3398. "@var{length} and @var{offset} are arithmetic expressions (@pxref{Shell "
  3399. "Arithmetic})."
  3400. msgstr ""
  3401. #. type: table
  3402. #: ./bashref.texi:1967
  3403. msgid ""
  3404. "If @var{offset} evaluates to a number less than zero, the value is used as "
  3405. "an offset in characters from the end of the value of @var{parameter}. If "
  3406. "@var{length} evaluates to a number less than zero, it is interpreted as an "
  3407. "offset in characters from the end of the value of @var{parameter} rather "
  3408. "than a number of characters, and the expansion is the characters between "
  3409. "@var{offset} and that result. Note that a negative offset must be separated "
  3410. "from the colon by at least one space to avoid being confused with the "
  3411. "@samp{:-} expansion."
  3412. msgstr ""
  3413. #. type: table
  3414. #: ./bashref.texi:1970
  3415. msgid ""
  3416. "Here are some examples illustrating substring expansion on parameters and "
  3417. "subscripted arrays:"
  3418. msgstr ""
  3419. #. type: verbatim
  3420. #: ./bashref.texi:1976
  3421. #, no-wrap
  3422. msgid ""
  3423. "$ string=01234567890abcdefgh\n"
  3424. "$ echo ${string:7}\n"
  3425. "7890abcdefgh\n"
  3426. "$ echo ${string:7:0}\n"
  3427. "\n"
  3428. msgstr ""
  3429. #. type: verbatim
  3430. #: ./bashref.texi:1984
  3431. #, no-wrap
  3432. msgid ""
  3433. "$ echo ${string:7:2}\n"
  3434. "78\n"
  3435. "$ echo ${string:7:-2}\n"
  3436. "7890abcdef\n"
  3437. "$ echo ${string: -7}\n"
  3438. "bcdefgh\n"
  3439. "$ echo ${string: -7:0}\n"
  3440. "\n"
  3441. msgstr ""
  3442. #. type: verbatim
  3443. #: ./bashref.texi:1993
  3444. #, no-wrap
  3445. msgid ""
  3446. "$ echo ${string: -7:2}\n"
  3447. "bc\n"
  3448. "$ echo ${string: -7:-2}\n"
  3449. "bcdef\n"
  3450. "$ set -- 01234567890abcdefgh\n"
  3451. "$ echo ${1:7}\n"
  3452. "7890abcdefgh\n"
  3453. "$ echo ${1:7:0}\n"
  3454. "\n"
  3455. msgstr ""
  3456. #. type: verbatim
  3457. #: ./bashref.texi:2001
  3458. #, no-wrap
  3459. msgid ""
  3460. "$ echo ${1:7:2}\n"
  3461. "78\n"
  3462. "$ echo ${1:7:-2}\n"
  3463. "7890abcdef\n"
  3464. "$ echo ${1: -7}\n"
  3465. "bcdefgh\n"
  3466. "$ echo ${1: -7:0}\n"
  3467. "\n"
  3468. msgstr ""
  3469. #. type: verbatim
  3470. #: ./bashref.texi:2010
  3471. #, no-wrap
  3472. msgid ""
  3473. "$ echo ${1: -7:2}\n"
  3474. "bc\n"
  3475. "$ echo ${1: -7:-2}\n"
  3476. "bcdef\n"
  3477. "$ array[0]=01234567890abcdefgh\n"
  3478. "$ echo ${array[0]:7}\n"
  3479. "7890abcdefgh\n"
  3480. "$ echo ${array[0]:7:0}\n"
  3481. "\n"
  3482. msgstr ""
  3483. #. type: verbatim
  3484. #: ./bashref.texi:2018
  3485. #, no-wrap
  3486. msgid ""
  3487. "$ echo ${array[0]:7:2}\n"
  3488. "78\n"
  3489. "$ echo ${array[0]:7:-2}\n"
  3490. "7890abcdef\n"
  3491. "$ echo ${array[0]: -7}\n"
  3492. "bcdefgh\n"
  3493. "$ echo ${array[0]: -7:0}\n"
  3494. "\n"
  3495. msgstr ""
  3496. #. type: verbatim
  3497. #: ./bashref.texi:2023
  3498. #, no-wrap
  3499. msgid ""
  3500. "$ echo ${array[0]: -7:2}\n"
  3501. "bc\n"
  3502. "$ echo ${array[0]: -7:-2}\n"
  3503. "bcdef\n"
  3504. msgstr ""
  3505. #. type: table
  3506. #: ./bashref.texi:2031
  3507. msgid ""
  3508. "If @var{parameter} is @samp{@@}, the result is @var{length} positional "
  3509. "parameters beginning at @var{offset}. A negative @var{offset} is taken "
  3510. "relative to one greater than the greatest positional parameter, so an offset "
  3511. "of -1 evaluates to the last positional parameter. It is an expansion error "
  3512. "if @var{length} evaluates to a number less than zero."
  3513. msgstr ""
  3514. #. type: table
  3515. #: ./bashref.texi:2034
  3516. msgid ""
  3517. "The following examples illustrate substring expansion using positional "
  3518. "parameters:"
  3519. msgstr ""
  3520. #. type: verbatim
  3521. #: ./bashref.texi:2040
  3522. #, no-wrap
  3523. msgid ""
  3524. "$ set -- 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3525. "$ echo ${@:7}\n"
  3526. "7 8 9 0 a b c d e f g h\n"
  3527. "$ echo ${@:7:0}\n"
  3528. "\n"
  3529. msgstr ""
  3530. #. type: verbatim
  3531. #: ./bashref.texi:2052
  3532. #, no-wrap
  3533. msgid ""
  3534. "$ echo ${@:7:2}\n"
  3535. "7 8\n"
  3536. "$ echo ${@:7:-2}\n"
  3537. "bash: -2: substring expression < 0\n"
  3538. "$ echo ${@: -7:2}\n"
  3539. "b c\n"
  3540. "$ echo ${@:0}\n"
  3541. "./bash 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3542. "$ echo ${@:0:2}\n"
  3543. "./bash 1\n"
  3544. "$ echo ${@: -7:0}\n"
  3545. "\n"
  3546. msgstr ""
  3547. #. type: table
  3548. #: ./bashref.texi:2061
  3549. msgid ""
  3550. "If @var{parameter} is an indexed array name subscripted by @samp{@@} or "
  3551. "@samp{*}, the result is the @var{length} members of the array beginning with "
  3552. "@code{$@{@var{parameter}[@var{offset}]@}}. A negative @var{offset} is taken "
  3553. "relative to one greater than the maximum index of the specified array. It "
  3554. "is an expansion error if @var{length} evaluates to a number less than zero."
  3555. msgstr ""
  3556. #. type: table
  3557. #: ./bashref.texi:2064
  3558. msgid "These examples show how you can use substring expansion with indexed arrays:"
  3559. msgstr ""
  3560. #. type: verbatim
  3561. #: ./bashref.texi:2080
  3562. #, no-wrap
  3563. msgid ""
  3564. "$ array=(0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h)\n"
  3565. "$ echo ${array[@]:7}\n"
  3566. "7 8 9 0 a b c d e f g h\n"
  3567. "$ echo ${array[@]:7:2}\n"
  3568. "7 8\n"
  3569. "$ echo ${array[@]: -7:2}\n"
  3570. "b c\n"
  3571. "$ echo ${array[@]: -7:-2}\n"
  3572. "bash: -2: substring expression < 0\n"
  3573. "$ echo ${array[@]:0}\n"
  3574. "0 1 2 3 4 5 6 7 8 9 0 a b c d e f g h\n"
  3575. "$ echo ${array[@]:0:2}\n"
  3576. "0 1\n"
  3577. "$ echo ${array[@]: -7:0}\n"
  3578. "\n"
  3579. msgstr ""
  3580. #. type: table
  3581. #: ./bashref.texi:2085
  3582. msgid ""
  3583. "Substring expansion applied to an associative array produces undefined "
  3584. "results."
  3585. msgstr ""
  3586. #. type: table
  3587. #: ./bashref.texi:2090
  3588. msgid ""
  3589. "Substring indexing is zero-based unless the positional parameters are used, "
  3590. "in which case the indexing starts at 1 by default. If @var{offset} is 0, "
  3591. "and the positional parameters are used, @code{$@@} is prefixed to the list."
  3592. msgstr ""
  3593. #. type: item
  3594. #: ./bashref.texi:2091
  3595. #, no-wrap
  3596. msgid "$@{!@var{prefix}*@}"
  3597. msgstr ""
  3598. #. type: itemx
  3599. #: ./bashref.texi:2092
  3600. #, no-wrap
  3601. msgid "$@{!@var{prefix}@@@}"
  3602. msgstr ""
  3603. #. type: table
  3604. #: ./bashref.texi:2097
  3605. msgid ""
  3606. "Expands to the names of variables whose names begin with @var{prefix}, "
  3607. "separated by the first character of the @env{IFS} special variable. When "
  3608. "@samp{@@} is used and the expansion appears within double quotes, each "
  3609. "variable name expands to a separate word."
  3610. msgstr ""
  3611. #. type: item
  3612. #: ./bashref.texi:2098
  3613. #, no-wrap
  3614. msgid "$@{!@var{name}[@@]@}"
  3615. msgstr ""
  3616. #. type: itemx
  3617. #: ./bashref.texi:2099
  3618. #, no-wrap
  3619. msgid "$@{!@var{name}[*]@}"
  3620. msgstr ""
  3621. #. type: table
  3622. #: ./bashref.texi:2106
  3623. msgid ""
  3624. "If @var{name} is an array variable, expands to the list of array indices "
  3625. "(keys) assigned in @var{name}. If @var{name} is not an array, expands to 0 "
  3626. "if @var{name} is set and null otherwise. When @samp{@@} is used and the "
  3627. "expansion appears within double quotes, each key expands to a separate word."
  3628. msgstr ""
  3629. #. type: item
  3630. #: ./bashref.texi:2107
  3631. #, no-wrap
  3632. msgid "$@{#@var{parameter}@}"
  3633. msgstr ""
  3634. #. type: table
  3635. #: ./bashref.texi:2119
  3636. msgid ""
  3637. "The length in characters of the expanded value of @var{parameter} is "
  3638. "substituted. If @var{parameter} is @samp{*} or @samp{@@}, the value "
  3639. "substituted is the number of positional parameters. If @var{parameter} is "
  3640. "an array name subscripted by @samp{*} or @samp{@@}, the value substituted is "
  3641. "the number of elements in the array. If @var{parameter} is an indexed array "
  3642. "name subscripted by a negative number, that number is interpreted as "
  3643. "relative to one greater than the maximum index of @var{parameter}, so "
  3644. "negative indices count back from the end of the array, and an index of -1 "
  3645. "references the last element."
  3646. msgstr ""
  3647. #. type: item
  3648. #: ./bashref.texi:2120
  3649. #, no-wrap
  3650. msgid "$@{@var{parameter}#@var{word}@}"
  3651. msgstr ""
  3652. #. type: itemx
  3653. #: ./bashref.texi:2121
  3654. #, no-wrap
  3655. msgid "$@{@var{parameter}##@var{word}@}"
  3656. msgstr ""
  3657. #. type: table
  3658. #: ./bashref.texi:2136
  3659. msgid ""
  3660. "The @var{word} is expanded to produce a pattern just as in filename "
  3661. "expansion (@pxref{Filename Expansion}). If the pattern matches the "
  3662. "beginning of the expanded value of @var{parameter}, then the result of the "
  3663. "expansion is the expanded value of @var{parameter} with the shortest "
  3664. "matching pattern (the @samp{#} case) or the longest matching pattern (the "
  3665. "@samp{##} case) deleted. If @var{parameter} is @samp{@@} or @samp{*}, the "
  3666. "pattern removal operation is applied to each positional parameter in turn, "
  3667. "and the expansion is the resultant list. If @var{parameter} is an array "
  3668. "variable subscripted with @samp{@@} or @samp{*}, the pattern removal "
  3669. "operation is applied to each member of the array in turn, and the expansion "
  3670. "is the resultant list."
  3671. msgstr ""
  3672. #. type: item
  3673. #: ./bashref.texi:2137
  3674. #, no-wrap
  3675. msgid "$@{@var{parameter}%@var{word}@}"
  3676. msgstr ""
  3677. #. type: itemx
  3678. #: ./bashref.texi:2138
  3679. #, no-wrap
  3680. msgid "$@{@var{parameter}%%@var{word}@}"
  3681. msgstr ""
  3682. #. type: table
  3683. #: ./bashref.texi:2152
  3684. msgid ""
  3685. "The @var{word} is expanded to produce a pattern just as in filename "
  3686. "expansion. If the pattern matches a trailing portion of the expanded value "
  3687. "of @var{parameter}, then the result of the expansion is the value of "
  3688. "@var{parameter} with the shortest matching pattern (the @samp{%} case) or "
  3689. "the longest matching pattern (the @samp{%%} case) deleted. If "
  3690. "@var{parameter} is @samp{@@} or @samp{*}, the pattern removal operation is "
  3691. "applied to each positional parameter in turn, and the expansion is the "
  3692. "resultant list. If @var{parameter} is an array variable subscripted with "
  3693. "@samp{@@} or @samp{*}, the pattern removal operation is applied to each "
  3694. "member of the array in turn, and the expansion is the resultant list."
  3695. msgstr ""
  3696. #. type: item
  3697. #: ./bashref.texi:2153
  3698. #, no-wrap
  3699. msgid "$@{@var{parameter}/@var{pattern}/@var{string}@}"
  3700. msgstr ""
  3701. #. type: table
  3702. #: ./bashref.texi:2178
  3703. msgid ""
  3704. "The @var{pattern} is expanded to produce a pattern just as in filename "
  3705. "expansion. @var{Parameter} is expanded and the longest match of "
  3706. "@var{pattern} against its value is replaced with @var{string}. If "
  3707. "@var{pattern} begins with @samp{/}, all matches of @var{pattern} are "
  3708. "replaced with @var{string}. Normally only the first match is replaced. If "
  3709. "@var{pattern} begins with @samp{#}, it must match at the beginning of the "
  3710. "expanded value of @var{parameter}. If @var{pattern} begins with @samp{%}, "
  3711. "it must match at the end of the expanded value of @var{parameter}. If "
  3712. "@var{string} is null, matches of @var{pattern} are deleted and the @code{/} "
  3713. "following @var{pattern} may be omitted. If the @code{nocasematch} shell "
  3714. "option (see the description of @code{shopt} in @ref{The Shopt Builtin}) is "
  3715. "enabled, the match is performed without regard to the case of alphabetic "
  3716. "characters. If @var{parameter} is @samp{@@} or @samp{*}, the substitution "
  3717. "operation is applied to each positional parameter in turn, and the expansion "
  3718. "is the resultant list. If @var{parameter} is an array variable subscripted "
  3719. "with @samp{@@} or @samp{*}, the substitution operation is applied to each "
  3720. "member of the array in turn, and the expansion is the resultant list."
  3721. msgstr ""
  3722. #. type: item
  3723. #: ./bashref.texi:2179
  3724. #, no-wrap
  3725. msgid "$@{@var{parameter}^@var{pattern}@}"
  3726. msgstr ""
  3727. #. type: itemx
  3728. #: ./bashref.texi:2180
  3729. #, no-wrap
  3730. msgid "$@{@var{parameter}^^@var{pattern}@}"
  3731. msgstr ""
  3732. #. type: itemx
  3733. #: ./bashref.texi:2181
  3734. #, no-wrap
  3735. msgid "$@{@var{parameter},@var{pattern}@}"
  3736. msgstr ""
  3737. #. type: itemx
  3738. #: ./bashref.texi:2182
  3739. #, no-wrap
  3740. msgid "$@{@var{parameter},,@var{pattern}@}"
  3741. msgstr ""
  3742. #. type: table
  3743. #: ./bashref.texi:2204
  3744. msgid ""
  3745. "This expansion modifies the case of alphabetic characters in "
  3746. "@var{parameter}. The @var{pattern} is expanded to produce a pattern just as "
  3747. "in filename expansion. Each character in the expanded value of "
  3748. "@var{parameter} is tested against @var{pattern}, and, if it matches the "
  3749. "pattern, its case is converted. The pattern should not attempt to match "
  3750. "more than one character. The @samp{^} operator converts lowercase letters "
  3751. "matching @var{pattern} to uppercase; the @samp{,} operator converts matching "
  3752. "uppercase letters to lowercase. The @samp{^^} and @samp{,,} expansions "
  3753. "convert each matched character in the expanded value; the @samp{^} and "
  3754. "@samp{,} expansions match and convert only the first character in the "
  3755. "expanded value. If @var{pattern} is omitted, it is treated like a @samp{?}, "
  3756. "which matches every character. If @var{parameter} is @samp{@@} or @samp{*}, "
  3757. "the case modification operation is applied to each positional parameter in "
  3758. "turn, and the expansion is the resultant list. If @var{parameter} is an "
  3759. "array variable subscripted with @samp{@@} or @samp{*}, the case modification "
  3760. "operation is applied to each member of the array in turn, and the expansion "
  3761. "is the resultant list."
  3762. msgstr ""
  3763. #. type: item
  3764. #: ./bashref.texi:2205
  3765. #, no-wrap
  3766. msgid "$@{@var{parameter}@@@var{operator}@}"
  3767. msgstr ""
  3768. #. type: table
  3769. #: ./bashref.texi:2209
  3770. msgid ""
  3771. "The expansion is either a transformation of the value of @var{parameter} or "
  3772. "information about @var{parameter} itself, depending on the value of "
  3773. "@var{operator}. Each @var{operator} is a single letter:"
  3774. msgstr ""
  3775. #. type: item
  3776. #: ./bashref.texi:2211
  3777. #, no-wrap
  3778. msgid "Q"
  3779. msgstr ""
  3780. #. type: table
  3781. #: ./bashref.texi:2214
  3782. msgid ""
  3783. "The expansion is a string that is the value of @var{parameter} quoted in a "
  3784. "format that can be reused as input."
  3785. msgstr ""
  3786. #. type: item
  3787. #: ./bashref.texi:2214
  3788. #, no-wrap
  3789. msgid "E"
  3790. msgstr ""
  3791. #. type: table
  3792. #: ./bashref.texi:2217
  3793. msgid ""
  3794. "The expansion is a string that is the value of @var{parameter} with "
  3795. "backslash escape sequences expanded as with the @code{$'@dots{}'} quoting "
  3796. "mechansim."
  3797. msgstr ""
  3798. #. type: item
  3799. #: ./bashref.texi:2217
  3800. #, no-wrap
  3801. msgid "P"
  3802. msgstr ""
  3803. #. type: table
  3804. #: ./bashref.texi:2220
  3805. msgid ""
  3806. "The expansion is a string that is the result of expanding the value of "
  3807. "@var{parameter} as if it were a prompt string (@pxref{Controlling the "
  3808. "Prompt})."
  3809. msgstr ""
  3810. #. type: item
  3811. #: ./bashref.texi:2220
  3812. #, no-wrap
  3813. msgid "A"
  3814. msgstr ""
  3815. #. type: table
  3816. #: ./bashref.texi:2224
  3817. msgid ""
  3818. "The expansion is a string in the form of an assignment statement or "
  3819. "@code{declare} command that, if evaluated, will recreate @var{parameter} "
  3820. "with its attributes and value."
  3821. msgstr ""
  3822. #. type: item
  3823. #: ./bashref.texi:2224
  3824. #, no-wrap
  3825. msgid "a"
  3826. msgstr ""
  3827. #. type: table
  3828. #: ./bashref.texi:2227
  3829. msgid ""
  3830. "The expansion is a string consisting of flag values representing "
  3831. "@var{parameter}'s attributes."
  3832. msgstr ""
  3833. #. type: table
  3834. #: ./bashref.texi:2236
  3835. msgid ""
  3836. "If @var{parameter} is @samp{@@} or @samp{*}, the operation is applied to "
  3837. "each positional parameter in turn, and the expansion is the resultant list. "
  3838. "If @var{parameter} is an array variable subscripted with @samp{@@} or "
  3839. "@samp{*}, the operation is applied to each member of the array in turn, and "
  3840. "the expansion is the resultant list."
  3841. msgstr ""
  3842. #. type: table
  3843. #: ./bashref.texi:2239
  3844. msgid ""
  3845. "The result of the expansion is subject to word splitting and pathname "
  3846. "expansion as described below."
  3847. msgstr ""
  3848. #. type: Plain text
  3849. #: ./bashref.texi:2248
  3850. msgid ""
  3851. "Command substitution allows the output of a command to replace the command "
  3852. "itself. Command substitution occurs when a command is enclosed as follows:"
  3853. msgstr ""
  3854. #. type: example
  3855. #: ./bashref.texi:2250
  3856. #, no-wrap
  3857. msgid "$(@var{command})\n"
  3858. msgstr ""
  3859. #. type: example
  3860. #: ./bashref.texi:2255
  3861. #, no-wrap
  3862. msgid "`@var{command}`\n"
  3863. msgstr ""
  3864. #. type: Plain text
  3865. #: ./bashref.texi:2265
  3866. msgid ""
  3867. "Bash performs the expansion by executing @var{command} in a subshell "
  3868. "environment and replacing the command substitution with the standard output "
  3869. "of the command, with any trailing newlines deleted. Embedded newlines are "
  3870. "not deleted, but they may be removed during word splitting. The command "
  3871. "substitution @code{$(cat @var{file})} can be replaced by the equivalent but "
  3872. "faster @code{$(< @var{file})}."
  3873. msgstr ""
  3874. #. type: Plain text
  3875. #: ./bashref.texi:2273
  3876. msgid ""
  3877. "When the old-style backquote form of substitution is used, backslash retains "
  3878. "its literal meaning except when followed by @samp{$}, @samp{`}, or "
  3879. "@samp{\\}. The first backquote not preceded by a backslash terminates the "
  3880. "command substitution. When using the @code{$(@var{command})} form, all "
  3881. "characters between the parentheses make up the command; none are treated "
  3882. "specially."
  3883. msgstr ""
  3884. #. type: Plain text
  3885. #: ./bashref.texi:2276
  3886. msgid ""
  3887. "Command substitutions may be nested. To nest when using the backquoted "
  3888. "form, escape the inner backquotes with backslashes."
  3889. msgstr ""
  3890. #. type: Plain text
  3891. #: ./bashref.texi:2279
  3892. msgid ""
  3893. "If the substitution appears within double quotes, word splitting and "
  3894. "filename expansion are not performed on the results."
  3895. msgstr ""
  3896. #. type: cindex
  3897. #: ./bashref.texi:2282
  3898. #, no-wrap
  3899. msgid "expansion, arithmetic"
  3900. msgstr ""
  3901. #. type: Plain text
  3902. #: ./bashref.texi:2287
  3903. msgid ""
  3904. "Arithmetic expansion allows the evaluation of an arithmetic expression and "
  3905. "the substitution of the result. The format for arithmetic expansion is:"
  3906. msgstr ""
  3907. #. type: example
  3908. #: ./bashref.texi:2290
  3909. #, no-wrap
  3910. msgid "$(( @var{expression} ))\n"
  3911. msgstr ""
  3912. #. type: Plain text
  3913. #: ./bashref.texi:2298
  3914. msgid ""
  3915. "The expression is treated as if it were within double quotes, but a double "
  3916. "quote inside the parentheses is not treated specially. All tokens in the "
  3917. "expression undergo parameter and variable expansion, command substitution, "
  3918. "and quote removal. The result is treated as the arithmetic expression to be "
  3919. "evaluated. Arithmetic expansions may be nested."
  3920. msgstr ""
  3921. #. type: Plain text
  3922. #: ./bashref.texi:2303
  3923. msgid ""
  3924. "The evaluation is performed according to the rules listed below "
  3925. "(@pxref{Shell Arithmetic}). If the expression is invalid, Bash prints a "
  3926. "message indicating failure to the standard error and no substitution occurs."
  3927. msgstr ""
  3928. #. type: cindex
  3929. #: ./bashref.texi:2306
  3930. #, no-wrap
  3931. msgid "process substitution"
  3932. msgstr ""
  3933. #. type: Plain text
  3934. #: ./bashref.texi:2311
  3935. msgid ""
  3936. "Process substitution allows a process's input or output to be referred to "
  3937. "using a filename. It takes the form of"
  3938. msgstr ""
  3939. #. type: example
  3940. #: ./bashref.texi:2313
  3941. #, no-wrap
  3942. msgid "<(@var{list})\n"
  3943. msgstr ""
  3944. #. type: example
  3945. #: ./bashref.texi:2318
  3946. #, no-wrap
  3947. msgid ">(@var{list})\n"
  3948. msgstr ""
  3949. #. type: Plain text
  3950. #: ./bashref.texi:2334
  3951. msgid ""
  3952. "The process @var{list} is run asynchronously, and its input or output "
  3953. "appears as a filename. This filename is passed as an argument to the "
  3954. "current command as the result of the expansion. If the @code{>(@var{list})} "
  3955. "form is used, writing to the file will provide input for @var{list}. If the "
  3956. "@code{<(@var{list})} form is used, the file passed as an argument should be "
  3957. "read to obtain the output of @var{list}. Note that no space may appear "
  3958. "between the @code{<} or @code{>} and the left parenthesis, otherwise the "
  3959. "construct would be interpreted as a redirection. Process substitution is "
  3960. "supported on systems that support named pipes (@sc{fifo}s) or the "
  3961. "@file{/dev/fd} method of naming open files."
  3962. msgstr ""
  3963. #. type: Plain text
  3964. #: ./bashref.texi:2338
  3965. msgid ""
  3966. "When available, process substitution is performed simultaneously with "
  3967. "parameter and variable expansion, command substitution, and arithmetic "
  3968. "expansion."
  3969. msgstr ""
  3970. #. type: Plain text
  3971. #: ./bashref.texi:2346
  3972. msgid ""
  3973. "The shell scans the results of parameter expansion, command substitution, "
  3974. "and arithmetic expansion that did not occur within double quotes for word "
  3975. "splitting."
  3976. msgstr ""
  3977. #. type: Plain text
  3978. #: ./bashref.texi:2366
  3979. msgid ""
  3980. "The shell treats each character of @env{$IFS} as a delimiter, and splits the "
  3981. "results of the other expansions into words using these characters as field "
  3982. "terminators. If @env{IFS} is unset, or its value is exactly "
  3983. "@code{<space><tab><newline>}, the default, then sequences of @code{ "
  3984. "<space>}, @code{<tab>}, and @code{<newline>} at the beginning and end of the "
  3985. "results of the previous expansions are ignored, and any sequence of "
  3986. "@env{IFS} characters not at the beginning or end serves to delimit words. "
  3987. "If @env{IFS} has a value other than the default, then sequences of the "
  3988. "whitespace characters @code{space}, @code{tab}, and @code{newline} are "
  3989. "ignored at the beginning and end of the word, as long as the whitespace "
  3990. "character is in the value of @env{IFS} (an @env{IFS} whitespace character). "
  3991. "Any character in @env{IFS} that is not @env{IFS} whitespace, along with any "
  3992. "adjacent @env{IFS} whitespace characters, delimits a field. A sequence of "
  3993. "@env{IFS} whitespace characters is also treated as a delimiter. If the "
  3994. "value of @env{IFS} is null, no word splitting occurs."
  3995. msgstr ""
  3996. #. type: Plain text
  3997. #: ./bashref.texi:2379
  3998. msgid ""
  3999. "Explicit null arguments (@code{\"\"} or @code{''}) are retained and passed "
  4000. "to commands as empty strings. Unquoted implicit null arguments, resulting "
  4001. "from the expansion of parameters that have no values, are removed. If a "
  4002. "parameter with no value is expanded within double quotes, a null argument "
  4003. "results and is retained and passed to a command as an empty string. When a "
  4004. "quoted null argument appears as part of a word whose expansion is non-null, "
  4005. "the null argument is removed. That is, the word @code{-d''} becomes "
  4006. "@code{-d} after word splitting and null argument removal."
  4007. msgstr ""
  4008. #. type: Plain text
  4009. #: ./bashref.texi:2382
  4010. msgid "Note that if no expansion occurs, no splitting is performed."
  4011. msgstr ""
  4012. #. type: subsubsection
  4013. #: ./bashref.texi:2387 ./bashref.texi:2441 ./bashref.texi:2442
  4014. #, no-wrap
  4015. msgid "Pattern Matching"
  4016. msgstr ""
  4017. #. type: menuentry
  4018. #: ./bashref.texi:2387
  4019. msgid "How the shell matches patterns."
  4020. msgstr ""
  4021. #. type: cindex
  4022. #: ./bashref.texi:2388
  4023. #, no-wrap
  4024. msgid "expansion, filename"
  4025. msgstr ""
  4026. #. type: cindex
  4027. #: ./bashref.texi:2389
  4028. #, no-wrap
  4029. msgid "expansion, pathname"
  4030. msgstr ""
  4031. #. type: cindex
  4032. #: ./bashref.texi:2391
  4033. #, no-wrap
  4034. msgid "pathname expansion"
  4035. msgstr ""
  4036. #. type: Plain text
  4037. #: ./bashref.texi:2409
  4038. msgid ""
  4039. "After word splitting, unless the @option{-f} option has been set (@pxref{The "
  4040. "Set Builtin}), Bash scans each word for the characters @samp{*}, @samp{?}, "
  4041. "and @samp{[}. If one of these characters appears, then the word is regarded "
  4042. "as a @var{pattern}, and replaced with an alphabetically sorted list of "
  4043. "filenames matching the pattern (@pxref{Pattern Matching}). If no matching "
  4044. "filenames are found, and the shell option @code{nullglob} is disabled, the "
  4045. "word is left unchanged. If the @code{nullglob} option is set, and no "
  4046. "matches are found, the word is removed. If the @code{failglob} shell option "
  4047. "is set, and no matches are found, an error message is printed and the "
  4048. "command is not executed. If the shell option @code{nocaseglob} is enabled, "
  4049. "the match is performed without regard to the case of alphabetic characters."
  4050. msgstr ""
  4051. #. type: Plain text
  4052. #: ./bashref.texi:2416
  4053. msgid ""
  4054. "When a pattern is used for filename expansion, the character @samp{.} at the "
  4055. "start of a filename or immediately following a slash must be matched "
  4056. "explicitly, unless the shell option @code{dotglob} is set. When matching a "
  4057. "filename, the slash character must always be matched explicitly. In other "
  4058. "cases, the @samp{.} character is not treated specially."
  4059. msgstr ""
  4060. #. type: Plain text
  4061. #: ./bashref.texi:2420
  4062. msgid ""
  4063. "See the description of @code{shopt} in @ref{The Shopt Builtin}, for a "
  4064. "description of the @code{nocaseglob}, @code{nullglob}, @code{failglob}, and "
  4065. "@code{dotglob} options."
  4066. msgstr ""
  4067. #. type: Plain text
  4068. #: ./bashref.texi:2440
  4069. msgid ""
  4070. "The @env{GLOBIGNORE} shell variable may be used to restrict the set of "
  4071. "filenames matching a pattern. If @env{GLOBIGNORE} is set, each matching "
  4072. "filename that also matches one of the patterns in @env{GLOBIGNORE} is "
  4073. "removed from the list of matches. If the @code{nocaseglob} option is set, "
  4074. "the matching against the patterns in @env{GLOBIGNORE} is performed without "
  4075. "regard to case. The filenames @file{.} and @file{..} are always ignored "
  4076. "when @env{GLOBIGNORE} is set and not null. However, setting "
  4077. "@env{GLOBIGNORE} to a non-null value has the effect of enabling the "
  4078. "@code{dotglob} shell option, so all other filenames beginning with a "
  4079. "@samp{.} will match. To get the old behavior of ignoring filenames "
  4080. "beginning with a @samp{.}, make @samp{.*} one of the patterns in "
  4081. "@env{GLOBIGNORE}. The @code{dotglob} option is disabled when "
  4082. "@env{GLOBIGNORE} is unset."
  4083. msgstr ""
  4084. #. type: cindex
  4085. #: ./bashref.texi:2443
  4086. #, no-wrap
  4087. msgid "pattern matching"
  4088. msgstr ""
  4089. #. type: cindex
  4090. #: ./bashref.texi:2444
  4091. #, no-wrap
  4092. msgid "matching, pattern"
  4093. msgstr ""
  4094. #. type: Plain text
  4095. #: ./bashref.texi:2453
  4096. msgid ""
  4097. "Any character that appears in a pattern, other than the special pattern "
  4098. "characters described below, matches itself. The @sc{nul} character may not "
  4099. "occur in a pattern. A backslash escapes the following character; the "
  4100. "escaping backslash is discarded when matching. The special pattern "
  4101. "characters must be quoted if they are to be matched literally."
  4102. msgstr ""
  4103. #. type: Plain text
  4104. #: ./bashref.texi:2455
  4105. msgid "The special pattern characters have the following meanings:"
  4106. msgstr ""
  4107. #. type: table
  4108. #: ./bashref.texi:2464
  4109. msgid ""
  4110. "Matches any string, including the null string. When the @code{globstar} "
  4111. "shell option is enabled, and @samp{*} is used in a filename expansion "
  4112. "context, two adjacent @samp{*}s used as a single pattern will match all "
  4113. "files and zero or more directories and subdirectories. If followed by a "
  4114. "@samp{/}, two adjacent @samp{*}s will match only directories and "
  4115. "subdirectories."
  4116. msgstr ""
  4117. #. type: table
  4118. #: ./bashref.texi:2466
  4119. msgid "Matches any single character."
  4120. msgstr ""
  4121. #. type: item
  4122. #: ./bashref.texi:2466
  4123. #, no-wrap
  4124. msgid "[@dots{}]"
  4125. msgstr ""
  4126. #. type: table
  4127. #: ./bashref.texi:2480
  4128. msgid ""
  4129. "Matches any one of the enclosed characters. A pair of characters separated "
  4130. "by a hyphen denotes a @var{range expression}; any character that falls "
  4131. "between those two characters, inclusive, using the current locale's "
  4132. "collating sequence and character set, is matched. If the first character "
  4133. "following the @samp{[} is a @samp{!} or a @samp{^} then any character not "
  4134. "enclosed is matched. A @samp{@minus{}} may be matched by including it as "
  4135. "the first or last character in the set. A @samp{]} may be matched by "
  4136. "including it as the first character in the set. The sorting order of "
  4137. "characters in range expressions is determined by the current locale and the "
  4138. "values of the @env{LC_COLLATE} and @env{LC_ALL} shell variables, if set."
  4139. msgstr ""
  4140. #. type: table
  4141. #: ./bashref.texi:2489
  4142. msgid ""
  4143. "For example, in the default C locale, @samp{[a-dx-z]} is equivalent to "
  4144. "@samp{[abcdxyz]}. Many locales sort characters in dictionary order, and in "
  4145. "these locales @samp{[a-dx-z]} is typically not equivalent to "
  4146. "@samp{[abcdxyz]}; it might be equivalent to @samp{[aBbCcDdxXyYz]}, for "
  4147. "example. To obtain the traditional interpretation of ranges in bracket "
  4148. "expressions, you can force the use of the C locale by setting the "
  4149. "@env{LC_COLLATE} or @env{LC_ALL} environment variable to the value @samp{C}, "
  4150. "or enable the @code{globasciiranges} shell option."
  4151. msgstr ""
  4152. #. type: table
  4153. #: ./bashref.texi:2494
  4154. msgid ""
  4155. "Within @samp{[} and @samp{]}, @var{character classes} can be specified using "
  4156. "the syntax @code{[:}@var{class}@code{:]}, where @var{class} is one of the "
  4157. "following classes defined in the @sc{posix} standard:"
  4158. msgstr ""
  4159. #. type: example
  4160. #: ./bashref.texi:2497
  4161. #, no-wrap
  4162. msgid ""
  4163. "alnum alpha ascii blank cntrl digit graph lower\n"
  4164. "print punct space upper word xdigit\n"
  4165. msgstr ""
  4166. #. type: table
  4167. #: ./bashref.texi:2502
  4168. msgid ""
  4169. "A character class matches any character belonging to that class. The "
  4170. "@code{word} character class matches letters, digits, and the character "
  4171. "@samp{_}."
  4172. msgstr ""
  4173. #. type: table
  4174. #: ./bashref.texi:2507
  4175. msgid ""
  4176. "Within @samp{[} and @samp{]}, an @var{equivalence class} can be specified "
  4177. "using the syntax @code{[=}@var{c}@code{=]}, which matches all characters "
  4178. "with the same collation weight (as defined by the current locale) as the "
  4179. "character @var{c}."
  4180. msgstr ""
  4181. #. type: table
  4182. #: ./bashref.texi:2510
  4183. msgid ""
  4184. "Within @samp{[} and @samp{]}, the syntax @code{[.}@var{symbol}@code{.]} "
  4185. "matches the collating symbol @var{symbol}."
  4186. msgstr ""
  4187. #. type: Plain text
  4188. #: ./bashref.texi:2518
  4189. msgid ""
  4190. "If the @code{extglob} shell option is enabled using the @code{shopt} "
  4191. "builtin, several extended pattern matching operators are recognized. In the "
  4192. "following description, a @var{pattern-list} is a list of one or more "
  4193. "patterns separated by a @samp{|}. Composite patterns may be formed using "
  4194. "one or more of the following sub-patterns:"
  4195. msgstr ""
  4196. #. type: item
  4197. #: ./bashref.texi:2520
  4198. #, no-wrap
  4199. msgid "?(@var{pattern-list})"
  4200. msgstr ""
  4201. #. type: table
  4202. #: ./bashref.texi:2522
  4203. msgid "Matches zero or one occurrence of the given patterns."
  4204. msgstr ""
  4205. #. type: item
  4206. #: ./bashref.texi:2523
  4207. #, no-wrap
  4208. msgid "*(@var{pattern-list})"
  4209. msgstr ""
  4210. #. type: table
  4211. #: ./bashref.texi:2525
  4212. msgid "Matches zero or more occurrences of the given patterns."
  4213. msgstr ""
  4214. #. type: item
  4215. #: ./bashref.texi:2526
  4216. #, no-wrap
  4217. msgid "+(@var{pattern-list})"
  4218. msgstr ""
  4219. #. type: table
  4220. #: ./bashref.texi:2528
  4221. msgid "Matches one or more occurrences of the given patterns."
  4222. msgstr ""
  4223. #. type: item
  4224. #: ./bashref.texi:2529
  4225. #, no-wrap
  4226. msgid "@@(@var{pattern-list})"
  4227. msgstr ""
  4228. #. type: table
  4229. #: ./bashref.texi:2531
  4230. msgid "Matches one of the given patterns."
  4231. msgstr ""
  4232. #. type: item
  4233. #: ./bashref.texi:2532
  4234. #, no-wrap
  4235. msgid "!(@var{pattern-list})"
  4236. msgstr ""
  4237. #. type: table
  4238. #: ./bashref.texi:2534
  4239. msgid "Matches anything except one of the given patterns."
  4240. msgstr ""
  4241. #. type: Plain text
  4242. #: ./bashref.texi:2542
  4243. msgid ""
  4244. "After the preceding expansions, all unquoted occurrences of the characters "
  4245. "@samp{\\}, @samp{'}, and @samp{\"} that did not result from one of the above "
  4246. "expansions are removed."
  4247. msgstr ""
  4248. #. type: cindex
  4249. #: ./bashref.texi:2545
  4250. #, no-wrap
  4251. msgid "redirection"
  4252. msgstr ""
  4253. #. type: Plain text
  4254. #: ./bashref.texi:2560
  4255. msgid ""
  4256. "Before a command is executed, its input and output may be @var{redirected} "
  4257. "using a special notation interpreted by the shell. Redirection allows "
  4258. "commands' file handles to be duplicated, opened, closed, made to refer to "
  4259. "different files, and can change the files the command reads from and writes "
  4260. "to. Redirection may also be used to modify file handles in the current "
  4261. "shell execution environment. The following redirection operators may "
  4262. "precede or appear anywhere within a simple command or may follow a command. "
  4263. "Redirections are processed in the order they appear, from left to right."
  4264. msgstr ""
  4265. #. type: Plain text
  4266. #: ./bashref.texi:2568
  4267. msgid ""
  4268. "Each redirection that may be preceded by a file descriptor number may "
  4269. "instead be preceded by a word of the form @{@var{varname}@}. In this case, "
  4270. "for each redirection operator except >&- and <&-, the shell will allocate a "
  4271. "file descriptor greater than 10 and assign it to @{@var{varname}@}. If >&- "
  4272. "or <&- is preceded by @{@var{varname}@}, the value of @var{varname} defines "
  4273. "the file descriptor to close."
  4274. msgstr ""
  4275. #. type: Plain text
  4276. #: ./bashref.texi:2575
  4277. msgid ""
  4278. "In the following descriptions, if the file descriptor number is omitted, and "
  4279. "the first character of the redirection operator is @samp{<}, the redirection "
  4280. "refers to the standard input (file descriptor 0). If the first character of "
  4281. "the redirection operator is @samp{>}, the redirection refers to the standard "
  4282. "output (file descriptor 1)."
  4283. msgstr ""
  4284. #. type: Plain text
  4285. #: ./bashref.texi:2581
  4286. msgid ""
  4287. "The word following the redirection operator in the following descriptions, "
  4288. "unless otherwise noted, is subjected to brace expansion, tilde expansion, "
  4289. "parameter expansion, command substitution, arithmetic expansion, quote "
  4290. "removal, filename expansion, and word splitting. If it expands to more than "
  4291. "one word, Bash reports an error."
  4292. msgstr ""
  4293. #. type: Plain text
  4294. #: ./bashref.texi:2584
  4295. msgid ""
  4296. "Note that the order of redirections is significant. For example, the "
  4297. "command"
  4298. msgstr ""
  4299. #. type: example
  4300. #: ./bashref.texi:2586
  4301. #, no-wrap
  4302. msgid "ls > @var{dirlist} 2>&1\n"
  4303. msgstr ""
  4304. #. type: Plain text
  4305. #: ./bashref.texi:2590
  4306. msgid ""
  4307. "directs both standard output (file descriptor 1) and standard error (file "
  4308. "descriptor 2) to the file @var{dirlist}, while the command"
  4309. msgstr ""
  4310. #. type: example
  4311. #: ./bashref.texi:2592
  4312. #, no-wrap
  4313. msgid "ls 2>&1 > @var{dirlist}\n"
  4314. msgstr ""
  4315. #. type: Plain text
  4316. #: ./bashref.texi:2597
  4317. msgid ""
  4318. "directs only the standard output to file @var{dirlist}, because the standard "
  4319. "error was made a copy of the standard output before the standard output was "
  4320. "redirected to @var{dirlist}."
  4321. msgstr ""
  4322. #. type: Plain text
  4323. #: ./bashref.texi:2603
  4324. msgid ""
  4325. "Bash handles several filenames specially when they are used in redirections, "
  4326. "as described in the following table. If the operating system on which Bash "
  4327. "is running provides these special files, bash will use them; otherwise it "
  4328. "will emulate them internally with the behavior described below."
  4329. msgstr ""
  4330. #. type: item
  4331. #: ./bashref.texi:2605
  4332. #, no-wrap
  4333. msgid "/dev/fd/@var{fd}"
  4334. msgstr ""
  4335. #. type: table
  4336. #: ./bashref.texi:2607
  4337. msgid "If @var{fd} is a valid integer, file descriptor @var{fd} is duplicated."
  4338. msgstr ""
  4339. #. type: item
  4340. #: ./bashref.texi:2608
  4341. #, no-wrap
  4342. msgid "/dev/stdin"
  4343. msgstr ""
  4344. #. type: table
  4345. #: ./bashref.texi:2610
  4346. msgid "File descriptor 0 is duplicated."
  4347. msgstr ""
  4348. #. type: item
  4349. #: ./bashref.texi:2611
  4350. #, no-wrap
  4351. msgid "/dev/stdout"
  4352. msgstr ""
  4353. #. type: table
  4354. #: ./bashref.texi:2613
  4355. msgid "File descriptor 1 is duplicated."
  4356. msgstr ""
  4357. #. type: item
  4358. #: ./bashref.texi:2614
  4359. #, no-wrap
  4360. msgid "/dev/stderr"
  4361. msgstr ""
  4362. #. type: table
  4363. #: ./bashref.texi:2616
  4364. msgid "File descriptor 2 is duplicated."
  4365. msgstr ""
  4366. #. type: item
  4367. #: ./bashref.texi:2617
  4368. #, no-wrap
  4369. msgid "/dev/tcp/@var{host}/@var{port}"
  4370. msgstr ""
  4371. #. type: table
  4372. #: ./bashref.texi:2621
  4373. msgid ""
  4374. "If @var{host} is a valid hostname or Internet address, and @var{port} is an "
  4375. "integer port number or service name, Bash attempts to open the corresponding "
  4376. "TCP socket."
  4377. msgstr ""
  4378. #. type: item
  4379. #: ./bashref.texi:2622
  4380. #, no-wrap
  4381. msgid "/dev/udp/@var{host}/@var{port}"
  4382. msgstr ""
  4383. #. type: table
  4384. #: ./bashref.texi:2626
  4385. msgid ""
  4386. "If @var{host} is a valid hostname or Internet address, and @var{port} is an "
  4387. "integer port number or service name, Bash attempts to open the corresponding "
  4388. "UDP socket."
  4389. msgstr ""
  4390. #. type: Plain text
  4391. #: ./bashref.texi:2629
  4392. msgid "A failure to open or create a file causes the redirection to fail."
  4393. msgstr ""
  4394. #. type: Plain text
  4395. #: ./bashref.texi:2633
  4396. msgid ""
  4397. "Redirections using file descriptors greater than 9 should be used with care, "
  4398. "as they may conflict with file descriptors the shell uses internally."
  4399. msgstr ""
  4400. #. type: subsection
  4401. #: ./bashref.texi:2634
  4402. #, no-wrap
  4403. msgid "Redirecting Input"
  4404. msgstr ""
  4405. #. type: Plain text
  4406. #: ./bashref.texi:2640
  4407. msgid ""
  4408. "Redirection of input causes the file whose name results from the expansion "
  4409. "of @var{word} to be opened for reading on file descriptor @code{n}, or the "
  4410. "standard input (file descriptor 0) if @code{n} is not specified."
  4411. msgstr ""
  4412. #. type: Plain text
  4413. #: ./bashref.texi:2642
  4414. msgid "The general format for redirecting input is:"
  4415. msgstr ""
  4416. #. type: example
  4417. #: ./bashref.texi:2644
  4418. #, no-wrap
  4419. msgid "[@var{n}]<@var{word}\n"
  4420. msgstr ""
  4421. #. type: subsection
  4422. #: ./bashref.texi:2646
  4423. #, no-wrap
  4424. msgid "Redirecting Output"
  4425. msgstr ""
  4426. #. type: Plain text
  4427. #: ./bashref.texi:2653
  4428. msgid ""
  4429. "Redirection of output causes the file whose name results from the expansion "
  4430. "of @var{word} to be opened for writing on file descriptor @var{n}, or the "
  4431. "standard output (file descriptor 1) if @var{n} is not specified. If the "
  4432. "file does not exist it is created; if it does exist it is truncated to zero "
  4433. "size."
  4434. msgstr ""
  4435. #. type: Plain text
  4436. #: ./bashref.texi:2655
  4437. msgid "The general format for redirecting output is:"
  4438. msgstr ""
  4439. #. type: example
  4440. #: ./bashref.texi:2657
  4441. #, no-wrap
  4442. msgid "[@var{n}]>[|]@var{word}\n"
  4443. msgstr ""
  4444. #. type: Plain text
  4445. #: ./bashref.texi:2666
  4446. msgid ""
  4447. "If the redirection operator is @samp{>}, and the @code{noclobber} option to "
  4448. "the @code{set} builtin has been enabled, the redirection will fail if the "
  4449. "file whose name results from the expansion of @var{word} exists and is a "
  4450. "regular file. If the redirection operator is @samp{>|}, or the redirection "
  4451. "operator is @samp{>} and the @code{noclobber} option is not enabled, the "
  4452. "redirection is attempted even if the file named by @var{word} exists."
  4453. msgstr ""
  4454. #. type: subsection
  4455. #: ./bashref.texi:2667
  4456. #, no-wrap
  4457. msgid "Appending Redirected Output"
  4458. msgstr ""
  4459. #. type: Plain text
  4460. #: ./bashref.texi:2674
  4461. msgid ""
  4462. "Redirection of output in this fashion causes the file whose name results "
  4463. "from the expansion of @var{word} to be opened for appending on file "
  4464. "descriptor @var{n}, or the standard output (file descriptor 1) if @var{n} is "
  4465. "not specified. If the file does not exist it is created."
  4466. msgstr ""
  4467. #. type: Plain text
  4468. #: ./bashref.texi:2676
  4469. msgid "The general format for appending output is:"
  4470. msgstr ""
  4471. #. type: example
  4472. #: ./bashref.texi:2678
  4473. #, no-wrap
  4474. msgid "[@var{n}]>>@var{word}\n"
  4475. msgstr ""
  4476. #. type: subsection
  4477. #: ./bashref.texi:2680
  4478. #, no-wrap
  4479. msgid "Redirecting Standard Output and Standard Error"
  4480. msgstr ""
  4481. #. type: Plain text
  4482. #: ./bashref.texi:2686
  4483. msgid ""
  4484. "This construct allows both the standard output (file descriptor 1) and the "
  4485. "standard error output (file descriptor 2) to be redirected to the file "
  4486. "whose name is the expansion of @var{word}."
  4487. msgstr ""
  4488. #. type: Plain text
  4489. #: ./bashref.texi:2689
  4490. msgid "There are two formats for redirecting standard output and standard error:"
  4491. msgstr ""
  4492. #. type: example
  4493. #: ./bashref.texi:2691
  4494. #, no-wrap
  4495. msgid "&>@var{word}\n"
  4496. msgstr ""
  4497. #. type: Plain text
  4498. #: ./bashref.texi:2694
  4499. msgid "and"
  4500. msgstr ""
  4501. #. type: example
  4502. #: ./bashref.texi:2696
  4503. #, no-wrap
  4504. msgid ">&@var{word}\n"
  4505. msgstr ""
  4506. #. type: Plain text
  4507. #: ./bashref.texi:2700
  4508. msgid ""
  4509. "Of the two forms, the first is preferred. This is semantically equivalent "
  4510. "to"
  4511. msgstr ""
  4512. #. type: example
  4513. #: ./bashref.texi:2702
  4514. #, no-wrap
  4515. msgid ">@var{word} 2>&1\n"
  4516. msgstr ""
  4517. #. type: Plain text
  4518. #: ./bashref.texi:2706
  4519. msgid ""
  4520. "When using the second form, @var{word} may not expand to a number or "
  4521. "@samp{-}. If it does, other redirection operators apply (see Duplicating "
  4522. "File Descriptors below) for compatibility reasons."
  4523. msgstr ""
  4524. #. type: subsection
  4525. #: ./bashref.texi:2707
  4526. #, no-wrap
  4527. msgid "Appending Standard Output and Standard Error"
  4528. msgstr ""
  4529. #. type: Plain text
  4530. #: ./bashref.texi:2713
  4531. msgid ""
  4532. "This construct allows both the standard output (file descriptor 1) and the "
  4533. "standard error output (file descriptor 2) to be appended to the file whose "
  4534. "name is the expansion of @var{word}."
  4535. msgstr ""
  4536. #. type: Plain text
  4537. #: ./bashref.texi:2715
  4538. msgid "The format for appending standard output and standard error is:"
  4539. msgstr ""
  4540. #. type: example
  4541. #: ./bashref.texi:2717
  4542. #, no-wrap
  4543. msgid "&>>@var{word}\n"
  4544. msgstr ""
  4545. #. type: Plain text
  4546. #: ./bashref.texi:2720
  4547. msgid "This is semantically equivalent to"
  4548. msgstr ""
  4549. #. type: example
  4550. #: ./bashref.texi:2722
  4551. #, no-wrap
  4552. msgid ">>@var{word} 2>&1\n"
  4553. msgstr ""
  4554. #. type: Plain text
  4555. #: ./bashref.texi:2724
  4556. msgid "(see Duplicating File Descriptors below)."
  4557. msgstr ""
  4558. #. type: subsection
  4559. #: ./bashref.texi:2725
  4560. #, no-wrap
  4561. msgid "Here Documents"
  4562. msgstr ""
  4563. #. type: Plain text
  4564. #: ./bashref.texi:2731
  4565. msgid ""
  4566. "This type of redirection instructs the shell to read input from the current "
  4567. "source until a line containing only @var{word} (with no trailing blanks) is "
  4568. "seen. All of the lines read up to that point are then used as the standard "
  4569. "input (or file descriptor @var{n} if @var{n} is specified) for a command."
  4570. msgstr ""
  4571. #. type: Plain text
  4572. #: ./bashref.texi:2733
  4573. msgid "The format of here-documents is:"
  4574. msgstr ""
  4575. #. type: example
  4576. #: ./bashref.texi:2737
  4577. #, no-wrap
  4578. msgid ""
  4579. "[@var{n}]<<[@minus{}]@var{word}\n"
  4580. " @var{here-document}\n"
  4581. "@var{delimiter}\n"
  4582. msgstr ""
  4583. #. type: Plain text
  4584. #: ./bashref.texi:2750
  4585. msgid ""
  4586. "No parameter and variable expansion, command substitution, arithmetic "
  4587. "expansion, or filename expansion is performed on @var{word}. If any part of "
  4588. "@var{word} is quoted, the @var{delimiter} is the result of quote removal on "
  4589. "@var{word}, and the lines in the here-document are not expanded. If "
  4590. "@var{word} is unquoted, all lines of the here-document are subjected to "
  4591. "parameter expansion, command substitution, and arithmetic expansion, the "
  4592. "character sequence @code{\\newline} is ignored, and @samp{\\} must be used "
  4593. "to quote the characters @samp{\\}, @samp{$}, and @samp{`}."
  4594. msgstr ""
  4595. #. type: Plain text
  4596. #: ./bashref.texi:2756
  4597. msgid ""
  4598. "If the redirection operator is @samp{<<-}, then all leading tab characters "
  4599. "are stripped from input lines and the line containing @var{delimiter}. This "
  4600. "allows here-documents within shell scripts to be indented in a natural "
  4601. "fashion."
  4602. msgstr ""
  4603. #. type: subsection
  4604. #: ./bashref.texi:2757
  4605. #, no-wrap
  4606. msgid "Here Strings"
  4607. msgstr ""
  4608. #. type: Plain text
  4609. #: ./bashref.texi:2759
  4610. msgid "A variant of here documents, the format is:"
  4611. msgstr ""
  4612. #. type: example
  4613. #: ./bashref.texi:2761
  4614. #, no-wrap
  4615. msgid "[@var{n}]<<< @var{word}\n"
  4616. msgstr ""
  4617. #. type: Plain text
  4618. #: ./bashref.texi:2771
  4619. msgid ""
  4620. "The @var{word} undergoes brace expansion, tilde expansion, parameter and "
  4621. "variable expansion, command substitution, arithmetic expansion, and quote "
  4622. "removal. Pathname expansion and word splitting are not performed. The "
  4623. "result is supplied as a single string, with a newline appended, to the "
  4624. "command on its standard input (or file descriptor @var{n} if @var{n} is "
  4625. "specified)."
  4626. msgstr ""
  4627. #. type: subsection
  4628. #: ./bashref.texi:2772
  4629. #, no-wrap
  4630. msgid "Duplicating File Descriptors"
  4631. msgstr ""
  4632. #. type: Plain text
  4633. #: ./bashref.texi:2774 ./bashref.texi:2805 ./bashref.texi:2823
  4634. msgid "The redirection operator"
  4635. msgstr ""
  4636. #. type: example
  4637. #: ./bashref.texi:2776
  4638. #, no-wrap
  4639. msgid "[@var{n}]<&@var{word}\n"
  4640. msgstr ""
  4641. #. type: Plain text
  4642. #: ./bashref.texi:2787
  4643. msgid ""
  4644. "is used to duplicate input file descriptors. If @var{word} expands to one "
  4645. "or more digits, the file descriptor denoted by @var{n} is made to be a copy "
  4646. "of that file descriptor. If the digits in @var{word} do not specify a file "
  4647. "descriptor open for input, a redirection error occurs. If @var{word} "
  4648. "evaluates to @samp{-}, file descriptor @var{n} is closed. If @var{n} is not "
  4649. "specified, the standard input (file descriptor 0) is used."
  4650. msgstr ""
  4651. #. type: Plain text
  4652. #: ./bashref.texi:2789
  4653. msgid "The operator"
  4654. msgstr ""
  4655. #. type: example
  4656. #: ./bashref.texi:2791
  4657. #, no-wrap
  4658. msgid "[@var{n}]>&@var{word}\n"
  4659. msgstr ""
  4660. #. type: Plain text
  4661. #: ./bashref.texi:2802
  4662. msgid ""
  4663. "is used similarly to duplicate output file descriptors. If @var{n} is not "
  4664. "specified, the standard output (file descriptor 1) is used. If the digits "
  4665. "in @var{word} do not specify a file descriptor open for output, a "
  4666. "redirection error occurs. If @var{word} evaluates to @samp{-}, file "
  4667. "descriptor @var{n} is closed. As a special case, if @var{n} is omitted, and "
  4668. "@var{word} does not expand to one or more digits or @samp{-}, the standard "
  4669. "output and standard error are redirected as described previously."
  4670. msgstr ""
  4671. #. type: subsection
  4672. #: ./bashref.texi:2803
  4673. #, no-wrap
  4674. msgid "Moving File Descriptors"
  4675. msgstr ""
  4676. #. type: example
  4677. #: ./bashref.texi:2807
  4678. #, no-wrap
  4679. msgid "[@var{n}]<&@var{digit}-\n"
  4680. msgstr ""
  4681. #. type: Plain text
  4682. #: ./bashref.texi:2812
  4683. msgid ""
  4684. "moves the file descriptor @var{digit} to file descriptor @var{n}, or the "
  4685. "standard input (file descriptor 0) if @var{n} is not specified. @var{digit} "
  4686. "is closed after being duplicated to @var{n}."
  4687. msgstr ""
  4688. #. type: Plain text
  4689. #: ./bashref.texi:2814
  4690. msgid "Similarly, the redirection operator"
  4691. msgstr ""
  4692. #. type: example
  4693. #: ./bashref.texi:2816
  4694. #, no-wrap
  4695. msgid "[@var{n}]>&@var{digit}-\n"
  4696. msgstr ""
  4697. #. type: Plain text
  4698. #: ./bashref.texi:2820
  4699. msgid ""
  4700. "moves the file descriptor @var{digit} to file descriptor @var{n}, or the "
  4701. "standard output (file descriptor 1) if @var{n} is not specified."
  4702. msgstr ""
  4703. #. type: subsection
  4704. #: ./bashref.texi:2821
  4705. #, no-wrap
  4706. msgid "Opening File Descriptors for Reading and Writing"
  4707. msgstr ""
  4708. #. type: example
  4709. #: ./bashref.texi:2825
  4710. #, no-wrap
  4711. msgid "[@var{n}]<>@var{word}\n"
  4712. msgstr ""
  4713. #. type: Plain text
  4714. #: ./bashref.texi:2831
  4715. msgid ""
  4716. "causes the file whose name is the expansion of @var{word} to be opened for "
  4717. "both reading and writing on file descriptor @var{n}, or on file descriptor 0 "
  4718. "if @var{n} is not specified. If the file does not exist, it is created."
  4719. msgstr ""
  4720. #. type: subsection
  4721. #: ./bashref.texi:2847 ./bashref.texi:2849 ./bashref.texi:2850
  4722. #, no-wrap
  4723. msgid "Simple Command Expansion"
  4724. msgstr ""
  4725. #. type: menuentry
  4726. #: ./bashref.texi:2847
  4727. msgid "How Bash expands simple commands before executing them."
  4728. msgstr ""
  4729. #. type: subsection
  4730. #: ./bashref.texi:2847 ./bashref.texi:2894 ./bashref.texi:2895
  4731. #, no-wrap
  4732. msgid "Command Search and Execution"
  4733. msgstr ""
  4734. #. type: menuentry
  4735. #: ./bashref.texi:2847
  4736. msgid "How Bash finds commands and runs them."
  4737. msgstr ""
  4738. #. type: subsection
  4739. #: ./bashref.texi:2847 ./bashref.texi:2950 ./bashref.texi:2951
  4740. #, no-wrap
  4741. msgid "Command Execution Environment"
  4742. msgstr ""
  4743. #. type: menuentry
  4744. #: ./bashref.texi:2847
  4745. msgid "The environment in which Bash executes commands that are not shell builtins."
  4746. msgstr ""
  4747. #. type: subsection
  4748. #: ./bashref.texi:2847 ./bashref.texi:3046 ./bashref.texi:3047
  4749. #, no-wrap
  4750. msgid "Environment"
  4751. msgstr ""
  4752. #. type: menuentry
  4753. #: ./bashref.texi:2847
  4754. msgid "The environment given to a command."
  4755. msgstr ""
  4756. #. type: subsection
  4757. #: ./bashref.texi:2847 ./bashref.texi:3084 ./bashref.texi:3085
  4758. #, no-wrap
  4759. msgid "Exit Status"
  4760. msgstr ""
  4761. #. type: menuentry
  4762. #: ./bashref.texi:2847
  4763. msgid "The status returned by commands and how Bash interprets it."
  4764. msgstr ""
  4765. #. type: subsection
  4766. #: ./bashref.texi:2847 ./bashref.texi:3122 ./bashref.texi:3123
  4767. #, no-wrap
  4768. msgid "Signals"
  4769. msgstr ""
  4770. #. type: menuentry
  4771. #: ./bashref.texi:2847
  4772. msgid "What happens when Bash or a command it runs receives a signal."
  4773. msgstr ""
  4774. #. type: cindex
  4775. #: ./bashref.texi:2851
  4776. #, no-wrap
  4777. msgid "command expansion"
  4778. msgstr ""
  4779. #. type: Plain text
  4780. #: ./bashref.texi:2855
  4781. msgid ""
  4782. "When a simple command is executed, the shell performs the following "
  4783. "expansions, assignments, and redirections, from left to right."
  4784. msgstr ""
  4785. #. type: enumerate
  4786. #: ./bashref.texi:2861
  4787. msgid ""
  4788. "The words that the parser has marked as variable assignments (those "
  4789. "preceding the command name) and redirections are saved for later processing."
  4790. msgstr ""
  4791. #. type: enumerate
  4792. #: ./bashref.texi:2868
  4793. msgid ""
  4794. "The words that are not variable assignments or redirections are expanded "
  4795. "(@pxref{Shell Expansions}). If any words remain after expansion, the first "
  4796. "word is taken to be the name of the command and the remaining words are the "
  4797. "arguments."
  4798. msgstr ""
  4799. #. type: enumerate
  4800. #: ./bashref.texi:2871
  4801. msgid "Redirections are performed as described above (@pxref{Redirections})."
  4802. msgstr ""
  4803. #. type: enumerate
  4804. #: ./bashref.texi:2876
  4805. msgid ""
  4806. "The text after the @samp{=} in each variable assignment undergoes tilde "
  4807. "expansion, parameter expansion, command substitution, arithmetic expansion, "
  4808. "and quote removal before being assigned to the variable."
  4809. msgstr ""
  4810. #. type: Plain text
  4811. #: ./bashref.texi:2883
  4812. msgid ""
  4813. "If no command name results, the variable assignments affect the current "
  4814. "shell environment. Otherwise, the variables are added to the environment of "
  4815. "the executed command and do not affect the current shell environment. If "
  4816. "any of the assignments attempts to assign a value to a readonly variable, an "
  4817. "error occurs, and the command exits with a non-zero status."
  4818. msgstr ""
  4819. #. type: Plain text
  4820. #: ./bashref.texi:2887
  4821. msgid ""
  4822. "If no command name results, redirections are performed, but do not affect "
  4823. "the current shell environment. A redirection error causes the command to "
  4824. "exit with a non-zero status."
  4825. msgstr ""
  4826. #. type: Plain text
  4827. #: ./bashref.texi:2893
  4828. msgid ""
  4829. "If there is a command name left after expansion, execution proceeds as "
  4830. "described below. Otherwise, the command exits. If one of the expansions "
  4831. "contained a command substitution, the exit status of the command is the exit "
  4832. "status of the last command substitution performed. If there were no command "
  4833. "substitutions, the command exits with a status of zero."
  4834. msgstr ""
  4835. #. type: cindex
  4836. #: ./bashref.texi:2896
  4837. #, no-wrap
  4838. msgid "command execution"
  4839. msgstr ""
  4840. #. type: cindex
  4841. #: ./bashref.texi:2897
  4842. #, no-wrap
  4843. msgid "command search"
  4844. msgstr ""
  4845. #. type: Plain text
  4846. #: ./bashref.texi:2902
  4847. msgid ""
  4848. "After a command has been split into words, if it results in a simple command "
  4849. "and an optional list of arguments, the following actions are taken."
  4850. msgstr ""
  4851. #. type: enumerate
  4852. #: ./bashref.texi:2908
  4853. msgid ""
  4854. "If the command name contains no slashes, the shell attempts to locate it. "
  4855. "If there exists a shell function by that name, that function is invoked as "
  4856. "described in @ref{Shell Functions}."
  4857. msgstr ""
  4858. #. type: enumerate
  4859. #: ./bashref.texi:2913
  4860. msgid ""
  4861. "If the name does not match a function, the shell searches for it in the list "
  4862. "of shell builtins. If a match is found, that builtin is invoked."
  4863. msgstr ""
  4864. #. type: enumerate
  4865. #: ./bashref.texi:2930
  4866. msgid ""
  4867. "If the name is neither a shell function nor a builtin, and contains no "
  4868. "slashes, Bash searches each element of @env{$PATH} for a directory "
  4869. "containing an executable file by that name. Bash uses a hash table to "
  4870. "remember the full pathnames of executable files to avoid multiple @env{PATH} "
  4871. "searches (see the description of @code{hash} in @ref{Bourne Shell "
  4872. "Builtins}). A full search of the directories in @env{$PATH} is performed "
  4873. "only if the command is not found in the hash table. If the search is "
  4874. "unsuccessful, the shell searches for a defined shell function named "
  4875. "@code{command_not_found_handle}. If that function exists, it is invoked "
  4876. "with the original command and the original command's arguments as its "
  4877. "arguments, and the function's exit status becomes the exit status of the "
  4878. "shell. If that function is not defined, the shell prints an error message "
  4879. "and returns an exit status of 127."
  4880. msgstr ""
  4881. #. type: enumerate
  4882. #: ./bashref.texi:2937
  4883. msgid ""
  4884. "If the search is successful, or if the command name contains one or more "
  4885. "slashes, the shell executes the named program in a separate execution "
  4886. "environment. Argument 0 is set to the name given, and the remaining "
  4887. "arguments to the command are set to the arguments supplied, if any."
  4888. msgstr ""
  4889. #. type: enumerate
  4890. #: ./bashref.texi:2943
  4891. msgid ""
  4892. "If this execution fails because the file is not in executable format, and "
  4893. "the file is not a directory, it is assumed to be a @var{shell script} and "
  4894. "the shell executes it as described in @ref{Shell Scripts}."
  4895. msgstr ""
  4896. #. type: enumerate
  4897. #: ./bashref.texi:2947
  4898. msgid ""
  4899. "If the command was not begun asynchronously, the shell waits for the command "
  4900. "to complete and collects its exit status."
  4901. msgstr ""
  4902. #. type: cindex
  4903. #: ./bashref.texi:2952
  4904. #, no-wrap
  4905. msgid "execution environment"
  4906. msgstr ""
  4907. #. type: Plain text
  4908. #: ./bashref.texi:2956
  4909. msgid ""
  4910. "The shell has an @var{execution environment}, which consists of the "
  4911. "following:"
  4912. msgstr ""
  4913. #. type: itemize
  4914. #: ./bashref.texi:2961
  4915. msgid ""
  4916. "open files inherited by the shell at invocation, as modified by redirections "
  4917. "supplied to the @code{exec} builtin"
  4918. msgstr ""
  4919. #. type: itemize
  4920. #: ./bashref.texi:2965
  4921. msgid ""
  4922. "the current working directory as set by @code{cd}, @code{pushd}, or "
  4923. "@code{popd}, or inherited by the shell at invocation"
  4924. msgstr ""
  4925. #. type: itemize
  4926. #: ./bashref.texi:2969
  4927. msgid ""
  4928. "the file creation mode mask as set by @code{umask} or inherited from the "
  4929. "shell's parent"
  4930. msgstr ""
  4931. #. type: itemize
  4932. #: ./bashref.texi:2972
  4933. msgid "current traps set by @code{trap}"
  4934. msgstr ""
  4935. #. type: itemize
  4936. #: ./bashref.texi:2976
  4937. msgid ""
  4938. "shell parameters that are set by variable assignment or with @code{set} or "
  4939. "inherited from the shell's parent in the environment"
  4940. msgstr ""
  4941. #. type: itemize
  4942. #: ./bashref.texi:2980
  4943. msgid ""
  4944. "shell functions defined during execution or inherited from the shell's "
  4945. "parent in the environment"
  4946. msgstr ""
  4947. #. type: itemize
  4948. #: ./bashref.texi:2984
  4949. msgid ""
  4950. "options enabled at invocation (either by default or with command-line "
  4951. "arguments) or by @code{set}"
  4952. msgstr ""
  4953. #. type: itemize
  4954. #: ./bashref.texi:2987
  4955. msgid "options enabled by @code{shopt} (@pxref{The Shopt Builtin})"
  4956. msgstr ""
  4957. #. type: itemize
  4958. #: ./bashref.texi:2990
  4959. msgid "shell aliases defined with @code{alias} (@pxref{Aliases})"
  4960. msgstr ""
  4961. #. type: itemize
  4962. #: ./bashref.texi:2995
  4963. msgid ""
  4964. "various process @sc{id}s, including those of background jobs "
  4965. "(@pxref{Lists}), the value of @code{$$}, and the value of @env{$PPID}"
  4966. msgstr ""
  4967. #. type: Plain text
  4968. #: ./bashref.texi:3003
  4969. msgid ""
  4970. "When a simple command other than a builtin or shell function is to be "
  4971. "executed, it is invoked in a separate execution environment that consists of "
  4972. "the following. Unless otherwise noted, the values are inherited from the "
  4973. "shell."
  4974. msgstr ""
  4975. #. type: itemize
  4976. #: ./bashref.texi:3008
  4977. msgid ""
  4978. "the shell's open files, plus any modifications and additions specified by "
  4979. "redirections to the command"
  4980. msgstr ""
  4981. #. type: itemize
  4982. #: ./bashref.texi:3011
  4983. msgid "the current working directory"
  4984. msgstr ""
  4985. #. type: itemize
  4986. #: ./bashref.texi:3014
  4987. msgid "the file creation mode mask"
  4988. msgstr ""
  4989. #. type: itemize
  4990. #: ./bashref.texi:3018
  4991. msgid ""
  4992. "shell variables and functions marked for export, along with variables "
  4993. "exported for the command, passed in the environment (@pxref{Environment})"
  4994. msgstr ""
  4995. #. type: itemize
  4996. #: ./bashref.texi:3022
  4997. msgid ""
  4998. "traps caught by the shell are reset to the values inherited from the shell's "
  4999. "parent, and traps ignored by the shell are ignored"
  5000. msgstr ""
  5001. #. type: Plain text
  5002. #: ./bashref.texi:3027
  5003. msgid ""
  5004. "A command invoked in this separate environment cannot affect the shell's "
  5005. "execution environment."
  5006. msgstr ""
  5007. #. type: Plain text
  5008. #: ./bashref.texi:3036
  5009. msgid ""
  5010. "Command substitution, commands grouped with parentheses, and asynchronous "
  5011. "commands are invoked in a subshell environment that is a duplicate of the "
  5012. "shell environment, except that traps caught by the shell are reset to the "
  5013. "values that the shell inherited from its parent at invocation. Builtin "
  5014. "commands that are invoked as part of a pipeline are also executed in a "
  5015. "subshell environment. Changes made to the subshell environment cannot "
  5016. "affect the shell's execution environment."
  5017. msgstr ""
  5018. #. type: Plain text
  5019. #: ./bashref.texi:3040
  5020. msgid ""
  5021. "Subshells spawned to execute command substitutions inherit the value of the "
  5022. "@option{-e} option from the parent shell. When not in @sc{posix} mode, Bash "
  5023. "clears the @option{-e} option in such subshells."
  5024. msgstr ""
  5025. #. type: Plain text
  5026. #: ./bashref.texi:3045
  5027. msgid ""
  5028. "If a command is followed by a @samp{&} and job control is not active, the "
  5029. "default standard input for the command is the empty file @file{/dev/null}. "
  5030. "Otherwise, the invoked command inherits the file descriptors of the calling "
  5031. "shell as modified by redirections."
  5032. msgstr ""
  5033. #. type: cindex
  5034. #: ./bashref.texi:3048
  5035. #, no-wrap
  5036. msgid "environment"
  5037. msgstr ""
  5038. #. type: Plain text
  5039. #: ./bashref.texi:3053
  5040. msgid ""
  5041. "When a program is invoked it is given an array of strings called the "
  5042. "@var{environment}. This is a list of name-value pairs, of the form "
  5043. "@code{name=value}."
  5044. msgstr ""
  5045. #. type: Plain text
  5046. #: ./bashref.texi:3069
  5047. msgid ""
  5048. "Bash provides several ways to manipulate the environment. On invocation, "
  5049. "the shell scans its own environment and creates a parameter for each name "
  5050. "found, automatically marking it for @var{export} to child processes. "
  5051. "Executed commands inherit the environment. The @code{export} and "
  5052. "@samp{declare -x} commands allow parameters and functions to be added to and "
  5053. "deleted from the environment. If the value of a parameter in the "
  5054. "environment is modified, the new value becomes part of the environment, "
  5055. "replacing the old. The environment inherited by any executed command "
  5056. "consists of the shell's initial environment, whose values may be modified in "
  5057. "the shell, less any pairs removed by the @code{unset} and @samp{export -n} "
  5058. "commands, plus any additions via the @code{export} and @samp{declare -x} "
  5059. "commands."
  5060. msgstr ""
  5061. #. type: Plain text
  5062. #: ./bashref.texi:3075
  5063. msgid ""
  5064. "The environment for any simple command or function may be augmented "
  5065. "temporarily by prefixing it with parameter assignments, as described in "
  5066. "@ref{Shell Parameters}. These assignment statements affect only the "
  5067. "environment seen by that command."
  5068. msgstr ""
  5069. #. type: Plain text
  5070. #: ./bashref.texi:3079
  5071. msgid ""
  5072. "If the @option{-k} option is set (@pxref{The Set Builtin}), then all "
  5073. "parameter assignments are placed in the environment for a command, not just "
  5074. "those that precede the command name."
  5075. msgstr ""
  5076. #. type: Plain text
  5077. #: ./bashref.texi:3083
  5078. msgid ""
  5079. "When Bash invokes an external command, the variable @samp{$_} is set to the "
  5080. "full pathname of the command and passed to that command in its environment."
  5081. msgstr ""
  5082. #. type: Plain text
  5083. #: ./bashref.texi:3095
  5084. msgid ""
  5085. "The exit status of an executed command is the value returned by the "
  5086. "@var{waitpid} system call or equivalent function. Exit statuses fall "
  5087. "between 0 and 255, though, as explained below, the shell may use values "
  5088. "above 125 specially. Exit statuses from shell builtins and compound "
  5089. "commands are also limited to this range. Under certain circumstances, the "
  5090. "shell will use special values to indicate specific failure modes."
  5091. msgstr ""
  5092. #. type: Plain text
  5093. #: ./bashref.texi:3104
  5094. msgid ""
  5095. "For the shell's purposes, a command which exits with a zero exit status has "
  5096. "succeeded. A non-zero exit status indicates failure. This seemingly "
  5097. "counter-intuitive scheme is used so there is one well-defined way to "
  5098. "indicate success and a variety of ways to indicate various failure modes. "
  5099. "When a command terminates on a fatal signal whose number is @var{N}, Bash "
  5100. "uses the value 128+@var{N} as the exit status."
  5101. msgstr ""
  5102. #. type: Plain text
  5103. #: ./bashref.texi:3108
  5104. msgid ""
  5105. "If a command is not found, the child process created to execute it returns a "
  5106. "status of 127. If a command is found but is not executable, the return "
  5107. "status is 126."
  5108. msgstr ""
  5109. #. type: Plain text
  5110. #: ./bashref.texi:3111
  5111. msgid ""
  5112. "If a command fails because of an error during expansion or redirection, the "
  5113. "exit status is greater than zero."
  5114. msgstr ""
  5115. #. type: Plain text
  5116. #: ./bashref.texi:3115
  5117. msgid ""
  5118. "The exit status is used by the Bash conditional commands (@pxref{Conditional "
  5119. "Constructs}) and some of the list constructs (@pxref{Lists})."
  5120. msgstr ""
  5121. #. type: Plain text
  5122. #: ./bashref.texi:3121
  5123. msgid ""
  5124. "All of the Bash builtins return an exit status of zero if they succeed and a "
  5125. "non-zero status on failure, so they may be used by the conditional and list "
  5126. "constructs. All builtins return an exit status of 2 to indicate incorrect "
  5127. "usage, generally invalid options or missing arguments."
  5128. msgstr ""
  5129. #. type: cindex
  5130. #: ./bashref.texi:3124
  5131. #, no-wrap
  5132. msgid "signal handling"
  5133. msgstr ""
  5134. #. type: Plain text
  5135. #: ./bashref.texi:3134
  5136. msgid ""
  5137. "When Bash is interactive, in the absence of any traps, it ignores "
  5138. "@code{SIGTERM} (so that @samp{kill 0} does not kill an interactive shell), "
  5139. "and @code{SIGINT} is caught and handled (so that the @code{wait} builtin is "
  5140. "interruptible). When Bash receives a @code{SIGINT}, it breaks out of any "
  5141. "executing loops. In all cases, Bash ignores @code{SIGQUIT}. If job control "
  5142. "is in effect (@pxref{Job Control}), Bash ignores @code{SIGTTIN}, "
  5143. "@code{SIGTTOU}, and @code{SIGTSTP}."
  5144. msgstr ""
  5145. #. type: Plain text
  5146. #: ./bashref.texi:3143
  5147. msgid ""
  5148. "Non-builtin commands started by Bash have signal handlers set to the values "
  5149. "inherited by the shell from its parent. When job control is not in effect, "
  5150. "asynchronous commands ignore @code{SIGINT} and @code{SIGQUIT} in addition to "
  5151. "these inherited handlers. Commands run as a result of command substitution "
  5152. "ignore the keyboard-generated job control signals @code{SIGTTIN}, "
  5153. "@code{SIGTTOU}, and @code{SIGTSTP}."
  5154. msgstr ""
  5155. #. type: Plain text
  5156. #: ./bashref.texi:3154
  5157. msgid ""
  5158. "The shell exits by default upon receipt of a @code{SIGHUP}. Before exiting, "
  5159. "an interactive shell resends the @code{SIGHUP} to all jobs, running or "
  5160. "stopped. Stopped jobs are sent @code{SIGCONT} to ensure that they receive "
  5161. "the @code{SIGHUP}. To prevent the shell from sending the @code{SIGHUP} "
  5162. "signal to a particular job, it should be removed from the jobs table with "
  5163. "the @code{disown} builtin (@pxref{Job Control Builtins}) or marked to not "
  5164. "receive @code{SIGHUP} using @code{disown -h}."
  5165. msgstr ""
  5166. #. type: Plain text
  5167. #: ./bashref.texi:3158
  5168. msgid ""
  5169. "If the @code{huponexit} shell option has been set with @code{shopt} "
  5170. "(@pxref{The Shopt Builtin}), Bash sends a @code{SIGHUP} to all jobs when an "
  5171. "interactive login shell exits."
  5172. msgstr ""
  5173. #. type: Plain text
  5174. #: ./bashref.texi:3167
  5175. msgid ""
  5176. "If Bash is waiting for a command to complete and receives a signal for which "
  5177. "a trap has been set, the trap will not be executed until the command "
  5178. "completes. When Bash is waiting for an asynchronous command via the "
  5179. "@code{wait} builtin, the reception of a signal for which a trap has been set "
  5180. "will cause the @code{wait} builtin to return immediately with an exit status "
  5181. "greater than 128, immediately after which the trap is executed."
  5182. msgstr ""
  5183. #. type: cindex
  5184. #: ./bashref.texi:3170
  5185. #, no-wrap
  5186. msgid "shell script"
  5187. msgstr ""
  5188. #. type: Plain text
  5189. #: ./bashref.texi:3180
  5190. msgid ""
  5191. "A shell script is a text file containing shell commands. When such a file "
  5192. "is used as the first non-option argument when invoking Bash, and neither the "
  5193. "@option{-c} nor @option{-s} option is supplied (@pxref{Invoking Bash}), Bash "
  5194. "reads and executes commands from the file, then exits. This mode of "
  5195. "operation creates a non-interactive shell. The shell first searches for the "
  5196. "file in the current directory, and looks in the directories in @env{$PATH} "
  5197. "if not found there."
  5198. msgstr ""
  5199. #. type: Plain text
  5200. #: ./bashref.texi:3187
  5201. msgid ""
  5202. "When Bash runs a shell script, it sets the special parameter @code{0} to the "
  5203. "name of the file, rather than the name of the shell, and the positional "
  5204. "parameters are set to the remaining arguments, if any are given. If no "
  5205. "additional arguments are supplied, the positional parameters are unset."
  5206. msgstr ""
  5207. #. type: Plain text
  5208. #: ./bashref.texi:3192
  5209. msgid ""
  5210. "A shell script may be made executable by using the @code{chmod} command to "
  5211. "turn on the execute bit. When Bash finds such a file while searching the "
  5212. "@env{$PATH} for a command, it spawns a subshell to execute it. In other "
  5213. "words, executing"
  5214. msgstr ""
  5215. #. type: example
  5216. #: ./bashref.texi:3194
  5217. #, no-wrap
  5218. msgid "filename @var{arguments}\n"
  5219. msgstr ""
  5220. #. type: Plain text
  5221. #: ./bashref.texi:3197
  5222. msgid "is equivalent to executing"
  5223. msgstr ""
  5224. #. type: example
  5225. #: ./bashref.texi:3199
  5226. #, no-wrap
  5227. msgid "bash filename @var{arguments}\n"
  5228. msgstr ""
  5229. #. type: Plain text
  5230. #: ./bashref.texi:3208
  5231. msgid ""
  5232. "if @code{filename} is an executable shell script. This subshell "
  5233. "reinitializes itself, so that the effect is as if a new shell had been "
  5234. "invoked to interpret the script, with the exception that the locations of "
  5235. "commands remembered by the parent (see the description of @code{hash} in "
  5236. "@ref{Bourne Shell Builtins}) are retained by the child."
  5237. msgstr ""
  5238. #. type: Plain text
  5239. #: ./bashref.texi:3215
  5240. msgid ""
  5241. "Most versions of Unix make this a part of the operating system's command "
  5242. "execution mechanism. If the first line of a script begins with the two "
  5243. "characters @samp{#!}, the remainder of the line specifies an interpreter for "
  5244. "the program. Thus, you can specify Bash, @code{awk}, Perl, or some other "
  5245. "interpreter and write the rest of the script file in that language."
  5246. msgstr ""
  5247. #. type: Plain text
  5248. #: ./bashref.texi:3223
  5249. msgid ""
  5250. "The arguments to the interpreter consist of a single optional argument "
  5251. "following the interpreter name on the first line of the script file, "
  5252. "followed by the name of the script file, followed by the rest of the "
  5253. "arguments. Bash will perform this action on operating systems that do not "
  5254. "handle it themselves. Note that some older versions of Unix limit the "
  5255. "interpreter name and argument to a maximum of 32 characters."
  5256. msgstr ""
  5257. #. type: Plain text
  5258. #: ./bashref.texi:3228
  5259. msgid ""
  5260. "Bash scripts often begin with @code{#! /bin/bash} (assuming that Bash has "
  5261. "been installed in @file{/bin}), since this ensures that Bash will be used to "
  5262. "interpret the script, even if it is executed under another shell."
  5263. msgstr ""
  5264. #. type: section
  5265. #: ./bashref.texi:3240 ./bashref.texi:3275 ./bashref.texi:3276
  5266. #, no-wrap
  5267. msgid "Bourne Shell Builtins"
  5268. msgstr ""
  5269. #. type: menuentry
  5270. #: ./bashref.texi:3240
  5271. msgid "Builtin commands inherited from the Bourne Shell."
  5272. msgstr ""
  5273. #. type: node
  5274. #: ./bashref.texi:3240 ./bashref.texi:3825
  5275. #, no-wrap
  5276. msgid "Bash Builtins"
  5277. msgstr ""
  5278. #. type: menuentry
  5279. #: ./bashref.texi:3240
  5280. msgid "Table of builtins specific to Bash."
  5281. msgstr ""
  5282. #. type: section
  5283. #: ./bashref.texi:3240 ./bashref.texi:4657 ./bashref.texi:4658
  5284. #, no-wrap
  5285. msgid "Modifying Shell Behavior"
  5286. msgstr ""
  5287. #. type: menuentry
  5288. #: ./bashref.texi:3240
  5289. msgid "Builtins to modify shell attributes and optional behavior."
  5290. msgstr ""
  5291. #. type: section
  5292. #: ./bashref.texi:3240 ./bashref.texi:5346 ./bashref.texi:5347
  5293. #, no-wrap
  5294. msgid "Special Builtins"
  5295. msgstr ""
  5296. #. type: menuentry
  5297. #: ./bashref.texi:3240
  5298. msgid "Builtin commands classified specially by POSIX."
  5299. msgstr ""
  5300. #. type: Plain text
  5301. #: ./bashref.texi:3248
  5302. msgid ""
  5303. "Builtin commands are contained within the shell itself. When the name of a "
  5304. "builtin command is used as the first word of a simple command (@pxref{Simple "
  5305. "Commands}), the shell executes the command directly, without invoking "
  5306. "another program. Builtin commands are necessary to implement functionality "
  5307. "impossible or inconvenient to obtain with separate utilities."
  5308. msgstr ""
  5309. #. type: Plain text
  5310. #: ./bashref.texi:3252
  5311. msgid ""
  5312. "This section briefly describes the builtins which Bash inherits from the "
  5313. "Bourne Shell, as well as the builtin commands which are unique to or have "
  5314. "been extended in Bash."
  5315. msgstr ""
  5316. #. type: Plain text
  5317. #: ./bashref.texi:3259
  5318. msgid ""
  5319. "Several builtin commands are described in other chapters: builtin commands "
  5320. "which provide the Bash interface to the job control facilities (@pxref{Job "
  5321. "Control Builtins}), the directory stack (@pxref{Directory Stack Builtins}), "
  5322. "the command history (@pxref{Bash History Builtins}), and the programmable "
  5323. "completion facilities (@pxref{Programmable Completion Builtins})."
  5324. msgstr ""
  5325. #. type: Plain text
  5326. #: ./bashref.texi:3261
  5327. msgid "Many of the builtins have been extended by @sc{posix} or Bash."
  5328. msgstr ""
  5329. #. type: Plain text
  5330. #: ./bashref.texi:3274
  5331. msgid ""
  5332. "Unless otherwise noted, each builtin command documented as accepting options "
  5333. "preceded by @samp{-} accepts @samp{--} to signify the end of the options. "
  5334. "The @code{:}, @code{true}, @code{false}, and @code{test} builtins do not "
  5335. "accept options and do not treat @samp{--} specially. The @code{exit}, "
  5336. "@code{logout}, @code{return}, @code{break}, @code{continue}, @code{let}, and "
  5337. "@code{shift} builtins accept and process arguments beginning with @samp{-} "
  5338. "without requiring @samp{--}. Other builtins that accept arguments but are "
  5339. "not specified as accepting options interpret arguments beginning with "
  5340. "@samp{-} as invalid options and require @samp{--} to prevent this "
  5341. "interpretation."
  5342. msgstr ""
  5343. #. type: Plain text
  5344. #: ./bashref.texi:3280
  5345. msgid ""
  5346. "The following shell builtin commands are inherited from the Bourne Shell. "
  5347. "These commands are implemented as specified by the @sc{posix} standard."
  5348. msgstr ""
  5349. #. type: item
  5350. #: ./bashref.texi:3282
  5351. #, no-wrap
  5352. msgid ": @r{(a colon)}"
  5353. msgstr ""
  5354. #. type: btindex
  5355. #: ./bashref.texi:3283
  5356. #, no-wrap
  5357. msgid ":"
  5358. msgstr ""
  5359. #. type: example
  5360. #: ./bashref.texi:3286
  5361. #, no-wrap
  5362. msgid ": [@var{arguments}]\n"
  5363. msgstr ""
  5364. #. type: table
  5365. #: ./bashref.texi:3290
  5366. msgid ""
  5367. "Do nothing beyond expanding @var{arguments} and performing redirections. "
  5368. "The return status is zero."
  5369. msgstr ""
  5370. #. type: item
  5371. #: ./bashref.texi:3291
  5372. #, no-wrap
  5373. msgid ". @r{(a period)}"
  5374. msgstr ""
  5375. #. type: btindex
  5376. #: ./bashref.texi:3292
  5377. #, no-wrap
  5378. msgid "."
  5379. msgstr ""
  5380. #. type: example
  5381. #: ./bashref.texi:3295
  5382. #, no-wrap
  5383. msgid ". @var{filename} [@var{arguments}]\n"
  5384. msgstr ""
  5385. #. type: table
  5386. #: ./bashref.texi:3315
  5387. msgid ""
  5388. "Read and execute commands from the @var{filename} argument in the current "
  5389. "shell context. If @var{filename} does not contain a slash, the @env{PATH} "
  5390. "variable is used to find @var{filename}. When Bash is not in @sc{posix} "
  5391. "mode, the current directory is searched if @var{filename} is not found in "
  5392. "@env{$PATH}. If any @var{arguments} are supplied, they become the "
  5393. "positional parameters when @var{filename} is executed. Otherwise the "
  5394. "positional parameters are unchanged. If the @option{-T} option is enabled, "
  5395. "@code{source} inherits any trap on @code{DEBUG}; if it is not, any "
  5396. "@code{DEBUG} trap string is saved and restored around the call to "
  5397. "@code{source}, and @code{source} unsets the @code{DEBUG} trap while it "
  5398. "executes. If @option{-T} is not set, and the sourced file changes the "
  5399. "@code{DEBUG} trap, the new value is retained when @code{source} completes. "
  5400. "The return status is the exit status of the last command executed, or zero "
  5401. "if no commands are executed. If @var{filename} is not found, or cannot be "
  5402. "read, the return status is non-zero. This builtin is equivalent to "
  5403. "@code{source}."
  5404. msgstr ""
  5405. #. type: btindex
  5406. #: ./bashref.texi:3316 ./bashref.texi:3317
  5407. #, no-wrap
  5408. msgid "break"
  5409. msgstr ""
  5410. #. type: example
  5411. #: ./bashref.texi:3320
  5412. #, no-wrap
  5413. msgid "break [@var{n}]\n"
  5414. msgstr ""
  5415. #. type: table
  5416. #: ./bashref.texi:3326
  5417. msgid ""
  5418. "Exit from a @code{for}, @code{while}, @code{until}, or @code{select} loop. "
  5419. "If @var{n} is supplied, the @var{n}th enclosing loop is exited. @var{n} "
  5420. "must be greater than or equal to 1. The return status is zero unless "
  5421. "@var{n} is not greater than or equal to 1."
  5422. msgstr ""
  5423. #. type: btindex
  5424. #: ./bashref.texi:3327 ./bashref.texi:3328
  5425. #, no-wrap
  5426. msgid "cd"
  5427. msgstr ""
  5428. #. type: example
  5429. #: ./bashref.texi:3331
  5430. #, no-wrap
  5431. msgid "cd [-L|[-P [-e]] [-@@] [@var{directory}]\n"
  5432. msgstr ""
  5433. #. type: table
  5434. #: ./bashref.texi:3343
  5435. msgid ""
  5436. "Change the current working directory to @var{directory}. If @var{directory} "
  5437. "is not supplied, the value of the @env{HOME} shell variable is used. Any "
  5438. "additional arguments following @var{directory} are ignored. If the shell "
  5439. "variable @env{CDPATH} exists, it is used as a search path: each directory "
  5440. "name in @env{CDPATH} is searched for @var{directory}, with alternative "
  5441. "directory names in @env{CDPATH} separated by a colon (@samp{:}). If "
  5442. "@var{directory} begins with a slash, @env{CDPATH} is not used."
  5443. msgstr ""
  5444. #. type: table
  5445. #: ./bashref.texi:3347
  5446. msgid ""
  5447. "The @option{-P} option means to not follow symbolic links: symbolic links "
  5448. "are resolved while @code{cd} is traversing @var{directory} and before "
  5449. "processing an instance of @samp{..} in @var{directory}."
  5450. msgstr ""
  5451. #. type: table
  5452. #: ./bashref.texi:3351
  5453. msgid ""
  5454. "By default, or when the @option{-L} option is supplied, symbolic links in "
  5455. "@var{directory} are resolved after @code{cd} processes an instance of "
  5456. "@samp{..} in @var{directory}."
  5457. msgstr ""
  5458. #. type: table
  5459. #: ./bashref.texi:3355
  5460. msgid ""
  5461. "If @samp{..} appears in @var{directory}, it is processed by removing the "
  5462. "immediately preceding pathname component, back to a slash or the beginning "
  5463. "of @var{directory}."
  5464. msgstr ""
  5465. #. type: table
  5466. #: ./bashref.texi:3360
  5467. msgid ""
  5468. "If the @option{-e} option is supplied with @option{-P} and the current "
  5469. "working directory cannot be successfully determined after a successful "
  5470. "directory change, @code{cd} will return an unsuccessful status."
  5471. msgstr ""
  5472. #. type: table
  5473. #: ./bashref.texi:3363
  5474. msgid ""
  5475. "On systems that support it, the @option{-@@} option presents the extended "
  5476. "attributes associated with a file as a directory."
  5477. msgstr ""
  5478. #. type: table
  5479. #: ./bashref.texi:3366
  5480. msgid ""
  5481. "If @var{directory} is @samp{-}, it is converted to @env{$OLDPWD} before the "
  5482. "directory change is attempted."
  5483. msgstr ""
  5484. #. type: table
  5485. #: ./bashref.texi:3371
  5486. msgid ""
  5487. "If a non-empty directory name from @env{CDPATH} is used, or if @samp{-} is "
  5488. "the first argument, and the directory change is successful, the absolute "
  5489. "pathname of the new working directory is written to the standard output."
  5490. msgstr ""
  5491. #. type: table
  5492. #: ./bashref.texi:3374
  5493. msgid ""
  5494. "The return status is zero if the directory is successfully changed, non-zero "
  5495. "otherwise."
  5496. msgstr ""
  5497. #. type: btindex
  5498. #: ./bashref.texi:3375 ./bashref.texi:3376
  5499. #, no-wrap
  5500. msgid "continue"
  5501. msgstr ""
  5502. #. type: example
  5503. #: ./bashref.texi:3379
  5504. #, no-wrap
  5505. msgid "continue [@var{n}]\n"
  5506. msgstr ""
  5507. #. type: table
  5508. #: ./bashref.texi:3387
  5509. msgid ""
  5510. "Resume the next iteration of an enclosing @code{for}, @code{while}, "
  5511. "@code{until}, or @code{select} loop. If @var{n} is supplied, the execution "
  5512. "of the @var{n}th enclosing loop is resumed. @var{n} must be greater than or "
  5513. "equal to 1. The return status is zero unless @var{n} is not greater than or "
  5514. "equal to 1."
  5515. msgstr ""
  5516. #. type: btindex
  5517. #: ./bashref.texi:3388 ./bashref.texi:3389
  5518. #, no-wrap
  5519. msgid "eval"
  5520. msgstr ""
  5521. #. type: example
  5522. #: ./bashref.texi:3392
  5523. #, no-wrap
  5524. msgid "eval [@var{arguments}]\n"
  5525. msgstr ""
  5526. #. type: table
  5527. #: ./bashref.texi:3399
  5528. msgid ""
  5529. "The arguments are concatenated together into a single command, which is then "
  5530. "read and executed, and its exit status returned as the exit status of "
  5531. "@code{eval}. If there are no arguments or only empty arguments, the return "
  5532. "status is zero."
  5533. msgstr ""
  5534. #. type: btindex
  5535. #: ./bashref.texi:3400 ./bashref.texi:3401
  5536. #, no-wrap
  5537. msgid "exec"
  5538. msgstr ""
  5539. #. type: example
  5540. #: ./bashref.texi:3404
  5541. #, no-wrap
  5542. msgid "exec [-cl] [-a @var{name}] [@var{command} [@var{arguments}]]\n"
  5543. msgstr ""
  5544. #. type: table
  5545. #: ./bashref.texi:3423
  5546. msgid ""
  5547. "If @var{command} is supplied, it replaces the shell without creating a new "
  5548. "process. If the @option{-l} option is supplied, the shell places a dash at "
  5549. "the beginning of the zeroth argument passed to @var{command}. This is what "
  5550. "the @code{login} program does. The @option{-c} option causes @var{command} "
  5551. "to be executed with an empty environment. If @option{-a} is supplied, the "
  5552. "shell passes @var{name} as the zeroth argument to @var{command}. If "
  5553. "@var{command} cannot be executed for some reason, a non-interactive shell "
  5554. "exits, unless the @code{execfail} shell option is enabled. In that case, it "
  5555. "returns failure. An interactive shell returns failure if the file cannot be "
  5556. "executed. If no @var{command} is specified, redirections may be used to "
  5557. "affect the current shell environment. If there are no redirection errors, "
  5558. "the return status is zero; otherwise the return status is non-zero."
  5559. msgstr ""
  5560. #. type: btindex
  5561. #: ./bashref.texi:3424 ./bashref.texi:3425
  5562. #, no-wrap
  5563. msgid "exit"
  5564. msgstr ""
  5565. #. type: example
  5566. #: ./bashref.texi:3428
  5567. #, no-wrap
  5568. msgid "exit [@var{n}]\n"
  5569. msgstr ""
  5570. #. type: table
  5571. #: ./bashref.texi:3433
  5572. msgid ""
  5573. "Exit the shell, returning a status of @var{n} to the shell's parent. If "
  5574. "@var{n} is omitted, the exit status is that of the last command executed. "
  5575. "Any trap on @code{EXIT} is executed before the shell terminates."
  5576. msgstr ""
  5577. #. type: btindex
  5578. #: ./bashref.texi:3434 ./bashref.texi:3435
  5579. #, no-wrap
  5580. msgid "export"
  5581. msgstr ""
  5582. #. type: example
  5583. #: ./bashref.texi:3438
  5584. #, no-wrap
  5585. msgid "export [-fn] [-p] [@var{name}[=@var{value}]]\n"
  5586. msgstr ""
  5587. #. type: table
  5588. #: ./bashref.texi:3449
  5589. msgid ""
  5590. "Mark each @var{name} to be passed to child processes in the environment. If "
  5591. "the @option{-f} option is supplied, the @var{name}s refer to shell "
  5592. "functions; otherwise the names refer to shell variables. The @option{-n} "
  5593. "option means to no longer mark each @var{name} for export. If no "
  5594. "@var{names} are supplied, or if the @option{-p} option is given, a list of "
  5595. "names of all exported variables is displayed. The @option{-p} option "
  5596. "displays output in a form that may be reused as input. If a variable name "
  5597. "is followed by =@var{value}, the value of the variable is set to "
  5598. "@var{value}."
  5599. msgstr ""
  5600. #. type: table
  5601. #: ./bashref.texi:3453
  5602. msgid ""
  5603. "The return status is zero unless an invalid option is supplied, one of the "
  5604. "names is not a valid shell variable name, or @option{-f} is supplied with a "
  5605. "name that is not a shell function."
  5606. msgstr ""
  5607. #. type: btindex
  5608. #: ./bashref.texi:3454 ./bashref.texi:3455
  5609. #, no-wrap
  5610. msgid "getopts"
  5611. msgstr ""
  5612. #. type: example
  5613. #: ./bashref.texi:3458
  5614. #, no-wrap
  5615. msgid "getopts @var{optstring} @var{name} [@var{args}]\n"
  5616. msgstr ""
  5617. #. type: table
  5618. #: ./bashref.texi:3478
  5619. msgid ""
  5620. "@code{getopts} is used by shell scripts to parse positional parameters. "
  5621. "@var{optstring} contains the option characters to be recognized; if a "
  5622. "character is followed by a colon, the option is expected to have an "
  5623. "argument, which should be separated from it by whitespace. The colon "
  5624. "(@samp{:}) and question mark (@samp{?}) may not be used as option "
  5625. "characters. Each time it is invoked, @code{getopts} places the next option "
  5626. "in the shell variable @var{name}, initializing @var{name} if it does not "
  5627. "exist, and the index of the next argument to be processed into the variable "
  5628. "@env{OPTIND}. @env{OPTIND} is initialized to 1 each time the shell or a "
  5629. "shell script is invoked. When an option requires an argument, "
  5630. "@code{getopts} places that argument into the variable @env{OPTARG}. The "
  5631. "shell does not reset @env{OPTIND} automatically; it must be manually reset "
  5632. "between multiple calls to @code{getopts} within the same shell invocation if "
  5633. "a new set of parameters is to be used."
  5634. msgstr ""
  5635. #. type: table
  5636. #: ./bashref.texi:3483
  5637. msgid ""
  5638. "When the end of options is encountered, @code{getopts} exits with a return "
  5639. "value greater than zero. @env{OPTIND} is set to the index of the first "
  5640. "non-option argument, and @var{name} is set to @samp{?}."
  5641. msgstr ""
  5642. #. type: table
  5643. #: ./bashref.texi:3487
  5644. msgid ""
  5645. "@code{getopts} normally parses the positional parameters, but if more "
  5646. "arguments are given in @var{args}, @code{getopts} parses those instead."
  5647. msgstr ""
  5648. #. type: table
  5649. #: ./bashref.texi:3496
  5650. msgid ""
  5651. "@code{getopts} can report errors in two ways. If the first character of "
  5652. "@var{optstring} is a colon, @var{silent} error reporting is used. In normal "
  5653. "operation, diagnostic messages are printed when invalid options or missing "
  5654. "option arguments are encountered. If the variable @env{OPTERR} is set to 0, "
  5655. "no error messages will be displayed, even if the first character of "
  5656. "@code{optstring} is not a colon."
  5657. msgstr ""
  5658. #. type: table
  5659. #: ./bashref.texi:3502
  5660. msgid ""
  5661. "If an invalid option is seen, @code{getopts} places @samp{?} into @var{name} "
  5662. "and, if not silent, prints an error message and unsets @env{OPTARG}. If "
  5663. "@code{getopts} is silent, the option character found is placed in "
  5664. "@env{OPTARG} and no diagnostic message is printed."
  5665. msgstr ""
  5666. #. type: table
  5667. #: ./bashref.texi:3508
  5668. msgid ""
  5669. "If a required argument is not found, and @code{getopts} is not silent, a "
  5670. "question mark (@samp{?}) is placed in @var{name}, @code{OPTARG} is unset, "
  5671. "and a diagnostic message is printed. If @code{getopts} is silent, then a "
  5672. "colon (@samp{:}) is placed in @var{name} and @env{OPTARG} is set to the "
  5673. "option character found."
  5674. msgstr ""
  5675. #. type: btindex
  5676. #: ./bashref.texi:3509 ./bashref.texi:3510
  5677. #, no-wrap
  5678. msgid "hash"
  5679. msgstr ""
  5680. #. type: example
  5681. #: ./bashref.texi:3513
  5682. #, no-wrap
  5683. msgid "hash [-r] [-p @var{filename}] [-dt] [@var{name}]\n"
  5684. msgstr ""
  5685. #. type: table
  5686. #: ./bashref.texi:3536
  5687. msgid ""
  5688. "Each time @code{hash} is invoked, it remembers the full pathnames of the "
  5689. "commands specified as @var{name} arguments, so they need not be searched for "
  5690. "on subsequent invocations. The commands are found by searching through the "
  5691. "directories listed in @env{$PATH}. Any previously-remembered pathname is "
  5692. "discarded. The @option{-p} option inhibits the path search, and "
  5693. "@var{filename} is used as the location of @var{name}. The @option{-r} "
  5694. "option causes the shell to forget all remembered locations. The @option{-d} "
  5695. "option causes the shell to forget the remembered location of each "
  5696. "@var{name}. If the @option{-t} option is supplied, the full pathname to "
  5697. "which each @var{name} corresponds is printed. If multiple @var{name} "
  5698. "arguments are supplied with @option{-t} the @var{name} is printed before the "
  5699. "hashed full pathname. The @option{-l} option causes output to be displayed "
  5700. "in a format that may be reused as input. If no arguments are given, or if "
  5701. "only @option{-l} is supplied, information about remembered commands is "
  5702. "printed. The return status is zero unless a @var{name} is not found or an "
  5703. "invalid option is supplied."
  5704. msgstr ""
  5705. #. type: btindex
  5706. #: ./bashref.texi:3537 ./bashref.texi:3538
  5707. #, no-wrap
  5708. msgid "pwd"
  5709. msgstr ""
  5710. #. type: example
  5711. #: ./bashref.texi:3541
  5712. #, no-wrap
  5713. msgid "pwd [-LP]\n"
  5714. msgstr ""
  5715. #. type: table
  5716. #: ./bashref.texi:3551
  5717. msgid ""
  5718. "Print the absolute pathname of the current working directory. If the "
  5719. "@option{-P} option is supplied, the pathname printed will not contain "
  5720. "symbolic links. If the @option{-L} option is supplied, the pathname printed "
  5721. "may contain symbolic links. The return status is zero unless an error is "
  5722. "encountered while determining the name of the current directory or an "
  5723. "invalid option is supplied."
  5724. msgstr ""
  5725. #. type: btindex
  5726. #: ./bashref.texi:3552 ./bashref.texi:3553
  5727. #, no-wrap
  5728. msgid "readonly"
  5729. msgstr ""
  5730. #. type: example
  5731. #: ./bashref.texi:3556
  5732. #, no-wrap
  5733. msgid "readonly [-aAf] [-p] [@var{name}[=@var{value}]] @dots{}\n"
  5734. msgstr ""
  5735. #. type: table
  5736. #: ./bashref.texi:3577
  5737. msgid ""
  5738. "Mark each @var{name} as readonly. The values of these names may not be "
  5739. "changed by subsequent assignment. If the @option{-f} option is supplied, "
  5740. "each @var{name} refers to a shell function. The @option{-a} option means "
  5741. "each @var{name} refers to an indexed array variable; the @option{-A} option "
  5742. "means each @var{name} refers to an associative array variable. If both "
  5743. "options are supplied, @option{-A} takes precedence. If no @var{name} "
  5744. "arguments are given, or if the @option{-p} option is supplied, a list of all "
  5745. "readonly names is printed. The other options may be used to restrict the "
  5746. "output to a subset of the set of readonly names. The @option{-p} option "
  5747. "causes output to be displayed in a format that may be reused as input. If a "
  5748. "variable name is followed by =@var{value}, the value of the variable is set "
  5749. "to @var{value}. The return status is zero unless an invalid option is "
  5750. "supplied, one of the @var{name} arguments is not a valid shell variable or "
  5751. "function name, or the @option{-f} option is supplied with a name that is not "
  5752. "a shell function."
  5753. msgstr ""
  5754. #. type: btindex
  5755. #: ./bashref.texi:3578 ./bashref.texi:3579
  5756. #, no-wrap
  5757. msgid "return"
  5758. msgstr ""
  5759. #. type: example
  5760. #: ./bashref.texi:3582
  5761. #, no-wrap
  5762. msgid "return [@var{n}]\n"
  5763. msgstr ""
  5764. #. type: table
  5765. #: ./bashref.texi:3605
  5766. msgid ""
  5767. "Cause a shell function to stop executing and return the value @var{n} to its "
  5768. "caller. If @var{n} is not supplied, the return value is the exit status of "
  5769. "the last command executed in the function. If @code{return} is executed by "
  5770. "a trap handler, the last command used to determine the status is the last "
  5771. "command executed before the trap handler. if @code{return} is executed "
  5772. "during a @code{DEBUG} trap, the last command used to determine the status is "
  5773. "the last command executed by the trap handler before @code{return} was "
  5774. "invoked. @code{return} may also be used to terminate execution of a script "
  5775. "being executed with the @code{.} (@code{source}) builtin, returning either "
  5776. "@var{n} or the exit status of the last command executed within the script as "
  5777. "the exit status of the script. If @var{n} is supplied, the return value is "
  5778. "its least significant 8 bits. Any command associated with the @code{RETURN} "
  5779. "trap is executed before execution resumes after the function or script. The "
  5780. "return status is non-zero if @code{return} is supplied a non-numeric "
  5781. "argument or is used outside a function and not during the execution of a "
  5782. "script by @code{.} or @code{source}."
  5783. msgstr ""
  5784. #. type: btindex
  5785. #: ./bashref.texi:3606 ./bashref.texi:3607
  5786. #, no-wrap
  5787. msgid "shift"
  5788. msgstr ""
  5789. #. type: example
  5790. #: ./bashref.texi:3610
  5791. #, no-wrap
  5792. msgid "shift [@var{n}]\n"
  5793. msgstr ""
  5794. #. type: table
  5795. #: ./bashref.texi:3623
  5796. msgid ""
  5797. "Shift the positional parameters to the left by @var{n}. The positional "
  5798. "parameters from @var{n}+1 @dots{} @code{$#} are renamed to @code{$1} @dots{} "
  5799. "@code{$#}-@var{n}. Parameters represented by the numbers @code{$#} to "
  5800. "@code{$#}-@var{n}+1 are unset. @var{n} must be a non-negative number less "
  5801. "than or equal to @code{$#}. If @var{n} is zero or greater than @code{$#}, "
  5802. "the positional parameters are not changed. If @var{n} is not supplied, it "
  5803. "is assumed to be 1. The return status is zero unless @var{n} is greater "
  5804. "than @code{$#} or less than zero, non-zero otherwise."
  5805. msgstr ""
  5806. #. type: btindex
  5807. #: ./bashref.texi:3624 ./bashref.texi:3626
  5808. #, no-wrap
  5809. msgid "test"
  5810. msgstr ""
  5811. #. type: btindex
  5812. #: ./bashref.texi:3625 ./bashref.texi:3627
  5813. #, no-wrap
  5814. msgid "["
  5815. msgstr ""
  5816. #. type: example
  5817. #: ./bashref.texi:3630
  5818. #, no-wrap
  5819. msgid "test @var{expr}\n"
  5820. msgstr ""
  5821. #. type: table
  5822. #: ./bashref.texi:3639
  5823. msgid ""
  5824. "Evaluate a conditional expression @var{expr} and return a status of 0 (true) "
  5825. "or 1 (false). Each operator and operand must be a separate argument. "
  5826. "Expressions are composed of the primaries described below in @ref{Bash "
  5827. "Conditional Expressions}. @code{test} does not accept any options, nor does "
  5828. "it accept and ignore an argument of @option{--} as signifying the end of "
  5829. "options."
  5830. msgstr ""
  5831. #. type: table
  5832. #: ./bashref.texi:3642
  5833. msgid ""
  5834. "When the @code{[} form is used, the last argument to the command must be a "
  5835. "@code{]}."
  5836. msgstr ""
  5837. #. type: table
  5838. #: ./bashref.texi:3647
  5839. msgid ""
  5840. "Expressions may be combined using the following operators, listed in "
  5841. "decreasing order of precedence. The evaluation depends on the number of "
  5842. "arguments; see below. Operator precedence is used when there are five or "
  5843. "more arguments."
  5844. msgstr ""
  5845. #. type: item
  5846. #: ./bashref.texi:3649
  5847. #, no-wrap
  5848. msgid "! @var{expr}"
  5849. msgstr ""
  5850. #. type: table
  5851. #: ./bashref.texi:3651
  5852. msgid "True if @var{expr} is false."
  5853. msgstr ""
  5854. #. type: item
  5855. #: ./bashref.texi:3652
  5856. #, no-wrap
  5857. msgid "( @var{expr} )"
  5858. msgstr ""
  5859. #. type: table
  5860. #: ./bashref.texi:3655
  5861. msgid ""
  5862. "Returns the value of @var{expr}. This may be used to override the normal "
  5863. "precedence of operators."
  5864. msgstr ""
  5865. #. type: item
  5866. #: ./bashref.texi:3656
  5867. #, no-wrap
  5868. msgid "@var{expr1} -a @var{expr2}"
  5869. msgstr ""
  5870. #. type: table
  5871. #: ./bashref.texi:3658
  5872. msgid "True if both @var{expr1} and @var{expr2} are true."
  5873. msgstr ""
  5874. #. type: item
  5875. #: ./bashref.texi:3659
  5876. #, no-wrap
  5877. msgid "@var{expr1} -o @var{expr2}"
  5878. msgstr ""
  5879. #. type: table
  5880. #: ./bashref.texi:3661
  5881. msgid "True if either @var{expr1} or @var{expr2} is true."
  5882. msgstr ""
  5883. #. type: table
  5884. #: ./bashref.texi:3665
  5885. msgid ""
  5886. "The @code{test} and @code{[} builtins evaluate conditional expressions using "
  5887. "a set of rules based on the number of arguments."
  5888. msgstr ""
  5889. #. type: item
  5890. #: ./bashref.texi:3667
  5891. #, no-wrap
  5892. msgid "0 arguments"
  5893. msgstr ""
  5894. #. type: table
  5895. #: ./bashref.texi:3669
  5896. msgid "The expression is false."
  5897. msgstr ""
  5898. #. type: item
  5899. #: ./bashref.texi:3670
  5900. #, no-wrap
  5901. msgid "1 argument"
  5902. msgstr ""
  5903. #. type: table
  5904. #: ./bashref.texi:3672
  5905. msgid "The expression is true if and only if the argument is not null."
  5906. msgstr ""
  5907. #. type: item
  5908. #: ./bashref.texi:3673
  5909. #, no-wrap
  5910. msgid "2 arguments"
  5911. msgstr ""
  5912. #. type: table
  5913. #: ./bashref.texi:3681
  5914. msgid ""
  5915. "If the first argument is @samp{!}, the expression is true if and only if the "
  5916. "second argument is null. If the first argument is one of the unary "
  5917. "conditional operators (@pxref{Bash Conditional Expressions}), the expression "
  5918. "is true if the unary test is true. If the first argument is not a valid "
  5919. "unary operator, the expression is false."
  5920. msgstr ""
  5921. #. type: item
  5922. #: ./bashref.texi:3682
  5923. #, no-wrap
  5924. msgid "3 arguments"
  5925. msgstr ""
  5926. #. type: table
  5927. #: ./bashref.texi:3696
  5928. msgid ""
  5929. "The following conditions are applied in the order listed. If the second "
  5930. "argument is one of the binary conditional operators (@pxref{Bash Conditional "
  5931. "Expressions}), the result of the expression is the result of the binary test "
  5932. "using the first and third arguments as operands. The @samp{-a} and "
  5933. "@samp{-o} operators are considered binary operators when there are three "
  5934. "arguments. If the first argument is @samp{!}, the value is the negation of "
  5935. "the two-argument test using the second and third arguments. If the first "
  5936. "argument is exactly @samp{(} and the third argument is exactly @samp{)}, the "
  5937. "result is the one-argument test of the second argument. Otherwise, the "
  5938. "expression is false."
  5939. msgstr ""
  5940. #. type: item
  5941. #: ./bashref.texi:3697
  5942. #, no-wrap
  5943. msgid "4 arguments"
  5944. msgstr ""
  5945. #. type: table
  5946. #: ./bashref.texi:3702
  5947. msgid ""
  5948. "If the first argument is @samp{!}, the result is the negation of the "
  5949. "three-argument expression composed of the remaining arguments. Otherwise, "
  5950. "the expression is parsed and evaluated according to precedence using the "
  5951. "rules listed above."
  5952. msgstr ""
  5953. #. type: item
  5954. #: ./bashref.texi:3703
  5955. #, no-wrap
  5956. msgid "5 or more arguments"
  5957. msgstr ""
  5958. #. type: table
  5959. #: ./bashref.texi:3706
  5960. msgid ""
  5961. "The expression is parsed and evaluated according to precedence using the "
  5962. "rules listed above."
  5963. msgstr ""
  5964. #. type: table
  5965. #: ./bashref.texi:3710
  5966. msgid ""
  5967. "When used with @code{test} or @samp{[}, the @samp{<} and @samp{>} operators "
  5968. "sort lexicographically using ASCII ordering."
  5969. msgstr ""
  5970. #. type: btindex
  5971. #: ./bashref.texi:3711 ./bashref.texi:3712
  5972. #, no-wrap
  5973. msgid "times"
  5974. msgstr ""
  5975. #. type: example
  5976. #: ./bashref.texi:3715
  5977. #, no-wrap
  5978. msgid "times\n"
  5979. msgstr ""
  5980. #. type: table
  5981. #: ./bashref.texi:3719
  5982. msgid ""
  5983. "Print out the user and system times used by the shell and its children. The "
  5984. "return status is zero."
  5985. msgstr ""
  5986. #. type: btindex
  5987. #: ./bashref.texi:3720 ./bashref.texi:3721
  5988. #, no-wrap
  5989. msgid "trap"
  5990. msgstr ""
  5991. #. type: example
  5992. #: ./bashref.texi:3724
  5993. #, no-wrap
  5994. msgid "trap [-lp] [@var{arg}] [@var{sigspec} @dots{}]\n"
  5995. msgstr ""
  5996. #. type: table
  5997. #: ./bashref.texi:3743
  5998. msgid ""
  5999. "The commands in @var{arg} are to be read and executed when the shell "
  6000. "receives signal @var{sigspec}. If @var{arg} is absent (and there is a "
  6001. "single @var{sigspec}) or equal to @samp{-}, each specified signal's "
  6002. "disposition is reset to the value it had when the shell was started. If "
  6003. "@var{arg} is the null string, then the signal specified by each "
  6004. "@var{sigspec} is ignored by the shell and commands it invokes. If @var{arg} "
  6005. "is not present and @option{-p} has been supplied, the shell displays the "
  6006. "trap commands associated with each @var{sigspec}. If no arguments are "
  6007. "supplied, or only @option{-p} is given, @code{trap} prints the list of "
  6008. "commands associated with each signal number in a form that may be reused as "
  6009. "shell input. The @option{-l} option causes the shell to print a list of "
  6010. "signal names and their corresponding numbers. Each @var{sigspec} is either "
  6011. "a signal name or a signal number. Signal names are case insensitive and the "
  6012. "@code{SIG} prefix is optional."
  6013. msgstr ""
  6014. #. type: table
  6015. #: ./bashref.texi:3756
  6016. msgid ""
  6017. "If a @var{sigspec} is @code{0} or @code{EXIT}, @var{arg} is executed when "
  6018. "the shell exits. If a @var{sigspec} is @code{DEBUG}, the command @var{arg} "
  6019. "is executed before every simple command, @code{for} command, @code{case} "
  6020. "command, @code{select} command, every arithmetic @code{for} command, and "
  6021. "before the first command executes in a shell function. Refer to the "
  6022. "description of the @code{extdebug} option to the @code{shopt} builtin "
  6023. "(@pxref{The Shopt Builtin}) for details of its effect on the @code{DEBUG} "
  6024. "trap. If a @var{sigspec} is @code{RETURN}, the command @var{arg} is "
  6025. "executed each time a shell function or a script executed with the @code{.} "
  6026. "or @code{source} builtins finishes executing."
  6027. msgstr ""
  6028. #. type: table
  6029. #: ./bashref.texi:3773
  6030. msgid ""
  6031. "If a @var{sigspec} is @code{ERR}, the command @var{arg} is executed whenever "
  6032. "a pipeline (which may consist of a single simple command), a list, or a "
  6033. "compound command returns a non-zero exit status, subject to the following "
  6034. "conditions. The @code{ERR} trap is not executed if the failed command is "
  6035. "part of the command list immediately following an @code{until} or "
  6036. "@code{while} keyword, part of the test following the @code{if} or "
  6037. "@code{elif} reserved words, part of a command executed in a @code{&&} or "
  6038. "@code{||} list except the command following the final @code{&&} or "
  6039. "@code{||}, any command in a pipeline but the last, or if the command's "
  6040. "return status is being inverted using @code{!}. These are the same "
  6041. "conditions obeyed by the @code{errexit} (@option{-e}) option."
  6042. msgstr ""
  6043. #. type: table
  6044. #: ./bashref.texi:3777
  6045. msgid ""
  6046. "Signals ignored upon entry to the shell cannot be trapped or reset. Trapped "
  6047. "signals that are not being ignored are reset to their original values in a "
  6048. "subshell or subshell environment when one is created."
  6049. msgstr ""
  6050. #. type: table
  6051. #: ./bashref.texi:3780
  6052. msgid ""
  6053. "The return status is zero unless a @var{sigspec} does not specify a valid "
  6054. "signal."
  6055. msgstr ""
  6056. #. type: btindex
  6057. #: ./bashref.texi:3781 ./bashref.texi:3782
  6058. #, no-wrap
  6059. msgid "umask"
  6060. msgstr ""
  6061. #. type: example
  6062. #: ./bashref.texi:3785
  6063. #, no-wrap
  6064. msgid "umask [-p] [-S] [@var{mode}]\n"
  6065. msgstr ""
  6066. #. type: table
  6067. #: ./bashref.texi:3798
  6068. msgid ""
  6069. "Set the shell process's file creation mask to @var{mode}. If @var{mode} "
  6070. "begins with a digit, it is interpreted as an octal number; if not, it is "
  6071. "interpreted as a symbolic mode mask similar to that accepted by the "
  6072. "@code{chmod} command. If @var{mode} is omitted, the current value of the "
  6073. "mask is printed. If the @option{-S} option is supplied without a @var{mode} "
  6074. "argument, the mask is printed in a symbolic format. If the @option{-p} "
  6075. "option is supplied, and @var{mode} is omitted, the output is in a form that "
  6076. "may be reused as input. The return status is zero if the mode is "
  6077. "successfully changed or if no @var{mode} argument is supplied, and non-zero "
  6078. "otherwise."
  6079. msgstr ""
  6080. #. type: table
  6081. #: ./bashref.texi:3802
  6082. msgid ""
  6083. "Note that when the mode is interpreted as an octal number, each number of "
  6084. "the umask is subtracted from @code{7}. Thus, a umask of @code{022} results "
  6085. "in permissions of @code{755}."
  6086. msgstr ""
  6087. #. type: btindex
  6088. #: ./bashref.texi:3803 ./bashref.texi:3804
  6089. #, no-wrap
  6090. msgid "unset"
  6091. msgstr ""
  6092. #. type: example
  6093. #: ./bashref.texi:3807
  6094. #, no-wrap
  6095. msgid "unset [-fnv] [@var{name}]\n"
  6096. msgstr ""
  6097. #. type: table
  6098. #: ./bashref.texi:3823
  6099. msgid ""
  6100. "Remove each variable or function @var{name}. If the @option{-v} option is "
  6101. "given, each @var{name} refers to a shell variable and that variable is "
  6102. "removed. If the @option{-f} option is given, the @var{name}s refer to shell "
  6103. "functions, and the function definition is removed. If the @option{-n} "
  6104. "option is supplied, and @var{name} is a variable with the @var{nameref} "
  6105. "attribute, @var{name} will be unset rather than the variable it references. "
  6106. "@option{-n} has no effect if the @option{-f} option is supplied. If no "
  6107. "options are supplied, each @var{name} refers to a variable; if there is no "
  6108. "variable by that name, any function with that name is unset. Readonly "
  6109. "variables and functions may not be unset. The return status is zero unless "
  6110. "a @var{name} is readonly."
  6111. msgstr ""
  6112. #. type: section
  6113. #: ./bashref.texi:3826
  6114. #, no-wrap
  6115. msgid "Bash Builtin Commands"
  6116. msgstr ""
  6117. #. type: Plain text
  6118. #: ./bashref.texi:3831
  6119. msgid ""
  6120. "This section describes builtin commands which are unique to or have been "
  6121. "extended in Bash. Some of these commands are specified in the @sc{posix} "
  6122. "standard."
  6123. msgstr ""
  6124. #. type: btindex
  6125. #: ./bashref.texi:3834 ./bashref.texi:3835
  6126. #, no-wrap
  6127. msgid "alias"
  6128. msgstr ""
  6129. #. type: example
  6130. #: ./bashref.texi:3838
  6131. #, no-wrap
  6132. msgid "alias [-p] [@var{name}[=@var{value}] @dots{}]\n"
  6133. msgstr ""
  6134. #. type: table
  6135. #: ./bashref.texi:3847
  6136. msgid ""
  6137. "Without arguments or with the @option{-p} option, @code{alias} prints the "
  6138. "list of aliases on the standard output in a form that allows them to be "
  6139. "reused as input. If arguments are supplied, an alias is defined for each "
  6140. "@var{name} whose @var{value} is given. If no @var{value} is given, the name "
  6141. "and value of the alias is printed. Aliases are described in @ref{Aliases}."
  6142. msgstr ""
  6143. #. type: btindex
  6144. #: ./bashref.texi:3848 ./bashref.texi:3849
  6145. #, no-wrap
  6146. msgid "bind"
  6147. msgstr ""
  6148. #. type: example
  6149. #: ./bashref.texi:3857
  6150. #, no-wrap
  6151. msgid ""
  6152. "bind [-m @var{keymap}] [-lpsvPSVX]\n"
  6153. "bind [-m @var{keymap}] [-q @var{function}] [-u @var{function}] [-r "
  6154. "@var{keyseq}]\n"
  6155. "bind [-m @var{keymap}] -f @var{filename}\n"
  6156. "bind [-m @var{keymap}] -x @var{keyseq:shell-command}\n"
  6157. "bind [-m @var{keymap}] @var{keyseq:function-name}\n"
  6158. "bind [-m @var{keymap}] @var{keyseq:readline-command}\n"
  6159. msgstr ""
  6160. #. type: table
  6161. #: ./bashref.texi:3867
  6162. msgid ""
  6163. "Display current Readline (@pxref{Command Line Editing}) key and function "
  6164. "bindings, bind a key sequence to a Readline function or macro, or set a "
  6165. "Readline variable. Each non-option argument is a command as it would appear "
  6166. "in a Readline initialization file (@pxref{Readline Init File}), but each "
  6167. "binding or command must be passed as a separate argument; e.g., "
  6168. "@samp{\"\\C-x\\C-r\":re-read-init-file}."
  6169. msgstr ""
  6170. #. type: table
  6171. #: ./bashref.texi:3869 ./bashref.texi:4212 ./bashref.texi:4397
  6172. msgid "Options, if supplied, have the following meanings:"
  6173. msgstr ""
  6174. #. type: item
  6175. #: ./bashref.texi:3871
  6176. #, no-wrap
  6177. msgid "-m @var{keymap}"
  6178. msgstr ""
  6179. #. type: table
  6180. #: ./bashref.texi:3885
  6181. msgid ""
  6182. "Use @var{keymap} as the keymap to be affected by the subsequent bindings. "
  6183. "Acceptable @var{keymap} names are @code{emacs}, @code{emacs-standard}, "
  6184. "@code{emacs-meta}, @code{emacs-ctlx}, @code{vi}, @code{vi-move}, "
  6185. "@code{vi-command}, and @code{vi-insert}. @code{vi} is equivalent to "
  6186. "@code{vi-command} (@code{vi-move} is also a synonym); @code{emacs} is "
  6187. "equivalent to @code{emacs-standard}."
  6188. msgstr ""
  6189. #. type: item
  6190. #: ./bashref.texi:3886 ./bashref.texi:4053 ./bashref.texi:4579 ./bashref.texi:6271 ./bashref.texi:7106 ./bashref.texi:7784
  6191. #, no-wrap
  6192. msgid "-l"
  6193. msgstr ""
  6194. #. type: table
  6195. #: ./bashref.texi:3888
  6196. msgid "List the names of all Readline functions."
  6197. msgstr ""
  6198. #. type: item
  6199. #: ./bashref.texi:3889 ./bashref.texi:4589 ./bashref.texi:4851 ./bashref.texi:7109 ./bashref.texi:7791
  6200. #, no-wrap
  6201. msgid "-p"
  6202. msgstr ""
  6203. #. type: table
  6204. #: ./bashref.texi:3892
  6205. msgid ""
  6206. "Display Readline function names and bindings in such a way that they can be "
  6207. "used as input or in a Readline initialization file."
  6208. msgstr ""
  6209. #. type: item
  6210. #: ./bashref.texi:3893 ./bashref.texi:4614 ./bashref.texi:4902
  6211. #, no-wrap
  6212. msgid "-P"
  6213. msgstr ""
  6214. #. type: table
  6215. #: ./bashref.texi:3895
  6216. msgid "List current Readline function names and bindings."
  6217. msgstr ""
  6218. #. type: item
  6219. #: ./bashref.texi:3896 ./bashref.texi:4607 ./bashref.texi:4874 ./bashref.texi:7112
  6220. #, no-wrap
  6221. msgid "-v"
  6222. msgstr ""
  6223. #. type: table
  6224. #: ./bashref.texi:3899
  6225. msgid ""
  6226. "Display Readline variable names and values in such a way that they can be "
  6227. "used as input or in a Readline initialization file."
  6228. msgstr ""
  6229. #. type: item
  6230. #: ./bashref.texi:3900
  6231. #, no-wrap
  6232. msgid "-V"
  6233. msgstr ""
  6234. #. type: table
  6235. #: ./bashref.texi:3902
  6236. msgid "List current Readline variable names and values."
  6237. msgstr ""
  6238. #. type: item
  6239. #: ./bashref.texi:3903 ./bashref.texi:4218 ./bashref.texi:4288 ./bashref.texi:4445 ./bashref.texi:4598 ./bashref.texi:4981 ./bashref.texi:6285 ./bashref.texi:7797
  6240. #, no-wrap
  6241. msgid "-s"
  6242. msgstr ""
  6243. #. type: table
  6244. #: ./bashref.texi:3907
  6245. msgid ""
  6246. "Display Readline key sequences bound to macros and the strings they output "
  6247. "in such a way that they can be used as input or in a Readline initialization "
  6248. "file."
  6249. msgstr ""
  6250. #. type: item
  6251. #: ./bashref.texi:3908 ./bashref.texi:4549
  6252. #, no-wrap
  6253. msgid "-S"
  6254. msgstr ""
  6255. #. type: table
  6256. #: ./bashref.texi:3910
  6257. msgid "Display Readline key sequences bound to macros and the strings they output."
  6258. msgstr ""
  6259. #. type: item
  6260. #: ./bashref.texi:3911
  6261. #, no-wrap
  6262. msgid "-f @var{filename}"
  6263. msgstr ""
  6264. #. type: table
  6265. #: ./bashref.texi:3913
  6266. msgid "Read key bindings from @var{filename}."
  6267. msgstr ""
  6268. #. type: item
  6269. #: ./bashref.texi:3914
  6270. #, no-wrap
  6271. msgid "-q @var{function}"
  6272. msgstr ""
  6273. #. type: table
  6274. #: ./bashref.texi:3916
  6275. msgid "Query about which keys invoke the named @var{function}."
  6276. msgstr ""
  6277. #. type: item
  6278. #: ./bashref.texi:3917
  6279. #, no-wrap
  6280. msgid "-u @var{function}"
  6281. msgstr ""
  6282. #. type: table
  6283. #: ./bashref.texi:3919
  6284. msgid "Unbind all keys bound to the named @var{function}."
  6285. msgstr ""
  6286. #. type: item
  6287. #: ./bashref.texi:3920
  6288. #, no-wrap
  6289. msgid "-r @var{keyseq}"
  6290. msgstr ""
  6291. #. type: table
  6292. #: ./bashref.texi:3922
  6293. msgid "Remove any current binding for @var{keyseq}."
  6294. msgstr ""
  6295. #. type: item
  6296. #: ./bashref.texi:3923
  6297. #, no-wrap
  6298. msgid "-x @var{keyseq:shell-command}"
  6299. msgstr ""
  6300. #. type: table
  6301. #: ./bashref.texi:3933
  6302. msgid ""
  6303. "Cause @var{shell-command} to be executed whenever @var{keyseq} is entered. "
  6304. "When @var{shell-command} is executed, the shell sets the "
  6305. "@code{READLINE_LINE} variable to the contents of the Readline line buffer "
  6306. "and the @code{READLINE_POINT} variable to the current location of the "
  6307. "insertion point. If the executed command changes the value of "
  6308. "@code{READLINE_LINE} or @code{READLINE_POINT}, those new values will be "
  6309. "reflected in the editing state."
  6310. msgstr ""
  6311. #. type: item
  6312. #: ./bashref.texi:3934
  6313. #, no-wrap
  6314. msgid "-X"
  6315. msgstr ""
  6316. #. type: table
  6317. #: ./bashref.texi:3937
  6318. msgid ""
  6319. "List all key sequences bound to shell commands and the associated commands "
  6320. "in a format that can be reused as input."
  6321. msgstr ""
  6322. #. type: table
  6323. #: ./bashref.texi:3942
  6324. msgid ""
  6325. "The return status is zero unless an invalid option is supplied or an error "
  6326. "occurs."
  6327. msgstr ""
  6328. #. type: example
  6329. #: ./bashref.texi:3947
  6330. #, no-wrap
  6331. msgid "builtin [@var{shell-builtin} [@var{args}]]\n"
  6332. msgstr ""
  6333. #. type: table
  6334. #: ./bashref.texi:3955
  6335. msgid ""
  6336. "Run a shell builtin, passing it @var{args}, and return its exit status. "
  6337. "This is useful when defining a shell function with the same name as a shell "
  6338. "builtin, retaining the functionality of the builtin within the function. "
  6339. "The return status is non-zero if @var{shell-builtin} is not a shell builtin "
  6340. "command."
  6341. msgstr ""
  6342. #. type: btindex
  6343. #: ./bashref.texi:3956 ./bashref.texi:3957
  6344. #, no-wrap
  6345. msgid "caller"
  6346. msgstr ""
  6347. #. type: example
  6348. #: ./bashref.texi:3960
  6349. #, no-wrap
  6350. msgid "caller [@var{expr}]\n"
  6351. msgstr ""
  6352. #. type: table
  6353. #: ./bashref.texi:3964
  6354. msgid ""
  6355. "Returns the context of any active subroutine call (a shell function or a "
  6356. "script executed with the @code{.} or @code{source} builtins)."
  6357. msgstr ""
  6358. #. type: table
  6359. #: ./bashref.texi:3972
  6360. msgid ""
  6361. "Without @var{expr}, @code{caller} displays the line number and source "
  6362. "filename of the current subroutine call. If a non-negative integer is "
  6363. "supplied as @var{expr}, @code{caller} displays the line number, subroutine "
  6364. "name, and source file corresponding to that position in the current "
  6365. "execution call stack. This extra information may be used, for example, to "
  6366. "print a stack trace. The current frame is frame 0."
  6367. msgstr ""
  6368. #. type: table
  6369. #: ./bashref.texi:3976
  6370. msgid ""
  6371. "The return value is 0 unless the shell is not executing a subroutine call or "
  6372. "@var{expr} does not correspond to a valid position in the call stack."
  6373. msgstr ""
  6374. #. type: btindex
  6375. #: ./bashref.texi:3977 ./bashref.texi:3978
  6376. #, no-wrap
  6377. msgid "command"
  6378. msgstr ""
  6379. #. type: example
  6380. #: ./bashref.texi:3981
  6381. #, no-wrap
  6382. msgid "command [-pVv] @var{command} [@var{arguments} @dots{}]\n"
  6383. msgstr ""
  6384. #. type: table
  6385. #: ./bashref.texi:3995
  6386. msgid ""
  6387. "Runs @var{command} with @var{arguments} ignoring any shell function named "
  6388. "@var{command}. Only shell builtin commands or commands found by searching "
  6389. "the @env{PATH} are executed. If there is a shell function named @code{ls}, "
  6390. "running @samp{command ls} within the function will execute the external "
  6391. "command @code{ls} instead of calling the function recursively. The "
  6392. "@option{-p} option means to use a default value for @env{PATH} that is "
  6393. "guaranteed to find all of the standard utilities. The return status in this "
  6394. "case is 127 if @var{command} cannot be found or an error occurred, and the "
  6395. "exit status of @var{command} otherwise."
  6396. msgstr ""
  6397. #. type: table
  6398. #: ./bashref.texi:4002
  6399. msgid ""
  6400. "If either the @option{-V} or @option{-v} option is supplied, a description "
  6401. "of @var{command} is printed. The @option{-v} option causes a single word "
  6402. "indicating the command or file name used to invoke @var{command} to be "
  6403. "displayed; the @option{-V} option produces a more verbose description. In "
  6404. "this case, the return status is zero if @var{command} is found, and non-zero "
  6405. "if not."
  6406. msgstr ""
  6407. #. type: btindex
  6408. #: ./bashref.texi:4003 ./bashref.texi:4004
  6409. #, no-wrap
  6410. msgid "declare"
  6411. msgstr ""
  6412. #. type: example
  6413. #: ./bashref.texi:4007
  6414. #, no-wrap
  6415. msgid "declare [-aAfFgilnrtux] [-p] [@var{name}[=@var{value}] @dots{}]\n"
  6416. msgstr ""
  6417. #. type: table
  6418. #: ./bashref.texi:4011
  6419. msgid ""
  6420. "Declare variables and give them attributes. If no @var{name}s are given, "
  6421. "then display the values of variables instead."
  6422. msgstr ""
  6423. #. type: table
  6424. #: ./bashref.texi:4016
  6425. msgid ""
  6426. "The @option{-p} option will display the attributes and values of each "
  6427. "@var{name}. When @option{-p} is used with @var{name} arguments, additional "
  6428. "options, other than @option{-f} and @option{-F}, are ignored."
  6429. msgstr ""
  6430. #. type: table
  6431. #: ./bashref.texi:4023
  6432. msgid ""
  6433. "When @option{-p} is supplied without @var{name} arguments, @code{declare} "
  6434. "will display the attributes and values of all variables having the "
  6435. "attributes specified by the additional options. If no other options are "
  6436. "supplied with @option{-p}, @code{declare} will display the attributes and "
  6437. "values of all shell variables. The @option{-f} option will restrict the "
  6438. "display to shell functions."
  6439. msgstr ""
  6440. #. type: table
  6441. #: ./bashref.texi:4030
  6442. msgid ""
  6443. "The @option{-F} option inhibits the display of function definitions; only "
  6444. "the function name and attributes are printed. If the @code{extdebug} shell "
  6445. "option is enabled using @code{shopt} (@pxref{The Shopt Builtin}), the source "
  6446. "file name and line number where each @var{name} is defined are displayed as "
  6447. "well. @option{-F} implies @option{-f}."
  6448. msgstr ""
  6449. #. type: table
  6450. #: ./bashref.texi:4034
  6451. msgid ""
  6452. "The @option{-g} option forces variables to be created or modified at the "
  6453. "global scope, even when @code{declare} is executed in a shell function. It "
  6454. "is ignored in all other cases."
  6455. msgstr ""
  6456. #. type: table
  6457. #: ./bashref.texi:4037
  6458. msgid ""
  6459. "The following options can be used to restrict output to variables with the "
  6460. "specified attributes or to give variables attributes:"
  6461. msgstr ""
  6462. #. type: item
  6463. #: ./bashref.texi:4039 ./bashref.texi:4555 ./bashref.texi:4692
  6464. #, no-wrap
  6465. msgid "-a"
  6466. msgstr ""
  6467. #. type: table
  6468. #: ./bashref.texi:4041
  6469. msgid "Each @var{name} is an indexed array variable (@pxref{Arrays})."
  6470. msgstr ""
  6471. #. type: item
  6472. #: ./bashref.texi:4042
  6473. #, no-wrap
  6474. msgid "-A"
  6475. msgstr ""
  6476. #. type: table
  6477. #: ./bashref.texi:4044
  6478. msgid "Each @var{name} is an associative array variable (@pxref{Arrays})."
  6479. msgstr ""
  6480. #. type: item
  6481. #: ./bashref.texi:4045 ./bashref.texi:4570 ./bashref.texi:4734
  6482. #, no-wrap
  6483. msgid "-f"
  6484. msgstr ""
  6485. #. type: table
  6486. #: ./bashref.texi:4047
  6487. msgid "Use function names only."
  6488. msgstr ""
  6489. #. type: item
  6490. #: ./bashref.texi:4048 ./bashref.texi:4573 ./bashref.texi:6267
  6491. #, no-wrap
  6492. msgid "-i"
  6493. msgstr ""
  6494. #. type: table
  6495. #: ./bashref.texi:4052
  6496. msgid ""
  6497. "The variable is to be treated as an integer; arithmetic evaluation "
  6498. "(@pxref{Shell Arithmetic}) is performed when the variable is assigned a "
  6499. "value."
  6500. msgstr ""
  6501. #. type: table
  6502. #: ./bashref.texi:4057
  6503. msgid ""
  6504. "When the variable is assigned a value, all upper-case characters are "
  6505. "converted to lower-case. The upper-case attribute is disabled."
  6506. msgstr ""
  6507. #. type: item
  6508. #: ./bashref.texi:4058 ./bashref.texi:4283 ./bashref.texi:4585 ./bashref.texi:4752 ./bashref.texi:7138 ./bashref.texi:7161 ./bashref.texi:7787
  6509. #, no-wrap
  6510. msgid "-n"
  6511. msgstr ""
  6512. #. type: table
  6513. #: ./bashref.texi:4067
  6514. msgid ""
  6515. "Give each @var{name} the @var{nameref} attribute, making it a name reference "
  6516. "to another variable. That other variable is defined by the value of "
  6517. "@var{name}. All references, assignments, and attribute modifications to "
  6518. "@var{name}, except for those using or changing the @option{-n} attribute "
  6519. "itself, are performed on the variable referenced by @var{name}'s value. The "
  6520. "nameref attribute cannot be applied to array variables."
  6521. msgstr ""
  6522. #. type: item
  6523. #: ./bashref.texi:4068 ./bashref.texi:4439 ./bashref.texi:4595 ./bashref.texi:6282 ./bashref.texi:7794
  6524. #, no-wrap
  6525. msgid "-r"
  6526. msgstr ""
  6527. #. type: table
  6528. #: ./bashref.texi:4071
  6529. msgid ""
  6530. "Make @var{name}s readonly. These names cannot then be assigned values by "
  6531. "subsequent assignment statements or unset."
  6532. msgstr ""
  6533. #. type: item
  6534. #: ./bashref.texi:4072 ./bashref.texi:4290 ./bashref.texi:4601 ./bashref.texi:4865
  6535. #, no-wrap
  6536. msgid "-t"
  6537. msgstr ""
  6538. #. type: table
  6539. #: ./bashref.texi:4077
  6540. msgid ""
  6541. "Give each @var{name} the @code{trace} attribute. Traced functions inherit "
  6542. "the @code{DEBUG} and @code{RETURN} traps from the calling shell. The trace "
  6543. "attribute has no special meaning for variables."
  6544. msgstr ""
  6545. #. type: item
  6546. #: ./bashref.texi:4078 ./bashref.texi:4292 ./bashref.texi:4604 ./bashref.texi:4868 ./bashref.texi:4984
  6547. #, no-wrap
  6548. msgid "-u"
  6549. msgstr ""
  6550. #. type: table
  6551. #: ./bashref.texi:4082
  6552. msgid ""
  6553. "When the variable is assigned a value, all lower-case characters are "
  6554. "converted to upper-case. The lower-case attribute is disabled."
  6555. msgstr ""
  6556. #. type: item
  6557. #: ./bashref.texi:4083 ./bashref.texi:4611 ./bashref.texi:4877
  6558. #, no-wrap
  6559. msgid "-x"
  6560. msgstr ""
  6561. #. type: table
  6562. #: ./bashref.texi:4086
  6563. msgid "Mark each @var{name} for export to subsequent commands via the environment."
  6564. msgstr ""
  6565. #. type: table
  6566. #: ./bashref.texi:4096
  6567. msgid ""
  6568. "Using @samp{+} instead of @samp{-} turns off the attribute instead, with the "
  6569. "exceptions that @samp{+a} may not be used to destroy an array variable and "
  6570. "@samp{+r} will not remove the readonly attribute. When used in a function, "
  6571. "@code{declare} makes each @var{name} local, as with the @code{local} "
  6572. "command, unless the @option{-g} option is used. If a variable name is "
  6573. "followed by =@var{value}, the value of the variable is set to @var{value}."
  6574. msgstr ""
  6575. #. type: table
  6576. #: ./bashref.texi:4100
  6577. msgid ""
  6578. "When using @option{-a} or @option{-A} and the compound assignment syntax to "
  6579. "create array variables, additional attributes do not take effect until "
  6580. "subsequent assignments."
  6581. msgstr ""
  6582. #. type: table
  6583. #: ./bashref.texi:4110
  6584. msgid ""
  6585. "The return status is zero unless an invalid option is encountered, an "
  6586. "attempt is made to define a function using @samp{-f foo=bar}, an attempt is "
  6587. "made to assign a value to a readonly variable, an attempt is made to assign "
  6588. "a value to an array variable without using the compound assignment syntax "
  6589. "(@pxref{Arrays}), one of the @var{names} is not a valid shell variable name, "
  6590. "an attempt is made to turn off readonly status for a readonly variable, an "
  6591. "attempt is made to turn off array status for an array variable, or an "
  6592. "attempt is made to display a non-existent function with @option{-f}."
  6593. msgstr ""
  6594. #. type: btindex
  6595. #: ./bashref.texi:4111 ./bashref.texi:4112
  6596. #, no-wrap
  6597. msgid "echo"
  6598. msgstr ""
  6599. #. type: example
  6600. #: ./bashref.texi:4115
  6601. #, no-wrap
  6602. msgid "echo [-neE] [@var{arg} @dots{}]\n"
  6603. msgstr ""
  6604. #. type: table
  6605. #: ./bashref.texi:4129
  6606. msgid ""
  6607. "Output the @var{arg}s, separated by spaces, terminated with a newline. The "
  6608. "return status is 0 unless a write error occurs. If @option{-n} is "
  6609. "specified, the trailing newline is suppressed. If the @option{-e} option is "
  6610. "given, interpretation of the following backslash-escaped characters is "
  6611. "enabled. The @option{-E} option disables the interpretation of these escape "
  6612. "characters, even on systems where they are interpreted by default. The "
  6613. "@code{xpg_echo} shell option may be used to dynamically determine whether or "
  6614. "not @code{echo} expands these escape characters by default. @code{echo} "
  6615. "does not interpret @option{--} to mean the end of options."
  6616. msgstr ""
  6617. #. type: table
  6618. #: ./bashref.texi:4131
  6619. msgid "@code{echo} interprets the following escape sequences:"
  6620. msgstr ""
  6621. #. type: item
  6622. #: ./bashref.texi:4136
  6623. #, no-wrap
  6624. msgid "\\c"
  6625. msgstr ""
  6626. #. type: table
  6627. #: ./bashref.texi:4138
  6628. msgid "suppress further output"
  6629. msgstr ""
  6630. #. type: table
  6631. #: ./bashref.texi:4141
  6632. msgid "escape"
  6633. msgstr ""
  6634. #. type: table
  6635. #: ./bashref.texi:4145
  6636. msgid "new line"
  6637. msgstr ""
  6638. #. type: item
  6639. #: ./bashref.texi:4153
  6640. #, no-wrap
  6641. msgid "\\0@var{nnn}"
  6642. msgstr ""
  6643. #. type: table
  6644. #: ./bashref.texi:4156
  6645. msgid ""
  6646. "the eight-bit character whose value is the octal value @var{nnn} (zero to "
  6647. "three octal digits)"
  6648. msgstr ""
  6649. #. type: btindex
  6650. #: ./bashref.texi:4167 ./bashref.texi:4168
  6651. #, no-wrap
  6652. msgid "enable"
  6653. msgstr ""
  6654. #. type: example
  6655. #: ./bashref.texi:4171
  6656. #, no-wrap
  6657. msgid "enable [-a] [-dnps] [-f @var{filename}] [@var{name} @dots{}]\n"
  6658. msgstr ""
  6659. #. type: table
  6660. #: ./bashref.texi:4181
  6661. msgid ""
  6662. "Enable and disable builtin shell commands. Disabling a builtin allows a "
  6663. "disk command which has the same name as a shell builtin to be executed "
  6664. "without specifying a full pathname, even though the shell normally searches "
  6665. "for builtins before disk commands. If @option{-n} is used, the @var{name}s "
  6666. "become disabled. Otherwise @var{name}s are enabled. For example, to use "
  6667. "the @code{test} binary found via @env{$PATH} instead of the shell builtin "
  6668. "version, type @samp{enable -n test}."
  6669. msgstr ""
  6670. #. type: table
  6671. #: ./bashref.texi:4187
  6672. msgid ""
  6673. "If the @option{-p} option is supplied, or no @var{name} arguments appear, a "
  6674. "list of shell builtins is printed. With no other arguments, the list "
  6675. "consists of all enabled shell builtins. The @option{-a} option means to "
  6676. "list each builtin with an indication of whether or not it is enabled."
  6677. msgstr ""
  6678. #. type: table
  6679. #: ./bashref.texi:4191
  6680. msgid ""
  6681. "The @option{-f} option means to load the new builtin command @var{name} from "
  6682. "shared object @var{filename}, on systems that support dynamic loading. The "
  6683. "@option{-d} option will delete a builtin loaded with @option{-f}."
  6684. msgstr ""
  6685. #. type: table
  6686. #: ./bashref.texi:4196
  6687. msgid ""
  6688. "If there are no options, a list of the shell builtins is displayed. The "
  6689. "@option{-s} option restricts @code{enable} to the @sc{posix} special "
  6690. "builtins. If @option{-s} is used with @option{-f}, the new builtin becomes "
  6691. "a special builtin (@pxref{Special Builtins})."
  6692. msgstr ""
  6693. #. type: table
  6694. #: ./bashref.texi:4199
  6695. msgid ""
  6696. "The return status is zero unless a @var{name} is not a shell builtin or "
  6697. "there is an error loading a new builtin from a shared object."
  6698. msgstr ""
  6699. #. type: btindex
  6700. #: ./bashref.texi:4200 ./bashref.texi:4201
  6701. #, no-wrap
  6702. msgid "help"
  6703. msgstr ""
  6704. #. type: example
  6705. #: ./bashref.texi:4204
  6706. #, no-wrap
  6707. msgid "help [-dms] [@var{pattern}]\n"
  6708. msgstr ""
  6709. #. type: table
  6710. #: ./bashref.texi:4210
  6711. msgid ""
  6712. "Display helpful information about builtin commands. If @var{pattern} is "
  6713. "specified, @code{help} gives detailed help on all commands matching "
  6714. "@var{pattern}, otherwise a list of the builtins is printed."
  6715. msgstr ""
  6716. #. type: item
  6717. #: ./bashref.texi:4214 ./bashref.texi:4280 ./bashref.texi:4564
  6718. #, no-wrap
  6719. msgid "-d"
  6720. msgstr ""
  6721. #. type: table
  6722. #: ./bashref.texi:4216
  6723. msgid "Display a short description of each @var{pattern}"
  6724. msgstr ""
  6725. #. type: item
  6726. #: ./bashref.texi:4216 ./bashref.texi:4582 ./bashref.texi:4746
  6727. #, no-wrap
  6728. msgid "-m"
  6729. msgstr ""
  6730. #. type: table
  6731. #: ./bashref.texi:4218
  6732. msgid "Display the description of each @var{pattern} in a manpage-like format"
  6733. msgstr ""
  6734. #. type: table
  6735. #: ./bashref.texi:4220
  6736. msgid "Display only a short usage synopsis for each @var{pattern}"
  6737. msgstr ""
  6738. #. type: table
  6739. #: ./bashref.texi:4223
  6740. msgid "The return status is zero unless no command matches @var{pattern}."
  6741. msgstr ""
  6742. #. type: btindex
  6743. #: ./bashref.texi:4224 ./bashref.texi:4225
  6744. #, no-wrap
  6745. msgid "let"
  6746. msgstr ""
  6747. #. type: example
  6748. #: ./bashref.texi:4228
  6749. #, no-wrap
  6750. msgid "let @var{expression} [@var{expression} @dots{}]\n"
  6751. msgstr ""
  6752. #. type: table
  6753. #: ./bashref.texi:4235
  6754. msgid ""
  6755. "The @code{let} builtin allows arithmetic to be performed on shell "
  6756. "variables. Each @var{expression} is evaluated according to the rules given "
  6757. "below in @ref{Shell Arithmetic}. If the last @var{expression} evaluates to "
  6758. "0, @code{let} returns 1; otherwise 0 is returned."
  6759. msgstr ""
  6760. #. type: btindex
  6761. #: ./bashref.texi:4236 ./bashref.texi:4237
  6762. #, no-wrap
  6763. msgid "local"
  6764. msgstr ""
  6765. #. type: example
  6766. #: ./bashref.texi:4240
  6767. #, no-wrap
  6768. msgid "local [@var{option}] @var{name}[=@var{value}] @dots{}\n"
  6769. msgstr ""
  6770. #. type: table
  6771. #: ./bashref.texi:4255
  6772. msgid ""
  6773. "For each argument, a local variable named @var{name} is created, and "
  6774. "assigned @var{value}. The @var{option} can be any of the options accepted "
  6775. "by @code{declare}. @code{local} can only be used within a function; it "
  6776. "makes the variable @var{name} have a visible scope restricted to that "
  6777. "function and its children. If @var{name} is @samp{-}, the set of shell "
  6778. "options is made local to the function in which @code{local} is invoked: "
  6779. "shell options changed using the @code{set} builtin inside the function are "
  6780. "restored to their original values when the function returns. The return "
  6781. "status is zero unless @code{local} is used outside a function, an invalid "
  6782. "@var{name} is supplied, or @var{name} is a readonly variable."
  6783. msgstr ""
  6784. #. type: btindex
  6785. #: ./bashref.texi:4256 ./bashref.texi:4257
  6786. #, no-wrap
  6787. msgid "logout"
  6788. msgstr ""
  6789. #. type: example
  6790. #: ./bashref.texi:4260
  6791. #, no-wrap
  6792. msgid "logout [@var{n}]\n"
  6793. msgstr ""
  6794. #. type: table
  6795. #: ./bashref.texi:4264
  6796. msgid "Exit a login shell, returning a status of @var{n} to the shell's parent."
  6797. msgstr ""
  6798. #. type: btindex
  6799. #: ./bashref.texi:4265 ./bashref.texi:4266
  6800. #, no-wrap
  6801. msgid "mapfile"
  6802. msgstr ""
  6803. #. type: example
  6804. #: ./bashref.texi:4270
  6805. #, no-wrap
  6806. msgid ""
  6807. "mapfile [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s @var{count}] "
  6808. "[-t] [-u @var{fd}]\n"
  6809. " [-C @var{callback}] [-c @var{quantum}] [@var{array}]\n"
  6810. msgstr ""
  6811. #. type: table
  6812. #: ./bashref.texi:4277
  6813. msgid ""
  6814. "Read lines from the standard input into the indexed array variable "
  6815. "@var{array}, or from file descriptor @var{fd} if the @option{-u} option is "
  6816. "supplied. The variable @code{MAPFILE} is the default @var{array}. Options, "
  6817. "if supplied, have the following meanings:"
  6818. msgstr ""
  6819. #. type: table
  6820. #: ./bashref.texi:4283
  6821. msgid ""
  6822. "The first character of @var{delim} is used to terminate each input line, "
  6823. "rather than newline."
  6824. msgstr ""
  6825. #. type: table
  6826. #: ./bashref.texi:4285
  6827. msgid "Copy at most @var{count} lines. If @var{count} is 0, all lines are copied."
  6828. msgstr ""
  6829. #. type: item
  6830. #: ./bashref.texi:4285
  6831. #, no-wrap
  6832. msgid "-O"
  6833. msgstr ""
  6834. #. type: table
  6835. #: ./bashref.texi:4288
  6836. msgid ""
  6837. "Begin assigning to @var{array} at index @var{origin}. The default index is "
  6838. "0."
  6839. msgstr ""
  6840. #. type: table
  6841. #: ./bashref.texi:4290
  6842. msgid "Discard the first @var{count} lines read."
  6843. msgstr ""
  6844. #. type: table
  6845. #: ./bashref.texi:4292
  6846. msgid "Remove a trailing @var{delim} (default newline) from each line read."
  6847. msgstr ""
  6848. #. type: table
  6849. #: ./bashref.texi:4294
  6850. msgid "Read lines from file descriptor @var{fd} instead of the standard input."
  6851. msgstr ""
  6852. #. type: item
  6853. #: ./bashref.texi:4294 ./bashref.texi:4889
  6854. #, no-wrap
  6855. msgid "-C"
  6856. msgstr ""
  6857. #. type: table
  6858. #: ./bashref.texi:4297
  6859. msgid ""
  6860. "Evaluate @var{callback} each time @var{quantum}P lines are read. The "
  6861. "@option{-c} option specifies @var{quantum}."
  6862. msgstr ""
  6863. #. type: item
  6864. #: ./bashref.texi:4297 ./bashref.texi:4561 ./bashref.texi:6258 ./bashref.texi:7104
  6865. #, no-wrap
  6866. msgid "-c"
  6867. msgstr ""
  6868. #. type: table
  6869. #: ./bashref.texi:4299
  6870. msgid "Specify the number of lines read between each call to @var{callback}."
  6871. msgstr ""
  6872. #. type: table
  6873. #: ./bashref.texi:4308
  6874. msgid ""
  6875. "If @option{-C} is specified without @option{-c}, the default quantum is "
  6876. "5000. When @var{callback} is evaluated, it is supplied the index of the "
  6877. "next array element to be assigned and the line to be assigned to that "
  6878. "element as additional arguments. @var{callback} is evaluated after the line "
  6879. "is read but before the array element is assigned."
  6880. msgstr ""
  6881. #. type: table
  6882. #: ./bashref.texi:4311
  6883. msgid ""
  6884. "If not supplied with an explicit origin, @code{mapfile} will clear "
  6885. "@var{array} before assigning to it."
  6886. msgstr ""
  6887. #. type: table
  6888. #: ./bashref.texi:4315
  6889. msgid ""
  6890. "@code{mapfile} returns successfully unless an invalid option or option "
  6891. "argument is supplied, @var{array} is invalid or unassignable, or @var{array} "
  6892. "is not an indexed array."
  6893. msgstr ""
  6894. #. type: btindex
  6895. #: ./bashref.texi:4316 ./bashref.texi:4317
  6896. #, no-wrap
  6897. msgid "printf"
  6898. msgstr ""
  6899. #. type: example
  6900. #: ./bashref.texi:4320
  6901. #, no-wrap
  6902. msgid "printf [-v @var{var}] @var{format} [@var{arguments}]\n"
  6903. msgstr ""
  6904. #. type: table
  6905. #: ./bashref.texi:4326
  6906. msgid ""
  6907. "Write the formatted @var{arguments} to the standard output under the control "
  6908. "of the @var{format}. The @option{-v} option causes the output to be "
  6909. "assigned to the variable @var{var} rather than being printed to the standard "
  6910. "output."
  6911. msgstr ""
  6912. #. type: table
  6913. #: ./bashref.texi:4334
  6914. msgid ""
  6915. "The @var{format} is a character string which contains three types of "
  6916. "objects: plain characters, which are simply copied to standard output, "
  6917. "character escape sequences, which are converted and copied to the standard "
  6918. "output, and format specifications, each of which causes printing of the next "
  6919. "successive @var{argument}. In addition to the standard @code{printf(1)} "
  6920. "formats, @code{printf} interprets the following extensions:"
  6921. msgstr ""
  6922. #. type: item
  6923. #: ./bashref.texi:4336
  6924. #, no-wrap
  6925. msgid "%b"
  6926. msgstr ""
  6927. #. type: table
  6928. #: ./bashref.texi:4340
  6929. msgid ""
  6930. "Causes @code{printf} to expand backslash escape sequences in the "
  6931. "corresponding @var{argument} in the same way as @code{echo -e} (@pxref{Bash "
  6932. "Builtins})."
  6933. msgstr ""
  6934. #. type: item
  6935. #: ./bashref.texi:4340
  6936. #, no-wrap
  6937. msgid "%q"
  6938. msgstr ""
  6939. #. type: table
  6940. #: ./bashref.texi:4343
  6941. msgid ""
  6942. "Causes @code{printf} to output the corresponding @var{argument} in a format "
  6943. "that can be reused as shell input."
  6944. msgstr ""
  6945. #. type: item
  6946. #: ./bashref.texi:4343
  6947. #, no-wrap
  6948. msgid "%(@var{datefmt})T"
  6949. msgstr ""
  6950. #. type: table
  6951. #: ./bashref.texi:4352
  6952. msgid ""
  6953. "Causes @code{printf} to output the date-time string resulting from using "
  6954. "@var{datefmt} as a format string for @code{strftime}(3). The corresponding "
  6955. "@var{argument} is an integer representing the number of seconds since the "
  6956. "epoch. Two special argument values may be used: -1 represents the current "
  6957. "time, and -2 represents the time the shell was invoked. If no argument is "
  6958. "specified, conversion behaves as if -1 had been given. This is an exception "
  6959. "to the usual @code{printf} behavior."
  6960. msgstr ""
  6961. #. type: table
  6962. #: ./bashref.texi:4359
  6963. msgid ""
  6964. "Arguments to non-string format specifiers are treated as C language "
  6965. "constants, except that a leading plus or minus sign is allowed, and if the "
  6966. "leading character is a single or double quote, the value is the ASCII value "
  6967. "of the following character."
  6968. msgstr ""
  6969. #. type: table
  6970. #: ./bashref.texi:4365
  6971. msgid ""
  6972. "The @var{format} is reused as necessary to consume all of the "
  6973. "@var{arguments}. If the @var{format} requires more @var{arguments} than are "
  6974. "supplied, the extra format specifications behave as if a zero value or null "
  6975. "string, as appropriate, had been supplied. The return value is zero on "
  6976. "success, non-zero on failure."
  6977. msgstr ""
  6978. #. type: btindex
  6979. #: ./bashref.texi:4366 ./bashref.texi:4367
  6980. #, no-wrap
  6981. msgid "read"
  6982. msgstr ""
  6983. #. type: example
  6984. #: ./bashref.texi:4371
  6985. #, no-wrap
  6986. msgid ""
  6987. "read [-ers] [-a @var{aname}] [-d @var{delim}] [-i @var{text}] [-n "
  6988. "@var{nchars}]\n"
  6989. " [-N @var{nchars}] [-p @var{prompt}] [-t @var{timeout}] [-u @var{fd}] "
  6990. "[@var{name} @dots{}]\n"
  6991. msgstr ""
  6992. #. type: table
  6993. #: ./bashref.texi:4395
  6994. msgid ""
  6995. "One line is read from the standard input, or from the file descriptor "
  6996. "@var{fd} supplied as an argument to the @option{-u} option, split into words "
  6997. "as described above in @ref{Word Splitting}, and the first word is assigned "
  6998. "to the first @var{name}, the second word to the second @var{name}, and so "
  6999. "on. If there are more words than names, the remaining words and their "
  7000. "intervening delimiters are assigned to the last @var{name}. If there are "
  7001. "fewer words read from the input stream than names, the remaining names are "
  7002. "assigned empty values. The characters in the value of the @env{IFS} "
  7003. "variable are used to split the line into words using the same rules the "
  7004. "shell uses for expansion (described above in @ref{Word Splitting}). The "
  7005. "backslash character @samp{\\} may be used to remove any special meaning for "
  7006. "the next character read and for line continuation. If no names are "
  7007. "supplied, the line read is assigned to the variable @env{REPLY}. The exit "
  7008. "status is zero, unless end-of-file is encountered, @code{read} times out (in "
  7009. "which case the status is greater than 128), a variable assignment error "
  7010. "(such as assigning to a readonly variable) occurs, or an invalid file "
  7011. "descriptor is supplied as the argument to @option{-u}."
  7012. msgstr ""
  7013. #. type: item
  7014. #: ./bashref.texi:4399
  7015. #, no-wrap
  7016. msgid "-a @var{aname}"
  7017. msgstr ""
  7018. #. type: table
  7019. #: ./bashref.texi:4404
  7020. msgid ""
  7021. "The words are assigned to sequential indices of the array variable "
  7022. "@var{aname}, starting at 0. All elements are removed from @var{aname} "
  7023. "before the assignment. Other @var{name} arguments are ignored."
  7024. msgstr ""
  7025. #. type: item
  7026. #: ./bashref.texi:4405
  7027. #, no-wrap
  7028. msgid "-d @var{delim}"
  7029. msgstr ""
  7030. #. type: table
  7031. #: ./bashref.texi:4408
  7032. msgid ""
  7033. "The first character of @var{delim} is used to terminate the input line, "
  7034. "rather than newline."
  7035. msgstr ""
  7036. #. type: item
  7037. #: ./bashref.texi:4409 ./bashref.texi:4567 ./bashref.texi:4701
  7038. #, no-wrap
  7039. msgid "-e"
  7040. msgstr ""
  7041. #. type: table
  7042. #: ./bashref.texi:4413
  7043. msgid ""
  7044. "Readline (@pxref{Command Line Editing}) is used to obtain the line. "
  7045. "Readline uses the current (or default, if line editing was not previously "
  7046. "active) editing settings."
  7047. msgstr ""
  7048. #. type: item
  7049. #: ./bashref.texi:4414
  7050. #, no-wrap
  7051. msgid "-i @var{text}"
  7052. msgstr ""
  7053. #. type: table
  7054. #: ./bashref.texi:4417
  7055. msgid ""
  7056. "If Readline is being used to read the line, @var{text} is placed into the "
  7057. "editing buffer before editing begins."
  7058. msgstr ""
  7059. #. type: item
  7060. #: ./bashref.texi:4418
  7061. #, no-wrap
  7062. msgid "-n @var{nchars}"
  7063. msgstr ""
  7064. #. type: table
  7065. #: ./bashref.texi:4422
  7066. msgid ""
  7067. "@code{read} returns after reading @var{nchars} characters rather than "
  7068. "waiting for a complete line of input, but honors a delimiter if fewer than "
  7069. "@var{nchars} characters are read before the delimiter."
  7070. msgstr ""
  7071. #. type: item
  7072. #: ./bashref.texi:4423
  7073. #, no-wrap
  7074. msgid "-N @var{nchars}"
  7075. msgstr ""
  7076. #. type: table
  7077. #: ./bashref.texi:4433
  7078. msgid ""
  7079. "@code{read} returns after reading exactly @var{nchars} characters rather "
  7080. "than waiting for a complete line of input, unless EOF is encountered or "
  7081. "@code{read} times out. Delimiter characters encountered in the input are "
  7082. "not treated specially and do not cause @code{read} to return until "
  7083. "@var{nchars} characters are read. The result is not split on the characters "
  7084. "in @code{IFS}; the intent is that the variable is assigned exactly the "
  7085. "characters read (with the exception of backslash; see the @option{-r} option "
  7086. "below)."
  7087. msgstr ""
  7088. #. type: item
  7089. #: ./bashref.texi:4434
  7090. #, no-wrap
  7091. msgid "-p @var{prompt}"
  7092. msgstr ""
  7093. #. type: table
  7094. #: ./bashref.texi:4438
  7095. msgid ""
  7096. "Display @var{prompt}, without a trailing newline, before attempting to read "
  7097. "any input. The prompt is displayed only if input is coming from a terminal."
  7098. msgstr ""
  7099. #. type: table
  7100. #: ./bashref.texi:4444
  7101. msgid ""
  7102. "If this option is given, backslash does not act as an escape character. The "
  7103. "backslash is considered to be part of the line. In particular, a "
  7104. "backslash-newline pair may not be used as a line continuation."
  7105. msgstr ""
  7106. #. type: table
  7107. #: ./bashref.texi:4448
  7108. msgid "Silent mode. If input is coming from a terminal, characters are not echoed."
  7109. msgstr ""
  7110. #. type: item
  7111. #: ./bashref.texi:4449
  7112. #, no-wrap
  7113. msgid "-t @var{timeout}"
  7114. msgstr ""
  7115. #. type: table
  7116. #: ./bashref.texi:4464
  7117. msgid ""
  7118. "Cause @code{read} to time out and return failure if a complete line of input "
  7119. "(or a specified number of characters) is not read within @var{timeout} "
  7120. "seconds. @var{timeout} may be a decimal number with a fractional portion "
  7121. "following the decimal point. This option is only effective if @code{read} "
  7122. "is reading input from a terminal, pipe, or other special file; it has no "
  7123. "effect when reading from regular files. If @code{read} times out, "
  7124. "@code{read} saves any partial input read into the specified variable "
  7125. "@var{name}. If @var{timeout} is 0, @code{read} returns immediately, without "
  7126. "trying to read and data. The exit status is 0 if input is available on the "
  7127. "specified file descriptor, non-zero otherwise. The exit status is greater "
  7128. "than 128 if the timeout is exceeded."
  7129. msgstr ""
  7130. #. type: item
  7131. #: ./bashref.texi:4465
  7132. #, no-wrap
  7133. msgid "-u @var{fd}"
  7134. msgstr ""
  7135. #. type: table
  7136. #: ./bashref.texi:4467
  7137. msgid "Read input from file descriptor @var{fd}."
  7138. msgstr ""
  7139. #. type: btindex
  7140. #: ./bashref.texi:4469 ./bashref.texi:4470
  7141. #, no-wrap
  7142. msgid "readarray"
  7143. msgstr ""
  7144. #. type: example
  7145. #: ./bashref.texi:4474
  7146. #, no-wrap
  7147. msgid ""
  7148. "readarray [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s "
  7149. "@var{count}] [-t] [-u @var{fd}]\n"
  7150. " [-C @var{callback}] [-c @var{quantum}] [@var{array}]\n"
  7151. msgstr ""
  7152. #. type: table
  7153. #: ./bashref.texi:4479
  7154. msgid ""
  7155. "Read lines from the standard input into the indexed array variable "
  7156. "@var{array}, or from file descriptor @var{fd} if the @option{-u} option is "
  7157. "supplied."
  7158. msgstr ""
  7159. #. type: table
  7160. #: ./bashref.texi:4481
  7161. msgid "A synonym for @code{mapfile}."
  7162. msgstr ""
  7163. #. type: btindex
  7164. #: ./bashref.texi:4482 ./bashref.texi:4483
  7165. #, no-wrap
  7166. msgid "source"
  7167. msgstr ""
  7168. #. type: example
  7169. #: ./bashref.texi:4486
  7170. #, no-wrap
  7171. msgid "source @var{filename}\n"
  7172. msgstr ""
  7173. #. type: table
  7174. #: ./bashref.texi:4489
  7175. msgid "A synonym for @code{.} (@pxref{Bourne Shell Builtins})."
  7176. msgstr ""
  7177. #. type: btindex
  7178. #: ./bashref.texi:4490 ./bashref.texi:4491
  7179. #, no-wrap
  7180. msgid "type"
  7181. msgstr ""
  7182. #. type: example
  7183. #: ./bashref.texi:4494
  7184. #, no-wrap
  7185. msgid "type [-afptP] [@var{name} @dots{}]\n"
  7186. msgstr ""
  7187. #. type: table
  7188. #: ./bashref.texi:4498
  7189. msgid ""
  7190. "For each @var{name}, indicate how it would be interpreted if used as a "
  7191. "command name."
  7192. msgstr ""
  7193. #. type: table
  7194. #: ./bashref.texi:4506
  7195. msgid ""
  7196. "If the @option{-t} option is used, @code{type} prints a single word which is "
  7197. "one of @samp{alias}, @samp{function}, @samp{builtin}, @samp{file} or "
  7198. "@samp{keyword}, if @var{name} is an alias, shell function, shell builtin, "
  7199. "disk file, or shell reserved word, respectively. If the @var{name} is not "
  7200. "found, then nothing is printed, and @code{type} returns a failure status."
  7201. msgstr ""
  7202. #. type: table
  7203. #: ./bashref.texi:4510
  7204. msgid ""
  7205. "If the @option{-p} option is used, @code{type} either returns the name of "
  7206. "the disk file that would be executed, or nothing if @option{-t} would not "
  7207. "return @samp{file}."
  7208. msgstr ""
  7209. #. type: table
  7210. #: ./bashref.texi:4513
  7211. msgid ""
  7212. "The @option{-P} option forces a path search for each @var{name}, even if "
  7213. "@option{-t} would not return @samp{file}."
  7214. msgstr ""
  7215. #. type: table
  7216. #: ./bashref.texi:4516
  7217. msgid ""
  7218. "If a command is hashed, @option{-p} and @option{-P} print the hashed value, "
  7219. "which is not necessarily the file that appears first in @code{$PATH}."
  7220. msgstr ""
  7221. #. type: table
  7222. #: ./bashref.texi:4521
  7223. msgid ""
  7224. "If the @option{-a} option is used, @code{type} returns all of the places "
  7225. "that contain an executable named @var{file}. This includes aliases and "
  7226. "functions, if and only if the @option{-p} option is not also used."
  7227. msgstr ""
  7228. #. type: table
  7229. #: ./bashref.texi:4524
  7230. msgid ""
  7231. "If the @option{-f} option is used, @code{type} does not attempt to find "
  7232. "shell functions, as with the @code{command} builtin."
  7233. msgstr ""
  7234. #. type: table
  7235. #: ./bashref.texi:4527
  7236. msgid ""
  7237. "The return status is zero if all of the @var{names} are found, non-zero if "
  7238. "any are not found."
  7239. msgstr ""
  7240. #. type: btindex
  7241. #: ./bashref.texi:4528 ./bashref.texi:4529
  7242. #, no-wrap
  7243. msgid "typeset"
  7244. msgstr ""
  7245. #. type: example
  7246. #: ./bashref.texi:4532
  7247. #, no-wrap
  7248. msgid "typeset [-afFgrxilnrtux] [-p] [@var{name}[=@var{value}] @dots{}]\n"
  7249. msgstr ""
  7250. #. type: table
  7251. #: ./bashref.texi:4537
  7252. msgid ""
  7253. "The @code{typeset} command is supplied for compatibility with the Korn "
  7254. "shell. It is a synonym for the @code{declare} builtin command."
  7255. msgstr ""
  7256. #. type: btindex
  7257. #: ./bashref.texi:4538 ./bashref.texi:4539
  7258. #, no-wrap
  7259. msgid "ulimit"
  7260. msgstr ""
  7261. #. type: example
  7262. #: ./bashref.texi:4542
  7263. #, no-wrap
  7264. msgid "ulimit [-HSabcdefiklmnpqrstuvxPT] [@var{limit}]\n"
  7265. msgstr ""
  7266. #. type: table
  7267. #: ./bashref.texi:4547
  7268. msgid ""
  7269. "@code{ulimit} provides control over the resources available to processes "
  7270. "started by the shell, on systems that allow such control. If an option is "
  7271. "given, it is interpreted as follows:"
  7272. msgstr ""
  7273. #. type: table
  7274. #: ./bashref.texi:4551
  7275. msgid "Change and report the soft limit associated with a resource."
  7276. msgstr ""
  7277. #. type: item
  7278. #: ./bashref.texi:4552 ./bashref.texi:4898
  7279. #, no-wrap
  7280. msgid "-H"
  7281. msgstr ""
  7282. #. type: table
  7283. #: ./bashref.texi:4554
  7284. msgid "Change and report the hard limit associated with a resource."
  7285. msgstr ""
  7286. #. type: table
  7287. #: ./bashref.texi:4557
  7288. msgid "All current limits are reported."
  7289. msgstr ""
  7290. #. type: item
  7291. #: ./bashref.texi:4558 ./bashref.texi:4697
  7292. #, no-wrap
  7293. msgid "-b"
  7294. msgstr ""
  7295. #. type: table
  7296. #: ./bashref.texi:4560
  7297. msgid "The maximum socket buffer size."
  7298. msgstr ""
  7299. #. type: table
  7300. #: ./bashref.texi:4563
  7301. msgid "The maximum size of core files created."
  7302. msgstr ""
  7303. #. type: table
  7304. #: ./bashref.texi:4566
  7305. msgid "The maximum size of a process's data segment."
  7306. msgstr ""
  7307. #. type: table
  7308. #: ./bashref.texi:4569
  7309. msgid "The maximum scheduling priority (\"nice\")."
  7310. msgstr ""
  7311. #. type: table
  7312. #: ./bashref.texi:4572
  7313. msgid "The maximum size of files written by the shell and its children."
  7314. msgstr ""
  7315. #. type: table
  7316. #: ./bashref.texi:4575
  7317. msgid "The maximum number of pending signals."
  7318. msgstr ""
  7319. #. type: item
  7320. #: ./bashref.texi:4576 ./bashref.texi:4741
  7321. #, no-wrap
  7322. msgid "-k"
  7323. msgstr ""
  7324. #. type: table
  7325. #: ./bashref.texi:4578
  7326. msgid "The maximum number of kqueues that may be allocated."
  7327. msgstr ""
  7328. #. type: table
  7329. #: ./bashref.texi:4581
  7330. msgid "The maximum size that may be locked into memory."
  7331. msgstr ""
  7332. #. type: table
  7333. #: ./bashref.texi:4584
  7334. msgid "The maximum resident set size (many systems do not honor this limit)."
  7335. msgstr ""
  7336. #. type: table
  7337. #: ./bashref.texi:4588
  7338. msgid ""
  7339. "The maximum number of open file descriptors (most systems do not allow this "
  7340. "value to be set)."
  7341. msgstr ""
  7342. #. type: table
  7343. #: ./bashref.texi:4591
  7344. msgid "The pipe buffer size."
  7345. msgstr ""
  7346. #. type: itemx
  7347. #: ./bashref.texi:4592 ./bashref.texi:4987 ./bashref.texi:8145
  7348. #, no-wrap
  7349. msgid "-q"
  7350. msgstr ""
  7351. #. type: table
  7352. #: ./bashref.texi:4594
  7353. msgid "The maximum number of bytes in POSIX message queues."
  7354. msgstr ""
  7355. #. type: table
  7356. #: ./bashref.texi:4597
  7357. msgid "The maximum real-time scheduling priority."
  7358. msgstr ""
  7359. #. type: table
  7360. #: ./bashref.texi:4600
  7361. msgid "The maximum stack size."
  7362. msgstr ""
  7363. #. type: table
  7364. #: ./bashref.texi:4603
  7365. msgid "The maximum amount of cpu time in seconds."
  7366. msgstr ""
  7367. #. type: table
  7368. #: ./bashref.texi:4606
  7369. msgid "The maximum number of processes available to a single user."
  7370. msgstr ""
  7371. #. type: table
  7372. #: ./bashref.texi:4610
  7373. msgid ""
  7374. "The maximum amount of virtual memory available to the shell, and, on some "
  7375. "systems, to its children."
  7376. msgstr ""
  7377. #. type: table
  7378. #: ./bashref.texi:4613
  7379. msgid "The maximum number of file locks."
  7380. msgstr ""
  7381. #. type: table
  7382. #: ./bashref.texi:4616
  7383. msgid "The maximum number of pseudoterminals."
  7384. msgstr ""
  7385. #. type: item
  7386. #: ./bashref.texi:4617 ./bashref.texi:4927
  7387. #, no-wrap
  7388. msgid "-T"
  7389. msgstr ""
  7390. #. type: table
  7391. #: ./bashref.texi:4619
  7392. msgid "The maximum number of threads."
  7393. msgstr ""
  7394. #. type: table
  7395. #: ./bashref.texi:4642
  7396. msgid ""
  7397. "If @var{limit} is given, and the @option{-a} option is not used, @var{limit} "
  7398. "is the new value of the specified resource. The special @var{limit} values "
  7399. "@code{hard}, @code{soft}, and @code{unlimited} stand for the current hard "
  7400. "limit, the current soft limit, and no limit, respectively. A hard limit "
  7401. "cannot be increased by a non-root user once it is set; a soft limit may be "
  7402. "increased up to the value of the hard limit. Otherwise, the current value "
  7403. "of the soft limit for the specified resource is printed, unless the "
  7404. "@option{-H} option is supplied. When setting new limits, if neither "
  7405. "@option{-H} nor @option{-S} is supplied, both the hard and soft limits are "
  7406. "set. If no option is given, then @option{-f} is assumed. Values are in "
  7407. "1024-byte increments, except for @option{-t}, which is in seconds; "
  7408. "@option{-p}, which is in units of 512-byte blocks; @option{-P}, @option{-T}, "
  7409. "@option{-b}, @option{-k}, @option{-n} and @option{-u}, which are unscaled "
  7410. "values; and, when in @sc{posix} Mode (@pxref{Bash POSIX Mode}), @option{-c} "
  7411. "and @option{-f}, which are in 512-byte increments."
  7412. msgstr ""
  7413. #. type: table
  7414. #: ./bashref.texi:4645
  7415. msgid ""
  7416. "The return status is zero unless an invalid option or argument is supplied, "
  7417. "or an error occurs while setting a new limit."
  7418. msgstr ""
  7419. #. type: btindex
  7420. #: ./bashref.texi:4646 ./bashref.texi:4647
  7421. #, no-wrap
  7422. msgid "unalias"
  7423. msgstr ""
  7424. #. type: example
  7425. #: ./bashref.texi:4650
  7426. #, no-wrap
  7427. msgid "unalias [-a] [@var{name} @dots{} ]\n"
  7428. msgstr ""
  7429. #. type: table
  7430. #: ./bashref.texi:4655
  7431. msgid ""
  7432. "Remove each @var{name} from the list of aliases. If @option{-a} is "
  7433. "supplied, all aliases are removed. Aliases are described in @ref{Aliases}."
  7434. msgstr ""
  7435. #. type: subsection
  7436. #: ./bashref.texi:4664 ./bashref.texi:4666 ./bashref.texi:4667
  7437. #, no-wrap
  7438. msgid "The Set Builtin"
  7439. msgstr ""
  7440. #. type: menuentry
  7441. #: ./bashref.texi:4664
  7442. msgid "Change the values of shell attributes and positional parameters."
  7443. msgstr ""
  7444. #. type: subsection
  7445. #: ./bashref.texi:4664 ./bashref.texi:4957 ./bashref.texi:4958
  7446. #, no-wrap
  7447. msgid "The Shopt Builtin"
  7448. msgstr ""
  7449. #. type: menuentry
  7450. #: ./bashref.texi:4664
  7451. msgid "Modify shell optional behavior."
  7452. msgstr ""
  7453. #. type: Plain text
  7454. #: ./bashref.texi:4672
  7455. msgid ""
  7456. "This builtin is so complicated that it deserves its own section. @code{set} "
  7457. "allows you to change the values of shell options and set the positional "
  7458. "parameters, or to display the names and values of shell variables."
  7459. msgstr ""
  7460. #. type: btindex
  7461. #: ./bashref.texi:4674 ./bashref.texi:4675
  7462. #, no-wrap
  7463. msgid "set"
  7464. msgstr ""
  7465. #. type: example
  7466. #: ./bashref.texi:4679
  7467. #, no-wrap
  7468. msgid ""
  7469. "set [--abefhkmnptuvxBCEHPT] [-o @var{option-name}] [@var{argument} "
  7470. "@dots{}]\n"
  7471. "set [+abefhkmnptuvxBCEHPT] [+o @var{option-name}] [@var{argument} @dots{}]\n"
  7472. msgstr ""
  7473. #. type: table
  7474. #: ./bashref.texi:4687
  7475. msgid ""
  7476. "If no options or arguments are supplied, @code{set} displays the names and "
  7477. "values of all shell variables and functions, sorted according to the current "
  7478. "locale, in a format that may be reused as input for setting or resetting the "
  7479. "currently-set variables. Read-only variables cannot be reset. In "
  7480. "@sc{posix} mode, only shell variables are listed."
  7481. msgstr ""
  7482. #. type: table
  7483. #: ./bashref.texi:4690
  7484. msgid ""
  7485. "When options are supplied, they set or unset shell attributes. Options, if "
  7486. "specified, have the following meanings:"
  7487. msgstr ""
  7488. #. type: table
  7489. #: ./bashref.texi:4696
  7490. msgid ""
  7491. "Each variable or function that is created or modified is given the export "
  7492. "attribute and marked for export to the environment of subsequent commands."
  7493. msgstr ""
  7494. #. type: table
  7495. #: ./bashref.texi:4700
  7496. msgid ""
  7497. "Cause the status of terminated background jobs to be reported immediately, "
  7498. "rather than before printing the next primary prompt."
  7499. msgstr ""
  7500. #. type: table
  7501. #: ./bashref.texi:4719
  7502. msgid ""
  7503. "Exit immediately if a pipeline (@pxref{Pipelines}), which may consist of a "
  7504. "single simple command (@pxref{Simple Commands}), a list (@pxref{Lists}), or "
  7505. "a compound command (@pxref{Compound Commands}) returns a non-zero status. "
  7506. "The shell does not exit if the command that fails is part of the command "
  7507. "list immediately following a @code{while} or @code{until} keyword, part of "
  7508. "the test in an @code{if} statement, part of any command executed in a "
  7509. "@code{&&} or @code{||} list except the command following the final @code{&&} "
  7510. "or @code{||}, any command in a pipeline but the last, or if the command's "
  7511. "return status is being inverted with @code{!}. If a compound command other "
  7512. "than a subshell returns a non-zero status because a command failed while "
  7513. "@option{-e} was being ignored, the shell does not exit. A trap on "
  7514. "@code{ERR}, if set, is executed before the shell exits."
  7515. msgstr ""
  7516. #. type: table
  7517. #: ./bashref.texi:4723
  7518. msgid ""
  7519. "This option applies to the shell environment and each subshell environment "
  7520. "separately (@pxref{Command Execution Environment}), and may cause subshells "
  7521. "to exit before executing all the commands in the subshell."
  7522. msgstr ""
  7523. #. type: table
  7524. #: ./bashref.texi:4733
  7525. msgid ""
  7526. "If a compound command or shell function executes in a context where "
  7527. "@option{-e} is being ignored, none of the commands executed within the "
  7528. "compound command or function body will be affected by the @option{-e} "
  7529. "setting, even if @option{-e} is set and a command returns a failure status. "
  7530. "If a compound command or shell function sets @option{-e} while executing in "
  7531. "a context where @option{-e} is ignored, that setting will not have any "
  7532. "effect until the compound command or the command containing the function "
  7533. "call completes."
  7534. msgstr ""
  7535. #. type: table
  7536. #: ./bashref.texi:4736
  7537. msgid "Disable filename expansion (globbing)."
  7538. msgstr ""
  7539. #. type: item
  7540. #: ./bashref.texi:4737
  7541. #, no-wrap
  7542. msgid "-h"
  7543. msgstr ""
  7544. #. type: table
  7545. #: ./bashref.texi:4740
  7546. msgid ""
  7547. "Locate and remember (hash) commands as they are looked up for execution. "
  7548. "This option is enabled by default."
  7549. msgstr ""
  7550. #. type: table
  7551. #: ./bashref.texi:4745
  7552. msgid ""
  7553. "All arguments in the form of assignment statements are placed in the "
  7554. "environment for a command, not just those that precede the command name."
  7555. msgstr ""
  7556. #. type: table
  7557. #: ./bashref.texi:4751
  7558. msgid ""
  7559. "Job control is enabled (@pxref{Job Control}). All processes run in a "
  7560. "separate process group. When a background job completes, the shell prints a "
  7561. "line containing its exit status."
  7562. msgstr ""
  7563. #. type: table
  7564. #: ./bashref.texi:4756
  7565. msgid ""
  7566. "Read commands but do not execute them. This may be used to check a script "
  7567. "for syntax errors. This option is ignored by interactive shells."
  7568. msgstr ""
  7569. #. type: item
  7570. #: ./bashref.texi:4757
  7571. #, no-wrap
  7572. msgid "-o @var{option-name}"
  7573. msgstr ""
  7574. #. type: table
  7575. #: ./bashref.texi:4760
  7576. msgid "Set the option corresponding to @var{option-name}:"
  7577. msgstr ""
  7578. #. type: item
  7579. #: ./bashref.texi:4762
  7580. #, no-wrap
  7581. msgid "allexport"
  7582. msgstr ""
  7583. #. type: table
  7584. #: ./bashref.texi:4764
  7585. msgid "Same as @code{-a}."
  7586. msgstr ""
  7587. #. type: item
  7588. #: ./bashref.texi:4765
  7589. #, no-wrap
  7590. msgid "braceexpand"
  7591. msgstr ""
  7592. #. type: table
  7593. #: ./bashref.texi:4767
  7594. msgid "Same as @code{-B}."
  7595. msgstr ""
  7596. #. type: item
  7597. #: ./bashref.texi:4768
  7598. #, no-wrap
  7599. msgid "emacs"
  7600. msgstr ""
  7601. #. type: table
  7602. #: ./bashref.texi:4771
  7603. msgid ""
  7604. "Use an @code{emacs}-style line editing interface (@pxref{Command Line "
  7605. "Editing}). This also affects the editing interface used for @code{read -e}."
  7606. msgstr ""
  7607. #. type: item
  7608. #: ./bashref.texi:4772
  7609. #, no-wrap
  7610. msgid "errexit"
  7611. msgstr ""
  7612. #. type: table
  7613. #: ./bashref.texi:4774
  7614. msgid "Same as @code{-e}."
  7615. msgstr ""
  7616. #. type: item
  7617. #: ./bashref.texi:4775
  7618. #, no-wrap
  7619. msgid "errtrace"
  7620. msgstr ""
  7621. #. type: table
  7622. #: ./bashref.texi:4777
  7623. msgid "Same as @code{-E}."
  7624. msgstr ""
  7625. #. type: item
  7626. #: ./bashref.texi:4778
  7627. #, no-wrap
  7628. msgid "functrace"
  7629. msgstr ""
  7630. #. type: table
  7631. #: ./bashref.texi:4780
  7632. msgid "Same as @code{-T}."
  7633. msgstr ""
  7634. #. type: item
  7635. #: ./bashref.texi:4781
  7636. #, no-wrap
  7637. msgid "hashall"
  7638. msgstr ""
  7639. #. type: table
  7640. #: ./bashref.texi:4783
  7641. msgid "Same as @code{-h}."
  7642. msgstr ""
  7643. #. type: item
  7644. #: ./bashref.texi:4784
  7645. #, no-wrap
  7646. msgid "histexpand"
  7647. msgstr ""
  7648. #. type: table
  7649. #: ./bashref.texi:4786
  7650. msgid "Same as @code{-H}."
  7651. msgstr ""
  7652. #. type: item
  7653. #: ./bashref.texi:4787
  7654. #, no-wrap
  7655. msgid "history"
  7656. msgstr ""
  7657. #. type: table
  7658. #: ./bashref.texi:4790
  7659. msgid ""
  7660. "Enable command history, as described in @ref{Bash History Facilities}. This "
  7661. "option is on by default in interactive shells."
  7662. msgstr ""
  7663. #. type: item
  7664. #: ./bashref.texi:4791
  7665. #, no-wrap
  7666. msgid "ignoreeof"
  7667. msgstr ""
  7668. #. type: table
  7669. #: ./bashref.texi:4793
  7670. msgid "An interactive shell will not exit upon reading EOF."
  7671. msgstr ""
  7672. #. type: item
  7673. #: ./bashref.texi:4794
  7674. #, no-wrap
  7675. msgid "keyword"
  7676. msgstr ""
  7677. #. type: table
  7678. #: ./bashref.texi:4796
  7679. msgid "Same as @code{-k}."
  7680. msgstr ""
  7681. #. type: item
  7682. #: ./bashref.texi:4797
  7683. #, no-wrap
  7684. msgid "monitor"
  7685. msgstr ""
  7686. #. type: table
  7687. #: ./bashref.texi:4799
  7688. msgid "Same as @code{-m}."
  7689. msgstr ""
  7690. #. type: item
  7691. #: ./bashref.texi:4800
  7692. #, no-wrap
  7693. msgid "noclobber"
  7694. msgstr ""
  7695. #. type: table
  7696. #: ./bashref.texi:4802
  7697. msgid "Same as @code{-C}."
  7698. msgstr ""
  7699. #. type: item
  7700. #: ./bashref.texi:4803
  7701. #, no-wrap
  7702. msgid "noexec"
  7703. msgstr ""
  7704. #. type: table
  7705. #: ./bashref.texi:4805
  7706. msgid "Same as @code{-n}."
  7707. msgstr ""
  7708. #. type: item
  7709. #: ./bashref.texi:4806
  7710. #, no-wrap
  7711. msgid "noglob"
  7712. msgstr ""
  7713. #. type: table
  7714. #: ./bashref.texi:4808
  7715. msgid "Same as @code{-f}."
  7716. msgstr ""
  7717. #. type: item
  7718. #: ./bashref.texi:4809
  7719. #, no-wrap
  7720. msgid "nolog"
  7721. msgstr ""
  7722. #. type: table
  7723. #: ./bashref.texi:4811
  7724. msgid "Currently ignored."
  7725. msgstr ""
  7726. #. type: item
  7727. #: ./bashref.texi:4812
  7728. #, no-wrap
  7729. msgid "notify"
  7730. msgstr ""
  7731. #. type: table
  7732. #: ./bashref.texi:4814
  7733. msgid "Same as @code{-b}."
  7734. msgstr ""
  7735. #. type: item
  7736. #: ./bashref.texi:4815
  7737. #, no-wrap
  7738. msgid "nounset"
  7739. msgstr ""
  7740. #. type: table
  7741. #: ./bashref.texi:4817
  7742. msgid "Same as @code{-u}."
  7743. msgstr ""
  7744. #. type: item
  7745. #: ./bashref.texi:4818
  7746. #, no-wrap
  7747. msgid "onecmd"
  7748. msgstr ""
  7749. #. type: table
  7750. #: ./bashref.texi:4820
  7751. msgid "Same as @code{-t}."
  7752. msgstr ""
  7753. #. type: item
  7754. #: ./bashref.texi:4821
  7755. #, no-wrap
  7756. msgid "physical"
  7757. msgstr ""
  7758. #. type: table
  7759. #: ./bashref.texi:4823
  7760. msgid "Same as @code{-P}."
  7761. msgstr ""
  7762. #. type: item
  7763. #: ./bashref.texi:4824
  7764. #, no-wrap
  7765. msgid "pipefail"
  7766. msgstr ""
  7767. #. type: table
  7768. #: ./bashref.texi:4829
  7769. msgid ""
  7770. "If set, the return value of a pipeline is the value of the last (rightmost) "
  7771. "command to exit with a non-zero status, or zero if all commands in the "
  7772. "pipeline exit successfully. This option is disabled by default."
  7773. msgstr ""
  7774. #. type: item
  7775. #: ./bashref.texi:4830
  7776. #, no-wrap
  7777. msgid "posix"
  7778. msgstr ""
  7779. #. type: table
  7780. #: ./bashref.texi:4836
  7781. msgid ""
  7782. "Change the behavior of Bash where the default operation differs from the "
  7783. "@sc{posix} standard to match the standard (@pxref{Bash POSIX Mode}). This "
  7784. "is intended to make Bash behave as a strict superset of that standard."
  7785. msgstr ""
  7786. #. type: item
  7787. #: ./bashref.texi:4837
  7788. #, no-wrap
  7789. msgid "privileged"
  7790. msgstr ""
  7791. #. type: table
  7792. #: ./bashref.texi:4839
  7793. msgid "Same as @code{-p}."
  7794. msgstr ""
  7795. #. type: item
  7796. #: ./bashref.texi:4840
  7797. #, no-wrap
  7798. msgid "verbose"
  7799. msgstr ""
  7800. #. type: table
  7801. #: ./bashref.texi:4842
  7802. msgid "Same as @code{-v}."
  7803. msgstr ""
  7804. #. type: item
  7805. #: ./bashref.texi:4843
  7806. #, no-wrap
  7807. msgid "vi"
  7808. msgstr ""
  7809. #. type: table
  7810. #: ./bashref.texi:4846
  7811. msgid ""
  7812. "Use a @code{vi}-style line editing interface. This also affects the editing "
  7813. "interface used for @code{read -e}."
  7814. msgstr ""
  7815. #. type: item
  7816. #: ./bashref.texi:4847
  7817. #, no-wrap
  7818. msgid "xtrace"
  7819. msgstr ""
  7820. #. type: table
  7821. #: ./bashref.texi:4849
  7822. msgid "Same as @code{-x}."
  7823. msgstr ""
  7824. #. type: table
  7825. #: ./bashref.texi:4864
  7826. msgid ""
  7827. "Turn on privileged mode. In this mode, the @env{$BASH_ENV} and @env{$ENV} "
  7828. "files are not processed, shell functions are not inherited from the "
  7829. "environment, and the @env{SHELLOPTS}, @env{BASHOPTS}, @env{CDPATH} and "
  7830. "@env{GLOBIGNORE} variables, if they appear in the environment, are ignored. "
  7831. "If the shell is started with the effective user (group) id not equal to the "
  7832. "real user (group) id, and the @option{-p} option is not supplied, these "
  7833. "actions are taken and the effective user id is set to the real user id. If "
  7834. "the @option{-p} option is supplied at startup, the effective user id is not "
  7835. "reset. Turning this option off causes the effective user and group ids to "
  7836. "be set to the real user and group ids."
  7837. msgstr ""
  7838. #. type: table
  7839. #: ./bashref.texi:4867
  7840. msgid "Exit after reading and executing one command."
  7841. msgstr ""
  7842. #. type: table
  7843. #: ./bashref.texi:4873
  7844. msgid ""
  7845. "Treat unset variables and parameters other than the special parameters "
  7846. "@samp{@@} or @samp{*} as an error when performing parameter expansion. An "
  7847. "error message will be written to the standard error, and a non-interactive "
  7848. "shell will exit."
  7849. msgstr ""
  7850. #. type: table
  7851. #: ./bashref.texi:4876
  7852. msgid "Print shell input lines as they are read."
  7853. msgstr ""
  7854. #. type: table
  7855. #: ./bashref.texi:4884
  7856. msgid ""
  7857. "Print a trace of simple commands, @code{for} commands, @code{case} commands, "
  7858. "@code{select} commands, and arithmetic @code{for} commands and their "
  7859. "arguments or associated word lists after they are expanded and before they "
  7860. "are executed. The value of the @env{PS4} variable is expanded and the "
  7861. "resultant value is printed before the command and its expanded arguments."
  7862. msgstr ""
  7863. #. type: item
  7864. #: ./bashref.texi:4885
  7865. #, no-wrap
  7866. msgid "-B"
  7867. msgstr ""
  7868. #. type: table
  7869. #: ./bashref.texi:4888
  7870. msgid ""
  7871. "The shell will perform brace expansion (@pxref{Brace Expansion}). This "
  7872. "option is on by default."
  7873. msgstr ""
  7874. #. type: table
  7875. #: ./bashref.texi:4892
  7876. msgid ""
  7877. "Prevent output redirection using @samp{>}, @samp{>&}, and @samp{<>} from "
  7878. "overwriting existing files."
  7879. msgstr ""
  7880. #. type: item
  7881. #: ./bashref.texi:4893
  7882. #, no-wrap
  7883. msgid "-E"
  7884. msgstr ""
  7885. #. type: table
  7886. #: ./bashref.texi:4897
  7887. msgid ""
  7888. "If set, any trap on @code{ERR} is inherited by shell functions, command "
  7889. "substitutions, and commands executed in a subshell environment. The "
  7890. "@code{ERR} trap is normally not inherited in such cases."
  7891. msgstr ""
  7892. #. type: table
  7893. #: ./bashref.texi:4901
  7894. msgid ""
  7895. "Enable @samp{!} style history substitution (@pxref{History Interaction}). "
  7896. "This option is on by default for interactive shells."
  7897. msgstr ""
  7898. #. type: table
  7899. #: ./bashref.texi:4908
  7900. msgid ""
  7901. "If set, do not resolve symbolic links when performing commands such as "
  7902. "@code{cd} which change the current directory. The physical directory is "
  7903. "used instead. By default, Bash follows the logical chain of directories "
  7904. "when performing commands which change the current directory."
  7905. msgstr ""
  7906. #. type: table
  7907. #: ./bashref.texi:4911
  7908. msgid ""
  7909. "For example, if @file{/usr/sys} is a symbolic link to @file{/usr/local/sys} "
  7910. "then:"
  7911. msgstr ""
  7912. #. type: example
  7913. #: ./bashref.texi:4916
  7914. #, no-wrap
  7915. msgid ""
  7916. "$ cd /usr/sys; echo $PWD\n"
  7917. "/usr/sys\n"
  7918. "$ cd ..; pwd\n"
  7919. "/usr\n"
  7920. msgstr ""
  7921. #. type: table
  7922. #: ./bashref.texi:4920
  7923. msgid "If @code{set -P} is on, then:"
  7924. msgstr ""
  7925. #. type: example
  7926. #: ./bashref.texi:4925
  7927. #, no-wrap
  7928. msgid ""
  7929. "$ cd /usr/sys; echo $PWD\n"
  7930. "/usr/local/sys\n"
  7931. "$ cd ..; pwd\n"
  7932. "/usr/local\n"
  7933. msgstr ""
  7934. #. type: table
  7935. #: ./bashref.texi:4933
  7936. msgid ""
  7937. "If set, any trap on @code{DEBUG} and @code{RETURN} are inherited by shell "
  7938. "functions, command substitutions, and commands executed in a subshell "
  7939. "environment. The @code{DEBUG} and @code{RETURN} traps are normally not "
  7940. "inherited in such cases."
  7941. msgstr ""
  7942. #. type: item
  7943. #: ./bashref.texi:4934 ./bashref.texi:6309
  7944. #, no-wrap
  7945. msgid "--"
  7946. msgstr ""
  7947. #. type: table
  7948. #: ./bashref.texi:4938
  7949. msgid ""
  7950. "If no arguments follow this option, then the positional parameters are "
  7951. "unset. Otherwise, the positional parameters are set to the @var{arguments}, "
  7952. "even if some of them begin with a @samp{-}."
  7953. msgstr ""
  7954. #. type: table
  7955. #: ./bashref.texi:4944
  7956. msgid ""
  7957. "Signal the end of options, cause all remaining @var{arguments} to be "
  7958. "assigned to the positional parameters. The @option{-x} and @option{-v} "
  7959. "options are turned off. If there are no arguments, the positional "
  7960. "parameters remain unchanged."
  7961. msgstr ""
  7962. #. type: table
  7963. #: ./bashref.texi:4949
  7964. msgid ""
  7965. "Using @samp{+} rather than @samp{-} causes these options to be turned off. "
  7966. "The options can also be used upon invocation of the shell. The current set "
  7967. "of options may be found in @code{$-}."
  7968. msgstr ""
  7969. #. type: table
  7970. #: ./bashref.texi:4953
  7971. msgid ""
  7972. "The remaining N @var{arguments} are positional parameters and are assigned, "
  7973. "in order, to @code{$1}, @code{$2}, @dots{} @code{$N}. The special parameter "
  7974. "@code{#} is set to N."
  7975. msgstr ""
  7976. #. type: table
  7977. #: ./bashref.texi:4955
  7978. msgid "The return status is always zero unless an invalid option is supplied."
  7979. msgstr ""
  7980. #. type: Plain text
  7981. #: ./bashref.texi:4961
  7982. msgid "This builtin allows you to change additional shell optional behavior."
  7983. msgstr ""
  7984. #. type: btindex
  7985. #: ./bashref.texi:4964 ./bashref.texi:4965
  7986. #, no-wrap
  7987. msgid "shopt"
  7988. msgstr ""
  7989. #. type: example
  7990. #: ./bashref.texi:4968
  7991. #, no-wrap
  7992. msgid "shopt [-pqsu] [-o] [@var{optname} @dots{}]\n"
  7993. msgstr ""
  7994. #. type: table
  7995. #: ./bashref.texi:4979
  7996. msgid ""
  7997. "Toggle the values of settings controlling optional shell behavior. The "
  7998. "settings can be either those listed below, or, if the @option{-o} option is "
  7999. "used, those available with the @option{-o} option to the @code{set} builtin "
  8000. "command (@pxref{The Set Builtin}). With no options, or with the @option{-p} "
  8001. "option, a list of all settable options is displayed, with an indication of "
  8002. "whether or not each is set. The @option{-p} option causes output to be "
  8003. "displayed in a form that may be reused as input. Other options have the "
  8004. "following meanings:"
  8005. msgstr ""
  8006. #. type: table
  8007. #: ./bashref.texi:4983
  8008. msgid "Enable (set) each @var{optname}."
  8009. msgstr ""
  8010. #. type: table
  8011. #: ./bashref.texi:4986
  8012. msgid "Disable (unset) each @var{optname}."
  8013. msgstr ""
  8014. #. type: table
  8015. #: ./bashref.texi:4993
  8016. msgid ""
  8017. "Suppresses normal output; the return status indicates whether the "
  8018. "@var{optname} is set or unset. If multiple @var{optname} arguments are "
  8019. "given with @option{-q}, the return status is zero if all @var{optnames} are "
  8020. "enabled; non-zero otherwise."
  8021. msgstr ""
  8022. #. type: item
  8023. #: ./bashref.texi:4994
  8024. #, no-wrap
  8025. msgid "-o"
  8026. msgstr ""
  8027. #. type: table
  8028. #: ./bashref.texi:4998
  8029. msgid ""
  8030. "Restricts the values of @var{optname} to be those defined for the "
  8031. "@option{-o} option to the @code{set} builtin (@pxref{The Set Builtin})."
  8032. msgstr ""
  8033. #. type: table
  8034. #: ./bashref.texi:5003
  8035. msgid ""
  8036. "If either @option{-s} or @option{-u} is used with no @var{optname} "
  8037. "arguments, @code{shopt} shows only those options which are set or unset, "
  8038. "respectively."
  8039. msgstr ""
  8040. #. type: table
  8041. #: ./bashref.texi:5006
  8042. msgid ""
  8043. "Unless otherwise noted, the @code{shopt} options are disabled (off) by "
  8044. "default."
  8045. msgstr ""
  8046. #. type: table
  8047. #: ./bashref.texi:5011 ./bashref.texi:5344
  8048. msgid ""
  8049. "The return status when listing options is zero if all @var{optnames} are "
  8050. "enabled, non-zero otherwise. When setting or unsetting options, the return "
  8051. "status is zero unless an @var{optname} is not a valid shell option."
  8052. msgstr ""
  8053. #. type: table
  8054. #: ./bashref.texi:5013
  8055. msgid "The list of @code{shopt} options is:"
  8056. msgstr ""
  8057. #. type: item
  8058. #: ./bashref.texi:5015
  8059. #, no-wrap
  8060. msgid "autocd"
  8061. msgstr ""
  8062. #. type: table
  8063. #: ./bashref.texi:5019
  8064. msgid ""
  8065. "If set, a command name that is the name of a directory is executed as if it "
  8066. "were the argument to the @code{cd} command. This option is only used by "
  8067. "interactive shells."
  8068. msgstr ""
  8069. #. type: item
  8070. #: ./bashref.texi:5020
  8071. #, no-wrap
  8072. msgid "cdable_vars"
  8073. msgstr ""
  8074. #. type: table
  8075. #: ./bashref.texi:5024
  8076. msgid ""
  8077. "If this is set, an argument to the @code{cd} builtin command that is not a "
  8078. "directory is assumed to be the name of a variable whose value is the "
  8079. "directory to change to."
  8080. msgstr ""
  8081. #. type: item
  8082. #: ./bashref.texi:5025
  8083. #, no-wrap
  8084. msgid "cdspell"
  8085. msgstr ""
  8086. #. type: table
  8087. #: ./bashref.texi:5033
  8088. msgid ""
  8089. "If set, minor errors in the spelling of a directory component in a @code{cd} "
  8090. "command will be corrected. The errors checked for are transposed "
  8091. "characters, a missing character, and a character too many. If a correction "
  8092. "is found, the corrected path is printed, and the command proceeds. This "
  8093. "option is only used by interactive shells."
  8094. msgstr ""
  8095. #. type: item
  8096. #: ./bashref.texi:5034
  8097. #, no-wrap
  8098. msgid "checkhash"
  8099. msgstr ""
  8100. #. type: table
  8101. #: ./bashref.texi:5038
  8102. msgid ""
  8103. "If this is set, Bash checks that a command found in the hash table exists "
  8104. "before trying to execute it. If a hashed command no longer exists, a normal "
  8105. "path search is performed."
  8106. msgstr ""
  8107. #. type: item
  8108. #: ./bashref.texi:5039
  8109. #, no-wrap
  8110. msgid "checkjobs"
  8111. msgstr ""
  8112. #. type: table
  8113. #: ./bashref.texi:5045
  8114. msgid ""
  8115. "If set, Bash lists the status of any stopped and running jobs before exiting "
  8116. "an interactive shell. If any jobs are running, this causes the exit to be "
  8117. "deferred until a second exit is attempted without an intervening command "
  8118. "(@pxref{Job Control}). The shell always postpones exiting if any jobs are "
  8119. "stopped."
  8120. msgstr ""
  8121. #. type: item
  8122. #: ./bashref.texi:5046
  8123. #, no-wrap
  8124. msgid "checkwinsize"
  8125. msgstr ""
  8126. #. type: table
  8127. #: ./bashref.texi:5050
  8128. msgid ""
  8129. "If set, Bash checks the window size after each command and, if necessary, "
  8130. "updates the values of @env{LINES} and @env{COLUMNS}."
  8131. msgstr ""
  8132. #. type: item
  8133. #: ./bashref.texi:5051
  8134. #, no-wrap
  8135. msgid "cmdhist"
  8136. msgstr ""
  8137. #. type: table
  8138. #: ./bashref.texi:5056
  8139. msgid ""
  8140. "If set, Bash attempts to save all lines of a multiple-line command in the "
  8141. "same history entry. This allows easy re-editing of multi-line commands."
  8142. msgstr ""
  8143. #. type: item
  8144. #: ./bashref.texi:5057
  8145. #, no-wrap
  8146. msgid "compat31"
  8147. msgstr ""
  8148. #. type: table
  8149. #: ./bashref.texi:5066
  8150. msgid ""
  8151. "If set, Bash changes its behavior to that of version 3.1 with respect to "
  8152. "quoted arguments to the conditional command's @samp{=~} operator and with "
  8153. "respect to locale-specific string comparison when using the @code{[[} "
  8154. "conditional command's @samp{<} and @samp{>} operators. Bash versions prior "
  8155. "to bash-4.1 use ASCII collation and strcmp(3); bash-4.1 and later use the "
  8156. "current locale's collation sequence and strcoll(3)."
  8157. msgstr ""
  8158. #. type: item
  8159. #: ./bashref.texi:5067
  8160. #, no-wrap
  8161. msgid "compat32"
  8162. msgstr ""
  8163. #. type: table
  8164. #: ./bashref.texi:5075
  8165. msgid ""
  8166. "If set, Bash changes its behavior to that of version 3.2 with respect to "
  8167. "locale-specific string comparison when using the @code{[[} conditional "
  8168. "command's @samp{<} and @samp{>} operators (see previous item) and the "
  8169. "effect of interrupting a command list. Bash versions 3.2 and earlier "
  8170. "continue with the next command in the list after one terminates due to an "
  8171. "interrupt."
  8172. msgstr ""
  8173. #. type: item
  8174. #: ./bashref.texi:5076
  8175. #, no-wrap
  8176. msgid "compat40"
  8177. msgstr ""
  8178. #. type: table
  8179. #: ./bashref.texi:5085
  8180. msgid ""
  8181. "If set, Bash changes its behavior to that of version 4.0 with respect to "
  8182. "locale-specific string comparison when using the @code{[[} conditional "
  8183. "command's @samp{<} and @samp{>} operators (see description of "
  8184. "@code{compat31}) and the effect of interrupting a command list. Bash "
  8185. "versions 4.0 and later interrupt the list as if the shell received the "
  8186. "interrupt; previous versions continue with the next command in the list."
  8187. msgstr ""
  8188. #. type: item
  8189. #: ./bashref.texi:5086
  8190. #, no-wrap
  8191. msgid "compat41"
  8192. msgstr ""
  8193. #. type: table
  8194. #: ./bashref.texi:5092
  8195. msgid ""
  8196. "If set, Bash, when in @sc{posix} mode, treats a single quote in a "
  8197. "double-quoted parameter expansion as a special character. The single quotes "
  8198. "must match (an even number) and the characters between the single quotes are "
  8199. "considered quoted. This is the behavior of @sc{posix} mode through version "
  8200. "4.1. The default Bash behavior remains as in previous versions."
  8201. msgstr ""
  8202. #. type: item
  8203. #: ./bashref.texi:5093
  8204. #, no-wrap
  8205. msgid "compat42"
  8206. msgstr ""
  8207. #. type: table
  8208. #: ./bashref.texi:5097
  8209. msgid ""
  8210. "If set, Bash does not process the replacement string in the pattern "
  8211. "substitution word expansion using quote removal."
  8212. msgstr ""
  8213. #. type: item
  8214. #: ./bashref.texi:5098
  8215. #, no-wrap
  8216. msgid "compat43"
  8217. msgstr ""
  8218. #. type: table
  8219. #: ./bashref.texi:5108
  8220. msgid ""
  8221. "If set, Bash does not print a warning message if an attempt is made to use a "
  8222. "quoted compound array assignment as an argument to @code{declare}, makes "
  8223. "word expansion errors non-fatal errors that cause the current command to "
  8224. "fail (the default behavior is to make them fatal errors that cause the shell "
  8225. "to exit), and does not reset the loop state when a shell function is "
  8226. "executed (this allows @code{break} or @code{continue} in a shell function to "
  8227. "affect loops in the caller's context)."
  8228. msgstr ""
  8229. #. type: item
  8230. #: ./bashref.texi:5109
  8231. #, no-wrap
  8232. msgid "complete_fullquote"
  8233. msgstr ""
  8234. #. type: table
  8235. #: ./bashref.texi:5125
  8236. msgid ""
  8237. "If set, Bash quotes all shell metacharacters in filenames and directory "
  8238. "names when performing completion. If not set, Bash removes metacharacters "
  8239. "such as the dollar sign from the set of characters that will be quoted in "
  8240. "completed filenames when these metacharacters appear in shell variable "
  8241. "references in words to be completed. This means that dollar signs in "
  8242. "variable names that expand to directories will not be quoted; however, any "
  8243. "dollar signs appearing in filenames will not be quoted, either. This is "
  8244. "active only when bash is using backslashes to quote completed filenames. "
  8245. "This variable is set by default, which is the default Bash behavior in "
  8246. "versions through 4.2."
  8247. msgstr ""
  8248. #. type: item
  8249. #: ./bashref.texi:5126
  8250. #, no-wrap
  8251. msgid "direxpand"
  8252. msgstr ""
  8253. #. type: table
  8254. #: ./bashref.texi:5132
  8255. msgid ""
  8256. "If set, Bash replaces directory names with the results of word expansion "
  8257. "when performing filename completion. This changes the contents of the "
  8258. "readline editing buffer. If not set, Bash attempts to preserve what the "
  8259. "user typed."
  8260. msgstr ""
  8261. #. type: item
  8262. #: ./bashref.texi:5133
  8263. #, no-wrap
  8264. msgid "dirspell"
  8265. msgstr ""
  8266. #. type: table
  8267. #: ./bashref.texi:5137
  8268. msgid ""
  8269. "If set, Bash attempts spelling correction on directory names during word "
  8270. "completion if the directory name initially supplied does not exist."
  8271. msgstr ""
  8272. #. type: item
  8273. #: ./bashref.texi:5138
  8274. #, no-wrap
  8275. msgid "dotglob"
  8276. msgstr ""
  8277. #. type: table
  8278. #: ./bashref.texi:5141
  8279. msgid ""
  8280. "If set, Bash includes filenames beginning with a `.' in the results of "
  8281. "filename expansion."
  8282. msgstr ""
  8283. #. type: item
  8284. #: ./bashref.texi:5142
  8285. #, no-wrap
  8286. msgid "execfail"
  8287. msgstr ""
  8288. #. type: table
  8289. #: ./bashref.texi:5147
  8290. msgid ""
  8291. "If this is set, a non-interactive shell will not exit if it cannot execute "
  8292. "the file specified as an argument to the @code{exec} builtin command. An "
  8293. "interactive shell does not exit if @code{exec} fails."
  8294. msgstr ""
  8295. #. type: item
  8296. #: ./bashref.texi:5148
  8297. #, no-wrap
  8298. msgid "expand_aliases"
  8299. msgstr ""
  8300. #. type: table
  8301. #: ./bashref.texi:5152
  8302. msgid ""
  8303. "If set, aliases are expanded as described below under Aliases, "
  8304. "@ref{Aliases}. This option is enabled by default for interactive shells."
  8305. msgstr ""
  8306. #. type: item
  8307. #: ./bashref.texi:5153
  8308. #, no-wrap
  8309. msgid "extdebug"
  8310. msgstr ""
  8311. #. type: table
  8312. #: ./bashref.texi:5157
  8313. msgid ""
  8314. "If set at shell invocation, arrange to execute the debugger profile before "
  8315. "the shell starts, identical to the @option{--debugger} option. If set after "
  8316. "invocation, behavior intended for use by debuggers is enabled:"
  8317. msgstr ""
  8318. #. type: enumerate
  8319. #: ./bashref.texi:5163
  8320. msgid ""
  8321. "The @option{-F} option to the @code{declare} builtin (@pxref{Bash Builtins}) "
  8322. "displays the source file name and line number corresponding to each function "
  8323. "name supplied as an argument."
  8324. msgstr ""
  8325. #. type: enumerate
  8326. #: ./bashref.texi:5167
  8327. msgid ""
  8328. "If the command run by the @code{DEBUG} trap returns a non-zero value, the "
  8329. "next command is skipped and not executed."
  8330. msgstr ""
  8331. #. type: enumerate
  8332. #: ./bashref.texi:5173
  8333. msgid ""
  8334. "If the command run by the @code{DEBUG} trap returns a value of 2, and the "
  8335. "shell is executing in a subroutine (a shell function or a shell script "
  8336. "executed by the @code{.} or @code{source} builtins), the shell simulates a "
  8337. "call to @code{return}."
  8338. msgstr ""
  8339. #. type: enumerate
  8340. #: ./bashref.texi:5177
  8341. msgid ""
  8342. "@code{BASH_ARGC} and @code{BASH_ARGV} are updated as described in their "
  8343. "descriptions (@pxref{Bash Variables})."
  8344. msgstr ""
  8345. #. type: enumerate
  8346. #: ./bashref.texi:5182
  8347. msgid ""
  8348. "Function tracing is enabled: command substitution, shell functions, and "
  8349. "subshells invoked with @code{( @var{command} )} inherit the @code{DEBUG} and "
  8350. "@code{RETURN} traps."
  8351. msgstr ""
  8352. #. type: enumerate
  8353. #: ./bashref.texi:5187
  8354. msgid ""
  8355. "Error tracing is enabled: command substitution, shell functions, and "
  8356. "subshells invoked with @code{( @var{command} )} inherit the @code{ERR} trap."
  8357. msgstr ""
  8358. #. type: item
  8359. #: ./bashref.texi:5189
  8360. #, no-wrap
  8361. msgid "extglob"
  8362. msgstr ""
  8363. #. type: table
  8364. #: ./bashref.texi:5192
  8365. msgid ""
  8366. "If set, the extended pattern matching features described above "
  8367. "(@pxref{Pattern Matching}) are enabled."
  8368. msgstr ""
  8369. #. type: item
  8370. #: ./bashref.texi:5193
  8371. #, no-wrap
  8372. msgid "extquote"
  8373. msgstr ""
  8374. #. type: table
  8375. #: ./bashref.texi:5197
  8376. msgid ""
  8377. "If set, @code{$'@var{string}'} and @code{$\"@var{string}\"} quoting is "
  8378. "performed within @code{$@{@var{parameter}@}} expansions enclosed in double "
  8379. "quotes. This option is enabled by default."
  8380. msgstr ""
  8381. #. type: item
  8382. #: ./bashref.texi:5198
  8383. #, no-wrap
  8384. msgid "failglob"
  8385. msgstr ""
  8386. #. type: table
  8387. #: ./bashref.texi:5201
  8388. msgid ""
  8389. "If set, patterns which fail to match filenames during filename expansion "
  8390. "result in an expansion error."
  8391. msgstr ""
  8392. #. type: item
  8393. #: ./bashref.texi:5202
  8394. #, no-wrap
  8395. msgid "force_fignore"
  8396. msgstr ""
  8397. #. type: table
  8398. #: ./bashref.texi:5208
  8399. msgid ""
  8400. "If set, the suffixes specified by the @env{FIGNORE} shell variable cause "
  8401. "words to be ignored when performing word completion even if the ignored "
  8402. "words are the only possible completions. @xref{Bash Variables}, for a "
  8403. "description of @env{FIGNORE}. This option is enabled by default."
  8404. msgstr ""
  8405. #. type: item
  8406. #: ./bashref.texi:5209
  8407. #, no-wrap
  8408. msgid "globasciiranges"
  8409. msgstr ""
  8410. #. type: table
  8411. #: ./bashref.texi:5217
  8412. msgid ""
  8413. "If set, range expressions used in pattern matching bracket expressions "
  8414. "(@pxref{Pattern Matching}) behave as if in the traditional C locale when "
  8415. "performing comparisons. That is, the current locale's collating sequence is "
  8416. "not taken into account, so @samp{b} will not collate between @samp{A} and "
  8417. "@samp{B}, and upper-case and lower-case ASCII characters will collate "
  8418. "together."
  8419. msgstr ""
  8420. #. type: item
  8421. #: ./bashref.texi:5218
  8422. #, no-wrap
  8423. msgid "globstar"
  8424. msgstr ""
  8425. #. type: table
  8426. #: ./bashref.texi:5223
  8427. msgid ""
  8428. "If set, the pattern @samp{**} used in a filename expansion context will "
  8429. "match all files and zero or more directories and subdirectories. If the "
  8430. "pattern is followed by a @samp{/}, only directories and subdirectories "
  8431. "match."
  8432. msgstr ""
  8433. #. type: item
  8434. #: ./bashref.texi:5224
  8435. #, no-wrap
  8436. msgid "gnu_errfmt"
  8437. msgstr ""
  8438. #. type: table
  8439. #: ./bashref.texi:5227
  8440. msgid ""
  8441. "If set, shell error messages are written in the standard @sc{gnu} error "
  8442. "message format."
  8443. msgstr ""
  8444. #. type: item
  8445. #: ./bashref.texi:5228
  8446. #, no-wrap
  8447. msgid "histappend"
  8448. msgstr ""
  8449. #. type: table
  8450. #: ./bashref.texi:5232
  8451. msgid ""
  8452. "If set, the history list is appended to the file named by the value of the "
  8453. "@env{HISTFILE} variable when the shell exits, rather than overwriting the "
  8454. "file."
  8455. msgstr ""
  8456. #. type: item
  8457. #: ./bashref.texi:5233
  8458. #, no-wrap
  8459. msgid "histreedit"
  8460. msgstr ""
  8461. #. type: table
  8462. #: ./bashref.texi:5237
  8463. msgid ""
  8464. "If set, and Readline is being used, a user is given the opportunity to "
  8465. "re-edit a failed history substitution."
  8466. msgstr ""
  8467. #. type: item
  8468. #: ./bashref.texi:5238
  8469. #, no-wrap
  8470. msgid "histverify"
  8471. msgstr ""
  8472. #. type: table
  8473. #: ./bashref.texi:5243
  8474. msgid ""
  8475. "If set, and Readline is being used, the results of history substitution are "
  8476. "not immediately passed to the shell parser. Instead, the resulting line is "
  8477. "loaded into the Readline editing buffer, allowing further modification."
  8478. msgstr ""
  8479. #. type: item
  8480. #: ./bashref.texi:5244
  8481. #, no-wrap
  8482. msgid "hostcomplete"
  8483. msgstr ""
  8484. #. type: table
  8485. #: ./bashref.texi:5249
  8486. msgid ""
  8487. "If set, and Readline is being used, Bash will attempt to perform hostname "
  8488. "completion when a word containing a @samp{@@} is being completed "
  8489. "(@pxref{Commands For Completion}). This option is enabled by default."
  8490. msgstr ""
  8491. #. type: item
  8492. #: ./bashref.texi:5250
  8493. #, no-wrap
  8494. msgid "huponexit"
  8495. msgstr ""
  8496. #. type: table
  8497. #: ./bashref.texi:5253
  8498. msgid ""
  8499. "If set, Bash will send @code{SIGHUP} to all jobs when an interactive login "
  8500. "shell exits (@pxref{Signals})."
  8501. msgstr ""
  8502. #. type: item
  8503. #: ./bashref.texi:5254
  8504. #, no-wrap
  8505. msgid "inherit_errexit"
  8506. msgstr ""
  8507. #. type: table
  8508. #: ./bashref.texi:5258
  8509. msgid ""
  8510. "If set, command substitution inherits the value of the @code{errexit} "
  8511. "option, instead of unsetting it in the subshell environment. This option is "
  8512. "enabled when @sc{posix} mode is enabled."
  8513. msgstr ""
  8514. #. type: item
  8515. #: ./bashref.texi:5259
  8516. #, no-wrap
  8517. msgid "interactive_comments"
  8518. msgstr ""
  8519. #. type: table
  8520. #: ./bashref.texi:5264
  8521. msgid ""
  8522. "Allow a word beginning with @samp{#} to cause that word and all remaining "
  8523. "characters on that line to be ignored in an interactive shell. This option "
  8524. "is enabled by default."
  8525. msgstr ""
  8526. #. type: item
  8527. #: ./bashref.texi:5265
  8528. #, no-wrap
  8529. msgid "lastpipe"
  8530. msgstr ""
  8531. #. type: table
  8532. #: ./bashref.texi:5268
  8533. msgid ""
  8534. "If set, and job control is not active, the shell runs the last command of a "
  8535. "pipeline not executed in the background in the current shell environment."
  8536. msgstr ""
  8537. #. type: item
  8538. #: ./bashref.texi:5269
  8539. #, no-wrap
  8540. msgid "lithist"
  8541. msgstr ""
  8542. #. type: table
  8543. #: ./bashref.texi:5273
  8544. msgid ""
  8545. "If enabled, and the @code{cmdhist} option is enabled, multi-line commands "
  8546. "are saved to the history with embedded newlines rather than using semicolon "
  8547. "separators where possible."
  8548. msgstr ""
  8549. #. type: item
  8550. #: ./bashref.texi:5274
  8551. #, no-wrap
  8552. msgid "login_shell"
  8553. msgstr ""
  8554. #. type: table
  8555. #: ./bashref.texi:5278
  8556. msgid ""
  8557. "The shell sets this option if it is started as a login shell "
  8558. "(@pxref{Invoking Bash}). The value may not be changed."
  8559. msgstr ""
  8560. #. type: item
  8561. #: ./bashref.texi:5279
  8562. #, no-wrap
  8563. msgid "mailwarn"
  8564. msgstr ""
  8565. #. type: table
  8566. #: ./bashref.texi:5283
  8567. msgid ""
  8568. "If set, and a file that Bash is checking for mail has been accessed since "
  8569. "the last time it was checked, the message @code{\"The mail in @var{mailfile} "
  8570. "has been read\"} is displayed."
  8571. msgstr ""
  8572. #. type: item
  8573. #: ./bashref.texi:5284
  8574. #, no-wrap
  8575. msgid "no_empty_cmd_completion"
  8576. msgstr ""
  8577. #. type: table
  8578. #: ./bashref.texi:5288
  8579. msgid ""
  8580. "If set, and Readline is being used, Bash will not attempt to search the "
  8581. "@env{PATH} for possible completions when completion is attempted on an empty "
  8582. "line."
  8583. msgstr ""
  8584. #. type: item
  8585. #: ./bashref.texi:5289
  8586. #, no-wrap
  8587. msgid "nocaseglob"
  8588. msgstr ""
  8589. #. type: table
  8590. #: ./bashref.texi:5292
  8591. msgid ""
  8592. "If set, Bash matches filenames in a case-insensitive fashion when performing "
  8593. "filename expansion."
  8594. msgstr ""
  8595. #. type: item
  8596. #: ./bashref.texi:5293
  8597. #, no-wrap
  8598. msgid "nocasematch"
  8599. msgstr ""
  8600. #. type: table
  8601. #: ./bashref.texi:5299
  8602. msgid ""
  8603. "If set, Bash matches patterns in a case-insensitive fashion when performing "
  8604. "matching while executing @code{case} or @code{[[} conditional commands, when "
  8605. "performing pattern substitution word expansions, or when filtering possible "
  8606. "completions as part of programmable completion."
  8607. msgstr ""
  8608. #. type: item
  8609. #: ./bashref.texi:5300
  8610. #, no-wrap
  8611. msgid "nullglob"
  8612. msgstr ""
  8613. #. type: table
  8614. #: ./bashref.texi:5303
  8615. msgid ""
  8616. "If set, Bash allows filename patterns which match no files to expand to a "
  8617. "null string, rather than themselves."
  8618. msgstr ""
  8619. #. type: item
  8620. #: ./bashref.texi:5304
  8621. #, no-wrap
  8622. msgid "progcomp"
  8623. msgstr ""
  8624. #. type: table
  8625. #: ./bashref.texi:5308
  8626. msgid ""
  8627. "If set, the programmable completion facilities (@pxref{Programmable "
  8628. "Completion}) are enabled. This option is enabled by default."
  8629. msgstr ""
  8630. #. type: item
  8631. #: ./bashref.texi:5309
  8632. #, no-wrap
  8633. msgid "promptvars"
  8634. msgstr ""
  8635. #. type: table
  8636. #: ./bashref.texi:5315
  8637. msgid ""
  8638. "If set, prompt strings undergo parameter expansion, command substitution, "
  8639. "arithmetic expansion, and quote removal after being expanded as described "
  8640. "below (@pxref{Controlling the Prompt}). This option is enabled by default."
  8641. msgstr ""
  8642. #. type: item
  8643. #: ./bashref.texi:5316
  8644. #, no-wrap
  8645. msgid "restricted_shell"
  8646. msgstr ""
  8647. #. type: table
  8648. #: ./bashref.texi:5322
  8649. msgid ""
  8650. "The shell sets this option if it is started in restricted mode (@pxref{The "
  8651. "Restricted Shell}). The value may not be changed. This is not reset when "
  8652. "the startup files are executed, allowing the startup files to discover "
  8653. "whether or not a shell is restricted."
  8654. msgstr ""
  8655. #. type: item
  8656. #: ./bashref.texi:5323
  8657. #, no-wrap
  8658. msgid "shift_verbose"
  8659. msgstr ""
  8660. #. type: table
  8661. #: ./bashref.texi:5327
  8662. msgid ""
  8663. "If this is set, the @code{shift} builtin prints an error message when the "
  8664. "shift count exceeds the number of positional parameters."
  8665. msgstr ""
  8666. #. type: item
  8667. #: ./bashref.texi:5328
  8668. #, no-wrap
  8669. msgid "sourcepath"
  8670. msgstr ""
  8671. #. type: table
  8672. #: ./bashref.texi:5332
  8673. msgid ""
  8674. "If set, the @code{source} builtin uses the value of @env{PATH} to find the "
  8675. "directory containing the file supplied as an argument. This option is "
  8676. "enabled by default."
  8677. msgstr ""
  8678. #. type: item
  8679. #: ./bashref.texi:5333
  8680. #, no-wrap
  8681. msgid "xpg_echo"
  8682. msgstr ""
  8683. #. type: table
  8684. #: ./bashref.texi:5336
  8685. msgid ""
  8686. "If set, the @code{echo} builtin expands backslash-escape sequences by "
  8687. "default."
  8688. msgstr ""
  8689. #. type: Plain text
  8690. #: ./bashref.texi:5354
  8691. msgid ""
  8692. "For historical reasons, the @sc{posix} standard has classified several "
  8693. "builtin commands as @emph{special}. When Bash is executing in @sc{posix} "
  8694. "mode, the special builtins differ from other builtin commands in three "
  8695. "respects:"
  8696. msgstr ""
  8697. #. type: enumerate
  8698. #: ./bashref.texi:5358
  8699. msgid "Special builtins are found before shell functions during command lookup."
  8700. msgstr ""
  8701. #. type: enumerate
  8702. #: ./bashref.texi:5361
  8703. msgid "If a special builtin returns an error status, a non-interactive shell exits."
  8704. msgstr ""
  8705. #. type: enumerate
  8706. #: ./bashref.texi:5365
  8707. msgid ""
  8708. "Assignment statements preceding the command stay in effect in the shell "
  8709. "environment after the command completes."
  8710. msgstr ""
  8711. #. type: Plain text
  8712. #: ./bashref.texi:5370
  8713. msgid ""
  8714. "When Bash is not executing in @sc{posix} mode, these builtins behave no "
  8715. "differently than the rest of the Bash builtin commands. The Bash @sc{posix} "
  8716. "mode is described in @ref{Bash POSIX Mode}."
  8717. msgstr ""
  8718. #. type: Plain text
  8719. #: ./bashref.texi:5372
  8720. msgid "These are the @sc{posix} special builtins:"
  8721. msgstr ""
  8722. #. type: example
  8723. #: ./bashref.texi:5375
  8724. #, no-wrap
  8725. msgid ""
  8726. "@w{break : . continue eval exec exit export readonly return set}\n"
  8727. "@w{shift trap unset}\n"
  8728. msgstr ""
  8729. #. type: section
  8730. #: ./bashref.texi:5384 ./bashref.texi:5389 ./bashref.texi:5390
  8731. #, no-wrap
  8732. msgid "Bourne Shell Variables"
  8733. msgstr ""
  8734. #. type: menuentry
  8735. #: ./bashref.texi:5384
  8736. msgid "Variables which Bash uses in the same way as the Bourne Shell."
  8737. msgstr ""
  8738. #. type: section
  8739. #: ./bashref.texi:5384 ./bashref.texi:5450 ./bashref.texi:5451
  8740. #, no-wrap
  8741. msgid "Bash Variables"
  8742. msgstr ""
  8743. #. type: menuentry
  8744. #: ./bashref.texi:5384
  8745. msgid "List of variables that exist in Bash."
  8746. msgstr ""
  8747. #. type: Plain text
  8748. #: ./bashref.texi:5388
  8749. msgid ""
  8750. "This chapter describes the shell variables that Bash uses. Bash "
  8751. "automatically assigns default values to a number of variables."
  8752. msgstr ""
  8753. #. type: Plain text
  8754. #: ./bashref.texi:5394
  8755. msgid ""
  8756. "Bash uses certain shell variables in the same way as the Bourne shell. In "
  8757. "some cases, Bash assigns a default value to the variable."
  8758. msgstr ""
  8759. #. type: item
  8760. #: ./bashref.texi:5397
  8761. #, no-wrap
  8762. msgid "CDPATH"
  8763. msgstr ""
  8764. #. type: Plain text
  8765. #: ./bashref.texi:5400
  8766. msgid ""
  8767. "A colon-separated list of directories used as a search path for the "
  8768. "@code{cd} builtin command."
  8769. msgstr ""
  8770. #. type: item
  8771. #: ./bashref.texi:5401
  8772. #, no-wrap
  8773. msgid "HOME"
  8774. msgstr ""
  8775. #. type: Plain text
  8776. #: ./bashref.texi:5406
  8777. msgid ""
  8778. "The current user's home directory; the default for the @code{cd} builtin "
  8779. "command. The value of this variable is also used by tilde expansion "
  8780. "(@pxref{Tilde Expansion})."
  8781. msgstr ""
  8782. #. type: item
  8783. #: ./bashref.texi:5407
  8784. #, no-wrap
  8785. msgid "IFS"
  8786. msgstr ""
  8787. #. type: Plain text
  8788. #: ./bashref.texi:5410
  8789. msgid ""
  8790. "A list of characters that separate fields; used when the shell splits words "
  8791. "as part of expansion."
  8792. msgstr ""
  8793. #. type: item
  8794. #: ./bashref.texi:5411
  8795. #, no-wrap
  8796. msgid "MAIL"
  8797. msgstr ""
  8798. #. type: Plain text
  8799. #: ./bashref.texi:5416
  8800. msgid ""
  8801. "If this parameter is set to a filename or directory name and the "
  8802. "@env{MAILPATH} variable is not set, Bash informs the user of the arrival of "
  8803. "mail in the specified file or Maildir-format directory."
  8804. msgstr ""
  8805. #. type: item
  8806. #: ./bashref.texi:5417
  8807. #, no-wrap
  8808. msgid "MAILPATH"
  8809. msgstr ""
  8810. #. type: Plain text
  8811. #: ./bashref.texi:5425
  8812. msgid ""
  8813. "A colon-separated list of filenames which the shell periodically checks for "
  8814. "new mail. Each list entry can specify the message that is printed when new "
  8815. "mail arrives in the mail file by separating the filename from the message "
  8816. "with a @samp{?}. When used in the text of the message, @code{$_} expands to "
  8817. "the name of the current mail file."
  8818. msgstr ""
  8819. #. type: item
  8820. #: ./bashref.texi:5426
  8821. #, no-wrap
  8822. msgid "OPTARG"
  8823. msgstr ""
  8824. #. type: Plain text
  8825. #: ./bashref.texi:5428
  8826. msgid ""
  8827. "The value of the last option argument processed by the @code{getopts} "
  8828. "builtin."
  8829. msgstr ""
  8830. #. type: item
  8831. #: ./bashref.texi:5429
  8832. #, no-wrap
  8833. msgid "OPTIND"
  8834. msgstr ""
  8835. #. type: Plain text
  8836. #: ./bashref.texi:5431
  8837. msgid ""
  8838. "The index of the last option argument processed by the @code{getopts} "
  8839. "builtin."
  8840. msgstr ""
  8841. #. type: item
  8842. #: ./bashref.texi:5432
  8843. #, no-wrap
  8844. msgid "PATH"
  8845. msgstr ""
  8846. #. type: Plain text
  8847. #: ./bashref.texi:5439
  8848. msgid ""
  8849. "A colon-separated list of directories in which the shell looks for "
  8850. "commands. A zero-length (null) directory name in the value of @code{PATH} "
  8851. "indicates the current directory. A null directory name may appear as two "
  8852. "adjacent colons, or as an initial or trailing colon."
  8853. msgstr ""
  8854. #. type: item
  8855. #: ./bashref.texi:5440
  8856. #, no-wrap
  8857. msgid "PS1"
  8858. msgstr ""
  8859. #. type: Plain text
  8860. #: ./bashref.texi:5444
  8861. msgid ""
  8862. "The primary prompt string. The default value is @samp{\\s-\\v\\$ }. "
  8863. "@xref{Controlling the Prompt}, for the complete list of escape sequences "
  8864. "that are expanded before @env{PS1} is displayed."
  8865. msgstr ""
  8866. #. type: item
  8867. #: ./bashref.texi:5445
  8868. #, no-wrap
  8869. msgid "PS2"
  8870. msgstr ""
  8871. #. type: Plain text
  8872. #: ./bashref.texi:5447
  8873. msgid "The secondary prompt string. The default value is @samp{> }."
  8874. msgstr ""
  8875. #. type: Plain text
  8876. #: ./bashref.texi:5455
  8877. msgid ""
  8878. "These variables are set or used by Bash, but other shells do not normally "
  8879. "treat them specially."
  8880. msgstr ""
  8881. #. type: Plain text
  8882. #: ./bashref.texi:5459
  8883. msgid ""
  8884. "A few variables used by Bash are described in different chapters: variables "
  8885. "for controlling the job control facilities (@pxref{Job Control Variables})."
  8886. msgstr ""
  8887. #. type: item
  8888. #: ./bashref.texi:5462
  8889. #, no-wrap
  8890. msgid "BASH"
  8891. msgstr ""
  8892. #. type: Plain text
  8893. #: ./bashref.texi:5464
  8894. msgid "The full pathname used to execute the current instance of Bash."
  8895. msgstr ""
  8896. #. type: item
  8897. #: ./bashref.texi:5465
  8898. #, no-wrap
  8899. msgid "BASHOPTS"
  8900. msgstr ""
  8901. #. type: Plain text
  8902. #: ./bashref.texi:5474
  8903. msgid ""
  8904. "A colon-separated list of enabled shell options. Each word in the list is a "
  8905. "valid argument for the @option{-s} option to the @code{shopt} builtin "
  8906. "command (@pxref{The Shopt Builtin}). The options appearing in "
  8907. "@env{BASHOPTS} are those reported as @samp{on} by @samp{shopt}. If this "
  8908. "variable is in the environment when Bash starts up, each shell option in the "
  8909. "list will be enabled before reading any startup files. This variable is "
  8910. "readonly."
  8911. msgstr ""
  8912. #. type: item
  8913. #: ./bashref.texi:5475
  8914. #, no-wrap
  8915. msgid "BASHPID"
  8916. msgstr ""
  8917. #. type: Plain text
  8918. #: ./bashref.texi:5479
  8919. msgid ""
  8920. "Expands to the process ID of the current Bash process. This differs from "
  8921. "@code{$$} under certain circumstances, such as subshells that do not require "
  8922. "Bash to be re-initialized."
  8923. msgstr ""
  8924. #. type: item
  8925. #: ./bashref.texi:5480
  8926. #, no-wrap
  8927. msgid "BASH_ALIASES"
  8928. msgstr ""
  8929. #. type: Plain text
  8930. #: ./bashref.texi:5490
  8931. msgid ""
  8932. "An associative array variable whose members correspond to the internal list "
  8933. "of aliases as maintained by the @code{alias} builtin. (@pxref{Bourne Shell "
  8934. "Builtins}). Elements added to this array appear in the alias list; however, "
  8935. "unsetting array elements currently does not cause aliases to be removed from "
  8936. "the alias list. If @code{BASH_ALIASES} is unset, it loses its special "
  8937. "properties, even if it is subsequently reset."
  8938. msgstr ""
  8939. #. type: item
  8940. #: ./bashref.texi:5491
  8941. #, no-wrap
  8942. msgid "BASH_ARGC"
  8943. msgstr ""
  8944. #. type: Plain text
  8945. #: ./bashref.texi:5502
  8946. msgid ""
  8947. "An array variable whose values are the number of parameters in each frame of "
  8948. "the current bash execution call stack. The number of parameters to the "
  8949. "current subroutine (shell function or script executed with @code{.} or "
  8950. "@code{source}) is at the top of the stack. When a subroutine is executed, "
  8951. "the number of parameters passed is pushed onto @code{BASH_ARGC}. The shell "
  8952. "sets @code{BASH_ARGC} only when in extended debugging mode (see @ref{The "
  8953. "Shopt Builtin} for a description of the @code{extdebug} option to the "
  8954. "@code{shopt} builtin)."
  8955. msgstr ""
  8956. #. type: item
  8957. #: ./bashref.texi:5503
  8958. #, no-wrap
  8959. msgid "BASH_ARGV"
  8960. msgstr ""
  8961. #. type: Plain text
  8962. #: ./bashref.texi:5513
  8963. msgid ""
  8964. "An array variable containing all of the parameters in the current bash "
  8965. "execution call stack. The final parameter of the last subroutine call is at "
  8966. "the top of the stack; the first parameter of the initial call is at the "
  8967. "bottom. When a subroutine is executed, the parameters supplied are pushed "
  8968. "onto @code{BASH_ARGV}. The shell sets @code{BASH_ARGV} only when in "
  8969. "extended debugging mode (see @ref{The Shopt Builtin} for a description of "
  8970. "the @code{extdebug} option to the @code{shopt} builtin)."
  8971. msgstr ""
  8972. #. type: item
  8973. #: ./bashref.texi:5514
  8974. #, no-wrap
  8975. msgid "BASH_CMDS"
  8976. msgstr ""
  8977. #. type: Plain text
  8978. #: ./bashref.texi:5524
  8979. msgid ""
  8980. "An associative array variable whose members correspond to the internal hash "
  8981. "table of commands as maintained by the @code{hash} builtin (@pxref{Bourne "
  8982. "Shell Builtins}). Elements added to this array appear in the hash table; "
  8983. "however, unsetting array elements currently does not cause command names to "
  8984. "be removed from the hash table. If @code{BASH_CMDS} is unset, it loses its "
  8985. "special properties, even if it is subsequently reset."
  8986. msgstr ""
  8987. #. type: item
  8988. #: ./bashref.texi:5525
  8989. #, no-wrap
  8990. msgid "BASH_COMMAND"
  8991. msgstr ""
  8992. #. type: Plain text
  8993. #: ./bashref.texi:5529
  8994. msgid ""
  8995. "The command currently being executed or about to be executed, unless the "
  8996. "shell is executing a command as the result of a trap, in which case it is "
  8997. "the command executing at the time of the trap."
  8998. msgstr ""
  8999. #. type: item
  9000. #: ./bashref.texi:5530
  9001. #, no-wrap
  9002. msgid "BASH_COMPAT"
  9003. msgstr ""
  9004. #. type: Plain text
  9005. #: ./bashref.texi:5545
  9006. msgid ""
  9007. "The value is used to set the shell's compatibility level. @xref{The Shopt "
  9008. "Builtin}, for a description of the various compatibility levels and their "
  9009. "effects. The value may be a decimal number (e.g., 4.2) or an integer (e.g., "
  9010. "42) corresponding to the desired compatibility level. If "
  9011. "@code{BASH_COMPAT} is unset or set to the empty string, the compatibility "
  9012. "level is set to the default for the current version. If @code{BASH_COMPAT} "
  9013. "is set to a value that is not one of the valid compatibility levels, the "
  9014. "shell prints an error message and sets the compatibility level to the "
  9015. "default for the current version. The valid compatibility levels correspond "
  9016. "to the compatibility options accepted by the @code{shopt} builtin described "
  9017. "above (for example, @var{compat42} means that 4.2 and 42 are valid values). "
  9018. "The current version is also a valid value."
  9019. msgstr ""
  9020. #. type: item
  9021. #: ./bashref.texi:5546
  9022. #, no-wrap
  9023. msgid "BASH_ENV"
  9024. msgstr ""
  9025. #. type: Plain text
  9026. #: ./bashref.texi:5550
  9027. msgid ""
  9028. "If this variable is set when Bash is invoked to execute a shell script, its "
  9029. "value is expanded and used as the name of a startup file to read before "
  9030. "executing the script. @xref{Bash Startup Files}."
  9031. msgstr ""
  9032. #. type: item
  9033. #: ./bashref.texi:5551
  9034. #, no-wrap
  9035. msgid "BASH_EXECUTION_STRING"
  9036. msgstr ""
  9037. #. type: Plain text
  9038. #: ./bashref.texi:5553
  9039. msgid "The command argument to the @option{-c} invocation option."
  9040. msgstr ""
  9041. #. type: item
  9042. #: ./bashref.texi:5554
  9043. #, no-wrap
  9044. msgid "BASH_LINENO"
  9045. msgstr ""
  9046. #. type: Plain text
  9047. #: ./bashref.texi:5562
  9048. msgid ""
  9049. "An array variable whose members are the line numbers in source files where "
  9050. "each corresponding member of @var{FUNCNAME} was invoked. "
  9051. "@code{$@{BASH_LINENO[$i]@}} is the line number in the source file "
  9052. "(@code{$@{BASH_SOURCE[$i+1]@}}) where @code{$@{FUNCNAME[$i]@}} was called "
  9053. "(or @code{$@{BASH_LINENO[$i-1]@}} if referenced within another shell "
  9054. "function). Use @code{LINENO} to obtain the current line number."
  9055. msgstr ""
  9056. #. type: item
  9057. #: ./bashref.texi:5563
  9058. #, no-wrap
  9059. msgid "BASH_LOADABLES_PATH"
  9060. msgstr ""
  9061. #. type: Plain text
  9062. #: ./bashref.texi:5567
  9063. msgid ""
  9064. "A colon-separated list of directories in which the shell looks for "
  9065. "dynamically loadable builtins specified by the @code{enable} command."
  9066. msgstr ""
  9067. #. type: item
  9068. #: ./bashref.texi:5568
  9069. #, no-wrap
  9070. msgid "BASH_REMATCH"
  9071. msgstr ""
  9072. #. type: Plain text
  9073. #: ./bashref.texi:5577
  9074. msgid ""
  9075. "An array variable whose members are assigned by the @samp{=~} binary "
  9076. "operator to the @code{[[} conditional command (@pxref{Conditional "
  9077. "Constructs}). The element with index 0 is the portion of the string "
  9078. "matching the entire regular expression. The element with index @var{n} is "
  9079. "the portion of the string matching the @var{n}th parenthesized "
  9080. "subexpression. This variable is read-only."
  9081. msgstr ""
  9082. #. type: item
  9083. #: ./bashref.texi:5578
  9084. #, no-wrap
  9085. msgid "BASH_SOURCE"
  9086. msgstr ""
  9087. #. type: Plain text
  9088. #: ./bashref.texi:5584
  9089. msgid ""
  9090. "An array variable whose members are the source filenames where the "
  9091. "corresponding shell function names in the @code{FUNCNAME} array variable are "
  9092. "defined. The shell function @code{$@{FUNCNAME[$i]@}} is defined in the file "
  9093. "@code{$@{BASH_SOURCE[$i]@}} and called from @code{$@{BASH_SOURCE[$i+1]@}}"
  9094. msgstr ""
  9095. #. type: item
  9096. #: ./bashref.texi:5585
  9097. #, no-wrap
  9098. msgid "BASH_SUBSHELL"
  9099. msgstr ""
  9100. #. type: Plain text
  9101. #: ./bashref.texi:5589
  9102. msgid ""
  9103. "Incremented by one within each subshell or subshell environment when the "
  9104. "shell begins executing in that environment. The initial value is 0."
  9105. msgstr ""
  9106. #. type: item
  9107. #: ./bashref.texi:5590
  9108. #, no-wrap
  9109. msgid "BASH_VERSINFO"
  9110. msgstr ""
  9111. #. type: Plain text
  9112. #: ./bashref.texi:5594
  9113. msgid ""
  9114. "A readonly array variable (@pxref{Arrays}) whose members hold version "
  9115. "information for this instance of Bash. The values assigned to the array "
  9116. "members are as follows:"
  9117. msgstr ""
  9118. #. type: item
  9119. #: ./bashref.texi:5597
  9120. #, no-wrap
  9121. msgid "BASH_VERSINFO[0]"
  9122. msgstr ""
  9123. #. type: table
  9124. #: ./bashref.texi:5599
  9125. msgid "The major version number (the @var{release})."
  9126. msgstr ""
  9127. #. type: item
  9128. #: ./bashref.texi:5600
  9129. #, no-wrap
  9130. msgid "BASH_VERSINFO[1]"
  9131. msgstr ""
  9132. #. type: table
  9133. #: ./bashref.texi:5602
  9134. msgid "The minor version number (the @var{version})."
  9135. msgstr ""
  9136. #. type: item
  9137. #: ./bashref.texi:5603
  9138. #, no-wrap
  9139. msgid "BASH_VERSINFO[2]"
  9140. msgstr ""
  9141. #. type: table
  9142. #: ./bashref.texi:5605
  9143. msgid "The patch level."
  9144. msgstr ""
  9145. #. type: item
  9146. #: ./bashref.texi:5606
  9147. #, no-wrap
  9148. msgid "BASH_VERSINFO[3]"
  9149. msgstr ""
  9150. #. type: table
  9151. #: ./bashref.texi:5608
  9152. msgid "The build version."
  9153. msgstr ""
  9154. #. type: item
  9155. #: ./bashref.texi:5609
  9156. #, no-wrap
  9157. msgid "BASH_VERSINFO[4]"
  9158. msgstr ""
  9159. #. type: table
  9160. #: ./bashref.texi:5611
  9161. msgid "The release status (e.g., @var{beta1})."
  9162. msgstr ""
  9163. #. type: item
  9164. #: ./bashref.texi:5612
  9165. #, no-wrap
  9166. msgid "BASH_VERSINFO[5]"
  9167. msgstr ""
  9168. #. type: table
  9169. #: ./bashref.texi:5614
  9170. msgid "The value of @env{MACHTYPE}."
  9171. msgstr ""
  9172. #. type: item
  9173. #: ./bashref.texi:5616
  9174. #, no-wrap
  9175. msgid "BASH_VERSION"
  9176. msgstr ""
  9177. #. type: Plain text
  9178. #: ./bashref.texi:5618
  9179. msgid "The version number of the current instance of Bash."
  9180. msgstr ""
  9181. #. type: item
  9182. #: ./bashref.texi:5619
  9183. #, no-wrap
  9184. msgid "BASH_XTRACEFD"
  9185. msgstr ""
  9186. #. type: Plain text
  9187. #: ./bashref.texi:5632
  9188. msgid ""
  9189. "If set to an integer corresponding to a valid file descriptor, Bash will "
  9190. "write the trace output generated when @samp{set -x} is enabled to that file "
  9191. "descriptor. This allows tracing output to be separated from diagnostic and "
  9192. "error messages. The file descriptor is closed when @code{BASH_XTRACEFD} is "
  9193. "unset or assigned a new value. Unsetting @code{BASH_XTRACEFD} or assigning "
  9194. "it the empty string causes the trace output to be sent to the standard "
  9195. "error. Note that setting @code{BASH_XTRACEFD} to 2 (the standard error file "
  9196. "descriptor) and then unsetting it will result in the standard error being "
  9197. "closed."
  9198. msgstr ""
  9199. #. type: item
  9200. #: ./bashref.texi:5633
  9201. #, no-wrap
  9202. msgid "CHILD_MAX"
  9203. msgstr ""
  9204. #. type: Plain text
  9205. #: ./bashref.texi:5639
  9206. msgid ""
  9207. "Set the number of exited child status values for the shell to remember. "
  9208. "Bash will not allow this value to be decreased below a @sc{posix}-mandated "
  9209. "minimum, and there is a maximum value (currently 8192) that this may not "
  9210. "exceed. The minimum value is system-dependent."
  9211. msgstr ""
  9212. #. type: item
  9213. #: ./bashref.texi:5640
  9214. #, no-wrap
  9215. msgid "COLUMNS"
  9216. msgstr ""
  9217. #. type: Plain text
  9218. #: ./bashref.texi:5646
  9219. msgid ""
  9220. "Used by the @code{select} command to determine the terminal width when "
  9221. "printing selection lists. Automatically set if the @code{checkwinsize} "
  9222. "option is enabled (@pxref{The Shopt Builtin}), or in an interactive shell "
  9223. "upon receipt of a @code{SIGWINCH}."
  9224. msgstr ""
  9225. #. type: item
  9226. #: ./bashref.texi:5647
  9227. #, no-wrap
  9228. msgid "COMP_CWORD"
  9229. msgstr ""
  9230. #. type: Plain text
  9231. #: ./bashref.texi:5652
  9232. msgid ""
  9233. "An index into @env{$@{COMP_WORDS@}} of the word containing the current "
  9234. "cursor position. This variable is available only in shell functions invoked "
  9235. "by the programmable completion facilities (@pxref{Programmable Completion})."
  9236. msgstr ""
  9237. #. type: item
  9238. #: ./bashref.texi:5653
  9239. #, no-wrap
  9240. msgid "COMP_LINE"
  9241. msgstr ""
  9242. #. type: Plain text
  9243. #: ./bashref.texi:5658
  9244. msgid ""
  9245. "The current command line. This variable is available only in shell "
  9246. "functions and external commands invoked by the programmable completion "
  9247. "facilities (@pxref{Programmable Completion})."
  9248. msgstr ""
  9249. #. type: item
  9250. #: ./bashref.texi:5659
  9251. #, no-wrap
  9252. msgid "COMP_POINT"
  9253. msgstr ""
  9254. #. type: Plain text
  9255. #: ./bashref.texi:5667
  9256. msgid ""
  9257. "The index of the current cursor position relative to the beginning of the "
  9258. "current command. If the current cursor position is at the end of the "
  9259. "current command, the value of this variable is equal to "
  9260. "@code{$@{#COMP_LINE@}}. This variable is available only in shell functions "
  9261. "and external commands invoked by the programmable completion facilities "
  9262. "(@pxref{Programmable Completion})."
  9263. msgstr ""
  9264. #. type: item
  9265. #: ./bashref.texi:5668
  9266. #, no-wrap
  9267. msgid "COMP_TYPE"
  9268. msgstr ""
  9269. #. type: Plain text
  9270. #: ./bashref.texi:5680
  9271. msgid ""
  9272. "Set to an integer value corresponding to the type of completion attempted "
  9273. "that caused a completion function to be called: @var{TAB}, for normal "
  9274. "completion, @samp{?}, for listing completions after successive tabs, "
  9275. "@samp{!}, for listing alternatives on partial word completion, @samp{@@}, to "
  9276. "list completions if the word is not unmodified, or @samp{%}, for menu "
  9277. "completion. This variable is available only in shell functions and external "
  9278. "commands invoked by the programmable completion facilities "
  9279. "(@pxref{Programmable Completion})."
  9280. msgstr ""
  9281. #. type: item
  9282. #: ./bashref.texi:5681
  9283. #, no-wrap
  9284. msgid "COMP_KEY"
  9285. msgstr ""
  9286. #. type: Plain text
  9287. #: ./bashref.texi:5684
  9288. msgid ""
  9289. "The key (or final key of a key sequence) used to invoke the current "
  9290. "completion function."
  9291. msgstr ""
  9292. #. type: item
  9293. #: ./bashref.texi:5685
  9294. #, no-wrap
  9295. msgid "COMP_WORDBREAKS"
  9296. msgstr ""
  9297. #. type: Plain text
  9298. #: ./bashref.texi:5690
  9299. msgid ""
  9300. "The set of characters that the Readline library treats as word separators "
  9301. "when performing word completion. If @code{COMP_WORDBREAKS} is unset, it "
  9302. "loses its special properties, even if it is subsequently reset."
  9303. msgstr ""
  9304. #. type: item
  9305. #: ./bashref.texi:5691
  9306. #, no-wrap
  9307. msgid "COMP_WORDS"
  9308. msgstr ""
  9309. #. type: Plain text
  9310. #: ./bashref.texi:5698
  9311. msgid ""
  9312. "An array variable consisting of the individual words in the current command "
  9313. "line. The line is split into words as Readline would split it, using "
  9314. "@code{COMP_WORDBREAKS} as described above. This variable is available only "
  9315. "in shell functions invoked by the programmable completion facilities "
  9316. "(@pxref{Programmable Completion})."
  9317. msgstr ""
  9318. #. type: item
  9319. #: ./bashref.texi:5699
  9320. #, no-wrap
  9321. msgid "COMPREPLY"
  9322. msgstr ""
  9323. #. type: Plain text
  9324. #: ./bashref.texi:5704
  9325. msgid ""
  9326. "An array variable from which Bash reads the possible completions generated "
  9327. "by a shell function invoked by the programmable completion facility "
  9328. "(@pxref{Programmable Completion}). Each array element contains one possible "
  9329. "completion."
  9330. msgstr ""
  9331. #. type: item
  9332. #: ./bashref.texi:5705
  9333. #, no-wrap
  9334. msgid "COPROC"
  9335. msgstr ""
  9336. #. type: Plain text
  9337. #: ./bashref.texi:5708
  9338. msgid ""
  9339. "An array variable created to hold the file descriptors for output from and "
  9340. "input to an unnamed coprocess (@pxref{Coprocesses})."
  9341. msgstr ""
  9342. #. type: item
  9343. #: ./bashref.texi:5709
  9344. #, no-wrap
  9345. msgid "DIRSTACK"
  9346. msgstr ""
  9347. #. type: Plain text
  9348. #: ./bashref.texi:5719
  9349. msgid ""
  9350. "An array variable containing the current contents of the directory stack. "
  9351. "Directories appear in the stack in the order they are displayed by the "
  9352. "@code{dirs} builtin. Assigning to members of this array variable may be "
  9353. "used to modify directories already in the stack, but the @code{pushd} and "
  9354. "@code{popd} builtins must be used to add and remove directories. Assignment "
  9355. "to this variable will not change the current directory. If @env{DIRSTACK} "
  9356. "is unset, it loses its special properties, even if it is subsequently reset."
  9357. msgstr ""
  9358. #. type: item
  9359. #: ./bashref.texi:5720
  9360. #, no-wrap
  9361. msgid "EMACS"
  9362. msgstr ""
  9363. #. type: Plain text
  9364. #: ./bashref.texi:5724
  9365. msgid ""
  9366. "If Bash finds this variable in the environment when the shell starts with "
  9367. "value @samp{t}, it assumes that the shell is running in an Emacs shell "
  9368. "buffer and disables line editing."
  9369. msgstr ""
  9370. #. type: item
  9371. #: ./bashref.texi:5725
  9372. #, no-wrap
  9373. msgid "ENV"
  9374. msgstr ""
  9375. #. type: Plain text
  9376. #: ./bashref.texi:5728
  9377. msgid ""
  9378. "Similar to @code{BASH_ENV}; used when the shell is invoked in @sc{posix} "
  9379. "Mode (@pxref{Bash POSIX Mode})."
  9380. msgstr ""
  9381. #. type: item
  9382. #: ./bashref.texi:5729
  9383. #, no-wrap
  9384. msgid "EUID"
  9385. msgstr ""
  9386. #. type: Plain text
  9387. #: ./bashref.texi:5732
  9388. msgid ""
  9389. "The numeric effective user id of the current user. This variable is "
  9390. "readonly."
  9391. msgstr ""
  9392. #. type: item
  9393. #: ./bashref.texi:5733
  9394. #, no-wrap
  9395. msgid "EXECIGNORE"
  9396. msgstr ""
  9397. #. type: Plain text
  9398. #: ./bashref.texi:5747
  9399. msgid ""
  9400. "A colon-separated list of shell patterns (@pxref{Pattern Matching}) "
  9401. "defining the list of filenames to be ignored by command search using "
  9402. "@code{PATH}. Files whose full pathnames match one of these patterns are not "
  9403. "considered executable files for the purposes of completion and command "
  9404. "execution via @code{PATH} lookup. This does not affect the behavior of the "
  9405. "@code{[}, @code{test}, and @code{[[} commands. Full pathnames in the "
  9406. "command hash table are not subject to @code{EXECIGNORE}. Use this variable "
  9407. "to ignore shared library files that have the executable bit set, but are not "
  9408. "executable files. The pattern matching honors the setting of the "
  9409. "@code{extglob} shell option."
  9410. msgstr ""
  9411. #. type: item
  9412. #: ./bashref.texi:5748
  9413. #, no-wrap
  9414. msgid "FCEDIT"
  9415. msgstr ""
  9416. #. type: Plain text
  9417. #: ./bashref.texi:5751
  9418. msgid ""
  9419. "The editor used as a default by the @option{-e} option to the @code{fc} "
  9420. "builtin command."
  9421. msgstr ""
  9422. #. type: item
  9423. #: ./bashref.texi:5752
  9424. #, no-wrap
  9425. msgid "FIGNORE"
  9426. msgstr ""
  9427. #. type: Plain text
  9428. #: ./bashref.texi:5759
  9429. msgid ""
  9430. "A colon-separated list of suffixes to ignore when performing filename "
  9431. "completion. A filename whose suffix matches one of the entries in "
  9432. "@env{FIGNORE} is excluded from the list of matched filenames. A sample "
  9433. "value is @samp{.o:~}"
  9434. msgstr ""
  9435. #. type: item
  9436. #: ./bashref.texi:5760
  9437. #, no-wrap
  9438. msgid "FUNCNAME"
  9439. msgstr ""
  9440. #. type: Plain text
  9441. #: ./bashref.texi:5771
  9442. msgid ""
  9443. "An array variable containing the names of all shell functions currently in "
  9444. "the execution call stack. The element with index 0 is the name of any "
  9445. "currently-executing shell function. The bottom-most element (the one with "
  9446. "the highest index) is @code{\"main\"}. This variable exists only when a "
  9447. "shell function is executing. Assignments to @env{FUNCNAME} have no effect. "
  9448. "If @env{FUNCNAME} is unset, it loses its special properties, even if it is "
  9449. "subsequently reset."
  9450. msgstr ""
  9451. #. type: Plain text
  9452. #: ./bashref.texi:5779
  9453. msgid ""
  9454. "This variable can be used with @code{BASH_LINENO} and @code{BASH_SOURCE}. "
  9455. "Each element of @code{FUNCNAME} has corresponding elements in "
  9456. "@code{BASH_LINENO} and @code{BASH_SOURCE} to describe the call stack. For "
  9457. "instance, @code{$@{FUNCNAME[$i]@}} was called from the file "
  9458. "@code{$@{BASH_SOURCE[$i+1]@}} at line number @code{$@{BASH_LINENO[$i]@}}. "
  9459. "The @code{caller} builtin displays the current call stack using this "
  9460. "information."
  9461. msgstr ""
  9462. #. type: item
  9463. #: ./bashref.texi:5780
  9464. #, no-wrap
  9465. msgid "FUNCNEST"
  9466. msgstr ""
  9467. #. type: Plain text
  9468. #: ./bashref.texi:5784
  9469. msgid ""
  9470. "If set to a numeric value greater than 0, defines a maximum function nesting "
  9471. "level. Function invocations that exceed this nesting level will cause the "
  9472. "current command to abort."
  9473. msgstr ""
  9474. #. type: item
  9475. #: ./bashref.texi:5785
  9476. #, no-wrap
  9477. msgid "GLOBIGNORE"
  9478. msgstr ""
  9479. #. type: Plain text
  9480. #: ./bashref.texi:5793
  9481. msgid ""
  9482. "A colon-separated list of patterns defining the set of filenames to be "
  9483. "ignored by filename expansion. If a filename matched by a filename "
  9484. "expansion pattern also matches one of the patterns in @env{GLOBIGNORE}, it "
  9485. "is removed from the list of matches. The pattern matching honors the "
  9486. "setting of the @code{extglob} shell option."
  9487. msgstr ""
  9488. #. type: item
  9489. #: ./bashref.texi:5794
  9490. #, no-wrap
  9491. msgid "GROUPS"
  9492. msgstr ""
  9493. #. type: Plain text
  9494. #: ./bashref.texi:5800
  9495. msgid ""
  9496. "An array variable containing the list of groups of which the current user is "
  9497. "a member. Assignments to @env{GROUPS} have no effect. If @env{GROUPS} is "
  9498. "unset, it loses its special properties, even if it is subsequently reset."
  9499. msgstr ""
  9500. #. type: item
  9501. #: ./bashref.texi:5801
  9502. #, no-wrap
  9503. msgid "histchars"
  9504. msgstr ""
  9505. #. type: Plain text
  9506. #: ./bashref.texi:5814
  9507. msgid ""
  9508. "Up to three characters which control history expansion, quick substitution, "
  9509. "and tokenization (@pxref{History Interaction}). The first character is the "
  9510. "@var{history expansion} character, that is, the character which signifies "
  9511. "the start of a history expansion, normally @samp{!}. The second character "
  9512. "is the character which signifies `quick substitution' when seen as the first "
  9513. "character on a line, normally @samp{^}. The optional third character is the "
  9514. "character which indicates that the remainder of the line is a comment when "
  9515. "found as the first character of a word, usually @samp{#}. The history "
  9516. "comment character causes history substitution to be skipped for the "
  9517. "remaining words on the line. It does not necessarily cause the shell parser "
  9518. "to treat the rest of the line as a comment."
  9519. msgstr ""
  9520. #. type: item
  9521. #: ./bashref.texi:5815
  9522. #, no-wrap
  9523. msgid "HISTCMD"
  9524. msgstr ""
  9525. #. type: Plain text
  9526. #: ./bashref.texi:5819
  9527. msgid ""
  9528. "The history number, or index in the history list, of the current command. "
  9529. "If @env{HISTCMD} is unset, it loses its special properties, even if it is "
  9530. "subsequently reset."
  9531. msgstr ""
  9532. #. type: item
  9533. #: ./bashref.texi:5820
  9534. #, no-wrap
  9535. msgid "HISTCONTROL"
  9536. msgstr ""
  9537. #. type: Plain text
  9538. #: ./bashref.texi:5839
  9539. msgid ""
  9540. "A colon-separated list of values controlling how commands are saved on the "
  9541. "history list. If the list of values includes @samp{ignorespace}, lines "
  9542. "which begin with a space character are not saved in the history list. A "
  9543. "value of @samp{ignoredups} causes lines which match the previous history "
  9544. "entry to not be saved. A value of @samp{ignoreboth} is shorthand for "
  9545. "@samp{ignorespace} and @samp{ignoredups}. A value of @samp{erasedups} "
  9546. "causes all previous lines matching the current line to be removed from the "
  9547. "history list before that line is saved. Any value not in the above list is "
  9548. "ignored. If @env{HISTCONTROL} is unset, or does not include a valid value, "
  9549. "all lines read by the shell parser are saved on the history list, subject to "
  9550. "the value of @env{HISTIGNORE}. The second and subsequent lines of a "
  9551. "multi-line compound command are not tested, and are added to the history "
  9552. "regardless of the value of @env{HISTCONTROL}."
  9553. msgstr ""
  9554. #. type: item
  9555. #: ./bashref.texi:5840
  9556. #, no-wrap
  9557. msgid "HISTFILE"
  9558. msgstr ""
  9559. #. type: Plain text
  9560. #: ./bashref.texi:5843
  9561. msgid ""
  9562. "The name of the file to which the command history is saved. The default "
  9563. "value is @file{~/.bash_history}."
  9564. msgstr ""
  9565. #. type: item
  9566. #: ./bashref.texi:5844
  9567. #, no-wrap
  9568. msgid "HISTFILESIZE"
  9569. msgstr ""
  9570. #. type: Plain text
  9571. #: ./bashref.texi:5855
  9572. msgid ""
  9573. "The maximum number of lines contained in the history file. When this "
  9574. "variable is assigned a value, the history file is truncated, if necessary, "
  9575. "to contain no more than that number of lines by removing the oldest "
  9576. "entries. The history file is also truncated to this size after writing it "
  9577. "when a shell exits. If the value is 0, the history file is truncated to "
  9578. "zero size. Non-numeric values and numeric values less than zero inhibit "
  9579. "truncation. The shell sets the default value to the value of @env{HISTSIZE} "
  9580. "after reading any startup files."
  9581. msgstr ""
  9582. #. type: item
  9583. #: ./bashref.texi:5856
  9584. #, no-wrap
  9585. msgid "HISTIGNORE"
  9586. msgstr ""
  9587. #. type: Plain text
  9588. #: ./bashref.texi:5871
  9589. msgid ""
  9590. "A colon-separated list of patterns used to decide which command lines should "
  9591. "be saved on the history list. Each pattern is anchored at the beginning of "
  9592. "the line and must match the complete line (no implicit @samp{*} is "
  9593. "appended). Each pattern is tested against the line after the checks "
  9594. "specified by @env{HISTCONTROL} are applied. In addition to the normal shell "
  9595. "pattern matching characters, @samp{&} matches the previous history line. "
  9596. "@samp{&} may be escaped using a backslash; the backslash is removed before "
  9597. "attempting a match. The second and subsequent lines of a multi-line "
  9598. "compound command are not tested, and are added to the history regardless of "
  9599. "the value of @env{HISTIGNORE}. The pattern matching honors the setting of "
  9600. "the @code{extglob} shell option."
  9601. msgstr ""
  9602. #. type: Plain text
  9603. #: ./bashref.texi:5877
  9604. msgid ""
  9605. "@env{HISTIGNORE} subsumes the function of @env{HISTCONTROL}. A pattern of "
  9606. "@samp{&} is identical to @code{ignoredups}, and a pattern of @samp{[ ]*} is "
  9607. "identical to @code{ignorespace}. Combining these two patterns, separating "
  9608. "them with a colon, provides the functionality of @code{ignoreboth}."
  9609. msgstr ""
  9610. #. type: item
  9611. #: ./bashref.texi:5878
  9612. #, no-wrap
  9613. msgid "HISTSIZE"
  9614. msgstr ""
  9615. #. type: Plain text
  9616. #: ./bashref.texi:5884
  9617. msgid ""
  9618. "The maximum number of commands to remember on the history list. If the "
  9619. "value is 0, commands are not saved in the history list. Numeric values less "
  9620. "than zero result in every command being saved on the history list (there is "
  9621. "no limit). The shell sets the default value to 500 after reading any "
  9622. "startup files."
  9623. msgstr ""
  9624. #. type: item
  9625. #: ./bashref.texi:5885
  9626. #, no-wrap
  9627. msgid "HISTTIMEFORMAT"
  9628. msgstr ""
  9629. #. type: Plain text
  9630. #: ./bashref.texi:5893
  9631. msgid ""
  9632. "If this variable is set and not null, its value is used as a format string "
  9633. "for @var{strftime} to print the time stamp associated with each history "
  9634. "entry displayed by the @code{history} builtin. If this variable is set, "
  9635. "time stamps are written to the history file so they may be preserved across "
  9636. "shell sessions. This uses the history comment character to distinguish "
  9637. "timestamps from other history lines."
  9638. msgstr ""
  9639. #. type: item
  9640. #: ./bashref.texi:5894
  9641. #, no-wrap
  9642. msgid "HOSTFILE"
  9643. msgstr ""
  9644. #. type: Plain text
  9645. #: ./bashref.texi:5906
  9646. msgid ""
  9647. "Contains the name of a file in the same format as @file{/etc/hosts} that "
  9648. "should be read when the shell needs to complete a hostname. The list of "
  9649. "possible hostname completions may be changed while the shell is running; the "
  9650. "next time hostname completion is attempted after the value is changed, Bash "
  9651. "adds the contents of the new file to the existing list. If @env{HOSTFILE} "
  9652. "is set, but has no value, or does not name a readable file, Bash attempts to "
  9653. "read @file{/etc/hosts} to obtain the list of possible hostname completions. "
  9654. "When @env{HOSTFILE} is unset, the hostname list is cleared."
  9655. msgstr ""
  9656. #. type: item
  9657. #: ./bashref.texi:5907
  9658. #, no-wrap
  9659. msgid "HOSTNAME"
  9660. msgstr ""
  9661. #. type: Plain text
  9662. #: ./bashref.texi:5909
  9663. msgid "The name of the current host."
  9664. msgstr ""
  9665. #. type: item
  9666. #: ./bashref.texi:5910
  9667. #, no-wrap
  9668. msgid "HOSTTYPE"
  9669. msgstr ""
  9670. #. type: Plain text
  9671. #: ./bashref.texi:5912
  9672. msgid "A string describing the machine Bash is running on."
  9673. msgstr ""
  9674. #. type: item
  9675. #: ./bashref.texi:5913
  9676. #, no-wrap
  9677. msgid "IGNOREEOF"
  9678. msgstr ""
  9679. #. type: Plain text
  9680. #: ./bashref.texi:5922
  9681. msgid ""
  9682. "Controls the action of the shell on receipt of an @code{EOF} character as "
  9683. "the sole input. If set, the value denotes the number of consecutive "
  9684. "@code{EOF} characters that can be read as the first character on an input "
  9685. "line before the shell will exit. If the variable exists but does not have a "
  9686. "numeric value (or has no value) then the default is 10. If the variable "
  9687. "does not exist, then @code{EOF} signifies the end of input to the shell. "
  9688. "This is only in effect for interactive shells."
  9689. msgstr ""
  9690. #. type: item
  9691. #: ./bashref.texi:5923
  9692. #, no-wrap
  9693. msgid "INPUTRC"
  9694. msgstr ""
  9695. #. type: Plain text
  9696. #: ./bashref.texi:5926
  9697. msgid ""
  9698. "The name of the Readline initialization file, overriding the default of "
  9699. "@file{~/.inputrc}."
  9700. msgstr ""
  9701. #. type: item
  9702. #: ./bashref.texi:5927
  9703. #, no-wrap
  9704. msgid "LANG"
  9705. msgstr ""
  9706. #. type: Plain text
  9707. #: ./bashref.texi:5930
  9708. msgid ""
  9709. "Used to determine the locale category for any category not specifically "
  9710. "selected with a variable starting with @code{LC_}."
  9711. msgstr ""
  9712. #. type: item
  9713. #: ./bashref.texi:5931
  9714. #, no-wrap
  9715. msgid "LC_ALL"
  9716. msgstr ""
  9717. #. type: Plain text
  9718. #: ./bashref.texi:5934
  9719. msgid ""
  9720. "This variable overrides the value of @env{LANG} and any other @code{LC_} "
  9721. "variable specifying a locale category."
  9722. msgstr ""
  9723. #. type: item
  9724. #: ./bashref.texi:5935
  9725. #, no-wrap
  9726. msgid "LC_COLLATE"
  9727. msgstr ""
  9728. #. type: Plain text
  9729. #: ./bashref.texi:5941
  9730. msgid ""
  9731. "This variable determines the collation order used when sorting the results "
  9732. "of filename expansion, and determines the behavior of range expressions, "
  9733. "equivalence classes, and collating sequences within filename expansion and "
  9734. "pattern matching (@pxref{Filename Expansion})."
  9735. msgstr ""
  9736. #. type: item
  9737. #: ./bashref.texi:5942
  9738. #, no-wrap
  9739. msgid "LC_CTYPE"
  9740. msgstr ""
  9741. #. type: Plain text
  9742. #: ./bashref.texi:5946
  9743. msgid ""
  9744. "This variable determines the interpretation of characters and the behavior "
  9745. "of character classes within filename expansion and pattern matching "
  9746. "(@pxref{Filename Expansion})."
  9747. msgstr ""
  9748. #. type: Plain text
  9749. #: ./bashref.texi:5950
  9750. msgid ""
  9751. "This variable determines the locale used to translate double-quoted strings "
  9752. "preceded by a @samp{$} (@pxref{Locale Translation})."
  9753. msgstr ""
  9754. #. type: item
  9755. #: ./bashref.texi:5951
  9756. #, no-wrap
  9757. msgid "LC_NUMERIC"
  9758. msgstr ""
  9759. #. type: Plain text
  9760. #: ./bashref.texi:5953
  9761. msgid "This variable determines the locale category used for number formatting."
  9762. msgstr ""
  9763. #. type: item
  9764. #: ./bashref.texi:5954
  9765. #, no-wrap
  9766. msgid "LC_TIME"
  9767. msgstr ""
  9768. #. type: Plain text
  9769. #: ./bashref.texi:5957
  9770. msgid ""
  9771. "This variable determines the locale category used for data and time "
  9772. "formatting."
  9773. msgstr ""
  9774. #. type: item
  9775. #: ./bashref.texi:5958
  9776. #, no-wrap
  9777. msgid "LINENO"
  9778. msgstr ""
  9779. #. type: Plain text
  9780. #: ./bashref.texi:5960
  9781. msgid "The line number in the script or shell function currently executing."
  9782. msgstr ""
  9783. #. type: item
  9784. #: ./bashref.texi:5961
  9785. #, no-wrap
  9786. msgid "LINES"
  9787. msgstr ""
  9788. #. type: Plain text
  9789. #: ./bashref.texi:5967
  9790. msgid ""
  9791. "Used by the @code{select} command to determine the column length for "
  9792. "printing selection lists. Automatically set if the @code{checkwinsize} "
  9793. "option is enabled (@pxref{The Shopt Builtin}), or in an interactive shell "
  9794. "upon receipt of a @code{SIGWINCH}."
  9795. msgstr ""
  9796. #. type: item
  9797. #: ./bashref.texi:5968
  9798. #, no-wrap
  9799. msgid "MACHTYPE"
  9800. msgstr ""
  9801. #. type: Plain text
  9802. #: ./bashref.texi:5971
  9803. msgid ""
  9804. "A string that fully describes the system type on which Bash is executing, in "
  9805. "the standard @sc{gnu} @var{cpu-company-system} format."
  9806. msgstr ""
  9807. #. type: item
  9808. #: ./bashref.texi:5972
  9809. #, no-wrap
  9810. msgid "MAILCHECK"
  9811. msgstr ""
  9812. #. type: Plain text
  9813. #: ./bashref.texi:5979
  9814. msgid ""
  9815. "How often (in seconds) that the shell should check for mail in the files "
  9816. "specified in the @env{MAILPATH} or @env{MAIL} variables. The default is 60 "
  9817. "seconds. When it is time to check for mail, the shell does so before "
  9818. "displaying the primary prompt. If this variable is unset, or set to a value "
  9819. "that is not a number greater than or equal to zero, the shell disables mail "
  9820. "checking."
  9821. msgstr ""
  9822. #. type: item
  9823. #: ./bashref.texi:5980
  9824. #, no-wrap
  9825. msgid "MAPFILE"
  9826. msgstr ""
  9827. #. type: Plain text
  9828. #: ./bashref.texi:5983
  9829. msgid ""
  9830. "An array variable created to hold the text read by the @code{mapfile} "
  9831. "builtin when no variable name is supplied."
  9832. msgstr ""
  9833. #. type: item
  9834. #: ./bashref.texi:5984
  9835. #, no-wrap
  9836. msgid "OLDPWD"
  9837. msgstr ""
  9838. #. type: Plain text
  9839. #: ./bashref.texi:5986
  9840. msgid "The previous working directory as set by the @code{cd} builtin."
  9841. msgstr ""
  9842. #. type: item
  9843. #: ./bashref.texi:5987
  9844. #, no-wrap
  9845. msgid "OPTERR"
  9846. msgstr ""
  9847. #. type: Plain text
  9848. #: ./bashref.texi:5990
  9849. msgid ""
  9850. "If set to the value 1, Bash displays error messages generated by the "
  9851. "@code{getopts} builtin command."
  9852. msgstr ""
  9853. #. type: item
  9854. #: ./bashref.texi:5991
  9855. #, no-wrap
  9856. msgid "OSTYPE"
  9857. msgstr ""
  9858. #. type: Plain text
  9859. #: ./bashref.texi:5993
  9860. msgid "A string describing the operating system Bash is running on."
  9861. msgstr ""
  9862. #. type: item
  9863. #: ./bashref.texi:5994
  9864. #, no-wrap
  9865. msgid "PIPESTATUS"
  9866. msgstr ""
  9867. #. type: Plain text
  9868. #: ./bashref.texi:5999
  9869. msgid ""
  9870. "An array variable (@pxref{Arrays}) containing a list of exit status values "
  9871. "from the processes in the most-recently-executed foreground pipeline (which "
  9872. "may contain only a single command)."
  9873. msgstr ""
  9874. #. type: item
  9875. #: ./bashref.texi:6000
  9876. #, no-wrap
  9877. msgid "POSIXLY_CORRECT"
  9878. msgstr ""
  9879. #. type: Plain text
  9880. #: ./bashref.texi:6006
  9881. msgid ""
  9882. "If this variable is in the environment when Bash starts, the shell enters "
  9883. "@sc{posix} mode (@pxref{Bash POSIX Mode}) before reading the startup files, "
  9884. "as if the @option{--posix} invocation option had been supplied. If it is "
  9885. "set while the shell is running, Bash enables @sc{posix} mode, as if the "
  9886. "command"
  9887. msgstr ""
  9888. #. type: example
  9889. #: ./bashref.texi:6008
  9890. #, no-wrap
  9891. msgid "@code{set -o posix}\n"
  9892. msgstr ""
  9893. #. type: Plain text
  9894. #: ./bashref.texi:6011
  9895. msgid "had been executed."
  9896. msgstr ""
  9897. #. type: item
  9898. #: ./bashref.texi:6012
  9899. #, no-wrap
  9900. msgid "PPID"
  9901. msgstr ""
  9902. #. type: Plain text
  9903. #: ./bashref.texi:6015
  9904. msgid ""
  9905. "The process @sc{id} of the shell's parent process. This variable is "
  9906. "readonly."
  9907. msgstr ""
  9908. #. type: item
  9909. #: ./bashref.texi:6016
  9910. #, no-wrap
  9911. msgid "PROMPT_COMMAND"
  9912. msgstr ""
  9913. #. type: Plain text
  9914. #: ./bashref.texi:6019
  9915. msgid ""
  9916. "If set, the value is interpreted as a command to execute before the printing "
  9917. "of each primary prompt (@env{$PS1})."
  9918. msgstr ""
  9919. #. type: item
  9920. #: ./bashref.texi:6020
  9921. #, no-wrap
  9922. msgid "PROMPT_DIRTRIM"
  9923. msgstr ""
  9924. #. type: Plain text
  9925. #: ./bashref.texi:6025
  9926. msgid ""
  9927. "If set to a number greater than zero, the value is used as the number of "
  9928. "trailing directory components to retain when expanding the @code{\\w} and "
  9929. "@code{\\W} prompt string escapes (@pxref{Controlling the Prompt}). "
  9930. "Characters removed are replaced with an ellipsis."
  9931. msgstr ""
  9932. #. type: item
  9933. #: ./bashref.texi:6026
  9934. #, no-wrap
  9935. msgid "PS0"
  9936. msgstr ""
  9937. #. type: Plain text
  9938. #: ./bashref.texi:6030
  9939. msgid ""
  9940. "The value of this parameter is expanded like @var{PS1} and displayed by "
  9941. "interactive shells after reading a command and before the command is "
  9942. "executed."
  9943. msgstr ""
  9944. #. type: item
  9945. #: ./bashref.texi:6031
  9946. #, no-wrap
  9947. msgid "PS3"
  9948. msgstr ""
  9949. #. type: Plain text
  9950. #: ./bashref.texi:6035
  9951. msgid ""
  9952. "The value of this variable is used as the prompt for the @code{select} "
  9953. "command. If this variable is not set, the @code{select} command prompts "
  9954. "with @samp{#? }"
  9955. msgstr ""
  9956. #. type: item
  9957. #: ./bashref.texi:6036
  9958. #, no-wrap
  9959. msgid "PS4"
  9960. msgstr ""
  9961. #. type: Plain text
  9962. #: ./bashref.texi:6042
  9963. msgid ""
  9964. "The value is the prompt printed before the command line is echoed when the "
  9965. "@option{-x} option is set (@pxref{The Set Builtin}). The first character of "
  9966. "@env{PS4} is replicated multiple times, as necessary, to indicate multiple "
  9967. "levels of indirection. The default is @samp{+ }."
  9968. msgstr ""
  9969. #. type: item
  9970. #: ./bashref.texi:6043
  9971. #, no-wrap
  9972. msgid "PWD"
  9973. msgstr ""
  9974. #. type: Plain text
  9975. #: ./bashref.texi:6045
  9976. msgid "The current working directory as set by the @code{cd} builtin."
  9977. msgstr ""
  9978. #. type: item
  9979. #: ./bashref.texi:6046
  9980. #, no-wrap
  9981. msgid "RANDOM"
  9982. msgstr ""
  9983. #. type: Plain text
  9984. #: ./bashref.texi:6050
  9985. msgid ""
  9986. "Each time this parameter is referenced, a random integer between 0 and 32767 "
  9987. "is generated. Assigning a value to this variable seeds the random number "
  9988. "generator."
  9989. msgstr ""
  9990. #. type: item
  9991. #: ./bashref.texi:6051
  9992. #, no-wrap
  9993. msgid "READLINE_LINE"
  9994. msgstr ""
  9995. #. type: Plain text
  9996. #: ./bashref.texi:6054
  9997. msgid ""
  9998. "The contents of the Readline line buffer, for use with @samp{bind -x} "
  9999. "(@pxref{Bash Builtins})."
  10000. msgstr ""
  10001. #. type: item
  10002. #: ./bashref.texi:6055
  10003. #, no-wrap
  10004. msgid "READLINE_POINT"
  10005. msgstr ""
  10006. #. type: Plain text
  10007. #: ./bashref.texi:6058
  10008. msgid ""
  10009. "The position of the insertion point in the Readline line buffer, for use "
  10010. "with @samp{bind -x} (@pxref{Bash Builtins})."
  10011. msgstr ""
  10012. #. type: item
  10013. #: ./bashref.texi:6059
  10014. #, no-wrap
  10015. msgid "REPLY"
  10016. msgstr ""
  10017. #. type: Plain text
  10018. #: ./bashref.texi:6061
  10019. msgid "The default variable for the @code{read} builtin."
  10020. msgstr ""
  10021. #. type: item
  10022. #: ./bashref.texi:6062
  10023. #, no-wrap
  10024. msgid "SECONDS"
  10025. msgstr ""
  10026. #. type: Plain text
  10027. #: ./bashref.texi:6068
  10028. msgid ""
  10029. "This variable expands to the number of seconds since the shell was started. "
  10030. "Assignment to this variable resets the count to the value assigned, and the "
  10031. "expanded value becomes the value assigned plus the number of seconds since "
  10032. "the assignment."
  10033. msgstr ""
  10034. #. type: item
  10035. #: ./bashref.texi:6069
  10036. #, no-wrap
  10037. msgid "SHELL"
  10038. msgstr ""
  10039. #. type: Plain text
  10040. #: ./bashref.texi:6073
  10041. msgid ""
  10042. "The full pathname to the shell is kept in this environment variable. If it "
  10043. "is not set when the shell starts, Bash assigns to it the full pathname of "
  10044. "the current user's login shell."
  10045. msgstr ""
  10046. #. type: item
  10047. #: ./bashref.texi:6074
  10048. #, no-wrap
  10049. msgid "SHELLOPTS"
  10050. msgstr ""
  10051. #. type: Plain text
  10052. #: ./bashref.texi:6083
  10053. msgid ""
  10054. "A colon-separated list of enabled shell options. Each word in the list is a "
  10055. "valid argument for the @option{-o} option to the @code{set} builtin command "
  10056. "(@pxref{The Set Builtin}). The options appearing in @env{SHELLOPTS} are "
  10057. "those reported as @samp{on} by @samp{set -o}. If this variable is in the "
  10058. "environment when Bash starts up, each shell option in the list will be "
  10059. "enabled before reading any startup files. This variable is readonly."
  10060. msgstr ""
  10061. #. type: item
  10062. #: ./bashref.texi:6084
  10063. #, no-wrap
  10064. msgid "SHLVL"
  10065. msgstr ""
  10066. #. type: Plain text
  10067. #: ./bashref.texi:6087
  10068. msgid ""
  10069. "Incremented by one each time a new instance of Bash is started. This is "
  10070. "intended to be a count of how deeply your Bash shells are nested."
  10071. msgstr ""
  10072. #. type: item
  10073. #: ./bashref.texi:6088
  10074. #, no-wrap
  10075. msgid "TIMEFORMAT"
  10076. msgstr ""
  10077. #. type: Plain text
  10078. #: ./bashref.texi:6097
  10079. msgid ""
  10080. "The value of this parameter is used as a format string specifying how the "
  10081. "timing information for pipelines prefixed with the @code{time} reserved word "
  10082. "should be displayed. The @samp{%} character introduces an escape sequence "
  10083. "that is expanded to a time value or other information. The escape sequences "
  10084. "and their meanings are as follows; the braces denote optional portions."
  10085. msgstr ""
  10086. #. type: item
  10087. #: ./bashref.texi:6100
  10088. #, no-wrap
  10089. msgid "%%"
  10090. msgstr ""
  10091. #. type: table
  10092. #: ./bashref.texi:6102
  10093. msgid "A literal @samp{%}."
  10094. msgstr ""
  10095. #. type: item
  10096. #: ./bashref.texi:6103
  10097. #, no-wrap
  10098. msgid "%[@var{p}][l]R"
  10099. msgstr ""
  10100. #. type: table
  10101. #: ./bashref.texi:6105
  10102. msgid "The elapsed time in seconds."
  10103. msgstr ""
  10104. #. type: item
  10105. #: ./bashref.texi:6106
  10106. #, no-wrap
  10107. msgid "%[@var{p}][l]U"
  10108. msgstr ""
  10109. #. type: table
  10110. #: ./bashref.texi:6108
  10111. msgid "The number of CPU seconds spent in user mode."
  10112. msgstr ""
  10113. #. type: item
  10114. #: ./bashref.texi:6109
  10115. #, no-wrap
  10116. msgid "%[@var{p}][l]S"
  10117. msgstr ""
  10118. #. type: table
  10119. #: ./bashref.texi:6111
  10120. msgid "The number of CPU seconds spent in system mode."
  10121. msgstr ""
  10122. #. type: item
  10123. #: ./bashref.texi:6112
  10124. #, no-wrap
  10125. msgid "%P"
  10126. msgstr ""
  10127. #. type: table
  10128. #: ./bashref.texi:6114
  10129. msgid "The CPU percentage, computed as (%U + %S) / %R."
  10130. msgstr ""
  10131. #. type: Plain text
  10132. #: ./bashref.texi:6122
  10133. msgid ""
  10134. "The optional @var{p} is a digit specifying the precision, the number of "
  10135. "fractional digits after a decimal point. A value of 0 causes no decimal "
  10136. "point or fraction to be output. At most three places after the decimal "
  10137. "point may be specified; values of @var{p} greater than 3 are changed to 3. "
  10138. "If @var{p} is not specified, the value 3 is used."
  10139. msgstr ""
  10140. #. type: Plain text
  10141. #: ./bashref.texi:6126
  10142. msgid ""
  10143. "The optional @code{l} specifies a longer format, including minutes, of the "
  10144. "form @var{MM}m@var{SS}.@var{FF}s. The value of @var{p} determines whether "
  10145. "or not the fraction is included."
  10146. msgstr ""
  10147. #. type: Plain text
  10148. #: ./bashref.texi:6128
  10149. msgid "If this variable is not set, Bash acts as if it had the value"
  10150. msgstr ""
  10151. #. type: example
  10152. #: ./bashref.texi:6130
  10153. #, no-wrap
  10154. msgid "@code{$'\\nreal\\t%3lR\\nuser\\t%3lU\\nsys\\t%3lS'}\n"
  10155. msgstr ""
  10156. #. type: Plain text
  10157. #: ./bashref.texi:6133
  10158. msgid ""
  10159. "If the value is null, no timing information is displayed. A trailing "
  10160. "newline is added when the format string is displayed."
  10161. msgstr ""
  10162. #. type: item
  10163. #: ./bashref.texi:6134
  10164. #, no-wrap
  10165. msgid "TMOUT"
  10166. msgstr ""
  10167. #. type: Plain text
  10168. #: ./bashref.texi:6140
  10169. msgid ""
  10170. "If set to a value greater than zero, @code{TMOUT} is treated as the default "
  10171. "timeout for the @code{read} builtin (@pxref{Bash Builtins}). The "
  10172. "@code{select} command (@pxref{Conditional Constructs}) terminates if input "
  10173. "does not arrive after @code{TMOUT} seconds when input is coming from a "
  10174. "terminal."
  10175. msgstr ""
  10176. #. type: Plain text
  10177. #: ./bashref.texi:6147
  10178. msgid ""
  10179. "In an interactive shell, the value is interpreted as the number of seconds "
  10180. "to wait for a line of input after issuing the primary prompt. Bash "
  10181. "terminates after waiting for that number of seconds if a complete line of "
  10182. "input does not arrive."
  10183. msgstr ""
  10184. #. type: item
  10185. #: ./bashref.texi:6148
  10186. #, no-wrap
  10187. msgid "TMPDIR"
  10188. msgstr ""
  10189. #. type: Plain text
  10190. #: ./bashref.texi:6151
  10191. msgid ""
  10192. "If set, Bash uses its value as the name of a directory in which Bash creates "
  10193. "temporary files for the shell's use."
  10194. msgstr ""
  10195. #. type: item
  10196. #: ./bashref.texi:6152
  10197. #, no-wrap
  10198. msgid "UID"
  10199. msgstr ""
  10200. #. type: Plain text
  10201. #: ./bashref.texi:6154
  10202. msgid "The numeric real user id of the current user. This variable is readonly."
  10203. msgstr ""
  10204. #. type: Plain text
  10205. #: ./bashref.texi:6161
  10206. msgid "This chapter describes features unique to Bash."
  10207. msgstr ""
  10208. #. type: section
  10209. #: ./bashref.texi:6177 ./bashref.texi:6179 ./bashref.texi:6180
  10210. #, no-wrap
  10211. msgid "Invoking Bash"
  10212. msgstr ""
  10213. #. type: menuentry
  10214. #: ./bashref.texi:6177
  10215. msgid "Command line options that you can give to Bash."
  10216. msgstr ""
  10217. #. type: section
  10218. #: ./bashref.texi:6177 ./bashref.texi:6338 ./bashref.texi:6339
  10219. #, no-wrap
  10220. msgid "Bash Startup Files"
  10221. msgstr ""
  10222. #. type: menuentry
  10223. #: ./bashref.texi:6177
  10224. msgid "When and how Bash executes scripts."
  10225. msgstr ""
  10226. #. type: section
  10227. #: ./bashref.texi:6177 ./bashref.texi:6456 ./bashref.texi:6457
  10228. #, no-wrap
  10229. msgid "Interactive Shells"
  10230. msgstr ""
  10231. #. type: menuentry
  10232. #: ./bashref.texi:6177
  10233. msgid "What an interactive shell is."
  10234. msgstr ""
  10235. #. type: section
  10236. #: ./bashref.texi:6177 ./bashref.texi:6614 ./bashref.texi:6615
  10237. #, no-wrap
  10238. msgid "Bash Conditional Expressions"
  10239. msgstr ""
  10240. #. type: menuentry
  10241. #: ./bashref.texi:6177
  10242. msgid "Primitives used in composing expressions for the @code{test} builtin."
  10243. msgstr ""
  10244. #. type: section
  10245. #: ./bashref.texi:6177 ./bashref.texi:6763 ./bashref.texi:6764
  10246. #, no-wrap
  10247. msgid "Shell Arithmetic"
  10248. msgstr ""
  10249. #. type: menuentry
  10250. #: ./bashref.texi:6177
  10251. msgid "Arithmetic on shell variables."
  10252. msgstr ""
  10253. #. type: section
  10254. #: ./bashref.texi:6177 ./bashref.texi:6870 ./bashref.texi:6871
  10255. #, no-wrap
  10256. msgid "Aliases"
  10257. msgstr ""
  10258. #. type: menuentry
  10259. #: ./bashref.texi:6177
  10260. msgid "Substituting one command for another."
  10261. msgstr ""
  10262. #. type: section
  10263. #: ./bashref.texi:6177 ./bashref.texi:6930 ./bashref.texi:6931
  10264. #, no-wrap
  10265. msgid "Arrays"
  10266. msgstr ""
  10267. #. type: menuentry
  10268. #: ./bashref.texi:6177
  10269. msgid "Array Variables."
  10270. msgstr ""
  10271. #. type: section
  10272. #: ./bashref.texi:6177 ./bashref.texi:7067 ./bashref.texi:7068
  10273. #, no-wrap
  10274. msgid "The Directory Stack"
  10275. msgstr ""
  10276. #. type: menuentry
  10277. #: ./bashref.texi:6177
  10278. msgid "History of visited directories."
  10279. msgstr ""
  10280. #. type: section
  10281. #: ./bashref.texi:6177 ./bashref.texi:7179 ./bashref.texi:7180
  10282. #, no-wrap
  10283. msgid "Controlling the Prompt"
  10284. msgstr ""
  10285. #. type: menuentry
  10286. #: ./bashref.texi:6177
  10287. msgid "Customizing the various prompt strings."
  10288. msgstr ""
  10289. #. type: section
  10290. #: ./bashref.texi:6177 ./bashref.texi:7265 ./bashref.texi:7266
  10291. #, no-wrap
  10292. msgid "The Restricted Shell"
  10293. msgstr ""
  10294. #. type: menuentry
  10295. #: ./bashref.texi:6177
  10296. msgid "A more controlled mode of shell execution."
  10297. msgstr ""
  10298. #. type: section
  10299. #: ./bashref.texi:6177 ./bashref.texi:7319 ./bashref.texi:7320
  10300. #, no-wrap
  10301. msgid "Bash POSIX Mode"
  10302. msgstr ""
  10303. #. type: menuentry
  10304. #: ./bashref.texi:6177
  10305. msgid "Making Bash behave more closely to what the POSIX standard specifies."
  10306. msgstr ""
  10307. #. type: example
  10308. #: ./bashref.texi:6186
  10309. #, no-wrap
  10310. msgid ""
  10311. "bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @var{option}] [-O "
  10312. "@var{shopt_option}] [@var{argument} @dots{}]\n"
  10313. "bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @var{option}] [-O "
  10314. "@var{shopt_option}] -c @var{string} [@var{argument} @dots{}]\n"
  10315. "bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @var{option}] [-O "
  10316. "@var{shopt_option}] [@var{argument} @dots{}]\n"
  10317. msgstr ""
  10318. #. type: Plain text
  10319. #: ./bashref.texi:6193
  10320. msgid ""
  10321. "All of the single-character options used with the @code{set} builtin "
  10322. "(@pxref{The Set Builtin}) can be used as options when the shell is invoked. "
  10323. "In addition, there are several multi-character options that you can use. "
  10324. "These options must appear on the command line before the single-character "
  10325. "options to be recognized."
  10326. msgstr ""
  10327. #. type: item
  10328. #: ./bashref.texi:6195
  10329. #, no-wrap
  10330. msgid "--debugger"
  10331. msgstr ""
  10332. #. type: table
  10333. #: ./bashref.texi:6200
  10334. msgid ""
  10335. "Arrange for the debugger profile to be executed before the shell starts. "
  10336. "Turns on extended debugging mode (see @ref{The Shopt Builtin} for a "
  10337. "description of the @code{extdebug} option to the @code{shopt} builtin)."
  10338. msgstr ""
  10339. #. type: item
  10340. #: ./bashref.texi:6201
  10341. #, no-wrap
  10342. msgid "--dump-po-strings"
  10343. msgstr ""
  10344. #. type: table
  10345. #: ./bashref.texi:6206
  10346. msgid ""
  10347. "A list of all double-quoted strings preceded by @samp{$} is printed on the "
  10348. "standard output in the @sc{gnu} @code{gettext} PO (portable object) file "
  10349. "format. Equivalent to @option{-D} except for the output format."
  10350. msgstr ""
  10351. #. type: item
  10352. #: ./bashref.texi:6207
  10353. #, no-wrap
  10354. msgid "--dump-strings"
  10355. msgstr ""
  10356. #. type: table
  10357. #: ./bashref.texi:6209
  10358. msgid "Equivalent to @option{-D}."
  10359. msgstr ""
  10360. #. type: item
  10361. #: ./bashref.texi:6210 ./bashref.texi:8140
  10362. #, no-wrap
  10363. msgid "--help"
  10364. msgstr ""
  10365. #. type: table
  10366. #: ./bashref.texi:6212
  10367. msgid "Display a usage message on standard output and exit successfully."
  10368. msgstr ""
  10369. #. type: item
  10370. #: ./bashref.texi:6213
  10371. #, no-wrap
  10372. msgid "--init-file @var{filename}"
  10373. msgstr ""
  10374. #. type: itemx
  10375. #: ./bashref.texi:6214
  10376. #, no-wrap
  10377. msgid "--rcfile @var{filename}"
  10378. msgstr ""
  10379. #. type: table
  10380. #: ./bashref.texi:6217
  10381. msgid ""
  10382. "Execute commands from @var{filename} (instead of @file{~/.bashrc}) in an "
  10383. "interactive shell."
  10384. msgstr ""
  10385. #. type: item
  10386. #: ./bashref.texi:6218
  10387. #, no-wrap
  10388. msgid "--login"
  10389. msgstr ""
  10390. #. type: table
  10391. #: ./bashref.texi:6220
  10392. msgid "Equivalent to @option{-l}."
  10393. msgstr ""
  10394. #. type: item
  10395. #: ./bashref.texi:6221
  10396. #, no-wrap
  10397. msgid "--noediting"
  10398. msgstr ""
  10399. #. type: table
  10400. #: ./bashref.texi:6224
  10401. msgid ""
  10402. "Do not use the @sc{gnu} Readline library (@pxref{Command Line Editing}) to "
  10403. "read command lines when the shell is interactive."
  10404. msgstr ""
  10405. #. type: item
  10406. #: ./bashref.texi:6225
  10407. #, no-wrap
  10408. msgid "--noprofile"
  10409. msgstr ""
  10410. #. type: table
  10411. #: ./bashref.texi:6230
  10412. msgid ""
  10413. "Don't load the system-wide startup file @file{/etc/profile} or any of the "
  10414. "personal initialization files @file{~/.bash_profile}, @file{~/.bash_login}, "
  10415. "or @file{~/.profile} when Bash is invoked as a login shell."
  10416. msgstr ""
  10417. #. type: item
  10418. #: ./bashref.texi:6231
  10419. #, no-wrap
  10420. msgid "--norc"
  10421. msgstr ""
  10422. #. type: table
  10423. #: ./bashref.texi:6235
  10424. msgid ""
  10425. "Don't read the @file{~/.bashrc} initialization file in an interactive "
  10426. "shell. This is on by default if the shell is invoked as @code{sh}."
  10427. msgstr ""
  10428. #. type: item
  10429. #: ./bashref.texi:6236
  10430. #, no-wrap
  10431. msgid "--posix"
  10432. msgstr ""
  10433. #. type: table
  10434. #: ./bashref.texi:6242
  10435. msgid ""
  10436. "Change the behavior of Bash where the default operation differs from the "
  10437. "@sc{posix} standard to match the standard. This is intended to make Bash "
  10438. "behave as a strict superset of that standard. @xref{Bash POSIX Mode}, for a "
  10439. "description of the Bash @sc{posix} mode."
  10440. msgstr ""
  10441. #. type: item
  10442. #: ./bashref.texi:6243
  10443. #, no-wrap
  10444. msgid "--restricted"
  10445. msgstr ""
  10446. #. type: table
  10447. #: ./bashref.texi:6245 ./bashref.texi:6284
  10448. msgid "Make the shell a restricted shell (@pxref{The Restricted Shell})."
  10449. msgstr ""
  10450. #. type: item
  10451. #: ./bashref.texi:6246
  10452. #, no-wrap
  10453. msgid "--verbose"
  10454. msgstr ""
  10455. #. type: table
  10456. #: ./bashref.texi:6248
  10457. msgid "Equivalent to @option{-v}. Print shell input lines as they're read."
  10458. msgstr ""
  10459. #. type: item
  10460. #: ./bashref.texi:6249 ./bashref.texi:8152
  10461. #, no-wrap
  10462. msgid "--version"
  10463. msgstr ""
  10464. #. type: table
  10465. #: ./bashref.texi:6252
  10466. msgid ""
  10467. "Show version information for this instance of Bash on the standard output "
  10468. "and exit successfully."
  10469. msgstr ""
  10470. #. type: Plain text
  10471. #: ./bashref.texi:6256
  10472. msgid ""
  10473. "There are several single-character options that may be supplied at "
  10474. "invocation which are not available with the @code{set} builtin."
  10475. msgstr ""
  10476. #. type: table
  10477. #: ./bashref.texi:6266
  10478. msgid ""
  10479. "Read and execute commands from the first non-option argument "
  10480. "@var{command_string}, then exit. If there are arguments after the "
  10481. "@var{command_string}, the first argument is assigned to @code{$0} and any "
  10482. "remaining arguments are assigned to the positional parameters. The "
  10483. "assignment to @code{$0} sets the name of the shell, which is used in warning "
  10484. "and error messages."
  10485. msgstr ""
  10486. #. type: table
  10487. #: ./bashref.texi:6270
  10488. msgid ""
  10489. "Force the shell to run interactively. Interactive shells are described in "
  10490. "@ref{Interactive Shells}."
  10491. msgstr ""
  10492. #. type: table
  10493. #: ./bashref.texi:6281
  10494. msgid ""
  10495. "Make this shell act as if it had been directly invoked by login. When the "
  10496. "shell is interactive, this is equivalent to starting a login shell with "
  10497. "@samp{exec -l bash}. When the shell is not interactive, the login shell "
  10498. "startup files will be executed. @samp{exec bash -l} or @samp{exec bash "
  10499. "--login} will replace the current shell with a Bash login shell. @xref{Bash "
  10500. "Startup Files}, for a description of the special behavior of a login shell."
  10501. msgstr ""
  10502. #. type: table
  10503. #: ./bashref.texi:6290
  10504. msgid ""
  10505. "If this option is present, or if no arguments remain after option "
  10506. "processing, then commands are read from the standard input. This option "
  10507. "allows the positional parameters to be set when invoking an interactive "
  10508. "shell."
  10509. msgstr ""
  10510. #. type: item
  10511. #: ./bashref.texi:6291
  10512. #, no-wrap
  10513. msgid "-D"
  10514. msgstr ""
  10515. #. type: table
  10516. #: ./bashref.texi:6298
  10517. msgid ""
  10518. "A list of all double-quoted strings preceded by @samp{$} is printed on the "
  10519. "standard output. These are the strings that are subject to language "
  10520. "translation when the current locale is not @code{C} or @code{POSIX} "
  10521. "(@pxref{Locale Translation}). This implies the @option{-n} option; no "
  10522. "commands will be executed."
  10523. msgstr ""
  10524. #. type: item
  10525. #: ./bashref.texi:6299
  10526. #, no-wrap
  10527. msgid "[-+]O [@var{shopt_option}]"
  10528. msgstr ""
  10529. #. type: table
  10530. #: ./bashref.texi:6308
  10531. msgid ""
  10532. "@var{shopt_option} is one of the shell options accepted by the @code{shopt} "
  10533. "builtin (@pxref{The Shopt Builtin}). If @var{shopt_option} is present, "
  10534. "@option{-O} sets the value of that option; @option{+O} unsets it. If "
  10535. "@var{shopt_option} is not supplied, the names and values of the shell "
  10536. "options accepted by @code{shopt} are printed on the standard output. If the "
  10537. "invocation option is @option{+O}, the output is displayed in a format that "
  10538. "may be reused as input."
  10539. msgstr ""
  10540. #. type: table
  10541. #: ./bashref.texi:6313
  10542. msgid ""
  10543. "A @code{--} signals the end of options and disables further option "
  10544. "processing. Any arguments after the @code{--} are treated as filenames and "
  10545. "arguments."
  10546. msgstr ""
  10547. #. type: cindex
  10548. #: ./bashref.texi:6315
  10549. #, no-wrap
  10550. msgid "login shell"
  10551. msgstr ""
  10552. #. type: Plain text
  10553. #: ./bashref.texi:6318
  10554. msgid ""
  10555. "A @emph{login} shell is one whose first character of argument zero is "
  10556. "@samp{-}, or one invoked with the @option{--login} option."
  10557. msgstr ""
  10558. #. type: cindex
  10559. #: ./bashref.texi:6319 ./bashref.texi:6458
  10560. #, no-wrap
  10561. msgid "interactive shell"
  10562. msgstr ""
  10563. #. type: Plain text
  10564. #: ./bashref.texi:6326
  10565. msgid ""
  10566. "An @emph{interactive} shell is one started without non-option arguments, "
  10567. "unless @option{-s} is specified, without specifying the @option{-c} option, "
  10568. "and whose input and output are both connected to terminals (as determined by "
  10569. "@code{isatty(3)}), or one started with the @option{-i} option. "
  10570. "@xref{Interactive Shells}, for more information."
  10571. msgstr ""
  10572. #. type: Plain text
  10573. #: ./bashref.texi:6337
  10574. msgid ""
  10575. "If arguments remain after option processing, and neither the @option{-c} nor "
  10576. "the @option{-s} option has been supplied, the first argument is assumed to "
  10577. "be the name of a file containing shell commands (@pxref{Shell Scripts}). "
  10578. "When Bash is invoked in this fashion, @code{$0} is set to the name of the "
  10579. "file, and the positional parameters are set to the remaining arguments. "
  10580. "Bash reads and executes commands from this file, then exits. Bash's exit "
  10581. "status is the exit status of the last command executed in the script. If no "
  10582. "commands are executed, the exit status is 0."
  10583. msgstr ""
  10584. #. type: cindex
  10585. #: ./bashref.texi:6340
  10586. #, no-wrap
  10587. msgid "startup files"
  10588. msgstr ""
  10589. #. type: Plain text
  10590. #: ./bashref.texi:6346
  10591. msgid ""
  10592. "This section describes how Bash executes its startup files. If any of the "
  10593. "files exist but cannot be read, Bash reports an error. Tildes are expanded "
  10594. "in filenames as described above under Tilde Expansion (@pxref{Tilde "
  10595. "Expansion})."
  10596. msgstr ""
  10597. #. type: Plain text
  10598. #: ./bashref.texi:6348
  10599. msgid "Interactive shells are described in @ref{Interactive Shells}."
  10600. msgstr ""
  10601. #. type: subsubheading
  10602. #: ./bashref.texi:6349
  10603. #, no-wrap
  10604. msgid "Invoked as an interactive login shell, or with @option{--login}"
  10605. msgstr ""
  10606. #. type: Plain text
  10607. #: ./bashref.texi:6359
  10608. msgid ""
  10609. "When Bash is invoked as an interactive login shell, or as a non-interactive "
  10610. "shell with the @option{--login} option, it first reads and executes commands "
  10611. "from the file @file{/etc/profile}, if that file exists. After reading that "
  10612. "file, it looks for @file{~/.bash_profile}, @file{~/.bash_login}, and "
  10613. "@file{~/.profile}, in that order, and reads and executes commands from the "
  10614. "first one that exists and is readable. The @option{--noprofile} option may "
  10615. "be used when the shell is started to inhibit this behavior."
  10616. msgstr ""
  10617. #. type: Plain text
  10618. #: ./bashref.texi:6364
  10619. msgid ""
  10620. "When an interactive login shell exits, or a non-interactive login shell "
  10621. "executes the @code{exit} builtin command, Bash reads and executes commands "
  10622. "from the file @file{~/.bash_logout}, if it exists."
  10623. msgstr ""
  10624. #. type: subsubheading
  10625. #: ./bashref.texi:6365
  10626. #, no-wrap
  10627. msgid "Invoked as an interactive non-login shell"
  10628. msgstr ""
  10629. #. type: Plain text
  10630. #: ./bashref.texi:6372
  10631. msgid ""
  10632. "When an interactive shell that is not a login shell is started, Bash reads "
  10633. "and executes commands from @file{~/.bashrc}, if that file exists. This may "
  10634. "be inhibited by using the @option{--norc} option. The @option{--rcfile "
  10635. "@var{file}} option will force Bash to read and execute commands from "
  10636. "@var{file} instead of @file{~/.bashrc}."
  10637. msgstr ""
  10638. #. type: Plain text
  10639. #: ./bashref.texi:6374
  10640. msgid "So, typically, your @file{~/.bash_profile} contains the line"
  10641. msgstr ""
  10642. #. type: example
  10643. #: ./bashref.texi:6376
  10644. #, no-wrap
  10645. msgid "@code{if [ -f ~/.bashrc ]; then . ~/.bashrc; fi}\n"
  10646. msgstr ""
  10647. #. type: Plain text
  10648. #: ./bashref.texi:6379
  10649. msgid "after (or before) any login-specific initializations."
  10650. msgstr ""
  10651. #. type: subsubheading
  10652. #: ./bashref.texi:6380
  10653. #, no-wrap
  10654. msgid "Invoked non-interactively"
  10655. msgstr ""
  10656. #. type: Plain text
  10657. #: ./bashref.texi:6387
  10658. msgid ""
  10659. "When Bash is started non-interactively, to run a shell script, for example, "
  10660. "it looks for the variable @env{BASH_ENV} in the environment, expands its "
  10661. "value if it appears there, and uses the expanded value as the name of a file "
  10662. "to read and execute. Bash behaves as if the following command were "
  10663. "executed:"
  10664. msgstr ""
  10665. #. type: example
  10666. #: ./bashref.texi:6389
  10667. #, no-wrap
  10668. msgid "@code{if [ -n \"$BASH_ENV\" ]; then . \"$BASH_ENV\"; fi}\n"
  10669. msgstr ""
  10670. #. type: Plain text
  10671. #: ./bashref.texi:6393
  10672. msgid ""
  10673. "but the value of the @env{PATH} variable is not used to search for the "
  10674. "filename."
  10675. msgstr ""
  10676. #. type: Plain text
  10677. #: ./bashref.texi:6397
  10678. msgid ""
  10679. "As noted above, if a non-interactive shell is invoked with the "
  10680. "@option{--login} option, Bash attempts to read and execute commands from the "
  10681. "login shell startup files."
  10682. msgstr ""
  10683. #. type: subsubheading
  10684. #: ./bashref.texi:6398
  10685. #, no-wrap
  10686. msgid "Invoked with name @code{sh}"
  10687. msgstr ""
  10688. #. type: Plain text
  10689. #: ./bashref.texi:6403
  10690. msgid ""
  10691. "If Bash is invoked with the name @code{sh}, it tries to mimic the startup "
  10692. "behavior of historical versions of @code{sh} as closely as possible, while "
  10693. "conforming to the @sc{posix} standard as well."
  10694. msgstr ""
  10695. #. type: Plain text
  10696. #: ./bashref.texi:6417
  10697. msgid ""
  10698. "When invoked as an interactive login shell, or as a non-interactive shell "
  10699. "with the @option{--login} option, it first attempts to read and execute "
  10700. "commands from @file{/etc/profile} and @file{~/.profile}, in that order. The "
  10701. "@option{--noprofile} option may be used to inhibit this behavior. When "
  10702. "invoked as an interactive shell with the name @code{sh}, Bash looks for the "
  10703. "variable @env{ENV}, expands its value if it is defined, and uses the "
  10704. "expanded value as the name of a file to read and execute. Since a shell "
  10705. "invoked as @code{sh} does not attempt to read and execute commands from any "
  10706. "other startup files, the @option{--rcfile} option has no effect. A "
  10707. "non-interactive shell invoked with the name @code{sh} does not attempt to "
  10708. "read any other startup files."
  10709. msgstr ""
  10710. #. type: Plain text
  10711. #: ./bashref.texi:6420
  10712. msgid ""
  10713. "When invoked as @code{sh}, Bash enters @sc{posix} mode after the startup "
  10714. "files are read."
  10715. msgstr ""
  10716. #. type: subsubheading
  10717. #: ./bashref.texi:6421
  10718. #, no-wrap
  10719. msgid "Invoked in @sc{posix} mode"
  10720. msgstr ""
  10721. #. type: Plain text
  10722. #: ./bashref.texi:6430
  10723. msgid ""
  10724. "When Bash is started in @sc{posix} mode, as with the @option{--posix} "
  10725. "command line option, it follows the @sc{posix} standard for startup files. "
  10726. "In this mode, interactive shells expand the @env{ENV} variable and commands "
  10727. "are read and executed from the file whose name is the expanded value. No "
  10728. "other startup files are read."
  10729. msgstr ""
  10730. #. type: subsubheading
  10731. #: ./bashref.texi:6431
  10732. #, no-wrap
  10733. msgid "Invoked by remote shell daemon"
  10734. msgstr ""
  10735. #. type: Plain text
  10736. #: ./bashref.texi:6444
  10737. msgid ""
  10738. "Bash attempts to determine when it is being run with its standard input "
  10739. "connected to a network connection, as when executed by the remote shell "
  10740. "daemon, usually @code{rshd}, or the secure shell daemon @code{sshd}. If "
  10741. "Bash determines it is being run in this fashion, it reads and executes "
  10742. "commands from @file{~/.bashrc}, if that file exists and is readable. It "
  10743. "will not do this if invoked as @code{sh}. The @option{--norc} option may be "
  10744. "used to inhibit this behavior, and the @option{--rcfile} option may be used "
  10745. "to force another file to be read, but neither @code{rshd} nor @code{sshd} "
  10746. "generally invoke the shell with those options or allow them to be specified."
  10747. msgstr ""
  10748. #. type: subsubheading
  10749. #: ./bashref.texi:6445
  10750. #, no-wrap
  10751. msgid "Invoked with unequal effective and real @sc{uid/gid}s"
  10752. msgstr ""
  10753. #. type: Plain text
  10754. #: ./bashref.texi:6455
  10755. msgid ""
  10756. "If Bash is started with the effective user (group) id not equal to the real "
  10757. "user (group) id, and the @option{-p} option is not supplied, no startup "
  10758. "files are read, shell functions are not inherited from the environment, the "
  10759. "@env{SHELLOPTS}, @env{BASHOPTS}, @env{CDPATH}, and @env{GLOBIGNORE} "
  10760. "variables, if they appear in the environment, are ignored, and the effective "
  10761. "user id is set to the real user id. If the @option{-p} option is supplied "
  10762. "at invocation, the startup behavior is the same, but the effective user id "
  10763. "is not reset."
  10764. msgstr ""
  10765. #. type: cindex
  10766. #: ./bashref.texi:6459
  10767. #, no-wrap
  10768. msgid "shell, interactive"
  10769. msgstr ""
  10770. #. type: subsection
  10771. #: ./bashref.texi:6465 ./bashref.texi:6467 ./bashref.texi:6468
  10772. #, no-wrap
  10773. msgid "What is an Interactive Shell?"
  10774. msgstr ""
  10775. #. type: menuentry
  10776. #: ./bashref.texi:6465
  10777. msgid "What determines whether a shell is Interactive."
  10778. msgstr ""
  10779. #. type: subsection
  10780. #: ./bashref.texi:6465 ./bashref.texi:6483 ./bashref.texi:6484
  10781. #, no-wrap
  10782. msgid "Is this Shell Interactive?"
  10783. msgstr ""
  10784. #. type: menuentry
  10785. #: ./bashref.texi:6465
  10786. msgid "How to tell if a shell is interactive."
  10787. msgstr ""
  10788. #. type: subsection
  10789. #: ./bashref.texi:6465 ./bashref.texi:6510 ./bashref.texi:6511
  10790. #, no-wrap
  10791. msgid "Interactive Shell Behavior"
  10792. msgstr ""
  10793. #. type: menuentry
  10794. #: ./bashref.texi:6465
  10795. msgid "What changes in a interactive shell?"
  10796. msgstr ""
  10797. #. type: Plain text
  10798. #: ./bashref.texi:6476
  10799. msgid ""
  10800. "An interactive shell is one started without non-option arguments, unless "
  10801. "@option{-s} is specified, without specifying the @option{-c} option, and "
  10802. "whose input and error output are both connected to terminals (as determined "
  10803. "by @code{isatty(3)}), or one started with the @option{-i} option."
  10804. msgstr ""
  10805. #. type: Plain text
  10806. #: ./bashref.texi:6479
  10807. msgid "An interactive shell generally reads from and writes to a user's terminal."
  10808. msgstr ""
  10809. #. type: Plain text
  10810. #: ./bashref.texi:6482
  10811. msgid ""
  10812. "The @option{-s} invocation option may be used to set the positional "
  10813. "parameters when an interactive shell is started."
  10814. msgstr ""
  10815. #. type: Plain text
  10816. #: ./bashref.texi:6490
  10817. msgid ""
  10818. "To determine within a startup script whether or not Bash is running "
  10819. "interactively, test the value of the @samp{-} special parameter. It "
  10820. "contains @code{i} when the shell is interactive. For example:"
  10821. msgstr ""
  10822. #. type: example
  10823. #: ./bashref.texi:6496
  10824. #, no-wrap
  10825. msgid ""
  10826. "case \"$-\" in\n"
  10827. "*i*)\techo This shell is interactive ;;\n"
  10828. "*)\techo This shell is not interactive ;;\n"
  10829. "esac\n"
  10830. msgstr ""
  10831. #. type: Plain text
  10832. #: ./bashref.texi:6501
  10833. msgid ""
  10834. "Alternatively, startup scripts may examine the variable @env{PS1}; it is "
  10835. "unset in non-interactive shells, and set in interactive shells. Thus:"
  10836. msgstr ""
  10837. #. type: example
  10838. #: ./bashref.texi:6508
  10839. #, no-wrap
  10840. msgid ""
  10841. "if [ -z \"$PS1\" ]; then\n"
  10842. " echo This shell is not interactive\n"
  10843. "else\n"
  10844. " echo This shell is interactive\n"
  10845. "fi\n"
  10846. msgstr ""
  10847. #. type: Plain text
  10848. #: ./bashref.texi:6515
  10849. msgid ""
  10850. "When the shell is running interactively, it changes its behavior in several "
  10851. "ways."
  10852. msgstr ""
  10853. #. type: enumerate
  10854. #: ./bashref.texi:6519
  10855. msgid ""
  10856. "Startup files are read and executed as described in @ref{Bash Startup "
  10857. "Files}."
  10858. msgstr ""
  10859. #. type: enumerate
  10860. #: ./bashref.texi:6524
  10861. msgid ""
  10862. "Job Control (@pxref{Job Control}) is enabled by default. When job control "
  10863. "is in effect, Bash ignores the keyboard-generated job control signals "
  10864. "@code{SIGTTIN}, @code{SIGTTOU}, and @code{SIGTSTP}."
  10865. msgstr ""
  10866. #. type: enumerate
  10867. #: ./bashref.texi:6530
  10868. msgid ""
  10869. "Bash expands and displays @env{PS1} before reading the first line of a "
  10870. "command, and expands and displays @env{PS2} before reading the second and "
  10871. "subsequent lines of a multi-line command. Bash displays @env{PS0} after it "
  10872. "reads a command but before executing it."
  10873. msgstr ""
  10874. #. type: enumerate
  10875. #: ./bashref.texi:6535
  10876. msgid ""
  10877. "Bash executes the value of the @env{PROMPT_COMMAND} variable as a command "
  10878. "before printing the primary prompt, @env{$PS1} (@pxref{Bash Variables})."
  10879. msgstr ""
  10880. #. type: enumerate
  10881. #: ./bashref.texi:6539
  10882. msgid ""
  10883. "Readline (@pxref{Command Line Editing}) is used to read commands from the "
  10884. "user's terminal."
  10885. msgstr ""
  10886. #. type: enumerate
  10887. #: ./bashref.texi:6544
  10888. msgid ""
  10889. "Bash inspects the value of the @code{ignoreeof} option to @code{set -o} "
  10890. "instead of exiting immediately when it receives an @code{EOF} on its "
  10891. "standard input when reading a command (@pxref{The Set Builtin})."
  10892. msgstr ""
  10893. #. type: enumerate
  10894. #: ./bashref.texi:6551
  10895. msgid ""
  10896. "Command history (@pxref{Bash History Facilities}) and history expansion "
  10897. "(@pxref{History Interaction}) are enabled by default. Bash will save the "
  10898. "command history to the file named by @env{$HISTFILE} when a shell with "
  10899. "history enabled exits."
  10900. msgstr ""
  10901. #. type: enumerate
  10902. #: ./bashref.texi:6554
  10903. msgid "Alias expansion (@pxref{Aliases}) is performed by default."
  10904. msgstr ""
  10905. #. type: enumerate
  10906. #: ./bashref.texi:6558
  10907. msgid "In the absence of any traps, Bash ignores @code{SIGTERM} (@pxref{Signals})."
  10908. msgstr ""
  10909. #. type: enumerate
  10910. #: ./bashref.texi:6563
  10911. msgid ""
  10912. "In the absence of any traps, @code{SIGINT} is caught and handled "
  10913. "((@pxref{Signals}). @code{SIGINT} will interrupt some shell builtins."
  10914. msgstr ""
  10915. #. type: enumerate
  10916. #: ./bashref.texi:6567
  10917. msgid ""
  10918. "An interactive login shell sends a @code{SIGHUP} to all jobs on exit if the "
  10919. "@code{huponexit} shell option has been enabled (@pxref{Signals})."
  10920. msgstr ""
  10921. #. type: enumerate
  10922. #: ./bashref.texi:6571
  10923. msgid ""
  10924. "The @option{-n} invocation option is ignored, and @samp{set -n} has no "
  10925. "effect (@pxref{The Set Builtin})."
  10926. msgstr ""
  10927. #. type: enumerate
  10928. #: ./bashref.texi:6576
  10929. msgid ""
  10930. "Bash will check for mail periodically, depending on the values of the "
  10931. "@env{MAIL}, @env{MAILPATH}, and @env{MAILCHECK} shell variables (@pxref{Bash "
  10932. "Variables})."
  10933. msgstr ""
  10934. #. type: enumerate
  10935. #: ./bashref.texi:6581
  10936. msgid ""
  10937. "Expansion errors due to references to unbound shell variables after "
  10938. "@samp{set -u} has been enabled will not cause the shell to exit (@pxref{The "
  10939. "Set Builtin})."
  10940. msgstr ""
  10941. #. type: enumerate
  10942. #: ./bashref.texi:6586
  10943. msgid ""
  10944. "The shell will not exit on expansion errors caused by @var{var} being unset "
  10945. "or null in @code{$@{@var{var}:?@var{word}@}} expansions (@pxref{Shell "
  10946. "Parameter Expansion})."
  10947. msgstr ""
  10948. #. type: enumerate
  10949. #: ./bashref.texi:6590
  10950. msgid ""
  10951. "Redirection errors encountered by shell builtins will not cause the shell to "
  10952. "exit."
  10953. msgstr ""
  10954. #. type: enumerate
  10955. #: ./bashref.texi:6594
  10956. msgid ""
  10957. "When running in @sc{posix} mode, a special builtin returning an error status "
  10958. "will not cause the shell to exit (@pxref{Bash POSIX Mode})."
  10959. msgstr ""
  10960. #. type: enumerate
  10961. #: ./bashref.texi:6598
  10962. msgid ""
  10963. "A failed @code{exec} will not cause the shell to exit (@pxref{Bourne Shell "
  10964. "Builtins})."
  10965. msgstr ""
  10966. #. type: enumerate
  10967. #: ./bashref.texi:6601
  10968. msgid "Parser syntax errors will not cause the shell to exit."
  10969. msgstr ""
  10970. #. type: enumerate
  10971. #: ./bashref.texi:6606
  10972. msgid ""
  10973. "Simple spelling correction for directory arguments to the @code{cd} builtin "
  10974. "is enabled by default (see the description of the @code{cdspell} option to "
  10975. "the @code{shopt} builtin in @ref{The Shopt Builtin})."
  10976. msgstr ""
  10977. #. type: enumerate
  10978. #: ./bashref.texi:6611
  10979. msgid ""
  10980. "The shell will check the value of the @env{TMOUT} variable and exit if a "
  10981. "command is not read within the specified number of seconds after printing "
  10982. "@env{$PS1} (@pxref{Bash Variables})."
  10983. msgstr ""
  10984. #. type: cindex
  10985. #: ./bashref.texi:6616
  10986. #, no-wrap
  10987. msgid "expressions, conditional"
  10988. msgstr ""
  10989. #. type: Plain text
  10990. #: ./bashref.texi:6620
  10991. msgid ""
  10992. "Conditional expressions are used by the @code{[[} compound command and the "
  10993. "@code{test} and @code{[} builtin commands."
  10994. msgstr ""
  10995. #. type: Plain text
  10996. #: ./bashref.texi:6634
  10997. msgid ""
  10998. "Expressions may be unary or binary. Unary expressions are often used to "
  10999. "examine the status of a file. There are string operators and numeric "
  11000. "comparison operators as well. Bash handles several filenames specially when "
  11001. "they are used in expressions. If the operating system on which Bash is "
  11002. "running provides these special files, Bash will use them; otherwise it will "
  11003. "emulate them internally with this behavior: If the @var{file} argument to "
  11004. "one of the primaries is of the form @file{/dev/fd/@var{N}}, then file "
  11005. "descriptor @var{N} is checked. If the @var{file} argument to one of the "
  11006. "primaries is one of @file{/dev/stdin}, @file{/dev/stdout}, or "
  11007. "@file{/dev/stderr}, file descriptor 0, 1, or 2, respectively, is checked."
  11008. msgstr ""
  11009. #. type: Plain text
  11010. #: ./bashref.texi:6638
  11011. msgid ""
  11012. "When used with @code{[[}, the @samp{<} and @samp{>} operators sort "
  11013. "lexicographically using the current locale. The @code{test} command uses "
  11014. "ASCII ordering."
  11015. msgstr ""
  11016. #. type: Plain text
  11017. #: ./bashref.texi:6641
  11018. msgid ""
  11019. "Unless otherwise specified, primaries that operate on files follow symbolic "
  11020. "links and operate on the target of the link, rather than the link itself."
  11021. msgstr ""
  11022. #. type: item
  11023. #: ./bashref.texi:6643
  11024. #, no-wrap
  11025. msgid "-a @var{file}"
  11026. msgstr ""
  11027. #. type: table
  11028. #: ./bashref.texi:6645 ./bashref.texi:6657
  11029. msgid "True if @var{file} exists."
  11030. msgstr ""
  11031. #. type: item
  11032. #: ./bashref.texi:6646
  11033. #, no-wrap
  11034. msgid "-b @var{file}"
  11035. msgstr ""
  11036. #. type: table
  11037. #: ./bashref.texi:6648
  11038. msgid "True if @var{file} exists and is a block special file."
  11039. msgstr ""
  11040. #. type: item
  11041. #: ./bashref.texi:6649
  11042. #, no-wrap
  11043. msgid "-c @var{file}"
  11044. msgstr ""
  11045. #. type: table
  11046. #: ./bashref.texi:6651
  11047. msgid "True if @var{file} exists and is a character special file."
  11048. msgstr ""
  11049. #. type: item
  11050. #: ./bashref.texi:6652
  11051. #, no-wrap
  11052. msgid "-d @var{file}"
  11053. msgstr ""
  11054. #. type: table
  11055. #: ./bashref.texi:6654
  11056. msgid "True if @var{file} exists and is a directory."
  11057. msgstr ""
  11058. #. type: item
  11059. #: ./bashref.texi:6655
  11060. #, no-wrap
  11061. msgid "-e @var{file}"
  11062. msgstr ""
  11063. #. type: item
  11064. #: ./bashref.texi:6658
  11065. #, no-wrap
  11066. msgid "-f @var{file}"
  11067. msgstr ""
  11068. #. type: table
  11069. #: ./bashref.texi:6660
  11070. msgid "True if @var{file} exists and is a regular file."
  11071. msgstr ""
  11072. #. type: item
  11073. #: ./bashref.texi:6661
  11074. #, no-wrap
  11075. msgid "-g @var{file}"
  11076. msgstr ""
  11077. #. type: table
  11078. #: ./bashref.texi:6663
  11079. msgid "True if @var{file} exists and its set-group-id bit is set."
  11080. msgstr ""
  11081. #. type: item
  11082. #: ./bashref.texi:6664
  11083. #, no-wrap
  11084. msgid "-h @var{file}"
  11085. msgstr ""
  11086. #. type: table
  11087. #: ./bashref.texi:6666 ./bashref.texi:6696
  11088. msgid "True if @var{file} exists and is a symbolic link."
  11089. msgstr ""
  11090. #. type: item
  11091. #: ./bashref.texi:6667
  11092. #, no-wrap
  11093. msgid "-k @var{file}"
  11094. msgstr ""
  11095. #. type: table
  11096. #: ./bashref.texi:6669
  11097. msgid "True if @var{file} exists and its \"sticky\" bit is set."
  11098. msgstr ""
  11099. #. type: item
  11100. #: ./bashref.texi:6670
  11101. #, no-wrap
  11102. msgid "-p @var{file}"
  11103. msgstr ""
  11104. #. type: table
  11105. #: ./bashref.texi:6672
  11106. msgid "True if @var{file} exists and is a named pipe (FIFO)."
  11107. msgstr ""
  11108. #. type: item
  11109. #: ./bashref.texi:6673
  11110. #, no-wrap
  11111. msgid "-r @var{file}"
  11112. msgstr ""
  11113. #. type: table
  11114. #: ./bashref.texi:6675
  11115. msgid "True if @var{file} exists and is readable."
  11116. msgstr ""
  11117. #. type: item
  11118. #: ./bashref.texi:6676
  11119. #, no-wrap
  11120. msgid "-s @var{file}"
  11121. msgstr ""
  11122. #. type: table
  11123. #: ./bashref.texi:6678
  11124. msgid "True if @var{file} exists and has a size greater than zero."
  11125. msgstr ""
  11126. #. type: item
  11127. #: ./bashref.texi:6679
  11128. #, no-wrap
  11129. msgid "-t @var{fd}"
  11130. msgstr ""
  11131. #. type: table
  11132. #: ./bashref.texi:6681
  11133. msgid "True if file descriptor @var{fd} is open and refers to a terminal."
  11134. msgstr ""
  11135. #. type: item
  11136. #: ./bashref.texi:6682
  11137. #, no-wrap
  11138. msgid "-u @var{file}"
  11139. msgstr ""
  11140. #. type: table
  11141. #: ./bashref.texi:6684
  11142. msgid "True if @var{file} exists and its set-user-id bit is set."
  11143. msgstr ""
  11144. #. type: item
  11145. #: ./bashref.texi:6685
  11146. #, no-wrap
  11147. msgid "-w @var{file}"
  11148. msgstr ""
  11149. #. type: table
  11150. #: ./bashref.texi:6687
  11151. msgid "True if @var{file} exists and is writable."
  11152. msgstr ""
  11153. #. type: item
  11154. #: ./bashref.texi:6688
  11155. #, no-wrap
  11156. msgid "-x @var{file}"
  11157. msgstr ""
  11158. #. type: table
  11159. #: ./bashref.texi:6690
  11160. msgid "True if @var{file} exists and is executable."
  11161. msgstr ""
  11162. #. type: item
  11163. #: ./bashref.texi:6691
  11164. #, no-wrap
  11165. msgid "-G @var{file}"
  11166. msgstr ""
  11167. #. type: table
  11168. #: ./bashref.texi:6693
  11169. msgid "True if @var{file} exists and is owned by the effective group id."
  11170. msgstr ""
  11171. #. type: item
  11172. #: ./bashref.texi:6694
  11173. #, no-wrap
  11174. msgid "-L @var{file}"
  11175. msgstr ""
  11176. #. type: item
  11177. #: ./bashref.texi:6697
  11178. #, no-wrap
  11179. msgid "-N @var{file}"
  11180. msgstr ""
  11181. #. type: table
  11182. #: ./bashref.texi:6699
  11183. msgid "True if @var{file} exists and has been modified since it was last read."
  11184. msgstr ""
  11185. #. type: item
  11186. #: ./bashref.texi:6700
  11187. #, no-wrap
  11188. msgid "-O @var{file}"
  11189. msgstr ""
  11190. #. type: table
  11191. #: ./bashref.texi:6702
  11192. msgid "True if @var{file} exists and is owned by the effective user id."
  11193. msgstr ""
  11194. #. type: item
  11195. #: ./bashref.texi:6703
  11196. #, no-wrap
  11197. msgid "-S @var{file}"
  11198. msgstr ""
  11199. #. type: table
  11200. #: ./bashref.texi:6705
  11201. msgid "True if @var{file} exists and is a socket."
  11202. msgstr ""
  11203. #. type: item
  11204. #: ./bashref.texi:6706
  11205. #, no-wrap
  11206. msgid "@var{file1} -ef @var{file2}"
  11207. msgstr ""
  11208. #. type: table
  11209. #: ./bashref.texi:6709
  11210. msgid ""
  11211. "True if @var{file1} and @var{file2} refer to the same device and inode "
  11212. "numbers."
  11213. msgstr ""
  11214. #. type: item
  11215. #: ./bashref.texi:6710
  11216. #, no-wrap
  11217. msgid "@var{file1} -nt @var{file2}"
  11218. msgstr ""
  11219. #. type: table
  11220. #: ./bashref.texi:6713
  11221. msgid ""
  11222. "True if @var{file1} is newer (according to modification date) than "
  11223. "@var{file2}, or if @var{file1} exists and @var{file2} does not."
  11224. msgstr ""
  11225. #. type: item
  11226. #: ./bashref.texi:6714
  11227. #, no-wrap
  11228. msgid "@var{file1} -ot @var{file2}"
  11229. msgstr ""
  11230. #. type: table
  11231. #: ./bashref.texi:6717
  11232. msgid ""
  11233. "True if @var{file1} is older than @var{file2}, or if @var{file2} exists and "
  11234. "@var{file1} does not."
  11235. msgstr ""
  11236. #. type: item
  11237. #: ./bashref.texi:6718
  11238. #, no-wrap
  11239. msgid "-o @var{optname}"
  11240. msgstr ""
  11241. #. type: table
  11242. #: ./bashref.texi:6722
  11243. msgid ""
  11244. "True if the shell option @var{optname} is enabled. The list of options "
  11245. "appears in the description of the @option{-o} option to the @code{set} "
  11246. "builtin (@pxref{The Set Builtin})."
  11247. msgstr ""
  11248. #. type: item
  11249. #: ./bashref.texi:6723
  11250. #, no-wrap
  11251. msgid "-v @var{varname}"
  11252. msgstr ""
  11253. #. type: table
  11254. #: ./bashref.texi:6725
  11255. msgid "True if the shell variable @var{varname} is set (has been assigned a value)."
  11256. msgstr ""
  11257. #. type: item
  11258. #: ./bashref.texi:6726
  11259. #, no-wrap
  11260. msgid "-R @var{varname}"
  11261. msgstr ""
  11262. #. type: table
  11263. #: ./bashref.texi:6728
  11264. msgid "True if the shell variable @var{varname} is set and is a name reference."
  11265. msgstr ""
  11266. #. type: item
  11267. #: ./bashref.texi:6729
  11268. #, no-wrap
  11269. msgid "-z @var{string}"
  11270. msgstr ""
  11271. #. type: table
  11272. #: ./bashref.texi:6731
  11273. msgid "True if the length of @var{string} is zero."
  11274. msgstr ""
  11275. #. type: item
  11276. #: ./bashref.texi:6732
  11277. #, no-wrap
  11278. msgid "-n @var{string}"
  11279. msgstr ""
  11280. #. type: var{#1}
  11281. #: ./bashref.texi:6733
  11282. #, no-wrap
  11283. msgid "string"
  11284. msgstr ""
  11285. #. type: table
  11286. #: ./bashref.texi:6735
  11287. msgid "True if the length of @var{string} is non-zero."
  11288. msgstr ""
  11289. #. type: item
  11290. #: ./bashref.texi:6736
  11291. #, no-wrap
  11292. msgid "@var{string1} == @var{string2}"
  11293. msgstr ""
  11294. #. type: itemx
  11295. #: ./bashref.texi:6737
  11296. #, no-wrap
  11297. msgid "@var{string1} = @var{string2}"
  11298. msgstr ""
  11299. #. type: table
  11300. #: ./bashref.texi:6741
  11301. msgid ""
  11302. "True if the strings are equal. When used with the @code{[[} command, this "
  11303. "performs pattern matching as described above (@pxref{Conditional "
  11304. "Constructs})."
  11305. msgstr ""
  11306. #. type: table
  11307. #: ./bashref.texi:6743
  11308. msgid ""
  11309. "@samp{=} should be used with the @code{test} command for @sc{posix} "
  11310. "conformance."
  11311. msgstr ""
  11312. #. type: item
  11313. #: ./bashref.texi:6744
  11314. #, no-wrap
  11315. msgid "@var{string1} != @var{string2}"
  11316. msgstr ""
  11317. #. type: table
  11318. #: ./bashref.texi:6746
  11319. msgid "True if the strings are not equal."
  11320. msgstr ""
  11321. #. type: item
  11322. #: ./bashref.texi:6747
  11323. #, no-wrap
  11324. msgid "@var{string1} < @var{string2}"
  11325. msgstr ""
  11326. #. type: table
  11327. #: ./bashref.texi:6749
  11328. msgid "True if @var{string1} sorts before @var{string2} lexicographically."
  11329. msgstr ""
  11330. #. type: item
  11331. #: ./bashref.texi:6750
  11332. #, no-wrap
  11333. msgid "@var{string1} > @var{string2}"
  11334. msgstr ""
  11335. #. type: table
  11336. #: ./bashref.texi:6752
  11337. msgid "True if @var{string1} sorts after @var{string2} lexicographically."
  11338. msgstr ""
  11339. #. type: item
  11340. #: ./bashref.texi:6753
  11341. #, no-wrap
  11342. msgid "@var{arg1} OP @var{arg2}"
  11343. msgstr ""
  11344. #. type: table
  11345. #: ./bashref.texi:6761
  11346. msgid ""
  11347. "@code{OP} is one of @samp{-eq}, @samp{-ne}, @samp{-lt}, @samp{-le}, "
  11348. "@samp{-gt}, or @samp{-ge}. These arithmetic binary operators return true if "
  11349. "@var{arg1} is equal to, not equal to, less than, less than or equal to, "
  11350. "greater than, or greater than or equal to @var{arg2}, respectively. "
  11351. "@var{Arg1} and @var{arg2} may be positive or negative integers."
  11352. msgstr ""
  11353. #. type: cindex
  11354. #: ./bashref.texi:6765
  11355. #, no-wrap
  11356. msgid "arithmetic, shell"
  11357. msgstr ""
  11358. #. type: cindex
  11359. #: ./bashref.texi:6766
  11360. #, no-wrap
  11361. msgid "shell arithmetic"
  11362. msgstr ""
  11363. #. type: cindex
  11364. #: ./bashref.texi:6767
  11365. #, no-wrap
  11366. msgid "expressions, arithmetic"
  11367. msgstr ""
  11368. #. type: cindex
  11369. #: ./bashref.texi:6768
  11370. #, no-wrap
  11371. msgid "evaluation, arithmetic"
  11372. msgstr ""
  11373. #. type: cindex
  11374. #: ./bashref.texi:6769
  11375. #, no-wrap
  11376. msgid "arithmetic evaluation"
  11377. msgstr ""
  11378. #. type: Plain text
  11379. #: ./bashref.texi:6774
  11380. msgid ""
  11381. "The shell allows arithmetic expressions to be evaluated, as one of the shell "
  11382. "expansions or by using the @code{((} compound command, the @code{let} "
  11383. "builtin, or the @option{-i} option to the @code{declare} builtin."
  11384. msgstr ""
  11385. #. type: Plain text
  11386. #: ./bashref.texi:6782
  11387. msgid ""
  11388. "Evaluation is done in fixed-width integers with no check for overflow, "
  11389. "though division by 0 is trapped and flagged as an error. The operators and "
  11390. "their precedence, associativity, and values are the same as in the C "
  11391. "language. The following list of operators is grouped into levels of "
  11392. "equal-precedence operators. The levels are listed in order of decreasing "
  11393. "precedence."
  11394. msgstr ""
  11395. #. type: item
  11396. #: ./bashref.texi:6785
  11397. #, no-wrap
  11398. msgid "@var{id}++ @var{id}--"
  11399. msgstr ""
  11400. #. type: table
  11401. #: ./bashref.texi:6787
  11402. msgid "variable post-increment and post-decrement"
  11403. msgstr ""
  11404. #. type: item
  11405. #: ./bashref.texi:6788
  11406. #, no-wrap
  11407. msgid "++@var{id} --@var{id}"
  11408. msgstr ""
  11409. #. type: table
  11410. #: ./bashref.texi:6790
  11411. msgid "variable pre-increment and pre-decrement"
  11412. msgstr ""
  11413. #. type: item
  11414. #: ./bashref.texi:6791
  11415. #, no-wrap
  11416. msgid "- +"
  11417. msgstr ""
  11418. #. type: table
  11419. #: ./bashref.texi:6793
  11420. msgid "unary minus and plus"
  11421. msgstr ""
  11422. #. type: item
  11423. #: ./bashref.texi:6794
  11424. #, no-wrap
  11425. msgid "! ~"
  11426. msgstr ""
  11427. #. type: table
  11428. #: ./bashref.texi:6796
  11429. msgid "logical and bitwise negation"
  11430. msgstr ""
  11431. #. type: item
  11432. #: ./bashref.texi:6797
  11433. #, no-wrap
  11434. msgid "**"
  11435. msgstr ""
  11436. #. type: table
  11437. #: ./bashref.texi:6799
  11438. msgid "exponentiation"
  11439. msgstr ""
  11440. #. type: item
  11441. #: ./bashref.texi:6800
  11442. #, no-wrap
  11443. msgid "* / %"
  11444. msgstr ""
  11445. #. type: table
  11446. #: ./bashref.texi:6802
  11447. msgid "multiplication, division, remainder"
  11448. msgstr ""
  11449. #. type: item
  11450. #: ./bashref.texi:6803
  11451. #, no-wrap
  11452. msgid "+ -"
  11453. msgstr ""
  11454. #. type: table
  11455. #: ./bashref.texi:6805
  11456. msgid "addition, subtraction"
  11457. msgstr ""
  11458. #. type: item
  11459. #: ./bashref.texi:6806
  11460. #, no-wrap
  11461. msgid "<< >>"
  11462. msgstr ""
  11463. #. type: table
  11464. #: ./bashref.texi:6808
  11465. msgid "left and right bitwise shifts"
  11466. msgstr ""
  11467. #. type: item
  11468. #: ./bashref.texi:6809
  11469. #, no-wrap
  11470. msgid "<= >= < >"
  11471. msgstr ""
  11472. #. type: table
  11473. #: ./bashref.texi:6811
  11474. msgid "comparison"
  11475. msgstr ""
  11476. #. type: item
  11477. #: ./bashref.texi:6812
  11478. #, no-wrap
  11479. msgid "== !="
  11480. msgstr ""
  11481. #. type: table
  11482. #: ./bashref.texi:6814
  11483. msgid "equality and inequality"
  11484. msgstr ""
  11485. #. type: item
  11486. #: ./bashref.texi:6815
  11487. #, no-wrap
  11488. msgid "&"
  11489. msgstr ""
  11490. #. type: table
  11491. #: ./bashref.texi:6817
  11492. msgid "bitwise AND"
  11493. msgstr ""
  11494. #. type: item
  11495. #: ./bashref.texi:6818
  11496. #, no-wrap
  11497. msgid "^"
  11498. msgstr ""
  11499. #. type: table
  11500. #: ./bashref.texi:6820
  11501. msgid "bitwise exclusive OR"
  11502. msgstr ""
  11503. #. type: item
  11504. #: ./bashref.texi:6821
  11505. #, no-wrap
  11506. msgid "|"
  11507. msgstr ""
  11508. #. type: table
  11509. #: ./bashref.texi:6823
  11510. msgid "bitwise OR"
  11511. msgstr ""
  11512. #. type: item
  11513. #: ./bashref.texi:6824
  11514. #, no-wrap
  11515. msgid "&&"
  11516. msgstr ""
  11517. #. type: table
  11518. #: ./bashref.texi:6826
  11519. msgid "logical AND"
  11520. msgstr ""
  11521. #. type: item
  11522. #: ./bashref.texi:6827
  11523. #, no-wrap
  11524. msgid "||"
  11525. msgstr ""
  11526. #. type: table
  11527. #: ./bashref.texi:6829
  11528. msgid "logical OR"
  11529. msgstr ""
  11530. #. type: item
  11531. #: ./bashref.texi:6830
  11532. #, no-wrap
  11533. msgid "expr ? expr : expr"
  11534. msgstr ""
  11535. #. type: table
  11536. #: ./bashref.texi:6832
  11537. msgid "conditional operator"
  11538. msgstr ""
  11539. #. type: item
  11540. #: ./bashref.texi:6833
  11541. #, no-wrap
  11542. msgid "= *= /= %= += -= <<= >>= &= ^= |="
  11543. msgstr ""
  11544. #. type: table
  11545. #: ./bashref.texi:6835
  11546. msgid "assignment"
  11547. msgstr ""
  11548. #. type: item
  11549. #: ./bashref.texi:6836
  11550. #, no-wrap
  11551. msgid "expr1 , expr2"
  11552. msgstr ""
  11553. #. type: table
  11554. #: ./bashref.texi:6838
  11555. msgid "comma"
  11556. msgstr ""
  11557. #. type: Plain text
  11558. #: ./bashref.texi:6852
  11559. msgid ""
  11560. "Shell variables are allowed as operands; parameter expansion is performed "
  11561. "before the expression is evaluated. Within an expression, shell variables "
  11562. "may also be referenced by name without using the parameter expansion "
  11563. "syntax. A shell variable that is null or unset evaluates to 0 when "
  11564. "referenced by name without using the parameter expansion syntax. The value "
  11565. "of a variable is evaluated as an arithmetic expression when it is "
  11566. "referenced, or when a variable which has been given the @var{integer} "
  11567. "attribute using @samp{declare -i} is assigned a value. A null value "
  11568. "evaluates to 0. A shell variable need not have its @var{integer} attribute "
  11569. "turned on to be used in an expression."
  11570. msgstr ""
  11571. #. type: Plain text
  11572. #: ./bashref.texi:6865
  11573. msgid ""
  11574. "Constants with a leading 0 are interpreted as octal numbers. A leading "
  11575. "@samp{0x} or @samp{0X} denotes hexadecimal. Otherwise, numbers take the "
  11576. "form [@var{base}@code{#}]@var{n}, where the optional @var{base} is a decimal "
  11577. "number between 2 and 64 representing the arithmetic base, and @var{n} is a "
  11578. "number in that base. If @var{base}@code{#} is omitted, then base 10 is "
  11579. "used. When specifying @var{n}, the digits greater than 9 are represented by "
  11580. "the lowercase letters, the uppercase letters, @samp{@@}, and @samp{_}, in "
  11581. "that order. If @var{base} is less than or equal to 36, lowercase and "
  11582. "uppercase letters may be used interchangeably to represent numbers between "
  11583. "10 and 35."
  11584. msgstr ""
  11585. #. type: Plain text
  11586. #: ./bashref.texi:6869
  11587. msgid ""
  11588. "Operators are evaluated in order of precedence. Sub-expressions in "
  11589. "parentheses are evaluated first and may override the precedence rules above."
  11590. msgstr ""
  11591. #. type: cindex
  11592. #: ./bashref.texi:6872
  11593. #, no-wrap
  11594. msgid "alias expansion"
  11595. msgstr ""
  11596. #. type: Plain text
  11597. #: ./bashref.texi:6878
  11598. msgid ""
  11599. "@var{Aliases} allow a string to be substituted for a word when it is used as "
  11600. "the first word of a simple command. The shell maintains a list of aliases "
  11601. "that may be set and unset with the @code{alias} and @code{unalias} builtin "
  11602. "commands."
  11603. msgstr ""
  11604. #. type: Plain text
  11605. #: ./bashref.texi:6896
  11606. msgid ""
  11607. "The first word of each simple command, if unquoted, is checked to see if it "
  11608. "has an alias. If so, that word is replaced by the text of the alias. The "
  11609. "characters @samp{/}, @samp{$}, @samp{`}, @samp{=} and any of the shell "
  11610. "metacharacters or quoting characters listed above may not appear in an alias "
  11611. "name. The replacement text may contain any valid shell input, including "
  11612. "shell metacharacters. The first word of the replacement text is tested for "
  11613. "aliases, but a word that is identical to an alias being expanded is not "
  11614. "expanded a second time. This means that one may alias @code{ls} to "
  11615. "@code{\"ls -F\"}, for instance, and Bash does not try to recursively expand "
  11616. "the replacement text. If the last character of the alias value is a "
  11617. "@var{blank}, then the next command word following the alias is also checked "
  11618. "for alias expansion."
  11619. msgstr ""
  11620. #. type: Plain text
  11621. #: ./bashref.texi:6899
  11622. msgid ""
  11623. "Aliases are created and listed with the @code{alias} command, and removed "
  11624. "with the @code{unalias} command."
  11625. msgstr ""
  11626. #. type: Plain text
  11627. #: ./bashref.texi:6904
  11628. msgid ""
  11629. "There is no mechanism for using arguments in the replacement text, as in "
  11630. "@code{csh}. If arguments are needed, a shell function should be used "
  11631. "(@pxref{Shell Functions})."
  11632. msgstr ""
  11633. #. type: Plain text
  11634. #: ./bashref.texi:6908
  11635. msgid ""
  11636. "Aliases are not expanded when the shell is not interactive, unless the "
  11637. "@code{expand_aliases} shell option is set using @code{shopt} (@pxref{The "
  11638. "Shopt Builtin})."
  11639. msgstr ""
  11640. #. type: Plain text
  11641. #: ./bashref.texi:6927
  11642. msgid ""
  11643. "The rules concerning the definition and use of aliases are somewhat "
  11644. "confusing. Bash always reads at least one complete line of input before "
  11645. "executing any of the commands on that line. Aliases are expanded when a "
  11646. "command is read, not when it is executed. Therefore, an alias definition "
  11647. "appearing on the same line as another command does not take effect until the "
  11648. "next line of input is read. The commands following the alias definition on "
  11649. "that line are not affected by the new alias. This behavior is also an issue "
  11650. "when functions are executed. Aliases are expanded when a function "
  11651. "definition is read, not when the function is executed, because a function "
  11652. "definition is itself a command. As a consequence, aliases defined in a "
  11653. "function are not available until after that function is executed. To be "
  11654. "safe, always put alias definitions on a separate line, and do not use "
  11655. "@code{alias} in compound commands."
  11656. msgstr ""
  11657. #. type: Plain text
  11658. #: ./bashref.texi:6929
  11659. msgid "For almost every purpose, shell functions are preferred over aliases."
  11660. msgstr ""
  11661. #. type: cindex
  11662. #: ./bashref.texi:6932
  11663. #, no-wrap
  11664. msgid "arrays"
  11665. msgstr ""
  11666. #. type: Plain text
  11667. #: ./bashref.texi:6944
  11668. msgid ""
  11669. "Bash provides one-dimensional indexed and associative array variables. Any "
  11670. "variable may be used as an indexed array; the @code{declare} builtin will "
  11671. "explicitly declare an array. There is no maximum limit on the size of an "
  11672. "array, nor any requirement that members be indexed or assigned "
  11673. "contiguously. Indexed arrays are referenced using integers (including "
  11674. "arithmetic expressions (@pxref{Shell Arithmetic})) and are zero-based; "
  11675. "associative arrays use arbitrary strings. Unless otherwise noted, indexed "
  11676. "array indices must be non-negative integers."
  11677. msgstr ""
  11678. #. type: Plain text
  11679. #: ./bashref.texi:6947
  11680. msgid ""
  11681. "An indexed array is created automatically if any variable is assigned to "
  11682. "using the syntax"
  11683. msgstr ""
  11684. #. type: example
  11685. #: ./bashref.texi:6949
  11686. #, no-wrap
  11687. msgid "@var{name}[@var{subscript}]=@var{value}\n"
  11688. msgstr ""
  11689. #. type: Plain text
  11690. #: ./bashref.texi:6955
  11691. msgid ""
  11692. "The @var{subscript} is treated as an arithmetic expression that must "
  11693. "evaluate to a number. To explicitly declare an array, use"
  11694. msgstr ""
  11695. #. type: example
  11696. #: ./bashref.texi:6957
  11697. #, no-wrap
  11698. msgid "declare -a @var{name}\n"
  11699. msgstr ""
  11700. #. type: Plain text
  11701. #: ./bashref.texi:6960
  11702. msgid "The syntax"
  11703. msgstr ""
  11704. #. type: example
  11705. #: ./bashref.texi:6962
  11706. #, no-wrap
  11707. msgid "declare -a @var{name}[@var{subscript}]\n"
  11708. msgstr ""
  11709. #. type: Plain text
  11710. #: ./bashref.texi:6965
  11711. msgid "is also accepted; the @var{subscript} is ignored."
  11712. msgstr ""
  11713. #. type: Plain text
  11714. #: ./bashref.texi:6968
  11715. msgid "Associative arrays are created using"
  11716. msgstr ""
  11717. #. type: example
  11718. #: ./bashref.texi:6970
  11719. #, no-wrap
  11720. msgid "declare -A @var{name}.\n"
  11721. msgstr ""
  11722. #. type: Plain text
  11723. #: ./bashref.texi:6976
  11724. msgid ""
  11725. "Attributes may be specified for an array variable using the @code{declare} "
  11726. "and @code{readonly} builtins. Each attribute applies to all members of an "
  11727. "array."
  11728. msgstr ""
  11729. #. type: Plain text
  11730. #: ./bashref.texi:6978
  11731. msgid "Arrays are assigned to using compound assignments of the form"
  11732. msgstr ""
  11733. #. type: example
  11734. #: ./bashref.texi:6980
  11735. #, no-wrap
  11736. msgid "@var{name}=(@var{value1} @var{value2} @dots{} )\n"
  11737. msgstr ""
  11738. #. type: Plain text
  11739. #: ./bashref.texi:6989
  11740. msgid ""
  11741. "where each @var{value} is of the form "
  11742. "@code{[@var{subscript}]=}@var{string}. Indexed array assignments do not "
  11743. "require anything but @var{string}. When assigning to indexed arrays, if the "
  11744. "optional subscript is supplied, that index is assigned to; otherwise the "
  11745. "index of the element assigned is the last index assigned to by the statement "
  11746. "plus one. Indexing starts at zero."
  11747. msgstr ""
  11748. #. type: Plain text
  11749. #: ./bashref.texi:6991
  11750. msgid "When assigning to an associative array, the subscript is required."
  11751. msgstr ""
  11752. #. type: Plain text
  11753. #: ./bashref.texi:6995
  11754. msgid ""
  11755. "This syntax is also accepted by the @code{declare} builtin. Individual "
  11756. "array elements may be assigned to using the "
  11757. "@code{@var{name}[@var{subscript}]=@var{value}} syntax introduced above."
  11758. msgstr ""
  11759. #. type: Plain text
  11760. #: ./bashref.texi:7001
  11761. msgid ""
  11762. "When assigning to an indexed array, if @var{name} is subscripted by a "
  11763. "negative number, that number is interpreted as relative to one greater than "
  11764. "the maximum index of @var{name}, so negative indices count back from the end "
  11765. "of the array, and an index of -1 references the last element."
  11766. msgstr ""
  11767. #. type: Plain text
  11768. #: ./bashref.texi:7031
  11769. msgid ""
  11770. "Any element of an array may be referenced using "
  11771. "@code{$@{@var{name}[@var{subscript}]@}}. The braces are required to avoid "
  11772. "conflicts with the shell's filename expansion operators. If the "
  11773. "@var{subscript} is @samp{@@} or @samp{*}, the word expands to all members of "
  11774. "the array @var{name}. These subscripts differ only when the word appears "
  11775. "within double quotes. If the word is double-quoted, "
  11776. "@code{$@{@var{name}[*]@}} expands to a single word with the value of each "
  11777. "array member separated by the first character of the @env{IFS} variable, and "
  11778. "@code{$@{@var{name}[@@]@}} expands each element of @var{name} to a separate "
  11779. "word. When there are no array members, @code{$@{@var{name}[@@]@}} expands "
  11780. "to nothing. If the double-quoted expansion occurs within a word, the "
  11781. "expansion of the first parameter is joined with the beginning part of the "
  11782. "original word, and the expansion of the last parameter is joined with the "
  11783. "last part of the original word. This is analogous to the expansion of the "
  11784. "special parameters @samp{@@} and @samp{*}. "
  11785. "@code{$@{#@var{name}[@var{subscript}]@}} expands to the length of "
  11786. "@code{$@{@var{name}[@var{subscript}]@}}. If @var{subscript} is @samp{@@} or "
  11787. "@samp{*}, the expansion is the number of elements in the array. If the "
  11788. "@var{subscript} used to reference an element of an indexed array evaluates "
  11789. "to a number less than zero, it is interpreted as relative to one greater "
  11790. "than the maximum index of the array, so negative indices count back from the "
  11791. "end of the array, and an index of -1 refers to the last element."
  11792. msgstr ""
  11793. #. type: Plain text
  11794. #: ./bashref.texi:7036
  11795. msgid ""
  11796. "Referencing an array variable without a subscript is equivalent to "
  11797. "referencing with a subscript of 0. Any reference to a variable using a "
  11798. "valid subscript is legal, and @code{bash} will create an array if necessary."
  11799. msgstr ""
  11800. #. type: Plain text
  11801. #: ./bashref.texi:7039
  11802. msgid ""
  11803. "An array variable is considered set if a subscript has been assigned a "
  11804. "value. The null string is a valid value."
  11805. msgstr ""
  11806. #. type: Plain text
  11807. #: ./bashref.texi:7045
  11808. msgid ""
  11809. "It is possible to obtain the keys (indices) of an array as well as the "
  11810. "values. $@{!@var{name}[@@]@} and $@{!@var{name}[*]@} expand to the indices "
  11811. "assigned in array variable @var{name}. The treatment when in double quotes "
  11812. "is similar to the expansion of the special parameters @samp{@@} and @samp{*} "
  11813. "within double quotes."
  11814. msgstr ""
  11815. #. type: Plain text
  11816. #: ./bashref.texi:7055
  11817. msgid ""
  11818. "The @code{unset} builtin is used to destroy arrays. @code{unset "
  11819. "@var{name}[@var{subscript}]} destroys the array element at index "
  11820. "@var{subscript}. Negative subscripts to indexed arrays are interpreted as "
  11821. "described above. Care must be taken to avoid unwanted side effects caused "
  11822. "by filename expansion. @code{unset @var{name}}, where @var{name} is an "
  11823. "array, removes the entire array. A subscript of @samp{*} or @samp{@@} also "
  11824. "removes the entire array."
  11825. msgstr ""
  11826. #. type: Plain text
  11827. #: ./bashref.texi:7066
  11828. msgid ""
  11829. "The @code{declare}, @code{local}, and @code{readonly} builtins each accept a "
  11830. "@option{-a} option to specify an indexed array and a @option{-A} option to "
  11831. "specify an associative array. If both options are supplied, @option{-A} "
  11832. "takes precedence. The @code{read} builtin accepts a @option{-a} option to "
  11833. "assign a list of words read from the standard input to an array, and can "
  11834. "read values from the standard input into individual array elements. The "
  11835. "@code{set} and @code{declare} builtins display array values in a way that "
  11836. "allows them to be reused as input."
  11837. msgstr ""
  11838. #. type: cindex
  11839. #: ./bashref.texi:7069
  11840. #, no-wrap
  11841. msgid "directory stack"
  11842. msgstr ""
  11843. #. type: subsection
  11844. #: ./bashref.texi:7074 ./bashref.texi:7087 ./bashref.texi:7088
  11845. #, no-wrap
  11846. msgid "Directory Stack Builtins"
  11847. msgstr ""
  11848. #. type: menuentry
  11849. #: ./bashref.texi:7074
  11850. msgid "Bash builtin commands to manipulate the directory stack."
  11851. msgstr ""
  11852. #. type: Plain text
  11853. #: ./bashref.texi:7083
  11854. msgid ""
  11855. "The directory stack is a list of recently-visited directories. The "
  11856. "@code{pushd} builtin adds directories to the stack as it changes the current "
  11857. "directory, and the @code{popd} builtin removes specified directories from "
  11858. "the stack and changes the current directory to the directory removed. The "
  11859. "@code{dirs} builtin displays the contents of the directory stack. The "
  11860. "current directory is always the \"top\" of the directory stack."
  11861. msgstr ""
  11862. #. type: Plain text
  11863. #: ./bashref.texi:7086
  11864. msgid ""
  11865. "The contents of the directory stack are also visible as the value of the "
  11866. "@env{DIRSTACK} shell variable."
  11867. msgstr ""
  11868. #. type: btindex
  11869. #: ./bashref.texi:7092 ./bashref.texi:7093
  11870. #, no-wrap
  11871. msgid "dirs"
  11872. msgstr ""
  11873. #. type: example
  11874. #: ./bashref.texi:7096
  11875. #, no-wrap
  11876. msgid "dirs [-clpv] [+@var{N} | -@var{N}]\n"
  11877. msgstr ""
  11878. #. type: table
  11879. #: ./bashref.texi:7102
  11880. msgid ""
  11881. "Display the list of currently remembered directories. Directories are added "
  11882. "to the list with the @code{pushd} command; the @code{popd} command removes "
  11883. "directories from the list. The current directory is always the first "
  11884. "directory in the stack."
  11885. msgstr ""
  11886. #. type: table
  11887. #: ./bashref.texi:7106
  11888. msgid "Clears the directory stack by deleting all of the elements."
  11889. msgstr ""
  11890. #. type: table
  11891. #: ./bashref.texi:7109
  11892. msgid ""
  11893. "Produces a listing using full pathnames; the default listing format uses a "
  11894. "tilde to denote the home directory."
  11895. msgstr ""
  11896. #. type: table
  11897. #: ./bashref.texi:7112
  11898. msgid "Causes @code{dirs} to print the directory stack with one entry per line."
  11899. msgstr ""
  11900. #. type: table
  11901. #: ./bashref.texi:7115
  11902. msgid ""
  11903. "Causes @code{dirs} to print the directory stack with one entry per line, "
  11904. "prefixing each entry with its index in the stack."
  11905. msgstr ""
  11906. #. type: item
  11907. #: ./bashref.texi:7115 ./bashref.texi:7141 ./bashref.texi:7164
  11908. #, no-wrap
  11909. msgid "+@var{N}"
  11910. msgstr ""
  11911. #. type: table
  11912. #: ./bashref.texi:7119
  11913. msgid ""
  11914. "Displays the @var{N}th directory (counting from the left of the list printed "
  11915. "by @code{dirs} when invoked without options), starting with zero."
  11916. msgstr ""
  11917. #. type: item
  11918. #: ./bashref.texi:7119 ./bashref.texi:7144 ./bashref.texi:7168
  11919. #, no-wrap
  11920. msgid "-@var{N}"
  11921. msgstr ""
  11922. #. type: table
  11923. #: ./bashref.texi:7123
  11924. msgid ""
  11925. "Displays the @var{N}th directory (counting from the right of the list "
  11926. "printed by @code{dirs} when invoked without options), starting with zero."
  11927. msgstr ""
  11928. #. type: btindex
  11929. #: ./bashref.texi:7125 ./bashref.texi:7126
  11930. #, no-wrap
  11931. msgid "popd"
  11932. msgstr ""
  11933. #. type: example
  11934. #: ./bashref.texi:7129
  11935. #, no-wrap
  11936. msgid "popd [-n] [+@var{N} | -@var{N}]\n"
  11937. msgstr ""
  11938. #. type: table
  11939. #: ./bashref.texi:7136
  11940. msgid ""
  11941. "When no arguments are given, @code{popd} removes the top directory from the "
  11942. "stack and performs a @code{cd} to the new top directory. The elements are "
  11943. "numbered from 0 starting at the first directory listed with @code{dirs}; "
  11944. "that is, @code{popd} is equivalent to @code{popd +0}."
  11945. msgstr ""
  11946. #. type: table
  11947. #: ./bashref.texi:7141
  11948. msgid ""
  11949. "Suppresses the normal change of directory when removing directories from the "
  11950. "stack, so that only the stack is manipulated."
  11951. msgstr ""
  11952. #. type: table
  11953. #: ./bashref.texi:7144
  11954. msgid ""
  11955. "Removes the @var{N}th directory (counting from the left of the list printed "
  11956. "by @code{dirs}), starting with zero."
  11957. msgstr ""
  11958. #. type: table
  11959. #: ./bashref.texi:7147
  11960. msgid ""
  11961. "Removes the @var{N}th directory (counting from the right of the list printed "
  11962. "by @code{dirs}), starting with zero."
  11963. msgstr ""
  11964. #. type: item
  11965. #: ./bashref.texi:7149 ./bashref.texi:7150
  11966. #, no-wrap
  11967. msgid "pushd"
  11968. msgstr ""
  11969. #. type: example
  11970. #: ./bashref.texi:7153
  11971. #, no-wrap
  11972. msgid "pushd [-n] [@var{+N} | @var{-N} | @var{dir}]\n"
  11973. msgstr ""
  11974. #. type: table
  11975. #: ./bashref.texi:7159
  11976. msgid ""
  11977. "Save the current directory on the top of the directory stack and then "
  11978. "@code{cd} to @var{dir}. With no arguments, @code{pushd} exchanges the top "
  11979. "two directories and makes the new top the current directory."
  11980. msgstr ""
  11981. #. type: table
  11982. #: ./bashref.texi:7164
  11983. msgid ""
  11984. "Suppresses the normal change of directory when rotating or adding "
  11985. "directories to the stack, so that only the stack is manipulated."
  11986. msgstr ""
  11987. #. type: table
  11988. #: ./bashref.texi:7168
  11989. msgid ""
  11990. "Brings the @var{N}th directory (counting from the left of the list printed "
  11991. "by @code{dirs}, starting with zero) to the top of the list by rotating the "
  11992. "stack."
  11993. msgstr ""
  11994. #. type: table
  11995. #: ./bashref.texi:7172
  11996. msgid ""
  11997. "Brings the @var{N}th directory (counting from the right of the list printed "
  11998. "by @code{dirs}, starting with zero) to the top of the list by rotating the "
  11999. "stack."
  12000. msgstr ""
  12001. #. type: var{#1}
  12002. #: ./bashref.texi:7172
  12003. #, no-wrap
  12004. msgid "dir"
  12005. msgstr ""
  12006. #. type: table
  12007. #: ./bashref.texi:7176
  12008. msgid ""
  12009. "Makes @var{dir} be the top of the stack, making it the new current directory "
  12010. "as if it had been supplied as an argument to the @code{cd} builtin."
  12011. msgstr ""
  12012. #. type: cindex
  12013. #: ./bashref.texi:7181
  12014. #, no-wrap
  12015. msgid "prompting"
  12016. msgstr ""
  12017. #. type: Plain text
  12018. #: ./bashref.texi:7187
  12019. msgid ""
  12020. "The value of the variable @env{PROMPT_COMMAND} is examined just before Bash "
  12021. "prints each primary prompt. If @env{PROMPT_COMMAND} is set and has a "
  12022. "non-null value, then the value is executed just as if it had been typed on "
  12023. "the command line."
  12024. msgstr ""
  12025. #. type: Plain text
  12026. #: ./bashref.texi:7190
  12027. msgid ""
  12028. "In addition, the following table describes the special characters which can "
  12029. "appear in the prompt variables @env{PS1} to @env{PS4}:"
  12030. msgstr ""
  12031. #. type: table
  12032. #: ./bashref.texi:7194
  12033. msgid "A bell character."
  12034. msgstr ""
  12035. #. type: item
  12036. #: ./bashref.texi:7194
  12037. #, no-wrap
  12038. msgid "\\d"
  12039. msgstr ""
  12040. #. type: table
  12041. #: ./bashref.texi:7196
  12042. msgid "The date, in \"Weekday Month Date\" format (e.g., \"Tue May 26\")."
  12043. msgstr ""
  12044. #. type: item
  12045. #: ./bashref.texi:7196
  12046. #, no-wrap
  12047. msgid "\\D@{@var{format}@}"
  12048. msgstr ""
  12049. #. type: table
  12050. #: ./bashref.texi:7200
  12051. msgid ""
  12052. "The @var{format} is passed to @code{strftime}(3) and the result is inserted "
  12053. "into the prompt string; an empty @var{format} results in a locale-specific "
  12054. "time representation. The braces are required."
  12055. msgstr ""
  12056. #. type: table
  12057. #: ./bashref.texi:7202
  12058. msgid "An escape character."
  12059. msgstr ""
  12060. #. type: item
  12061. #: ./bashref.texi:7202
  12062. #, no-wrap
  12063. msgid "\\h"
  12064. msgstr ""
  12065. #. type: table
  12066. #: ./bashref.texi:7204
  12067. msgid "The hostname, up to the first `.'."
  12068. msgstr ""
  12069. #. type: item
  12070. #: ./bashref.texi:7204
  12071. #, no-wrap
  12072. msgid "\\H"
  12073. msgstr ""
  12074. #. type: table
  12075. #: ./bashref.texi:7206
  12076. msgid "The hostname."
  12077. msgstr ""
  12078. #. type: item
  12079. #: ./bashref.texi:7206
  12080. #, no-wrap
  12081. msgid "\\j"
  12082. msgstr ""
  12083. #. type: table
  12084. #: ./bashref.texi:7208
  12085. msgid "The number of jobs currently managed by the shell."
  12086. msgstr ""
  12087. #. type: item
  12088. #: ./bashref.texi:7208
  12089. #, no-wrap
  12090. msgid "\\l"
  12091. msgstr ""
  12092. #. type: table
  12093. #: ./bashref.texi:7210
  12094. msgid "The basename of the shell's terminal device name."
  12095. msgstr ""
  12096. #. type: table
  12097. #: ./bashref.texi:7212
  12098. msgid "A newline."
  12099. msgstr ""
  12100. #. type: table
  12101. #: ./bashref.texi:7214
  12102. msgid "A carriage return."
  12103. msgstr ""
  12104. #. type: item
  12105. #: ./bashref.texi:7214
  12106. #, no-wrap
  12107. msgid "\\s"
  12108. msgstr ""
  12109. #. type: table
  12110. #: ./bashref.texi:7217
  12111. msgid ""
  12112. "The name of the shell, the basename of @code{$0} (the portion following the "
  12113. "final slash)."
  12114. msgstr ""
  12115. #. type: table
  12116. #: ./bashref.texi:7219
  12117. msgid "The time, in 24-hour HH:MM:SS format."
  12118. msgstr ""
  12119. #. type: item
  12120. #: ./bashref.texi:7219
  12121. #, no-wrap
  12122. msgid "\\T"
  12123. msgstr ""
  12124. #. type: table
  12125. #: ./bashref.texi:7221
  12126. msgid "The time, in 12-hour HH:MM:SS format."
  12127. msgstr ""
  12128. #. type: item
  12129. #: ./bashref.texi:7221
  12130. #, no-wrap
  12131. msgid "\\@@"
  12132. msgstr ""
  12133. #. type: table
  12134. #: ./bashref.texi:7223
  12135. msgid "The time, in 12-hour am/pm format."
  12136. msgstr ""
  12137. #. type: item
  12138. #: ./bashref.texi:7223
  12139. #, no-wrap
  12140. msgid "\\A"
  12141. msgstr ""
  12142. #. type: table
  12143. #: ./bashref.texi:7225
  12144. msgid "The time, in 24-hour HH:MM format."
  12145. msgstr ""
  12146. #. type: item
  12147. #: ./bashref.texi:7225
  12148. #, no-wrap
  12149. msgid "\\u"
  12150. msgstr ""
  12151. #. type: table
  12152. #: ./bashref.texi:7227
  12153. msgid "The username of the current user."
  12154. msgstr ""
  12155. #. type: table
  12156. #: ./bashref.texi:7229
  12157. msgid "The version of Bash (e.g., 2.00)"
  12158. msgstr ""
  12159. #. type: item
  12160. #: ./bashref.texi:7229
  12161. #, no-wrap
  12162. msgid "\\V"
  12163. msgstr ""
  12164. #. type: table
  12165. #: ./bashref.texi:7231
  12166. msgid "The release of Bash, version + patchlevel (e.g., 2.00.0)"
  12167. msgstr ""
  12168. #. type: item
  12169. #: ./bashref.texi:7231
  12170. #, no-wrap
  12171. msgid "\\w"
  12172. msgstr ""
  12173. #. type: table
  12174. #: ./bashref.texi:7234
  12175. msgid ""
  12176. "The current working directory, with @env{$HOME} abbreviated with a tilde "
  12177. "(uses the @env{$PROMPT_DIRTRIM} variable)."
  12178. msgstr ""
  12179. #. type: item
  12180. #: ./bashref.texi:7234
  12181. #, no-wrap
  12182. msgid "\\W"
  12183. msgstr ""
  12184. #. type: table
  12185. #: ./bashref.texi:7236
  12186. msgid "The basename of @env{$PWD}, with @env{$HOME} abbreviated with a tilde."
  12187. msgstr ""
  12188. #. type: item
  12189. #: ./bashref.texi:7236
  12190. #, no-wrap
  12191. msgid "\\!"
  12192. msgstr ""
  12193. #. type: table
  12194. #: ./bashref.texi:7238
  12195. msgid "The history number of this command."
  12196. msgstr ""
  12197. #. type: item
  12198. #: ./bashref.texi:7238
  12199. #, no-wrap
  12200. msgid "\\#"
  12201. msgstr ""
  12202. #. type: table
  12203. #: ./bashref.texi:7240
  12204. msgid "The command number of this command."
  12205. msgstr ""
  12206. #. type: item
  12207. #: ./bashref.texi:7240
  12208. #, no-wrap
  12209. msgid "\\$"
  12210. msgstr ""
  12211. #. type: table
  12212. #: ./bashref.texi:7242
  12213. msgid "If the effective uid is 0, @code{#}, otherwise @code{$}."
  12214. msgstr ""
  12215. #. type: table
  12216. #: ./bashref.texi:7244
  12217. msgid "The character whose ASCII code is the octal value @var{nnn}."
  12218. msgstr ""
  12219. #. type: table
  12220. #: ./bashref.texi:7246
  12221. msgid "A backslash."
  12222. msgstr ""
  12223. #. type: item
  12224. #: ./bashref.texi:7246
  12225. #, no-wrap
  12226. msgid "\\["
  12227. msgstr ""
  12228. #. type: table
  12229. #: ./bashref.texi:7249
  12230. msgid ""
  12231. "Begin a sequence of non-printing characters. This could be used to embed a "
  12232. "terminal control sequence into the prompt."
  12233. msgstr ""
  12234. #. type: item
  12235. #: ./bashref.texi:7249
  12236. #, no-wrap
  12237. msgid "\\]"
  12238. msgstr ""
  12239. #. type: table
  12240. #: ./bashref.texi:7251
  12241. msgid "End a sequence of non-printing characters."
  12242. msgstr ""
  12243. #. type: Plain text
  12244. #: ./bashref.texi:7259
  12245. msgid ""
  12246. "The command number and the history number are usually different: the history "
  12247. "number of a command is its position in the history list, which may include "
  12248. "commands restored from the history file (@pxref{Bash History Facilities}), "
  12249. "while the command number is the position in the sequence of commands "
  12250. "executed during the current shell session."
  12251. msgstr ""
  12252. #. type: Plain text
  12253. #: ./bashref.texi:7264
  12254. msgid ""
  12255. "After the string is decoded, it is expanded via parameter expansion, command "
  12256. "substitution, arithmetic expansion, and quote removal, subject to the value "
  12257. "of the @code{promptvars} shell option (@pxref{Bash Builtins})."
  12258. msgstr ""
  12259. #. type: cindex
  12260. #: ./bashref.texi:7267
  12261. #, no-wrap
  12262. msgid "restricted shell"
  12263. msgstr ""
  12264. #. type: Plain text
  12265. #: ./bashref.texi:7278
  12266. msgid ""
  12267. "If Bash is started with the name @code{rbash}, or the @option{--restricted} "
  12268. "or @option{-r} option is supplied at invocation, the shell becomes "
  12269. "restricted. A restricted shell is used to set up an environment more "
  12270. "controlled than the standard shell. A restricted shell behaves identically "
  12271. "to @code{bash} with the exception that the following are disallowed or not "
  12272. "performed:"
  12273. msgstr ""
  12274. #. type: itemize
  12275. #: ./bashref.texi:7282
  12276. msgid "Changing directories with the @code{cd} builtin."
  12277. msgstr ""
  12278. #. type: itemize
  12279. #: ./bashref.texi:7285
  12280. msgid ""
  12281. "Setting or unsetting the values of the @env{SHELL}, @env{PATH}, @env{ENV}, "
  12282. "or @env{BASH_ENV} variables."
  12283. msgstr ""
  12284. #. type: itemize
  12285. #: ./bashref.texi:7287
  12286. msgid "Specifying command names containing slashes."
  12287. msgstr ""
  12288. #. type: itemize
  12289. #: ./bashref.texi:7290
  12290. msgid ""
  12291. "Specifying a filename containing a slash as an argument to the @code{.} "
  12292. "builtin command."
  12293. msgstr ""
  12294. #. type: itemize
  12295. #: ./bashref.texi:7293
  12296. msgid ""
  12297. "Specifying a filename containing a slash as an argument to the @option{-p} "
  12298. "option to the @code{hash} builtin command."
  12299. msgstr ""
  12300. #. type: itemize
  12301. #: ./bashref.texi:7295
  12302. msgid "Importing function definitions from the shell environment at startup."
  12303. msgstr ""
  12304. #. type: itemize
  12305. #: ./bashref.texi:7297
  12306. msgid "Parsing the value of @env{SHELLOPTS} from the shell environment at startup."
  12307. msgstr ""
  12308. #. type: itemize
  12309. #: ./bashref.texi:7300
  12310. msgid ""
  12311. "Redirecting output using the @samp{>}, @samp{>|}, @samp{<>}, @samp{>&}, "
  12312. "@samp{&>}, and @samp{>>} redirection operators."
  12313. msgstr ""
  12314. #. type: itemize
  12315. #: ./bashref.texi:7302
  12316. msgid "Using the @code{exec} builtin to replace the shell with another command."
  12317. msgstr ""
  12318. #. type: itemize
  12319. #: ./bashref.texi:7305
  12320. msgid ""
  12321. "Adding or deleting builtin commands with the @option{-f} and @option{-d} "
  12322. "options to the @code{enable} builtin."
  12323. msgstr ""
  12324. #. type: itemize
  12325. #: ./bashref.texi:7307
  12326. msgid "Using the @code{enable} builtin command to enable disabled shell builtins."
  12327. msgstr ""
  12328. #. type: itemize
  12329. #: ./bashref.texi:7309
  12330. msgid "Specifying the @option{-p} option to the @code{command} builtin."
  12331. msgstr ""
  12332. #. type: itemize
  12333. #: ./bashref.texi:7311
  12334. msgid "Turning off restricted mode with @samp{set +r} or @samp{set +o restricted}."
  12335. msgstr ""
  12336. #. type: Plain text
  12337. #: ./bashref.texi:7314
  12338. msgid "These restrictions are enforced after any startup files are read."
  12339. msgstr ""
  12340. #. type: Plain text
  12341. #: ./bashref.texi:7318
  12342. msgid ""
  12343. "When a command that is found to be a shell script is executed (@pxref{Shell "
  12344. "Scripts}), @code{rbash} turns off any restrictions in the shell spawned to "
  12345. "execute the script."
  12346. msgstr ""
  12347. #. type: cindex
  12348. #: ./bashref.texi:7321
  12349. #, no-wrap
  12350. msgid "POSIX Mode"
  12351. msgstr ""
  12352. #. type: Plain text
  12353. #: ./bashref.texi:7327
  12354. msgid ""
  12355. "Starting Bash with the @option{--posix} command-line option or executing "
  12356. "@samp{set -o posix} while Bash is running will cause Bash to conform more "
  12357. "closely to the @sc{posix} standard by changing the behavior to match that "
  12358. "specified by @sc{posix} in areas where the Bash default differs."
  12359. msgstr ""
  12360. #. type: Plain text
  12361. #: ./bashref.texi:7330
  12362. msgid ""
  12363. "When invoked as @code{sh}, Bash enters @sc{posix} mode after reading the "
  12364. "startup files."
  12365. msgstr ""
  12366. #. type: Plain text
  12367. #: ./bashref.texi:7332
  12368. msgid "The following list is what's changed when `@sc{posix} mode' is in effect:"
  12369. msgstr ""
  12370. #. type: enumerate
  12371. #: ./bashref.texi:7338
  12372. msgid ""
  12373. "When a command in the hash table no longer exists, Bash will re-search "
  12374. "@env{$PATH} to find the new location. This is also available with "
  12375. "@samp{shopt -s checkhash}."
  12376. msgstr ""
  12377. #. type: enumerate
  12378. #: ./bashref.texi:7342
  12379. msgid ""
  12380. "The message printed by the job control code and builtins when a job exits "
  12381. "with a non-zero status is `Done(status)'."
  12382. msgstr ""
  12383. #. type: enumerate
  12384. #: ./bashref.texi:7347
  12385. msgid ""
  12386. "The message printed by the job control code and builtins when a job is "
  12387. "stopped is `Stopped(@var{signame})', where @var{signame} is, for example, "
  12388. "@code{SIGTSTP}."
  12389. msgstr ""
  12390. #. type: enumerate
  12391. #: ./bashref.texi:7350
  12392. msgid "Alias expansion is always enabled, even in non-interactive shells."
  12393. msgstr ""
  12394. #. type: enumerate
  12395. #: ./bashref.texi:7354
  12396. msgid ""
  12397. "Reserved words appearing in a context where reserved words are recognized do "
  12398. "not undergo alias expansion."
  12399. msgstr ""
  12400. #. type: enumerate
  12401. #: ./bashref.texi:7360
  12402. msgid ""
  12403. "The @sc{posix} @env{PS1} and @env{PS2} expansions of @samp{!} to the history "
  12404. "number and @samp{!!} to @samp{!} are enabled, and parameter expansion is "
  12405. "performed on the values of @env{PS1} and @env{PS2} regardless of the setting "
  12406. "of the @code{promptvars} option."
  12407. msgstr ""
  12408. #. type: enumerate
  12409. #: ./bashref.texi:7364
  12410. msgid ""
  12411. "The @sc{posix} startup files are executed (@env{$ENV}) rather than the "
  12412. "normal Bash files."
  12413. msgstr ""
  12414. #. type: enumerate
  12415. #: ./bashref.texi:7368
  12416. msgid ""
  12417. "Tilde expansion is only performed on assignments preceding a command name, "
  12418. "rather than on all assignment statements on the line."
  12419. msgstr ""
  12420. #. type: enumerate
  12421. #: ./bashref.texi:7372
  12422. msgid ""
  12423. "The default history file is @file{~/.sh_history} (this is the default value "
  12424. "of @env{$HISTFILE})."
  12425. msgstr ""
  12426. #. type: enumerate
  12427. #: ./bashref.texi:7376
  12428. msgid ""
  12429. "Redirection operators do not perform filename expansion on the word in the "
  12430. "redirection unless the shell is interactive."
  12431. msgstr ""
  12432. #. type: enumerate
  12433. #: ./bashref.texi:7380
  12434. msgid ""
  12435. "Redirection operators do not perform word splitting on the word in the "
  12436. "redirection."
  12437. msgstr ""
  12438. #. type: enumerate
  12439. #: ./bashref.texi:7386
  12440. msgid ""
  12441. "Function names must be valid shell @code{name}s. That is, they may not "
  12442. "contain characters other than letters, digits, and underscores, and may not "
  12443. "start with a digit. Declaring a function with an invalid name causes a "
  12444. "fatal syntax error in non-interactive shells."
  12445. msgstr ""
  12446. #. type: enumerate
  12447. #: ./bashref.texi:7390
  12448. msgid ""
  12449. "Function names may not be the same as one of the @sc{posix} special "
  12450. "builtins."
  12451. msgstr ""
  12452. #. type: enumerate
  12453. #: ./bashref.texi:7394
  12454. msgid ""
  12455. "@sc{posix} special builtins are found before shell functions during command "
  12456. "lookup."
  12457. msgstr ""
  12458. #. type: enumerate
  12459. #: ./bashref.texi:7398
  12460. msgid ""
  12461. "When printing shell function definitions (e.g., by @code{type}), Bash does "
  12462. "not print the @code{function} keyword."
  12463. msgstr ""
  12464. #. type: enumerate
  12465. #: ./bashref.texi:7403
  12466. msgid ""
  12467. "Literal tildes that appear as the first character in elements of the "
  12468. "@env{PATH} variable are not expanded as described above under @ref{Tilde "
  12469. "Expansion}."
  12470. msgstr ""
  12471. #. type: enumerate
  12472. #: ./bashref.texi:7409
  12473. msgid ""
  12474. "The @code{time} reserved word may be used by itself as a command. When used "
  12475. "in this way, it displays timing statistics for the shell and its completed "
  12476. "children. The @env{TIMEFORMAT} variable controls the format of the timing "
  12477. "information."
  12478. msgstr ""
  12479. #. type: enumerate
  12480. #: ./bashref.texi:7416
  12481. msgid ""
  12482. "When parsing and expanding a $@{@dots{}@} expansion that appears within "
  12483. "double quotes, single quotes are no longer special and cannot be used to "
  12484. "quote a closing brace or other special character, unless the operator is one "
  12485. "of those defined to perform pattern removal. In this case, they do not have "
  12486. "to appear as matched pairs."
  12487. msgstr ""
  12488. #. type: enumerate
  12489. #: ./bashref.texi:7420
  12490. msgid ""
  12491. "The parser does not recognize @code{time} as a reserved word if the next "
  12492. "token begins with a @samp{-}."
  12493. msgstr ""
  12494. #. type: enumerate
  12495. #: ./bashref.texi:7424
  12496. msgid ""
  12497. "The @samp{!} character does not introduce history expansion within a "
  12498. "double-quoted string, even if the @code{histexpand} option is enabled."
  12499. msgstr ""
  12500. #. type: enumerate
  12501. #: ./bashref.texi:7431
  12502. msgid ""
  12503. "If a @sc{posix} special builtin returns an error status, a non-interactive "
  12504. "shell exits. The fatal errors are those listed in the @sc{posix} standard, "
  12505. "and include things like passing incorrect options, redirection errors, "
  12506. "variable assignment errors for assignments preceding the command name, and "
  12507. "so on."
  12508. msgstr ""
  12509. #. type: enumerate
  12510. #: ./bashref.texi:7438
  12511. msgid ""
  12512. "A non-interactive shell exits with an error status if a variable assignment "
  12513. "error occurs when no command name follows the assignment statements. A "
  12514. "variable assignment error occurs, for example, when trying to assign a value "
  12515. "to a readonly variable."
  12516. msgstr ""
  12517. #. type: enumerate
  12518. #: ./bashref.texi:7443
  12519. msgid ""
  12520. "A non-interactive shell exits with an error status if a variable assignment "
  12521. "error occurs in an assignment statement preceding a special builtin, but not "
  12522. "with any other simple command."
  12523. msgstr ""
  12524. #. type: enumerate
  12525. #: ./bashref.texi:7448
  12526. msgid ""
  12527. "A non-interactive shell exits with an error status if the iteration variable "
  12528. "in a @code{for} statement or the selection variable in a @code{select} "
  12529. "statement is a readonly variable."
  12530. msgstr ""
  12531. #. type: enumerate
  12532. #: ./bashref.texi:7452
  12533. msgid ""
  12534. "Non-interactive shells exit if @var{filename} in @code{.} @var{filename} is "
  12535. "not found."
  12536. msgstr ""
  12537. #. type: enumerate
  12538. #: ./bashref.texi:7456
  12539. msgid ""
  12540. "Non-interactive shells exit if a syntax error in an arithmetic expansion "
  12541. "results in an invalid expression."
  12542. msgstr ""
  12543. #. type: enumerate
  12544. #: ./bashref.texi:7459
  12545. msgid "Non-interactive shells exit if a parameter expansion error occurs."
  12546. msgstr ""
  12547. #. type: enumerate
  12548. #: ./bashref.texi:7464
  12549. msgid ""
  12550. "Non-interactive shells exit if there is a syntax error in a script read with "
  12551. "the @code{.} or @code{source} builtins, or in a string processed by the "
  12552. "@code{eval} builtin."
  12553. msgstr ""
  12554. #. type: enumerate
  12555. #: ./bashref.texi:7467
  12556. msgid "Process substitution is not available."
  12557. msgstr ""
  12558. #. type: enumerate
  12559. #: ./bashref.texi:7471
  12560. msgid ""
  12561. "While variable indirection is available, it may not be applied to the "
  12562. "@samp{#} and @samp{?} special parameters."
  12563. msgstr ""
  12564. #. type: enumerate
  12565. #: ./bashref.texi:7476
  12566. msgid ""
  12567. "When expanding the @samp{*} special parameter in a pattern context where the "
  12568. "expansion is double-quoted does not treat the @code{$*} as if it were "
  12569. "double-quoted."
  12570. msgstr ""
  12571. #. type: enumerate
  12572. #: ./bashref.texi:7480
  12573. msgid ""
  12574. "Assignment statements preceding @sc{posix} special builtins persist in the "
  12575. "shell environment after the builtin completes."
  12576. msgstr ""
  12577. #. type: enumerate
  12578. #: ./bashref.texi:7485
  12579. msgid ""
  12580. "Assignment statements preceding shell function calls persist in the shell "
  12581. "environment after the function returns, as if a @sc{posix} special builtin "
  12582. "command had been executed."
  12583. msgstr ""
  12584. #. type: enumerate
  12585. #: ./bashref.texi:7491
  12586. msgid ""
  12587. "The @code{command} builtin does not prevent builtins that take assignment "
  12588. "statements as arguments from expanding them as assignment statements; when "
  12589. "not in @sc{posix} mode, assignment builtins lose their assignment statement "
  12590. "expansion properties when preceded by @code{command}."
  12591. msgstr ""
  12592. #. type: enumerate
  12593. #: ./bashref.texi:7496
  12594. msgid ""
  12595. "The @code{bg} builtin uses the required format to describe each job placed "
  12596. "in the background, which does not include an indication of whether the job "
  12597. "is the current or previous job."
  12598. msgstr ""
  12599. #. type: enumerate
  12600. #: ./bashref.texi:7500
  12601. msgid ""
  12602. "The output of @samp{kill -l} prints all the signal names on a single line, "
  12603. "separated by spaces, without the @samp{SIG} prefix."
  12604. msgstr ""
  12605. #. type: enumerate
  12606. #: ./bashref.texi:7504
  12607. msgid ""
  12608. "The @code{kill} builtin does not accept signal names with a @samp{SIG} "
  12609. "prefix."
  12610. msgstr ""
  12611. #. type: enumerate
  12612. #: ./bashref.texi:7508
  12613. msgid ""
  12614. "The @code{export} and @code{readonly} builtin commands display their output "
  12615. "in the format required by @sc{posix}."
  12616. msgstr ""
  12617. #. type: enumerate
  12618. #: ./bashref.texi:7512
  12619. msgid ""
  12620. "The @code{trap} builtin displays signal names without the leading "
  12621. "@code{SIG}."
  12622. msgstr ""
  12623. #. type: enumerate
  12624. #: ./bashref.texi:7520
  12625. msgid ""
  12626. "The @code{trap} builtin doesn't check the first argument for a possible "
  12627. "signal specification and revert the signal handling to the original "
  12628. "disposition if it is, unless that argument consists solely of digits and is "
  12629. "a valid signal number. If users want to reset the handler for a given "
  12630. "signal to the original disposition, they should use @samp{-} as the first "
  12631. "argument."
  12632. msgstr ""
  12633. #. type: enumerate
  12634. #: ./bashref.texi:7524
  12635. msgid ""
  12636. "The @code{.} and @code{source} builtins do not search the current directory "
  12637. "for the filename argument if it is not found by searching @env{PATH}."
  12638. msgstr ""
  12639. #. type: enumerate
  12640. #: ./bashref.texi:7532
  12641. msgid ""
  12642. "Enabling @sc{posix} mode has the effect of setting the "
  12643. "@code{inherit_errexit} option, so subshells spawned to execute command "
  12644. "substitutions inherit the value of the @option{-e} option from the parent "
  12645. "shell. When the @code{inherit_errexit} option is not enabled, Bash clears "
  12646. "the @option{-e} option in such subshells."
  12647. msgstr ""
  12648. #. type: enumerate
  12649. #: ./bashref.texi:7537
  12650. msgid ""
  12651. "When the @code{alias} builtin displays alias definitions, it does not "
  12652. "display them with a leading @samp{alias } unless the @option{-p} option is "
  12653. "supplied."
  12654. msgstr ""
  12655. #. type: enumerate
  12656. #: ./bashref.texi:7541
  12657. msgid ""
  12658. "When the @code{set} builtin is invoked without options, it does not display "
  12659. "shell function names and definitions."
  12660. msgstr ""
  12661. #. type: enumerate
  12662. #: ./bashref.texi:7546
  12663. msgid ""
  12664. "When the @code{set} builtin is invoked without options, it displays variable "
  12665. "values without quotes, unless they contain shell metacharacters, even if the "
  12666. "result contains nonprinting characters."
  12667. msgstr ""
  12668. #. type: enumerate
  12669. #: ./bashref.texi:7552
  12670. msgid ""
  12671. "When the @code{cd} builtin is invoked in @var{logical} mode, and the "
  12672. "pathname constructed from @code{$PWD} and the directory name supplied as an "
  12673. "argument does not refer to an existing directory, @code{cd} will fail "
  12674. "instead of falling back to @var{physical} mode."
  12675. msgstr ""
  12676. #. type: enumerate
  12677. #: ./bashref.texi:7557
  12678. msgid ""
  12679. "The @code{pwd} builtin verifies that the value it prints is the same as the "
  12680. "current directory, even if it is not asked to check the file system with the "
  12681. "@option{-P} option."
  12682. msgstr ""
  12683. #. type: enumerate
  12684. #: ./bashref.texi:7561
  12685. msgid ""
  12686. "When listing the history, the @code{fc} builtin does not include an "
  12687. "indication of whether or not a history entry has been modified."
  12688. msgstr ""
  12689. #. type: enumerate
  12690. #: ./bashref.texi:7564
  12691. msgid "The default editor used by @code{fc} is @code{ed}."
  12692. msgstr ""
  12693. #. type: enumerate
  12694. #: ./bashref.texi:7569
  12695. msgid ""
  12696. "The @code{type} and @code{command} builtins will not report a non-executable "
  12697. "file as having been found, though the shell will attempt to execute such a "
  12698. "file if it is the only so-named file found in @code{$PATH}."
  12699. msgstr ""
  12700. #. type: enumerate
  12701. #: ./bashref.texi:7574
  12702. msgid ""
  12703. "The @code{vi} editing mode will invoke the @code{vi} editor directly when "
  12704. "the @samp{v} command is run, instead of checking @code{$VISUAL} and "
  12705. "@code{$EDITOR}."
  12706. msgstr ""
  12707. #. type: enumerate
  12708. #: ./bashref.texi:7579
  12709. msgid ""
  12710. "When the @code{xpg_echo} option is enabled, Bash does not attempt to "
  12711. "interpret any arguments to @code{echo} as options. Each argument is "
  12712. "displayed, after escape characters are converted."
  12713. msgstr ""
  12714. #. type: enumerate
  12715. #: ./bashref.texi:7583
  12716. msgid ""
  12717. "The @code{ulimit} builtin uses a block size of 512 bytes for the @option{-c} "
  12718. "and @option{-f} options."
  12719. msgstr ""
  12720. #. type: enumerate
  12721. #: ./bashref.texi:7588
  12722. msgid ""
  12723. "The arrival of @code{SIGCHLD} when a trap is set on @code{SIGCHLD} does not "
  12724. "interrupt the @code{wait} builtin and cause it to return immediately. The "
  12725. "trap command is run once for each child that exits."
  12726. msgstr ""
  12727. #. type: enumerate
  12728. #: ./bashref.texi:7594
  12729. msgid ""
  12730. "The @code{read} builtin may be interrupted by a signal for which a trap has "
  12731. "been set. If Bash receives a trapped signal while executing @code{read}, "
  12732. "the trap handler executes and @code{read} returns an exit status greater "
  12733. "than 128."
  12734. msgstr ""
  12735. #. type: enumerate
  12736. #: ./bashref.texi:7598
  12737. msgid ""
  12738. "Bash removes an exited background process's status from the list of such "
  12739. "statuses after the @code{wait} builtin is used to obtain it."
  12740. msgstr ""
  12741. #. type: Plain text
  12742. #: ./bashref.texi:7604
  12743. msgid ""
  12744. "There is other @sc{posix} behavior that Bash does not implement by default "
  12745. "even when in @sc{posix} mode. Specifically:"
  12746. msgstr ""
  12747. #. type: enumerate
  12748. #: ./bashref.texi:7611
  12749. msgid ""
  12750. "The @code{fc} builtin checks @code{$EDITOR} as a program to edit history "
  12751. "entries if @code{FCEDIT} is unset, rather than defaulting directly to "
  12752. "@code{ed}. @code{fc} uses @code{ed} if @code{EDITOR} is unset."
  12753. msgstr ""
  12754. #. type: enumerate
  12755. #: ./bashref.texi:7615
  12756. msgid ""
  12757. "As noted above, Bash requires the @code{xpg_echo} option to be enabled for "
  12758. "the @code{echo} builtin to be fully conformant."
  12759. msgstr ""
  12760. #. type: Plain text
  12761. #: ./bashref.texi:7621
  12762. msgid ""
  12763. "Bash can be configured to be @sc{posix}-conformant by default, by specifying "
  12764. "the @option{--enable-strict-posix-default} to @code{configure} when building "
  12765. "(@pxref{Optional Features})."
  12766. msgstr ""
  12767. #. type: Plain text
  12768. #: ./bashref.texi:7627
  12769. msgid ""
  12770. "This chapter discusses what job control is, how it works, and how Bash "
  12771. "allows you to access its facilities."
  12772. msgstr ""
  12773. #. type: section
  12774. #: ./bashref.texi:7634 ./bashref.texi:7636 ./bashref.texi:7637
  12775. #, no-wrap
  12776. msgid "Job Control Basics"
  12777. msgstr ""
  12778. #. type: menuentry
  12779. #: ./bashref.texi:7634
  12780. msgid "How job control works."
  12781. msgstr ""
  12782. #. type: section
  12783. #: ./bashref.texi:7634 ./bashref.texi:7741 ./bashref.texi:7742
  12784. #, no-wrap
  12785. msgid "Job Control Builtins"
  12786. msgstr ""
  12787. #. type: menuentry
  12788. #: ./bashref.texi:7634
  12789. msgid "Bash builtin commands used to interact with job control."
  12790. msgstr ""
  12791. #. type: section
  12792. #: ./bashref.texi:7634 ./bashref.texi:7884 ./bashref.texi:7885
  12793. #, no-wrap
  12794. msgid "Job Control Variables"
  12795. msgstr ""
  12796. #. type: menuentry
  12797. #: ./bashref.texi:7634
  12798. msgid "Variables Bash uses to customize job control."
  12799. msgstr ""
  12800. #. type: cindex
  12801. #: ./bashref.texi:7639
  12802. #, no-wrap
  12803. msgid "foreground"
  12804. msgstr ""
  12805. #. type: cindex
  12806. #: ./bashref.texi:7640
  12807. #, no-wrap
  12808. msgid "background"
  12809. msgstr ""
  12810. #. type: cindex
  12811. #: ./bashref.texi:7641
  12812. #, no-wrap
  12813. msgid "suspending jobs"
  12814. msgstr ""
  12815. #. type: Plain text
  12816. #: ./bashref.texi:7649
  12817. msgid ""
  12818. "Job control refers to the ability to selectively stop (suspend) the "
  12819. "execution of processes and continue (resume) their execution at a later "
  12820. "point. A user typically employs this facility via an interactive interface "
  12821. "supplied jointly by the operating system kernel's terminal driver and Bash."
  12822. msgstr ""
  12823. #. type: Plain text
  12824. #: ./bashref.texi:7655
  12825. msgid ""
  12826. "The shell associates a @var{job} with each pipeline. It keeps a table of "
  12827. "currently executing jobs, which may be listed with the @code{jobs} command. "
  12828. "When Bash starts a job asynchronously, it prints a line that looks like:"
  12829. msgstr ""
  12830. #. type: example
  12831. #: ./bashref.texi:7657
  12832. #, no-wrap
  12833. msgid "[1] 25647\n"
  12834. msgstr ""
  12835. #. type: Plain text
  12836. #: ./bashref.texi:7664
  12837. msgid ""
  12838. "indicating that this job is job number 1 and that the process @sc{id} of the "
  12839. "last process in the pipeline associated with this job is 25647. All of the "
  12840. "processes in a single pipeline are members of the same job. Bash uses the "
  12841. "@var{job} abstraction as the basis for job control."
  12842. msgstr ""
  12843. #. type: Plain text
  12844. #: ./bashref.texi:7680
  12845. msgid ""
  12846. "To facilitate the implementation of the user interface to job control, the "
  12847. "operating system maintains the notion of a current terminal process group "
  12848. "@sc{id}. Members of this process group (processes whose process group "
  12849. "@sc{id} is equal to the current terminal process group @sc{id}) receive "
  12850. "keyboard-generated signals such as @code{SIGINT}. These processes are said "
  12851. "to be in the foreground. Background processes are those whose process group "
  12852. "@sc{id} differs from the terminal's; such processes are immune to "
  12853. "keyboard-generated signals. Only foreground processes are allowed to read "
  12854. "from or, if the user so specifies with @code{stty tostop}, write to the "
  12855. "terminal. Background processes which attempt to read from (write to when "
  12856. "@code{stty tostop} is in effect) the terminal are sent a @code{SIGTTIN} "
  12857. "(@code{SIGTTOU}) signal by the kernel's terminal driver, which, unless "
  12858. "caught, suspends the process."
  12859. msgstr ""
  12860. #. type: Plain text
  12861. #: ./bashref.texi:7694
  12862. msgid ""
  12863. "If the operating system on which Bash is running supports job control, Bash "
  12864. "contains facilities to use it. Typing the @var{suspend} character "
  12865. "(typically @samp{^Z}, Control-Z) while a process is running causes that "
  12866. "process to be stopped and returns control to Bash. Typing the @var{delayed "
  12867. "suspend} character (typically @samp{^Y}, Control-Y) causes the process to be "
  12868. "stopped when it attempts to read input from the terminal, and control to be "
  12869. "returned to Bash. The user then manipulates the state of this job, using "
  12870. "the @code{bg} command to continue it in the background, the @code{fg} "
  12871. "command to continue it in the foreground, or the @code{kill} command to kill "
  12872. "it. A @samp{^Z} takes effect immediately, and has the additional side "
  12873. "effect of causing pending output and typeahead to be discarded."
  12874. msgstr ""
  12875. #. type: Plain text
  12876. #: ./bashref.texi:7697
  12877. msgid ""
  12878. "There are a number of ways to refer to a job in the shell. The character "
  12879. "@samp{%} introduces a job specification (@var{jobspec})."
  12880. msgstr ""
  12881. #. type: Plain text
  12882. #: ./bashref.texi:7710
  12883. msgid ""
  12884. "Job number @code{n} may be referred to as @samp{%n}. The symbols @samp{%%} "
  12885. "and @samp{%+} refer to the shell's notion of the current job, which is the "
  12886. "last job stopped while it was in the foreground or started in the "
  12887. "background. A single @samp{%} (with no accompanying job specification) also "
  12888. "refers to the current job. The previous job may be referenced using "
  12889. "@samp{%-}. If there is only a single job, @samp{%+} and @samp{%-} can both "
  12890. "be used to refer to that job. In output pertaining to jobs (e.g., the "
  12891. "output of the @code{jobs} command), the current job is always flagged with a "
  12892. "@samp{+}, and the previous job with a @samp{-}."
  12893. msgstr ""
  12894. #. type: Plain text
  12895. #: ./bashref.texi:7718
  12896. msgid ""
  12897. "A job may also be referred to using a prefix of the name used to start it, "
  12898. "or using a substring that appears in its command line. For example, "
  12899. "@samp{%ce} refers to a stopped @code{ce} job. Using @samp{%?ce}, on the "
  12900. "other hand, refers to any job containing the string @samp{ce} in its command "
  12901. "line. If the prefix or substring matches more than one job, Bash reports an "
  12902. "error."
  12903. msgstr ""
  12904. #. type: Plain text
  12905. #: ./bashref.texi:7723
  12906. msgid ""
  12907. "Simply naming a job can be used to bring it into the foreground: @samp{%1} "
  12908. "is a synonym for @samp{fg %1}, bringing job 1 from the background into the "
  12909. "foreground. Similarly, @samp{%1 &} resumes job 1 in the background, "
  12910. "equivalent to @samp{bg %1}"
  12911. msgstr ""
  12912. #. type: Plain text
  12913. #: ./bashref.texi:7732
  12914. msgid ""
  12915. "The shell learns immediately whenever a job changes state. Normally, Bash "
  12916. "waits until it is about to print a prompt before reporting changes in a "
  12917. "job's status so as to not interrupt any other output. If the @option{-b} "
  12918. "option to the @code{set} builtin is enabled, Bash reports such changes "
  12919. "immediately (@pxref{The Set Builtin}). Any trap on @code{SIGCHLD} is "
  12920. "executed for each child process that exits."
  12921. msgstr ""
  12922. #. type: Plain text
  12923. #: ./bashref.texi:7740
  12924. msgid ""
  12925. "If an attempt to exit Bash is made while jobs are stopped, (or running, if "
  12926. "the @code{checkjobs} option is enabled -- see @ref{The Shopt Builtin}), the "
  12927. "shell prints a warning message, and if the @code{checkjobs} option is "
  12928. "enabled, lists the jobs and their statuses. The @code{jobs} command may "
  12929. "then be used to inspect their status. If a second attempt to exit is made "
  12930. "without an intervening command, Bash does not print another warning, and any "
  12931. "stopped jobs are terminated."
  12932. msgstr ""
  12933. #. type: btindex
  12934. #: ./bashref.texi:7746 ./bashref.texi:7747
  12935. #, no-wrap
  12936. msgid "bg"
  12937. msgstr ""
  12938. #. type: example
  12939. #: ./bashref.texi:7750
  12940. #, no-wrap
  12941. msgid "bg [@var{jobspec} @dots{}]\n"
  12942. msgstr ""
  12943. #. type: table
  12944. #: ./bashref.texi:7759
  12945. msgid ""
  12946. "Resume each suspended job @var{jobspec} in the background, as if it had been "
  12947. "started with @samp{&}. If @var{jobspec} is not supplied, the current job is "
  12948. "used. The return status is zero unless it is run when job control is not "
  12949. "enabled, or, when run with job control enabled, any @var{jobspec} was not "
  12950. "found or specifies a job that was started without job control."
  12951. msgstr ""
  12952. #. type: btindex
  12953. #: ./bashref.texi:7760 ./bashref.texi:7761
  12954. #, no-wrap
  12955. msgid "fg"
  12956. msgstr ""
  12957. #. type: example
  12958. #: ./bashref.texi:7764
  12959. #, no-wrap
  12960. msgid "fg [@var{jobspec}]\n"
  12961. msgstr ""
  12962. #. type: table
  12963. #: ./bashref.texi:7772
  12964. msgid ""
  12965. "Resume the job @var{jobspec} in the foreground and make it the current job. "
  12966. "If @var{jobspec} is not supplied, the current job is used. The return "
  12967. "status is that of the command placed into the foreground, or non-zero if run "
  12968. "when job control is disabled or, when run with job control enabled, "
  12969. "@var{jobspec} does not specify a valid job or @var{jobspec} specifies a job "
  12970. "that was started without job control."
  12971. msgstr ""
  12972. #. type: btindex
  12973. #: ./bashref.texi:7773 ./bashref.texi:7774
  12974. #, no-wrap
  12975. msgid "jobs"
  12976. msgstr ""
  12977. #. type: example
  12978. #: ./bashref.texi:7778
  12979. #, no-wrap
  12980. msgid ""
  12981. "jobs [-lnprs] [@var{jobspec}]\n"
  12982. "jobs -x @var{command} [@var{arguments}]\n"
  12983. msgstr ""
  12984. #. type: table
  12985. #: ./bashref.texi:7782
  12986. msgid ""
  12987. "The first form lists the active jobs. The options have the following "
  12988. "meanings:"
  12989. msgstr ""
  12990. #. type: table
  12991. #: ./bashref.texi:7786
  12992. msgid "List process @sc{id}s in addition to the normal information."
  12993. msgstr ""
  12994. #. type: table
  12995. #: ./bashref.texi:7790
  12996. msgid ""
  12997. "Display information only about jobs that have changed status since the user "
  12998. "was last notified of their status."
  12999. msgstr ""
  13000. #. type: table
  13001. #: ./bashref.texi:7793
  13002. msgid "List only the process @sc{id} of the job's process group leader."
  13003. msgstr ""
  13004. #. type: table
  13005. #: ./bashref.texi:7796
  13006. msgid "Display only running jobs."
  13007. msgstr ""
  13008. #. type: table
  13009. #: ./bashref.texi:7799
  13010. msgid "Display only stopped jobs."
  13011. msgstr ""
  13012. #. type: table
  13013. #: ./bashref.texi:7805
  13014. msgid ""
  13015. "If @var{jobspec} is given, output is restricted to information about that "
  13016. "job. If @var{jobspec} is not supplied, the status of all jobs is listed."
  13017. msgstr ""
  13018. #. type: table
  13019. #: ./bashref.texi:7810
  13020. msgid ""
  13021. "If the @option{-x} option is supplied, @code{jobs} replaces any "
  13022. "@var{jobspec} found in @var{command} or @var{arguments} with the "
  13023. "corresponding process group @sc{id}, and executes @var{command}, passing it "
  13024. "@var{argument}s, returning its exit status."
  13025. msgstr ""
  13026. #. type: btindex
  13027. #: ./bashref.texi:7811 ./bashref.texi:7812
  13028. #, no-wrap
  13029. msgid "kill"
  13030. msgstr ""
  13031. #. type: example
  13032. #: ./bashref.texi:7816
  13033. #, no-wrap
  13034. msgid ""
  13035. "kill [-s @var{sigspec}] [-n @var{signum}] [-@var{sigspec}] @var{jobspec} or "
  13036. "@var{pid}\n"
  13037. "kill -l|-L [@var{exit_status}]\n"
  13038. msgstr ""
  13039. #. type: table
  13040. #: ./bashref.texi:7833
  13041. msgid ""
  13042. "Send a signal specified by @var{sigspec} or @var{signum} to the process "
  13043. "named by job specification @var{jobspec} or process @sc{id} @var{pid}. "
  13044. "@var{sigspec} is either a case-insensitive signal name such as @code{SIGINT} "
  13045. "(with or without the @code{SIG} prefix) or a signal number; @var{signum} is "
  13046. "a signal number. If @var{sigspec} and @var{signum} are not present, "
  13047. "@code{SIGTERM} is used. The @option{-l} option lists the signal names. If "
  13048. "any arguments are supplied when @option{-l} is given, the names of the "
  13049. "signals corresponding to the arguments are listed, and the return status is "
  13050. "zero. @var{exit_status} is a number specifying a signal number or the exit "
  13051. "status of a process terminated by a signal. The @option{-L} option is "
  13052. "equivalent to @option{-l}. The return status is zero if at least one signal "
  13053. "was successfully sent, or non-zero if an error occurs or an invalid option "
  13054. "is encountered."
  13055. msgstr ""
  13056. #. type: btindex
  13057. #: ./bashref.texi:7834 ./bashref.texi:7835
  13058. #, no-wrap
  13059. msgid "wait"
  13060. msgstr ""
  13061. #. type: example
  13062. #: ./bashref.texi:7838
  13063. #, no-wrap
  13064. msgid "wait [-n] [@var{jobspec} or @var{pid} @dots{}]\n"
  13065. msgstr ""
  13066. #. type: table
  13067. #: ./bashref.texi:7850
  13068. msgid ""
  13069. "Wait until the child process specified by each process @sc{id} @var{pid} or "
  13070. "job specification @var{jobspec} exits and return the exit status of the last "
  13071. "command waited for. If a job spec is given, all processes in the job are "
  13072. "waited for. If no arguments are given, all currently active child processes "
  13073. "are waited for, and the return status is zero. If the @option{-n} option is "
  13074. "supplied, @code{wait} waits for any job to terminate and returns its exit "
  13075. "status. If neither @var{jobspec} nor @var{pid} specifies an active child "
  13076. "process of the shell, the return status is 127."
  13077. msgstr ""
  13078. #. type: btindex
  13079. #: ./bashref.texi:7851 ./bashref.texi:7852
  13080. #, no-wrap
  13081. msgid "disown"
  13082. msgstr ""
  13083. #. type: example
  13084. #: ./bashref.texi:7855
  13085. #, no-wrap
  13086. msgid "disown [-ar] [-h] [@var{jobspec} @dots{} | @var{pid} @dots{} ]\n"
  13087. msgstr ""
  13088. #. type: table
  13089. #: ./bashref.texi:7867
  13090. msgid ""
  13091. "Without options, remove each @var{jobspec} from the table of active jobs. "
  13092. "If the @option{-h} option is given, the job is not removed from the table, "
  13093. "but is marked so that @code{SIGHUP} is not sent to the job if the shell "
  13094. "receives a @code{SIGHUP}. If @var{jobspec} is not present, and neither the "
  13095. "@option{-a} nor the @option{-r} option is supplied, the current job is "
  13096. "used. If no @var{jobspec} is supplied, the @option{-a} option means to "
  13097. "remove or mark all jobs; the @option{-r} option without a @var{jobspec} "
  13098. "argument restricts operation to running jobs."
  13099. msgstr ""
  13100. #. type: btindex
  13101. #: ./bashref.texi:7868 ./bashref.texi:7869
  13102. #, no-wrap
  13103. msgid "suspend"
  13104. msgstr ""
  13105. #. type: example
  13106. #: ./bashref.texi:7872
  13107. #, no-wrap
  13108. msgid "suspend [-f]\n"
  13109. msgstr ""
  13110. #. type: table
  13111. #: ./bashref.texi:7878
  13112. msgid ""
  13113. "Suspend the execution of this shell until it receives a @code{SIGCONT} "
  13114. "signal. A login shell cannot be suspended; the @option{-f} option can be "
  13115. "used to override this and force the suspension."
  13116. msgstr ""
  13117. #. type: Plain text
  13118. #: ./bashref.texi:7883
  13119. msgid ""
  13120. "When job control is not active, the @code{kill} and @code{wait} builtins do "
  13121. "not accept @var{jobspec} arguments. They must be supplied process @sc{id}s."
  13122. msgstr ""
  13123. #. type: item
  13124. #: ./bashref.texi:7889
  13125. #, no-wrap
  13126. msgid "auto_resume"
  13127. msgstr ""
  13128. #. type: Plain text
  13129. #: ./bashref.texi:7906
  13130. msgid ""
  13131. "This variable controls how the shell interacts with the user and job "
  13132. "control. If this variable exists then single word simple commands without "
  13133. "redirections are treated as candidates for resumption of an existing job. "
  13134. "There is no ambiguity allowed; if there is more than one job beginning with "
  13135. "the string typed, then the most recently accessed job will be selected. The "
  13136. "name of a stopped job, in this context, is the command line used to start "
  13137. "it. If this variable is set to the value @samp{exact}, the string supplied "
  13138. "must match the name of a stopped job exactly; if set to @samp{substring}, "
  13139. "the string supplied needs to match a substring of the name of a stopped "
  13140. "job. The @samp{substring} value provides functionality analogous to the "
  13141. "@samp{%?} job @sc{id} (@pxref{Job Control Basics}). If set to any other "
  13142. "value, the supplied string must be a prefix of a stopped job's name; this "
  13143. "provides functionality analogous to the @samp{%} job @sc{id}."
  13144. msgstr ""
  13145. #. type: cindex
  13146. #: ./bashref.texi:7911
  13147. #, no-wrap
  13148. msgid "Readline, how to use"
  13149. msgstr ""
  13150. #. type: include
  13151. #: ./bashref.texi:7912
  13152. #, no-wrap
  13153. msgid "rluser.texi"
  13154. msgstr ""
  13155. #. type: cindex
  13156. #: ./bashref.texi:7913
  13157. #, no-wrap
  13158. msgid "History, how to use"
  13159. msgstr ""
  13160. #. type: include
  13161. #: ./bashref.texi:7914
  13162. #, no-wrap
  13163. msgid "hsuser.texi"
  13164. msgstr ""
  13165. #. type: Plain text
  13166. #: ./bashref.texi:7927
  13167. msgid ""
  13168. "This chapter provides basic instructions for installing Bash on the various "
  13169. "supported platforms. The distribution supports the @sc{gnu} operating "
  13170. "systems, nearly every version of Unix, and several non-Unix systems such as "
  13171. "BeOS and Interix. Other independent ports exist for @sc{ms-dos}, @sc{os/2}, "
  13172. "and Windows platforms."
  13173. msgstr ""
  13174. #. type: section
  13175. #: ./bashref.texi:7942 ./bashref.texi:7944 ./bashref.texi:7945
  13176. #, no-wrap
  13177. msgid "Basic Installation"
  13178. msgstr ""
  13179. #. type: menuentry
  13180. #: ./bashref.texi:7942
  13181. msgid "Installation instructions."
  13182. msgstr ""
  13183. #. type: section
  13184. #: ./bashref.texi:7942 ./bashref.texi:8024 ./bashref.texi:8025
  13185. #, no-wrap
  13186. msgid "Compilers and Options"
  13187. msgstr ""
  13188. #. type: menuentry
  13189. #: ./bashref.texi:7942
  13190. msgid "How to set special options for various systems."
  13191. msgstr ""
  13192. #. type: section
  13193. #: ./bashref.texi:7942 ./bashref.texi:8046 ./bashref.texi:8047
  13194. #, no-wrap
  13195. msgid "Compiling For Multiple Architectures"
  13196. msgstr ""
  13197. #. type: menuentry
  13198. #: ./bashref.texi:7942
  13199. msgid ""
  13200. "How to compile Bash for more than one kind of system from the same source "
  13201. "tree."
  13202. msgstr ""
  13203. #. type: section
  13204. #: ./bashref.texi:7942 ./bashref.texi:8081 ./bashref.texi:8082
  13205. #, no-wrap
  13206. msgid "Installation Names"
  13207. msgstr ""
  13208. #. type: menuentry
  13209. #: ./bashref.texi:7942
  13210. msgid "How to set the various paths used by the installation."
  13211. msgstr ""
  13212. #. type: section
  13213. #: ./bashref.texi:7942 ./bashref.texi:8098 ./bashref.texi:8099
  13214. #, no-wrap
  13215. msgid "Specifying the System Type"
  13216. msgstr ""
  13217. #. type: menuentry
  13218. #: ./bashref.texi:7942
  13219. msgid "How to configure Bash for a particular system."
  13220. msgstr ""
  13221. #. type: section
  13222. #: ./bashref.texi:7942 ./bashref.texi:8113 ./bashref.texi:8114
  13223. #, no-wrap
  13224. msgid "Sharing Defaults"
  13225. msgstr ""
  13226. #. type: menuentry
  13227. #: ./bashref.texi:7942
  13228. msgid "How to share default configuration values among GNU programs."
  13229. msgstr ""
  13230. #. type: section
  13231. #: ./bashref.texi:7942 ./bashref.texi:8126 ./bashref.texi:8127
  13232. #, no-wrap
  13233. msgid "Operation Controls"
  13234. msgstr ""
  13235. #. type: menuentry
  13236. #: ./bashref.texi:7942
  13237. msgid "Options recognized by the configuration program."
  13238. msgstr ""
  13239. #. type: section
  13240. #: ./bashref.texi:7942 ./bashref.texi:8160 ./bashref.texi:8161
  13241. #, no-wrap
  13242. msgid "Optional Features"
  13243. msgstr ""
  13244. #. type: menuentry
  13245. #: ./bashref.texi:7942
  13246. msgid "How to enable and disable optional features when building Bash."
  13247. msgstr ""
  13248. #. type: cindex
  13249. #: ./bashref.texi:7946
  13250. #, no-wrap
  13251. msgid "installation"
  13252. msgstr ""
  13253. #. type: cindex
  13254. #: ./bashref.texi:7947
  13255. #, no-wrap
  13256. msgid "configuration"
  13257. msgstr ""
  13258. #. type: cindex
  13259. #: ./bashref.texi:7948
  13260. #, no-wrap
  13261. msgid "Bash installation"
  13262. msgstr ""
  13263. #. type: cindex
  13264. #: ./bashref.texi:7949
  13265. #, no-wrap
  13266. msgid "Bash configuration"
  13267. msgstr ""
  13268. #. type: Plain text
  13269. #: ./bashref.texi:7952
  13270. msgid "These are installation instructions for Bash."
  13271. msgstr ""
  13272. #. type: Plain text
  13273. #: ./bashref.texi:7954
  13274. msgid "The simplest way to compile Bash is:"
  13275. msgstr ""
  13276. #. type: enumerate
  13277. #: ./bashref.texi:7962
  13278. msgid ""
  13279. "@code{cd} to the directory containing the source code and type "
  13280. "@samp{./configure} to configure Bash for your system. If you're using "
  13281. "@code{csh} on an old version of System V, you might need to type @samp{sh "
  13282. "./configure} instead to prevent @code{csh} from trying to execute "
  13283. "@code{configure} itself."
  13284. msgstr ""
  13285. #. type: enumerate
  13286. #: ./bashref.texi:7966
  13287. msgid ""
  13288. "Running @code{configure} takes some time. While running, it prints messages "
  13289. "telling which features it is checking for."
  13290. msgstr ""
  13291. #. type: enumerate
  13292. #: ./bashref.texi:7970
  13293. msgid ""
  13294. "Type @samp{make} to compile Bash and build the @code{bashbug} bug reporting "
  13295. "script."
  13296. msgstr ""
  13297. #. type: enumerate
  13298. #: ./bashref.texi:7973
  13299. msgid "Optionally, type @samp{make tests} to run the Bash test suite."
  13300. msgstr ""
  13301. #. type: enumerate
  13302. #: ./bashref.texi:7977
  13303. msgid ""
  13304. "Type @samp{make install} to install @code{bash} and @code{bashbug}. This "
  13305. "will also install the manual pages and Info file."
  13306. msgstr ""
  13307. #. type: Plain text
  13308. #: ./bashref.texi:7995
  13309. msgid ""
  13310. "The @code{configure} shell script attempts to guess correct values for "
  13311. "various system-dependent variables used during compilation. It uses those "
  13312. "values to create a @file{Makefile} in each directory of the package (the top "
  13313. "directory, the @file{builtins}, @file{doc}, and @file{support} directories, "
  13314. "each directory under @file{lib}, and several others). It also creates a "
  13315. "@file{config.h} file containing system-dependent definitions. Finally, it "
  13316. "creates a shell script named @code{config.status} that you can run in the "
  13317. "future to recreate the current configuration, a file @file{config.cache} "
  13318. "that saves the results of its tests to speed up reconfiguring, and a file "
  13319. "@file{config.log} containing compiler output (useful mainly for debugging "
  13320. "@code{configure}). If at some point @file{config.cache} contains results "
  13321. "you don't want to keep, you may remove or edit it."
  13322. msgstr ""
  13323. #. type: Plain text
  13324. #: ./bashref.texi:7998
  13325. msgid ""
  13326. "To find out more about the options and arguments that the @code{configure} "
  13327. "script understands, type"
  13328. msgstr ""
  13329. #. type: example
  13330. #: ./bashref.texi:8001
  13331. #, no-wrap
  13332. msgid "bash-2.04$ ./configure --help\n"
  13333. msgstr ""
  13334. #. type: Plain text
  13335. #: ./bashref.texi:8005
  13336. msgid "at the Bash prompt in your Bash source directory."
  13337. msgstr ""
  13338. #. type: Plain text
  13339. #: ./bashref.texi:8011
  13340. msgid ""
  13341. "If you need to do unusual things to compile Bash, please try to figure out "
  13342. "how @code{configure} could check whether or not to do them, and mail diffs "
  13343. "or instructions to @email{bash-maintainers@@gnu.org} so they can be "
  13344. "considered for the next release."
  13345. msgstr ""
  13346. #. type: Plain text
  13347. #: ./bashref.texi:8018
  13348. msgid ""
  13349. "The file @file{configure.ac} is used to create @code{configure} by a program "
  13350. "called Autoconf. You only need @file{configure.ac} if you want to change it "
  13351. "or regenerate @code{configure} using a newer version of Autoconf. If you do "
  13352. "this, make sure you are using Autoconf version 2.50 or newer."
  13353. msgstr ""
  13354. #. type: Plain text
  13355. #: ./bashref.texi:8023
  13356. msgid ""
  13357. "You can remove the program binaries and object files from the source code "
  13358. "directory by typing @samp{make clean}. To also remove the files that "
  13359. "@code{configure} created (so you can compile Bash for a different kind of "
  13360. "computer), type @samp{make distclean}."
  13361. msgstr ""
  13362. #. type: Plain text
  13363. #: ./bashref.texi:8032
  13364. msgid ""
  13365. "Some systems require unusual options for compilation or linking that the "
  13366. "@code{configure} script does not know about. You can give @code{configure} "
  13367. "initial values for variables by setting them in the environment. Using a "
  13368. "Bourne-compatible shell, you can do that on the command line like this:"
  13369. msgstr ""
  13370. #. type: example
  13371. #: ./bashref.texi:8035
  13372. #, no-wrap
  13373. msgid "CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure\n"
  13374. msgstr ""
  13375. #. type: Plain text
  13376. #: ./bashref.texi:8038
  13377. msgid "On systems that have the @code{env} program, you can do it like this:"
  13378. msgstr ""
  13379. #. type: example
  13380. #: ./bashref.texi:8041
  13381. #, no-wrap
  13382. msgid "env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure\n"
  13383. msgstr ""
  13384. #. type: Plain text
  13385. #: ./bashref.texi:8045
  13386. msgid "The configuration process uses GCC to build Bash if it is available."
  13387. msgstr ""
  13388. #. type: Plain text
  13389. #: ./bashref.texi:8059
  13390. msgid ""
  13391. "You can compile Bash for more than one kind of computer at the same time, by "
  13392. "placing the object files for each architecture in their own directory. To "
  13393. "do this, you must use a version of @code{make} that supports the "
  13394. "@code{VPATH} variable, such as GNU @code{make}. @code{cd} to the directory "
  13395. "where you want the object files and executables to go and run the "
  13396. "@code{configure} script from the source directory. You may need to supply "
  13397. "the @option{--srcdir=PATH} argument to tell @code{configure} where the "
  13398. "source files are. @code{configure} automatically checks for the source code "
  13399. "in the directory that @code{configure} is in and in `..'."
  13400. msgstr ""
  13401. #. type: Plain text
  13402. #: ./bashref.texi:8065
  13403. msgid ""
  13404. "If you have to use a @code{make} that does not supports the @code{VPATH} "
  13405. "variable, you can compile Bash for one architecture at a time in the source "
  13406. "code directory. After you have installed Bash for one architecture, use "
  13407. "@samp{make distclean} before reconfiguring for another architecture."
  13408. msgstr ""
  13409. #. type: Plain text
  13410. #: ./bashref.texi:8071
  13411. msgid ""
  13412. "Alternatively, if your system supports symbolic links, you can use the "
  13413. "@file{support/mkclone} script to create a build tree which has symbolic "
  13414. "links back to each file in the source directory. Here's an example that "
  13415. "creates a build directory in the current directory from a source directory "
  13416. "@file{/usr/gnu/src/bash-2.0}:"
  13417. msgstr ""
  13418. #. type: example
  13419. #: ./bashref.texi:8074
  13420. #, no-wrap
  13421. msgid "bash /usr/gnu/src/bash-2.0/support/mkclone -s /usr/gnu/src/bash-2.0 .\n"
  13422. msgstr ""
  13423. #. type: Plain text
  13424. #: ./bashref.texi:8080
  13425. msgid ""
  13426. "The @code{mkclone} script requires Bash, so you must have already built Bash "
  13427. "for at least one architecture before you can create build directories for "
  13428. "other architectures."
  13429. msgstr ""
  13430. #. type: Plain text
  13431. #: ./bashref.texi:8090
  13432. msgid ""
  13433. "By default, @samp{make install} will install into @file{/usr/local/bin}, "
  13434. "@file{/usr/local/man}, etc. You can specify an installation prefix other "
  13435. "than @file{/usr/local} by giving @code{configure} the option "
  13436. "@option{--prefix=@var{PATH}}, or by specifying a value for the "
  13437. "@code{DESTDIR} @samp{make} variable when running @samp{make install}."
  13438. msgstr ""
  13439. #. type: Plain text
  13440. #: ./bashref.texi:8097
  13441. msgid ""
  13442. "You can specify separate installation prefixes for architecture-specific "
  13443. "files and architecture-independent files. If you give @code{configure} the "
  13444. "option @option{--exec-prefix=@var{PATH}}, @samp{make install} will use "
  13445. "@var{PATH} as the prefix for installing programs and libraries. "
  13446. "Documentation and other data files will still use the regular prefix."
  13447. msgstr ""
  13448. #. type: Plain text
  13449. #: ./bashref.texi:8109
  13450. msgid ""
  13451. "There may be some features @code{configure} can not figure out "
  13452. "automatically, but need to determine by the type of host Bash will run on. "
  13453. "Usually @code{configure} can figure that out, but if it prints a message "
  13454. "saying it can not guess the host type, give it the @option{--host=TYPE} "
  13455. "option. @samp{TYPE} can either be a short name for the system type, such as "
  13456. "@samp{sun4}, or a canonical name with three fields: "
  13457. "@samp{CPU-COMPANY-SYSTEM} (e.g., @samp{i386-unknown-freebsd4.2})."
  13458. msgstr ""
  13459. #. type: Plain text
  13460. #: ./bashref.texi:8112
  13461. msgid ""
  13462. "See the file @file{support/config.sub} for the possible values of each "
  13463. "field."
  13464. msgstr ""
  13465. #. type: Plain text
  13466. #: ./bashref.texi:8125
  13467. msgid ""
  13468. "If you want to set default values for @code{configure} scripts to share, you "
  13469. "can create a site shell script called @code{config.site} that gives default "
  13470. "values for variables like @code{CC}, @code{cache_file}, and @code{prefix}. "
  13471. "@code{configure} looks for @file{PREFIX/share/config.site} if it exists, "
  13472. "then @file{PREFIX/etc/config.site} if it exists. Or, you can set the "
  13473. "@code{CONFIG_SITE} environment variable to the location of the site script. "
  13474. "A warning: the Bash @code{configure} looks for a site script, but not all "
  13475. "@code{configure} scripts do."
  13476. msgstr ""
  13477. #. type: Plain text
  13478. #: ./bashref.texi:8131
  13479. msgid ""
  13480. "@code{configure} recognizes the following options to control how it "
  13481. "operates."
  13482. msgstr ""
  13483. #. type: item
  13484. #: ./bashref.texi:8134
  13485. #, no-wrap
  13486. msgid "--cache-file=@var{file}"
  13487. msgstr ""
  13488. #. type: table
  13489. #: ./bashref.texi:8139
  13490. msgid ""
  13491. "Use and save the results of the tests in @var{file} instead of "
  13492. "@file{./config.cache}. Set @var{file} to @file{/dev/null} to disable "
  13493. "caching, for debugging @code{configure}."
  13494. msgstr ""
  13495. #. type: table
  13496. #: ./bashref.texi:8142
  13497. msgid "Print a summary of the options to @code{configure}, and exit."
  13498. msgstr ""
  13499. #. type: item
  13500. #: ./bashref.texi:8143
  13501. #, no-wrap
  13502. msgid "--quiet"
  13503. msgstr ""
  13504. #. type: itemx
  13505. #: ./bashref.texi:8144
  13506. #, no-wrap
  13507. msgid "--silent"
  13508. msgstr ""
  13509. #. type: table
  13510. #: ./bashref.texi:8147
  13511. msgid "Do not print messages saying which checks are being made."
  13512. msgstr ""
  13513. #. type: item
  13514. #: ./bashref.texi:8148
  13515. #, no-wrap
  13516. msgid "--srcdir=@var{dir}"
  13517. msgstr ""
  13518. #. type: table
  13519. #: ./bashref.texi:8151
  13520. msgid ""
  13521. "Look for the Bash source code in directory @var{dir}. Usually "
  13522. "@code{configure} can determine that directory automatically."
  13523. msgstr ""
  13524. #. type: table
  13525. #: ./bashref.texi:8155
  13526. msgid ""
  13527. "Print the version of Autoconf used to generate the @code{configure} script, "
  13528. "and exit."
  13529. msgstr ""
  13530. #. type: Plain text
  13531. #: ./bashref.texi:8159
  13532. msgid ""
  13533. "@code{configure} also accepts some other, not widely used, boilerplate "
  13534. "options. @samp{configure --help} prints the complete list."
  13535. msgstr ""
  13536. #. type: Plain text
  13537. #: ./bashref.texi:8170
  13538. msgid ""
  13539. "The Bash @code{configure} has a number of @option{--enable-@var{feature}} "
  13540. "options, where @var{feature} indicates an optional part of Bash. There are "
  13541. "also several @option{--with-@var{package}} options, where @var{package} is "
  13542. "something like @samp{bash-malloc} or @samp{purify}. To turn off the default "
  13543. "use of a package, use @option{--without-@var{package}}. To configure Bash "
  13544. "without a feature that is enabled by default, use "
  13545. "@option{--disable-@var{feature}}."
  13546. msgstr ""
  13547. #. type: Plain text
  13548. #: ./bashref.texi:8173
  13549. msgid ""
  13550. "Here is a complete list of the @option{--enable-} and @option{--with-} "
  13551. "options that the Bash @code{configure} recognizes."
  13552. msgstr ""
  13553. #. type: item
  13554. #: ./bashref.texi:8175
  13555. #, no-wrap
  13556. msgid "--with-afs"
  13557. msgstr ""
  13558. #. type: table
  13559. #: ./bashref.texi:8177
  13560. msgid "Define if you are using the Andrew File System from Transarc."
  13561. msgstr ""
  13562. #. type: item
  13563. #: ./bashref.texi:8178
  13564. #, no-wrap
  13565. msgid "--with-bash-malloc"
  13566. msgstr ""
  13567. #. type: table
  13568. #: ./bashref.texi:8188
  13569. msgid ""
  13570. "Use the Bash version of @code{malloc} in the directory @file{lib/malloc}. "
  13571. "This is not the same @code{malloc} that appears in @sc{gnu} libc, but an "
  13572. "older version originally derived from the 4.2 @sc{bsd} @code{malloc}. This "
  13573. "@code{malloc} is very fast, but wastes some space on each allocation. This "
  13574. "option is enabled by default. The @file{NOTES} file contains a list of "
  13575. "systems for which this should be turned off, and @code{configure} disables "
  13576. "this option automatically for a number of systems."
  13577. msgstr ""
  13578. #. type: item
  13579. #: ./bashref.texi:8189
  13580. #, no-wrap
  13581. msgid "--with-curses"
  13582. msgstr ""
  13583. #. type: table
  13584. #: ./bashref.texi:8193
  13585. msgid ""
  13586. "Use the curses library instead of the termcap library. This should be "
  13587. "supplied if your system has an inadequate or incomplete termcap database."
  13588. msgstr ""
  13589. #. type: item
  13590. #: ./bashref.texi:8194
  13591. #, no-wrap
  13592. msgid "--with-gnu-malloc"
  13593. msgstr ""
  13594. #. type: table
  13595. #: ./bashref.texi:8196
  13596. msgid "A synonym for @code{--with-bash-malloc}."
  13597. msgstr ""
  13598. #. type: item
  13599. #: ./bashref.texi:8197
  13600. #, no-wrap
  13601. msgid "--with-installed-readline[=@var{PREFIX}]"
  13602. msgstr ""
  13603. #. type: table
  13604. #: ./bashref.texi:8212
  13605. msgid ""
  13606. "Define this to make Bash link with a locally-installed version of Readline "
  13607. "rather than the version in @file{lib/readline}. This works only with "
  13608. "Readline 5.0 and later versions. If @var{PREFIX} is @code{yes} or not "
  13609. "supplied, @code{configure} uses the values of the make variables "
  13610. "@code{includedir} and @code{libdir}, which are subdirectories of "
  13611. "@code{prefix} by default, to find the installed version of Readline if it is "
  13612. "not in the standard system include and library directories. If @var{PREFIX} "
  13613. "is @code{no}, Bash links with the version in @file{lib/readline}. If "
  13614. "@var{PREFIX} is set to any other value, @code{configure} treats it as a "
  13615. "directory pathname and looks for the installed version of Readline in "
  13616. "subdirectories of that directory (include files in "
  13617. "@var{PREFIX}/@code{include} and the library in @var{PREFIX}/@code{lib})."
  13618. msgstr ""
  13619. #. type: item
  13620. #: ./bashref.texi:8213
  13621. #, no-wrap
  13622. msgid "--with-purify"
  13623. msgstr ""
  13624. #. type: table
  13625. #: ./bashref.texi:8216
  13626. msgid ""
  13627. "Define this to use the Purify memory allocation checker from Rational "
  13628. "Software."
  13629. msgstr ""
  13630. #. type: item
  13631. #: ./bashref.texi:8217
  13632. #, no-wrap
  13633. msgid "--enable-minimal-config"
  13634. msgstr ""
  13635. #. type: table
  13636. #: ./bashref.texi:8220
  13637. msgid ""
  13638. "This produces a shell with minimal features, close to the historical Bourne "
  13639. "shell."
  13640. msgstr ""
  13641. #. type: Plain text
  13642. #: ./bashref.texi:8224
  13643. msgid ""
  13644. "There are several @option{--enable-} options that alter how Bash is compiled "
  13645. "and linked, rather than changing run-time features."
  13646. msgstr ""
  13647. #. type: item
  13648. #: ./bashref.texi:8226
  13649. #, no-wrap
  13650. msgid "--enable-largefile"
  13651. msgstr ""
  13652. #. type: table
  13653. #: ./bashref.texi:8231
  13654. msgid ""
  13655. "Enable support for "
  13656. "@uref{http://www.sas.com/standards/large_file/x_open.20Mar96.html, large "
  13657. "files} if the operating system requires special compiler options to build "
  13658. "programs which can access large files. This is enabled by default, if the "
  13659. "operating system provides large file support."
  13660. msgstr ""
  13661. #. type: item
  13662. #: ./bashref.texi:8232
  13663. #, no-wrap
  13664. msgid "--enable-profiling"
  13665. msgstr ""
  13666. #. type: table
  13667. #: ./bashref.texi:8235
  13668. msgid ""
  13669. "This builds a Bash binary that produces profiling information to be "
  13670. "processed by @code{gprof} each time it is executed."
  13671. msgstr ""
  13672. #. type: item
  13673. #: ./bashref.texi:8236
  13674. #, no-wrap
  13675. msgid "--enable-static-link"
  13676. msgstr ""
  13677. #. type: table
  13678. #: ./bashref.texi:8239
  13679. msgid ""
  13680. "This causes Bash to be linked statically, if @code{gcc} is being used. This "
  13681. "could be used to build a version to use as root's shell."
  13682. msgstr ""
  13683. #. type: Plain text
  13684. #: ./bashref.texi:8244
  13685. msgid ""
  13686. "The @samp{minimal-config} option can be used to disable all of the following "
  13687. "options, but it is processed first, so individual options may be enabled "
  13688. "using @samp{enable-@var{feature}}."
  13689. msgstr ""
  13690. #. type: Plain text
  13691. #: ./bashref.texi:8250
  13692. msgid ""
  13693. "All of the following options except for @samp{disabled-builtins}, "
  13694. "@samp{direxpand-default}, and @samp{xpg-echo-default} are enabled by "
  13695. "default, unless the operating system does not provide the necessary support."
  13696. msgstr ""
  13697. #. type: item
  13698. #: ./bashref.texi:8252
  13699. #, no-wrap
  13700. msgid "--enable-alias"
  13701. msgstr ""
  13702. #. type: table
  13703. #: ./bashref.texi:8255
  13704. msgid ""
  13705. "Allow alias expansion and include the @code{alias} and @code{unalias} "
  13706. "builtins (@pxref{Aliases})."
  13707. msgstr ""
  13708. #. type: item
  13709. #: ./bashref.texi:8256
  13710. #, no-wrap
  13711. msgid "--enable-arith-for-command"
  13712. msgstr ""
  13713. #. type: table
  13714. #: ./bashref.texi:8260
  13715. msgid ""
  13716. "Include support for the alternate form of the @code{for} command that "
  13717. "behaves like the C language @code{for} statement (@pxref{Looping "
  13718. "Constructs})."
  13719. msgstr ""
  13720. #. type: item
  13721. #: ./bashref.texi:8261
  13722. #, no-wrap
  13723. msgid "--enable-array-variables"
  13724. msgstr ""
  13725. #. type: table
  13726. #: ./bashref.texi:8264
  13727. msgid "Include support for one-dimensional array shell variables (@pxref{Arrays})."
  13728. msgstr ""
  13729. #. type: item
  13730. #: ./bashref.texi:8265
  13731. #, no-wrap
  13732. msgid "--enable-bang-history"
  13733. msgstr ""
  13734. #. type: table
  13735. #: ./bashref.texi:8268
  13736. msgid ""
  13737. "Include support for @code{csh}-like history substitution (@pxref{History "
  13738. "Interaction})."
  13739. msgstr ""
  13740. #. type: item
  13741. #: ./bashref.texi:8269
  13742. #, no-wrap
  13743. msgid "--enable-brace-expansion"
  13744. msgstr ""
  13745. #. type: table
  13746. #: ./bashref.texi:8273
  13747. msgid ""
  13748. "Include @code{csh}-like brace expansion ( @code{b@{a,b@}c} @expansion{} "
  13749. "@code{bac bbc} ). See @ref{Brace Expansion}, for a complete description."
  13750. msgstr ""
  13751. #. type: item
  13752. #: ./bashref.texi:8274
  13753. #, no-wrap
  13754. msgid "--enable-casemod-attributes"
  13755. msgstr ""
  13756. #. type: table
  13757. #: ./bashref.texi:8278
  13758. msgid ""
  13759. "Include support for case-modifying attributes in the @code{declare} builtin "
  13760. "and assignment statements. Variables with the @var{uppercase} attribute, "
  13761. "for example, will have their values converted to uppercase upon assignment."
  13762. msgstr ""
  13763. #. type: item
  13764. #: ./bashref.texi:8279
  13765. #, no-wrap
  13766. msgid "--enable-casemod-expansion"
  13767. msgstr ""
  13768. #. type: table
  13769. #: ./bashref.texi:8281
  13770. msgid "Include support for case-modifying word expansions."
  13771. msgstr ""
  13772. #. type: item
  13773. #: ./bashref.texi:8282
  13774. #, no-wrap
  13775. msgid "--enable-command-timing"
  13776. msgstr ""
  13777. #. type: table
  13778. #: ./bashref.texi:8287
  13779. msgid ""
  13780. "Include support for recognizing @code{time} as a reserved word and for "
  13781. "displaying timing statistics for the pipeline following @code{time} "
  13782. "(@pxref{Pipelines}). This allows pipelines as well as shell builtins and "
  13783. "functions to be timed."
  13784. msgstr ""
  13785. #. type: item
  13786. #: ./bashref.texi:8288
  13787. #, no-wrap
  13788. msgid "--enable-cond-command"
  13789. msgstr ""
  13790. #. type: table
  13791. #: ./bashref.texi:8291
  13792. msgid ""
  13793. "Include support for the @code{[[} conditional command. (@pxref{Conditional "
  13794. "Constructs})."
  13795. msgstr ""
  13796. #. type: item
  13797. #: ./bashref.texi:8292
  13798. #, no-wrap
  13799. msgid "--enable-cond-regexp"
  13800. msgstr ""
  13801. #. type: table
  13802. #: ./bashref.texi:8296
  13803. msgid ""
  13804. "Include support for matching @sc{posix} regular expressions using the "
  13805. "@samp{=~} binary operator in the @code{[[} conditional command. "
  13806. "(@pxref{Conditional Constructs})."
  13807. msgstr ""
  13808. #. type: item
  13809. #: ./bashref.texi:8297
  13810. #, no-wrap
  13811. msgid "--enable-coprocesses"
  13812. msgstr ""
  13813. #. type: table
  13814. #: ./bashref.texi:8300
  13815. msgid ""
  13816. "Include support for coprocesses and the @code{coproc} reserved word "
  13817. "(@pxref{Pipelines})."
  13818. msgstr ""
  13819. #. type: item
  13820. #: ./bashref.texi:8301
  13821. #, no-wrap
  13822. msgid "--enable-debugger"
  13823. msgstr ""
  13824. #. type: table
  13825. #: ./bashref.texi:8303
  13826. msgid "Include support for the bash debugger (distributed separately)."
  13827. msgstr ""
  13828. #. type: item
  13829. #: ./bashref.texi:8304
  13830. #, no-wrap
  13831. msgid "--enable-direxpand-default"
  13832. msgstr ""
  13833. #. type: table
  13834. #: ./bashref.texi:8308
  13835. msgid ""
  13836. "Cause the @code{direxpand} shell option (@pxref{The Shopt Builtin}) to be "
  13837. "enabled by default when the shell starts. It is normally disabled by "
  13838. "default."
  13839. msgstr ""
  13840. #. type: item
  13841. #: ./bashref.texi:8309
  13842. #, no-wrap
  13843. msgid "--enable-directory-stack"
  13844. msgstr ""
  13845. #. type: table
  13846. #: ./bashref.texi:8313
  13847. msgid ""
  13848. "Include support for a @code{csh}-like directory stack and the @code{pushd}, "
  13849. "@code{popd}, and @code{dirs} builtins (@pxref{The Directory Stack})."
  13850. msgstr ""
  13851. #. type: item
  13852. #: ./bashref.texi:8314
  13853. #, no-wrap
  13854. msgid "--enable-disabled-builtins"
  13855. msgstr ""
  13856. #. type: table
  13857. #: ./bashref.texi:8319
  13858. msgid ""
  13859. "Allow builtin commands to be invoked via @samp{builtin xxx} even after "
  13860. "@code{xxx} has been disabled using @samp{enable -n xxx}. See @ref{Bash "
  13861. "Builtins}, for details of the @code{builtin} and @code{enable} builtin "
  13862. "commands."
  13863. msgstr ""
  13864. #. type: item
  13865. #: ./bashref.texi:8320
  13866. #, no-wrap
  13867. msgid "--enable-dparen-arithmetic"
  13868. msgstr ""
  13869. #. type: table
  13870. #: ./bashref.texi:8323
  13871. msgid ""
  13872. "Include support for the @code{((@dots{}))} command (@pxref{Conditional "
  13873. "Constructs})."
  13874. msgstr ""
  13875. #. type: item
  13876. #: ./bashref.texi:8324
  13877. #, no-wrap
  13878. msgid "--enable-extended-glob"
  13879. msgstr ""
  13880. #. type: table
  13881. #: ./bashref.texi:8327
  13882. msgid ""
  13883. "Include support for the extended pattern matching features described above "
  13884. "under @ref{Pattern Matching}."
  13885. msgstr ""
  13886. #. type: item
  13887. #: ./bashref.texi:8328
  13888. #, no-wrap
  13889. msgid "--enable-extended-glob-default"
  13890. msgstr ""
  13891. #. type: table
  13892. #: ./bashref.texi:8331
  13893. msgid ""
  13894. "Set the default value of the @var{extglob} shell option described above "
  13895. "under @ref{The Shopt Builtin} to be enabled."
  13896. msgstr ""
  13897. #. type: item
  13898. #: ./bashref.texi:8332
  13899. #, no-wrap
  13900. msgid "--enable-function-import"
  13901. msgstr ""
  13902. #. type: table
  13903. #: ./bashref.texi:8336
  13904. msgid ""
  13905. "Include support for importing function definitions exported by another "
  13906. "instance of the shell from the environment. This option is enabled by "
  13907. "default."
  13908. msgstr ""
  13909. #. type: item
  13910. #: ./bashref.texi:8337
  13911. #, no-wrap
  13912. msgid "--enable-glob-asciirange-default"
  13913. msgstr ""
  13914. #. type: table
  13915. #: ./bashref.texi:8342
  13916. msgid ""
  13917. "Set the default value of the @var{globasciiranges} shell option described "
  13918. "above under @ref{The Shopt Builtin} to be enabled. This controls the "
  13919. "behavior of character ranges when used in pattern matching bracket "
  13920. "expressions."
  13921. msgstr ""
  13922. #. type: item
  13923. #: ./bashref.texi:8343
  13924. #, no-wrap
  13925. msgid "--enable-help-builtin"
  13926. msgstr ""
  13927. #. type: table
  13928. #: ./bashref.texi:8346
  13929. msgid ""
  13930. "Include the @code{help} builtin, which displays help on shell builtins and "
  13931. "variables (@pxref{Bash Builtins})."
  13932. msgstr ""
  13933. #. type: item
  13934. #: ./bashref.texi:8347
  13935. #, no-wrap
  13936. msgid "--enable-history"
  13937. msgstr ""
  13938. #. type: table
  13939. #: ./bashref.texi:8350
  13940. msgid ""
  13941. "Include command history and the @code{fc} and @code{history} builtin "
  13942. "commands (@pxref{Bash History Facilities})."
  13943. msgstr ""
  13944. #. type: item
  13945. #: ./bashref.texi:8351
  13946. #, no-wrap
  13947. msgid "--enable-job-control"
  13948. msgstr ""
  13949. #. type: table
  13950. #: ./bashref.texi:8354
  13951. msgid ""
  13952. "This enables the job control features (@pxref{Job Control}), if the "
  13953. "operating system supports them."
  13954. msgstr ""
  13955. #. type: item
  13956. #: ./bashref.texi:8355
  13957. #, no-wrap
  13958. msgid "--enable-multibyte"
  13959. msgstr ""
  13960. #. type: table
  13961. #: ./bashref.texi:8358
  13962. msgid ""
  13963. "This enables support for multibyte characters if the operating system "
  13964. "provides the necessary support."
  13965. msgstr ""
  13966. #. type: item
  13967. #: ./bashref.texi:8359
  13968. #, no-wrap
  13969. msgid "--enable-net-redirections"
  13970. msgstr ""
  13971. #. type: table
  13972. #: ./bashref.texi:8364
  13973. msgid ""
  13974. "This enables the special handling of filenames of the form "
  13975. "@code{/dev/tcp/@var{host}/@var{port}} and "
  13976. "@code{/dev/udp/@var{host}/@var{port}} when used in redirections "
  13977. "(@pxref{Redirections})."
  13978. msgstr ""
  13979. #. type: item
  13980. #: ./bashref.texi:8365
  13981. #, no-wrap
  13982. msgid "--enable-process-substitution"
  13983. msgstr ""
  13984. #. type: table
  13985. #: ./bashref.texi:8368
  13986. msgid ""
  13987. "This enables process substitution (@pxref{Process Substitution}) if the "
  13988. "operating system provides the necessary support."
  13989. msgstr ""
  13990. #. type: item
  13991. #: ./bashref.texi:8369
  13992. #, no-wrap
  13993. msgid "--enable-progcomp"
  13994. msgstr ""
  13995. #. type: table
  13996. #: ./bashref.texi:8373
  13997. msgid ""
  13998. "Enable the programmable completion facilities (@pxref{Programmable "
  13999. "Completion}). If Readline is not enabled, this option has no effect."
  14000. msgstr ""
  14001. #. type: item
  14002. #: ./bashref.texi:8374
  14003. #, no-wrap
  14004. msgid "--enable-prompt-string-decoding"
  14005. msgstr ""
  14006. #. type: table
  14007. #: ./bashref.texi:8379
  14008. msgid ""
  14009. "Turn on the interpretation of a number of backslash-escaped characters in "
  14010. "the @env{$PS1}, @env{$PS2}, @env{$PS3}, and @env{$PS4} prompt strings. See "
  14011. "@ref{Controlling the Prompt}, for a complete list of prompt string escape "
  14012. "sequences."
  14013. msgstr ""
  14014. #. type: item
  14015. #: ./bashref.texi:8380
  14016. #, no-wrap
  14017. msgid "--enable-readline"
  14018. msgstr ""
  14019. #. type: table
  14020. #: ./bashref.texi:8383
  14021. msgid ""
  14022. "Include support for command-line editing and history with the Bash version "
  14023. "of the Readline library (@pxref{Command Line Editing})."
  14024. msgstr ""
  14025. #. type: item
  14026. #: ./bashref.texi:8384
  14027. #, no-wrap
  14028. msgid "--enable-restricted"
  14029. msgstr ""
  14030. #. type: table
  14031. #: ./bashref.texi:8388
  14032. msgid ""
  14033. "Include support for a @dfn{restricted shell}. If this is enabled, Bash, "
  14034. "when called as @code{rbash}, enters a restricted mode. See @ref{The "
  14035. "Restricted Shell}, for a description of restricted mode."
  14036. msgstr ""
  14037. #. type: item
  14038. #: ./bashref.texi:8389
  14039. #, no-wrap
  14040. msgid "--enable-select"
  14041. msgstr ""
  14042. #. type: table
  14043. #: ./bashref.texi:8392
  14044. msgid ""
  14045. "Include the @code{select} compound command, which allows the generation of "
  14046. "simple menus (@pxref{Conditional Constructs})."
  14047. msgstr ""
  14048. #. type: item
  14049. #: ./bashref.texi:8393
  14050. #, no-wrap
  14051. msgid "--enable-separate-helpfiles"
  14052. msgstr ""
  14053. #. type: table
  14054. #: ./bashref.texi:8396
  14055. msgid ""
  14056. "Use external files for the documentation displayed by the @code{help} "
  14057. "builtin instead of storing the text internally."
  14058. msgstr ""
  14059. #. type: item
  14060. #: ./bashref.texi:8397
  14061. #, no-wrap
  14062. msgid "--enable-single-help-strings"
  14063. msgstr ""
  14064. #. type: table
  14065. #: ./bashref.texi:8402
  14066. msgid ""
  14067. "Store the text displayed by the @code{help} builtin as a single string for "
  14068. "each help topic. This aids in translating the text to different languages. "
  14069. "You may need to disable this if your compiler cannot handle very long string "
  14070. "literals."
  14071. msgstr ""
  14072. #. type: item
  14073. #: ./bashref.texi:8403
  14074. #, no-wrap
  14075. msgid "--enable-strict-posix-default"
  14076. msgstr ""
  14077. #. type: table
  14078. #: ./bashref.texi:8405
  14079. msgid "Make Bash @sc{posix}-conformant by default (@pxref{Bash POSIX Mode})."
  14080. msgstr ""
  14081. #. type: item
  14082. #: ./bashref.texi:8406
  14083. #, no-wrap
  14084. msgid "--enable-usg-echo-default"
  14085. msgstr ""
  14086. #. type: table
  14087. #: ./bashref.texi:8408
  14088. msgid "A synonym for @code{--enable-xpg-echo-default}."
  14089. msgstr ""
  14090. #. type: item
  14091. #: ./bashref.texi:8409
  14092. #, no-wrap
  14093. msgid "--enable-xpg-echo-default"
  14094. msgstr ""
  14095. #. type: table
  14096. #: ./bashref.texi:8417
  14097. msgid ""
  14098. "Make the @code{echo} builtin expand backslash-escaped characters by default, "
  14099. "without requiring the @option{-e} option. This sets the default value of "
  14100. "the @code{xpg_echo} shell option to @code{on}, which makes the Bash "
  14101. "@code{echo} behave more like the version specified in the Single Unix "
  14102. "Specification, version 3. @xref{Bash Builtins}, for a description of the "
  14103. "escape sequences that @code{echo} recognizes."
  14104. msgstr ""
  14105. #. type: Plain text
  14106. #: ./bashref.texi:8426
  14107. msgid ""
  14108. "The file @file{config-top.h} contains C Preprocessor @samp{#define} "
  14109. "statements for options which are not settable from @code{configure}. Some "
  14110. "of these are not meant to be changed; beware of the consequences if you do. "
  14111. "Read the comments associated with each definition for more information about "
  14112. "its effect."
  14113. msgstr ""
  14114. #. type: Plain text
  14115. #: ./bashref.texi:8436
  14116. msgid ""
  14117. "Please report all bugs you find in Bash. But first, you should make sure "
  14118. "that it really is a bug, and that it appears in the latest version of Bash. "
  14119. "The latest version of Bash is always available for FTP from "
  14120. "@uref{ftp://ftp.gnu.org/pub/gnu/bash/}."
  14121. msgstr ""
  14122. #. type: Plain text
  14123. #: ./bashref.texi:8443
  14124. msgid ""
  14125. "Once you have determined that a bug actually exists, use the @code{bashbug} "
  14126. "command to submit a bug report. If you have a fix, you are encouraged to "
  14127. "mail that as well! Suggestions and `philosophical' bug reports may be mailed "
  14128. "to @email{bug-bash@@gnu.org} or posted to the Usenet newsgroup "
  14129. "@code{gnu.bash.bug}."
  14130. msgstr ""
  14131. #. type: Plain text
  14132. #: ./bashref.texi:8445
  14133. msgid "All bug reports should include:"
  14134. msgstr ""
  14135. #. type: itemize
  14136. #: ./bashref.texi:8448
  14137. msgid "The version number of Bash."
  14138. msgstr ""
  14139. #. type: itemize
  14140. #: ./bashref.texi:8450
  14141. msgid "The hardware and operating system."
  14142. msgstr ""
  14143. #. type: itemize
  14144. #: ./bashref.texi:8452
  14145. msgid "The compiler used to compile Bash."
  14146. msgstr ""
  14147. #. type: itemize
  14148. #: ./bashref.texi:8454
  14149. msgid "A description of the bug behaviour."
  14150. msgstr ""
  14151. #. type: itemize
  14152. #: ./bashref.texi:8457
  14153. msgid ""
  14154. "A short script or `recipe' which exercises the bug and may be used to "
  14155. "reproduce it."
  14156. msgstr ""
  14157. #. type: Plain text
  14158. #: ./bashref.texi:8462
  14159. msgid ""
  14160. "@code{bashbug} inserts the first three items automatically into the template "
  14161. "it provides for filing a bug report."
  14162. msgstr ""
  14163. #. type: Plain text
  14164. #: ./bashref.texi:8465
  14165. msgid "Please send all reports concerning this manual to @email{bug-bash@@gnu.org}."
  14166. msgstr ""
  14167. #. type: Plain text
  14168. #: ./bashref.texi:8479
  14169. msgid ""
  14170. "Bash implements essentially the same grammar, parameter and variable "
  14171. "expansion, redirection, and quoting as the Bourne Shell. Bash uses the "
  14172. "@sc{posix} standard as the specification of how these features are to be "
  14173. "implemented. There are some differences between the traditional Bourne "
  14174. "shell and Bash; this section quickly details the differences of "
  14175. "significance. A number of these differences are explained in greater depth "
  14176. "in previous sections. This section uses the version of @code{sh} included "
  14177. "in SVR4.2 (the last version of the historical Bourne shell) as the baseline "
  14178. "reference."
  14179. msgstr ""
  14180. #. type: itemize
  14181. #: ./bashref.texi:8485
  14182. msgid ""
  14183. "Bash is @sc{posix}-conformant, even where the @sc{posix} specification "
  14184. "differs from traditional @code{sh} behavior (@pxref{Bash POSIX Mode})."
  14185. msgstr ""
  14186. #. type: itemize
  14187. #: ./bashref.texi:8488
  14188. msgid "Bash has multi-character invocation options (@pxref{Invoking Bash})."
  14189. msgstr ""
  14190. #. type: itemize
  14191. #: ./bashref.texi:8492
  14192. msgid ""
  14193. "Bash has command-line editing (@pxref{Command Line Editing}) and the "
  14194. "@code{bind} builtin."
  14195. msgstr ""
  14196. #. type: itemize
  14197. #: ./bashref.texi:8498
  14198. msgid ""
  14199. "Bash provides a programmable word completion mechanism (@pxref{Programmable "
  14200. "Completion}), and builtin commands @code{complete}, @code{compgen}, and "
  14201. "@code{compopt}, to manipulate it."
  14202. msgstr ""
  14203. #. type: itemize
  14204. #: ./bashref.texi:8504
  14205. msgid ""
  14206. "Bash has command history (@pxref{Bash History Facilities}) and the "
  14207. "@code{history} and @code{fc} builtins to manipulate it. The Bash history "
  14208. "list maintains timestamp information and uses the value of the "
  14209. "@code{HISTTIMEFORMAT} variable to display it."
  14210. msgstr ""
  14211. #. type: itemize
  14212. #: ./bashref.texi:8508
  14213. msgid ""
  14214. "Bash implements @code{csh}-like history expansion (@pxref{History "
  14215. "Interaction})."
  14216. msgstr ""
  14217. #. type: itemize
  14218. #: ./bashref.texi:8514
  14219. msgid ""
  14220. "Bash has one-dimensional array variables (@pxref{Arrays}), and the "
  14221. "appropriate variable expansions and assignment syntax to use them. Several "
  14222. "of the Bash builtins take options to act on arrays. Bash provides a number "
  14223. "of built-in array variables."
  14224. msgstr ""
  14225. #. type: itemize
  14226. #: ./bashref.texi:8519
  14227. msgid ""
  14228. "The @code{$'@dots{}'} quoting syntax, which expands ANSI-C backslash-escaped "
  14229. "characters in the text between the single quotes, is supported "
  14230. "(@pxref{ANSI-C Quoting})."
  14231. msgstr ""
  14232. #. type: itemize
  14233. #: ./bashref.texi:8526
  14234. msgid ""
  14235. "Bash supports the @code{$\"@dots{}\"} quoting syntax to do locale-specific "
  14236. "translation of the characters between the double quotes. The @option{-D}, "
  14237. "@option{--dump-strings}, and @option{--dump-po-strings} invocation options "
  14238. "list the translatable strings found in a script (@pxref{Locale "
  14239. "Translation})."
  14240. msgstr ""
  14241. #. type: itemize
  14242. #: ./bashref.texi:8533
  14243. msgid ""
  14244. "Bash implements the @code{!} keyword to negate the return value of a "
  14245. "pipeline (@pxref{Pipelines}). Very useful when an @code{if} statement needs "
  14246. "to act only if a test fails. The Bash @samp{-o pipefail} option to "
  14247. "@code{set} will cause a pipeline to return a failure status if any command "
  14248. "fails."
  14249. msgstr ""
  14250. #. type: itemize
  14251. #: ./bashref.texi:8538
  14252. msgid ""
  14253. "Bash has the @code{time} reserved word and command timing "
  14254. "(@pxref{Pipelines}). The display of the timing statistics may be controlled "
  14255. "with the @env{TIMEFORMAT} variable."
  14256. msgstr ""
  14257. #. type: itemize
  14258. #: ./bashref.texi:8542
  14259. msgid ""
  14260. "Bash implements the @code{for (( @var{expr1} ; @var{expr2} ; @var{expr3} ))} "
  14261. "arithmetic for command, similar to the C language (@pxref{Looping "
  14262. "Constructs})."
  14263. msgstr ""
  14264. #. type: itemize
  14265. #: ./bashref.texi:8546
  14266. msgid ""
  14267. "Bash includes the @code{select} compound command, which allows the "
  14268. "generation of simple menus (@pxref{Conditional Constructs})."
  14269. msgstr ""
  14270. #. type: itemize
  14271. #: ./bashref.texi:8551
  14272. msgid ""
  14273. "Bash includes the @code{[[} compound command, which makes conditional "
  14274. "testing part of the shell grammar (@pxref{Conditional Constructs}), "
  14275. "including optional regular expression matching."
  14276. msgstr ""
  14277. #. type: itemize
  14278. #: ./bashref.texi:8555
  14279. msgid ""
  14280. "Bash provides optional case-insensitive matching for the @code{case} and "
  14281. "@code{[[} constructs."
  14282. msgstr ""
  14283. #. type: itemize
  14284. #: ./bashref.texi:8559
  14285. msgid ""
  14286. "Bash includes brace expansion (@pxref{Brace Expansion}) and tilde expansion "
  14287. "(@pxref{Tilde Expansion})."
  14288. msgstr ""
  14289. #. type: itemize
  14290. #: ./bashref.texi:8563
  14291. msgid ""
  14292. "Bash implements command aliases and the @code{alias} and @code{unalias} "
  14293. "builtins (@pxref{Aliases})."
  14294. msgstr ""
  14295. #. type: itemize
  14296. #: ./bashref.texi:8568
  14297. msgid ""
  14298. "Bash provides shell arithmetic, the @code{((} compound command "
  14299. "(@pxref{Conditional Constructs}), and arithmetic expansion (@pxref{Shell "
  14300. "Arithmetic})."
  14301. msgstr ""
  14302. #. type: itemize
  14303. #: ./bashref.texi:8574
  14304. msgid ""
  14305. "Variables present in the shell's initial environment are automatically "
  14306. "exported to child processes. The Bourne shell does not normally do this "
  14307. "unless the variables are explicitly marked using the @code{export} command."
  14308. msgstr ""
  14309. #. type: itemize
  14310. #: ./bashref.texi:8578
  14311. msgid ""
  14312. "Bash supports the @samp{+=} assignment operator, which appends to the value "
  14313. "of the variable named on the left hand side."
  14314. msgstr ""
  14315. #. type: itemize
  14316. #: ./bashref.texi:8583
  14317. msgid ""
  14318. "Bash includes the @sc{posix} pattern removal @samp{%}, @samp{#}, @samp{%%} "
  14319. "and @samp{##} expansions to remove leading or trailing substrings from "
  14320. "variable values (@pxref{Shell Parameter Expansion})."
  14321. msgstr ""
  14322. #. type: itemize
  14323. #: ./bashref.texi:8587
  14324. msgid ""
  14325. "The expansion @code{$@{#xx@}}, which returns the length of @code{$@{xx@}}, "
  14326. "is supported (@pxref{Shell Parameter Expansion})."
  14327. msgstr ""
  14328. #. type: itemize
  14329. #: ./bashref.texi:8593
  14330. msgid ""
  14331. "The expansion @code{$@{var:}@var{offset}@code{[:}@var{length}@code{]@}}, "
  14332. "which expands to the substring of @code{var}'s value of length @var{length}, "
  14333. "beginning at @var{offset}, is present (@pxref{Shell Parameter Expansion})."
  14334. msgstr ""
  14335. #. type: itemize
  14336. #: ./bashref.texi:8599
  14337. msgid ""
  14338. "The expansion "
  14339. "@code{$@{var/[/]}@var{pattern}@code{[/}@var{replacement}@code{]@}}, which "
  14340. "matches @var{pattern} and replaces it with @var{replacement} in the value of "
  14341. "@code{var}, is available (@pxref{Shell Parameter Expansion})."
  14342. msgstr ""
  14343. #. type: itemize
  14344. #: ./bashref.texi:8604
  14345. msgid ""
  14346. "The expansion @code{$@{!@var{prefix}*@}} expansion, which expands to the "
  14347. "names of all shell variables whose names begin with @var{prefix}, is "
  14348. "available (@pxref{Shell Parameter Expansion})."
  14349. msgstr ""
  14350. #. type: itemize
  14351. #: ./bashref.texi:8608
  14352. msgid ""
  14353. "Bash has @var{indirect} variable expansion using @code{$@{!word@}} "
  14354. "(@pxref{Shell Parameter Expansion})."
  14355. msgstr ""
  14356. #. type: itemize
  14357. #: ./bashref.texi:8612
  14358. msgid ""
  14359. "Bash can expand positional parameters beyond @code{$9} using "
  14360. "@code{$@{@var{num}@}}."
  14361. msgstr ""
  14362. #. type: itemize
  14363. #: ./bashref.texi:8618
  14364. msgid ""
  14365. "The @sc{posix} @code{$()} form of command substitution is implemented "
  14366. "(@pxref{Command Substitution}), and preferred to the Bourne shell's "
  14367. "@code{``} (which is also implemented for backwards compatibility)."
  14368. msgstr ""
  14369. #. type: itemize
  14370. #: ./bashref.texi:8621
  14371. msgid "Bash has process substitution (@pxref{Process Substitution})."
  14372. msgstr ""
  14373. #. type: itemize
  14374. #: ./bashref.texi:8629
  14375. msgid ""
  14376. "Bash automatically assigns variables that provide information about the "
  14377. "current user (@env{UID}, @env{EUID}, and @env{GROUPS}), the current host "
  14378. "(@env{HOSTTYPE}, @env{OSTYPE}, @env{MACHTYPE}, and @env{HOSTNAME}), and the "
  14379. "instance of Bash that is running (@env{BASH}, @env{BASH_VERSION}, and "
  14380. "@env{BASH_VERSINFO}). @xref{Bash Variables}, for details."
  14381. msgstr ""
  14382. #. type: itemize
  14383. #: ./bashref.texi:8634
  14384. msgid ""
  14385. "The @env{IFS} variable is used to split only the results of expansion, not "
  14386. "all words (@pxref{Word Splitting}). This closes a longstanding shell "
  14387. "security hole."
  14388. msgstr ""
  14389. #. type: itemize
  14390. #: ./bashref.texi:8639
  14391. msgid ""
  14392. "The filename expansion bracket expression code uses @samp{!} and @samp{^} to "
  14393. "negate the set of characters between the brackets. The Bourne shell uses "
  14394. "only @samp{!}."
  14395. msgstr ""
  14396. #. type: itemize
  14397. #: ./bashref.texi:8644
  14398. msgid ""
  14399. "Bash implements the full set of @sc{posix} filename expansion operators, "
  14400. "including @var{character classes}, @var{equivalence classes}, and "
  14401. "@var{collating symbols} (@pxref{Filename Expansion})."
  14402. msgstr ""
  14403. #. type: itemize
  14404. #: ./bashref.texi:8648
  14405. msgid ""
  14406. "Bash implements extended pattern matching features when the @code{extglob} "
  14407. "shell option is enabled (@pxref{Pattern Matching})."
  14408. msgstr ""
  14409. #. type: itemize
  14410. #: ./bashref.texi:8652
  14411. msgid ""
  14412. "It is possible to have a variable and a function with the same name; "
  14413. "@code{sh} does not separate the two name spaces."
  14414. msgstr ""
  14415. #. type: itemize
  14416. #: ./bashref.texi:8657
  14417. msgid ""
  14418. "Bash functions are permitted to have local variables using the @code{local} "
  14419. "builtin, and thus useful recursive functions may be written (@pxref{Bash "
  14420. "Builtins})."
  14421. msgstr ""
  14422. #. type: itemize
  14423. #: ./bashref.texi:8664
  14424. msgid ""
  14425. "Variable assignments preceding commands affect only that command, even "
  14426. "builtins and functions (@pxref{Environment}). In @code{sh}, all variable "
  14427. "assignments preceding commands are global unless the command is executed "
  14428. "from the file system."
  14429. msgstr ""
  14430. #. type: itemize
  14431. #: ./bashref.texi:8668
  14432. msgid ""
  14433. "Bash performs filename expansion on filenames specified as operands to input "
  14434. "and output redirection operators (@pxref{Redirections})."
  14435. msgstr ""
  14436. #. type: itemize
  14437. #: ./bashref.texi:8674
  14438. msgid ""
  14439. "Bash contains the @samp{<>} redirection operator, allowing a file to be "
  14440. "opened for both reading and writing, and the @samp{&>} redirection operator, "
  14441. "for directing standard output and standard error to the same file "
  14442. "(@pxref{Redirections})."
  14443. msgstr ""
  14444. #. type: itemize
  14445. #: ./bashref.texi:8678
  14446. msgid ""
  14447. "Bash includes the @samp{<<<} redirection operator, allowing a string to be "
  14448. "used as the standard input to a command."
  14449. msgstr ""
  14450. #. type: itemize
  14451. #: ./bashref.texi:8682
  14452. msgid ""
  14453. "Bash implements the @samp{[n]<&@var{word}} and @samp{[n]>&@var{word}} "
  14454. "redirection operators, which move one file descriptor to another."
  14455. msgstr ""
  14456. #. type: itemize
  14457. #: ./bashref.texi:8686
  14458. msgid ""
  14459. "Bash treats a number of filenames specially when they are used in "
  14460. "redirection operators (@pxref{Redirections})."
  14461. msgstr ""
  14462. #. type: itemize
  14463. #: ./bashref.texi:8690
  14464. msgid ""
  14465. "Bash can open network connections to arbitrary machines and services with "
  14466. "the redirection operators (@pxref{Redirections})."
  14467. msgstr ""
  14468. #. type: itemize
  14469. #: ./bashref.texi:8695
  14470. msgid ""
  14471. "The @code{noclobber} option is available to avoid overwriting existing files "
  14472. "with output redirection (@pxref{The Set Builtin}). The @samp{>|} "
  14473. "redirection operator may be used to override @code{noclobber}."
  14474. msgstr ""
  14475. #. type: itemize
  14476. #: ./bashref.texi:8700
  14477. msgid ""
  14478. "The Bash @code{cd} and @code{pwd} builtins (@pxref{Bourne Shell Builtins}) "
  14479. "each take @option{-L} and @option{-P} options to switch between logical and "
  14480. "physical modes."
  14481. msgstr ""
  14482. #. type: itemize
  14483. #: ./bashref.texi:8705
  14484. msgid ""
  14485. "Bash allows a function to override a builtin with the same name, and "
  14486. "provides access to that builtin's functionality within the function via the "
  14487. "@code{builtin} and @code{command} builtins (@pxref{Bash Builtins})."
  14488. msgstr ""
  14489. #. type: itemize
  14490. #: ./bashref.texi:8709
  14491. msgid ""
  14492. "The @code{command} builtin allows selective disabling of functions when "
  14493. "command lookup is performed (@pxref{Bash Builtins})."
  14494. msgstr ""
  14495. #. type: itemize
  14496. #: ./bashref.texi:8713
  14497. msgid ""
  14498. "Individual builtins may be enabled or disabled using the @code{enable} "
  14499. "builtin (@pxref{Bash Builtins})."
  14500. msgstr ""
  14501. #. type: itemize
  14502. #: ./bashref.texi:8719
  14503. msgid ""
  14504. "The Bash @code{exec} builtin takes additional options that allow users to "
  14505. "control the contents of the environment passed to the executed command, and "
  14506. "what the zeroth argument to the command is to be (@pxref{Bourne Shell "
  14507. "Builtins})."
  14508. msgstr ""
  14509. #. type: itemize
  14510. #: ./bashref.texi:8723
  14511. msgid ""
  14512. "Shell functions may be exported to children via the environment using "
  14513. "@code{export -f} (@pxref{Shell Functions})."
  14514. msgstr ""
  14515. #. type: itemize
  14516. #: ./bashref.texi:8731
  14517. msgid ""
  14518. "The Bash @code{export}, @code{readonly}, and @code{declare} builtins can "
  14519. "take a @option{-f} option to act on shell functions, a @option{-p} option to "
  14520. "display variables with various attributes set in a format that can be used "
  14521. "as shell input, a @option{-n} option to remove various variable attributes, "
  14522. "and @samp{name=value} arguments to set variable attributes and values "
  14523. "simultaneously."
  14524. msgstr ""
  14525. #. type: itemize
  14526. #: ./bashref.texi:8737
  14527. msgid ""
  14528. "The Bash @code{hash} builtin allows a name to be associated with an "
  14529. "arbitrary filename, even when that filename cannot be found by searching the "
  14530. "@env{$PATH}, using @samp{hash -p} (@pxref{Bourne Shell Builtins})."
  14531. msgstr ""
  14532. #. type: itemize
  14533. #: ./bashref.texi:8741
  14534. msgid ""
  14535. "Bash includes a @code{help} builtin for quick reference to shell facilities "
  14536. "(@pxref{Bash Builtins})."
  14537. msgstr ""
  14538. #. type: itemize
  14539. #: ./bashref.texi:8745
  14540. msgid ""
  14541. "The @code{printf} builtin is available to display formatted output "
  14542. "(@pxref{Bash Builtins})."
  14543. msgstr ""
  14544. #. type: itemize
  14545. #: ./bashref.texi:8761
  14546. msgid ""
  14547. "The Bash @code{read} builtin (@pxref{Bash Builtins}) will read a line "
  14548. "ending in @samp{\\} with the @option{-r} option, and will use the "
  14549. "@env{REPLY} variable as a default if no non-option arguments are supplied. "
  14550. "The Bash @code{read} builtin also accepts a prompt string with the "
  14551. "@option{-p} option and will use Readline to obtain the line when given the "
  14552. "@option{-e} option. The @code{read} builtin also has additional options to "
  14553. "control input: the @option{-s} option will turn off echoing of input "
  14554. "characters as they are read, the @option{-t} option will allow @code{read} "
  14555. "to time out if input does not arrive within a specified number of seconds, "
  14556. "the @option{-n} option will allow reading only a specified number of "
  14557. "characters rather than a full line, and the @option{-d} option will read "
  14558. "until a particular character rather than newline."
  14559. msgstr ""
  14560. #. type: itemize
  14561. #: ./bashref.texi:8766
  14562. msgid ""
  14563. "The @code{return} builtin may be used to abort execution of scripts executed "
  14564. "with the @code{.} or @code{source} builtins (@pxref{Bourne Shell Builtins})."
  14565. msgstr ""
  14566. #. type: itemize
  14567. #: ./bashref.texi:8771
  14568. msgid ""
  14569. "Bash includes the @code{shopt} builtin, for finer control of shell optional "
  14570. "capabilities (@pxref{The Shopt Builtin}), and allows these options to be set "
  14571. "and unset at shell invocation (@pxref{Invoking Bash})."
  14572. msgstr ""
  14573. #. type: itemize
  14574. #: ./bashref.texi:8775
  14575. msgid ""
  14576. "Bash has much more optional behavior controllable with the @code{set} "
  14577. "builtin (@pxref{The Set Builtin})."
  14578. msgstr ""
  14579. #. type: itemize
  14580. #: ./bashref.texi:8780
  14581. msgid ""
  14582. "The @samp{-x} (@option{xtrace}) option displays commands other than simple "
  14583. "commands when performing an execution trace (@pxref{The Set Builtin})."
  14584. msgstr ""
  14585. #. type: itemize
  14586. #: ./bashref.texi:8785
  14587. msgid ""
  14588. "The @code{test} builtin (@pxref{Bourne Shell Builtins}) is slightly "
  14589. "different, as it implements the @sc{posix} algorithm, which specifies the "
  14590. "behavior based on the number of arguments."
  14591. msgstr ""
  14592. #. type: itemize
  14593. #: ./bashref.texi:8791
  14594. msgid ""
  14595. "Bash includes the @code{caller} builtin, which displays the context of any "
  14596. "active subroutine call (a shell function or a script executed with the "
  14597. "@code{.} or @code{source} builtins). This supports the bash debugger."
  14598. msgstr ""
  14599. #. type: itemize
  14600. #: ./bashref.texi:8804
  14601. msgid ""
  14602. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows a "
  14603. "@code{DEBUG} pseudo-signal specification, similar to @code{EXIT}. Commands "
  14604. "specified with a @code{DEBUG} trap are executed before every simple command, "
  14605. "@code{for} command, @code{case} command, @code{select} command, every "
  14606. "arithmetic @code{for} command, and before the first command executes in a "
  14607. "shell function. The @code{DEBUG} trap is not inherited by shell functions "
  14608. "unless the function has been given the @code{trace} attribute or the "
  14609. "@code{functrace} option has been enabled using the @code{shopt} builtin. "
  14610. "The @code{extdebug} shell option has additional effects on the @code{DEBUG} "
  14611. "trap."
  14612. msgstr ""
  14613. #. type: itemize
  14614. #: ./bashref.texi:8811
  14615. msgid ""
  14616. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows an @code{ERR} "
  14617. "pseudo-signal specification, similar to @code{EXIT} and @code{DEBUG}. "
  14618. "Commands specified with an @code{ERR} trap are executed after a simple "
  14619. "command fails, with a few exceptions. The @code{ERR} trap is not inherited "
  14620. "by shell functions unless the @code{-o errtrace} option to the @code{set} "
  14621. "builtin is enabled."
  14622. msgstr ""
  14623. #. type: itemize
  14624. #: ./bashref.texi:8821
  14625. msgid ""
  14626. "The @code{trap} builtin (@pxref{Bourne Shell Builtins}) allows a "
  14627. "@code{RETURN} pseudo-signal specification, similar to @code{EXIT} and "
  14628. "@code{DEBUG}. Commands specified with an @code{RETURN} trap are executed "
  14629. "before execution resumes after a shell function or a shell script executed "
  14630. "with @code{.} or @code{source} returns. The @code{RETURN} trap is not "
  14631. "inherited by shell functions unless the function has been given the "
  14632. "@code{trace} attribute or the @code{functrace} option has been enabled using "
  14633. "the @code{shopt} builtin."
  14634. msgstr ""
  14635. #. type: itemize
  14636. #: ./bashref.texi:8825
  14637. msgid ""
  14638. "The Bash @code{type} builtin is more extensive and gives more information "
  14639. "about the names it finds (@pxref{Bash Builtins})."
  14640. msgstr ""
  14641. #. type: itemize
  14642. #: ./bashref.texi:8830
  14643. msgid ""
  14644. "The Bash @code{umask} builtin permits a @option{-p} option to cause the "
  14645. "output to be displayed in the form of a @code{umask} command that may be "
  14646. "reused as input (@pxref{Bourne Shell Builtins})."
  14647. msgstr ""
  14648. #. type: itemize
  14649. #: ./bashref.texi:8837
  14650. msgid ""
  14651. "Bash implements a @code{csh}-like directory stack, and provides the "
  14652. "@code{pushd}, @code{popd}, and @code{dirs} builtins to manipulate it "
  14653. "(@pxref{The Directory Stack}). Bash also makes the directory stack visible "
  14654. "as the value of the @env{DIRSTACK} shell variable."
  14655. msgstr ""
  14656. #. type: itemize
  14657. #: ./bashref.texi:8841
  14658. msgid ""
  14659. "Bash interprets special backslash-escaped characters in the prompt strings "
  14660. "when interactive (@pxref{Controlling the Prompt})."
  14661. msgstr ""
  14662. #. type: itemize
  14663. #: ./bashref.texi:8845
  14664. msgid ""
  14665. "The Bash restricted mode is more useful (@pxref{The Restricted Shell}); the "
  14666. "SVR4.2 shell restricted mode is too limited."
  14667. msgstr ""
  14668. #. type: itemize
  14669. #: ./bashref.texi:8851
  14670. msgid ""
  14671. "The @code{disown} builtin can remove a job from the internal shell job table "
  14672. "(@pxref{Job Control Builtins}) or suppress the sending of @code{SIGHUP} to a "
  14673. "job when the shell exits as the result of a @code{SIGHUP}."
  14674. msgstr ""
  14675. #. type: itemize
  14676. #: ./bashref.texi:8855
  14677. msgid ""
  14678. "Bash includes a number of features to support a separate debugger for shell "
  14679. "scripts."
  14680. msgstr ""
  14681. #. type: itemize
  14682. #: ./bashref.texi:8859
  14683. msgid ""
  14684. "The SVR4.2 shell has two privilege-related builtins (@code{mldmode} and "
  14685. "@code{priv}) not present in Bash."
  14686. msgstr ""
  14687. #. type: itemize
  14688. #: ./bashref.texi:8862
  14689. msgid "Bash does not have the @code{stop} or @code{newgrp} builtins."
  14690. msgstr ""
  14691. #. type: itemize
  14692. #: ./bashref.texi:8865
  14693. msgid "Bash does not use the @env{SHACCT} variable or perform shell accounting."
  14694. msgstr ""
  14695. #. type: itemize
  14696. #: ./bashref.texi:8869
  14697. msgid ""
  14698. "The SVR4.2 @code{sh} uses a @env{TIMEOUT} variable like Bash uses "
  14699. "@env{TMOUT}."
  14700. msgstr ""
  14701. #. type: Plain text
  14702. #: ./bashref.texi:8874
  14703. msgid "More features unique to Bash may be found in @ref{Bash Features}."
  14704. msgstr ""
  14705. #. type: appendixsec
  14706. #: ./bashref.texi:8876
  14707. #, no-wrap
  14708. msgid "Implementation Differences From The SVR4.2 Shell"
  14709. msgstr ""
  14710. #. type: Plain text
  14711. #: ./bashref.texi:8880
  14712. msgid ""
  14713. "Since Bash is a completely new implementation, it does not suffer from many "
  14714. "of the limitations of the SVR4.2 shell. For instance:"
  14715. msgstr ""
  14716. #. type: itemize
  14717. #: ./bashref.texi:8887
  14718. msgid ""
  14719. "Bash does not fork a subshell when redirecting into or out of a shell "
  14720. "control structure such as an @code{if} or @code{while} statement."
  14721. msgstr ""
  14722. #. type: itemize
  14723. #: ./bashref.texi:8892
  14724. msgid ""
  14725. "Bash does not allow unbalanced quotes. The SVR4.2 shell will silently "
  14726. "insert a needed closing quote at @code{EOF} under certain circumstances. "
  14727. "This can be the cause of some hard-to-find errors."
  14728. msgstr ""
  14729. #. type: itemize
  14730. #: ./bashref.texi:8898
  14731. msgid ""
  14732. "The SVR4.2 shell uses a baroque memory management scheme based on trapping "
  14733. "@code{SIGSEGV}. If the shell is started from a process with @code{SIGSEGV} "
  14734. "blocked (e.g., by using the @code{system()} C library function call), it "
  14735. "misbehaves badly."
  14736. msgstr ""
  14737. #. type: itemize
  14738. #: ./bashref.texi:8905
  14739. msgid ""
  14740. "In a questionable attempt at security, the SVR4.2 shell, when invoked "
  14741. "without the @option{-p} option, will alter its real and effective @sc{uid} "
  14742. "and @sc{gid} if they are less than some magic threshold value, commonly "
  14743. "100. This can lead to unexpected results."
  14744. msgstr ""
  14745. #. type: itemize
  14746. #: ./bashref.texi:8909
  14747. msgid ""
  14748. "The SVR4.2 shell does not allow users to trap @code{SIGSEGV}, "
  14749. "@code{SIGALRM}, or @code{SIGCHLD}."
  14750. msgstr ""
  14751. #. type: itemize
  14752. #: ./bashref.texi:8913
  14753. msgid ""
  14754. "The SVR4.2 shell does not allow the @env{IFS}, @env{MAILCHECK}, @env{PATH}, "
  14755. "@env{PS1}, or @env{PS2} variables to be unset."
  14756. msgstr ""
  14757. #. type: itemize
  14758. #: ./bashref.texi:8917
  14759. msgid "The SVR4.2 shell treats @samp{^} as the undocumented equivalent of @samp{|}."
  14760. msgstr ""
  14761. #. type: itemize
  14762. #: ./bashref.texi:8923
  14763. msgid ""
  14764. "Bash allows multiple option arguments when it is invoked (@code{-x -v}); the "
  14765. "SVR4.2 shell allows only one option argument (@code{-xv}). In fact, some "
  14766. "versions of the shell dump core if the second argument begins with a "
  14767. "@samp{-}."
  14768. msgstr ""
  14769. #. type: itemize
  14770. #: ./bashref.texi:8928
  14771. msgid ""
  14772. "The SVR4.2 shell exits a script if any builtin fails; Bash exits a script "
  14773. "only if one of the @sc{posix} special builtins fails, and only for certain "
  14774. "failures, as enumerated in the @sc{posix} standard."
  14775. msgstr ""
  14776. #. type: itemize
  14777. #: ./bashref.texi:8932
  14778. msgid ""
  14779. "The SVR4.2 shell behaves differently when invoked as @code{jsh} (it turns on "
  14780. "job control)."
  14781. msgstr ""
  14782. #. type: include
  14783. #: ./bashref.texi:8937
  14784. #, no-wrap
  14785. msgid "fdl.texi"
  14786. msgstr ""
  14787. #. type: node
  14788. #: ./bashref.texi:8950 ./bashref.texi:8952
  14789. #, no-wrap
  14790. msgid "Builtin Index"
  14791. msgstr ""
  14792. #. type: menuentry
  14793. #: ./bashref.texi:8950
  14794. msgid "Index of Bash builtin commands."
  14795. msgstr ""
  14796. #. type: node
  14797. #: ./bashref.texi:8950 ./bashref.texi:8956
  14798. #, no-wrap
  14799. msgid "Reserved Word Index"
  14800. msgstr ""
  14801. #. type: menuentry
  14802. #: ./bashref.texi:8950
  14803. msgid "Index of Bash reserved words."
  14804. msgstr ""
  14805. #. type: node
  14806. #: ./bashref.texi:8950 ./bashref.texi:8960
  14807. #, no-wrap
  14808. msgid "Variable Index"
  14809. msgstr ""
  14810. #. type: menuentry
  14811. #: ./bashref.texi:8950
  14812. msgid "Quick reference helps you find the variable you want."
  14813. msgstr ""
  14814. #. type: appendixsec
  14815. #: ./bashref.texi:8950 ./bashref.texi:8964 ./bashref.texi:8965
  14816. #, no-wrap
  14817. msgid "Function Index"
  14818. msgstr ""
  14819. #. type: menuentry
  14820. #: ./bashref.texi:8950
  14821. msgid "Index of bindable Readline functions."
  14822. msgstr ""
  14823. #. type: appendixsec
  14824. #: ./bashref.texi:8950 ./bashref.texi:8968 ./bashref.texi:8969
  14825. #, no-wrap
  14826. msgid "Concept Index"
  14827. msgstr ""
  14828. #. type: menuentry
  14829. #: ./bashref.texi:8950
  14830. msgid "General index for concepts described in this manual."
  14831. msgstr ""
  14832. #. type: appendixsec
  14833. #: ./bashref.texi:8953
  14834. #, no-wrap
  14835. msgid "Index of Shell Builtin Commands"
  14836. msgstr ""
  14837. #. type: appendixsec
  14838. #: ./bashref.texi:8957
  14839. #, no-wrap
  14840. msgid "Index of Shell Reserved Words"
  14841. msgstr ""
  14842. #. type: appendixsec
  14843. #: ./bashref.texi:8961
  14844. #, no-wrap
  14845. msgid "Parameter and Variable Index"
  14846. msgstr ""