dpkg-man.pot 549 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218132191322013221132221322313224132251322613227132281322913230132311323213233132341323513236132371323813239132401324113242132431324413245132461324713248132491325013251132521325313254132551325613257132581325913260132611326213263132641326513266132671326813269132701327113272132731327413275132761327713278132791328013281132821328313284132851328613287132881328913290132911329213293132941329513296132971329813299133001330113302133031330413305133061330713308133091331013311133121331313314133151331613317133181331913320133211332213323133241332513326133271332813329133301333113332133331333413335133361333713338133391334013341133421334313344133451334613347133481334913350133511335213353133541335513356133571335813359133601336113362133631336413365133661336713368133691337013371133721337313374133751337613377133781337913380133811338213383133841338513386133871338813389133901339113392133931339413395133961339713398133991340013401134021340313404134051340613407134081340913410134111341213413134141341513416134171341813419134201342113422134231342413425134261342713428134291343013431134321343313434134351343613437134381343913440134411344213443134441344513446134471344813449134501345113452134531345413455134561345713458134591346013461134621346313464134651346613467134681346913470134711347213473134741347513476134771347813479134801348113482134831348413485134861348713488134891349013491134921349313494134951349613497134981349913500135011350213503135041350513506135071350813509135101351113512135131351413515135161351713518135191352013521135221352313524135251352613527135281352913530135311353213533135341353513536135371353813539135401354113542135431354413545135461354713548135491355013551135521355313554135551355613557135581355913560135611356213563135641356513566135671356813569135701357113572135731357413575135761357713578135791358013581135821358313584135851358613587135881358913590135911359213593135941359513596135971359813599136001360113602136031360413605136061360713608136091361013611136121361313614136151361613617136181361913620136211362213623136241362513626136271362813629136301363113632136331363413635136361363713638136391364013641136421364313644136451364613647136481364913650136511365213653136541365513656136571365813659136601366113662136631366413665136661366713668136691367013671136721367313674136751367613677136781367913680136811368213683136841368513686136871368813689136901369113692136931369413695136961369713698136991370013701137021370313704137051370613707137081370913710137111371213713137141371513716137171371813719137201372113722137231372413725137261372713728137291373013731137321373313734137351373613737137381373913740137411374213743137441374513746137471374813749137501375113752137531375413755137561375713758137591376013761137621376313764137651376613767137681376913770137711377213773137741377513776137771377813779137801378113782137831378413785137861378713788137891379013791137921379313794137951379613797137981379913800138011380213803138041380513806138071380813809138101381113812138131381413815138161381713818138191382013821138221382313824138251382613827138281382913830138311383213833138341383513836138371383813839138401384113842138431384413845138461384713848138491385013851138521385313854138551385613857138581385913860138611386213863138641386513866138671386813869138701387113872138731387413875138761387713878138791388013881138821388313884138851388613887138881388913890138911389213893138941389513896138971389813899139001390113902139031390413905139061390713908139091391013911139121391313914139151391613917139181391913920139211392213923139241392513926139271392813929139301393113932139331393413935139361393713938139391394013941139421394313944139451394613947139481394913950139511395213953139541395513956139571395813959139601396113962139631396413965139661396713968139691397013971139721397313974139751397613977139781397913980139811398213983139841398513986139871398813989139901399113992139931399413995139961399713998139991400014001140021400314004140051400614007140081400914010140111401214013140141401514016140171401814019140201402114022140231402414025140261402714028140291403014031140321403314034140351403614037140381403914040140411404214043140441404514046140471404814049140501405114052140531405414055140561405714058140591406014061140621406314064140651406614067140681406914070140711407214073140741407514076140771407814079140801408114082140831408414085140861408714088140891409014091140921409314094140951409614097140981409914100141011410214103141041410514106141071410814109141101411114112141131411414115141161411714118141191412014121141221412314124141251412614127141281412914130141311413214133141341413514136141371413814139141401414114142141431414414145141461414714148141491415014151141521415314154141551415614157141581415914160141611416214163141641416514166141671416814169141701417114172141731417414175141761417714178141791418014181141821418314184141851418614187141881418914190141911419214193141941419514196141971419814199142001420114202142031420414205142061420714208142091421014211142121421314214142151421614217142181421914220142211422214223142241422514226142271422814229142301423114232142331423414235142361423714238142391424014241142421424314244142451424614247142481424914250142511425214253142541425514256142571425814259142601426114262142631426414265142661426714268142691427014271142721427314274142751427614277142781427914280142811428214283142841428514286142871428814289142901429114292142931429414295142961429714298142991430014301143021430314304143051430614307143081430914310143111431214313143141431514316143171431814319143201432114322143231432414325143261432714328143291433014331143321433314334143351433614337143381433914340143411434214343143441434514346143471434814349143501435114352143531435414355143561435714358143591436014361143621436314364143651436614367143681436914370143711437214373143741437514376143771437814379143801438114382143831438414385143861438714388143891439014391143921439314394143951439614397143981439914400144011440214403144041440514406144071440814409144101441114412144131441414415144161441714418144191442014421144221442314424144251442614427144281442914430144311443214433144341443514436144371443814439144401444114442144431444414445144461444714448144491445014451144521445314454144551445614457144581445914460144611446214463144641446514466144671446814469144701447114472144731447414475144761447714478144791448014481144821448314484144851448614487144881448914490144911449214493144941449514496144971449814499145001450114502145031450414505145061450714508145091451014511145121451314514145151451614517145181451914520145211452214523145241452514526145271452814529145301453114532145331453414535145361453714538145391454014541145421454314544145451454614547145481454914550145511455214553145541455514556145571455814559145601456114562145631456414565145661456714568145691457014571145721457314574145751457614577145781457914580145811458214583145841458514586145871458814589145901459114592145931459414595145961459714598145991460014601146021460314604146051460614607146081460914610146111461214613146141461514616146171461814619146201462114622146231462414625146261462714628146291463014631146321463314634146351463614637146381463914640146411464214643146441464514646146471464814649146501465114652146531465414655146561465714658146591466014661146621466314664146651466614667146681466914670146711467214673146741467514676146771467814679146801468114682146831468414685146861468714688146891469014691146921469314694146951469614697146981469914700147011470214703147041470514706147071470814709147101471114712147131471414715147161471714718147191472014721147221472314724147251472614727147281472914730147311473214733147341473514736147371473814739147401474114742147431474414745147461474714748147491475014751147521475314754147551475614757147581475914760147611476214763147641476514766147671476814769147701477114772147731477414775147761477714778147791478014781147821478314784147851478614787147881478914790147911479214793147941479514796147971479814799148001480114802148031480414805148061480714808148091481014811148121481314814148151481614817148181481914820148211482214823148241482514826148271482814829148301483114832148331483414835148361483714838148391484014841148421484314844148451484614847148481484914850148511485214853148541485514856148571485814859148601486114862148631486414865148661486714868148691487014871148721487314874148751487614877148781487914880148811488214883148841488514886148871488814889148901489114892148931489414895148961489714898148991490014901149021490314904149051490614907149081490914910149111491214913149141491514916149171491814919149201492114922149231492414925149261492714928149291493014931149321493314934149351493614937149381493914940149411494214943149441494514946149471494814949149501495114952149531495414955149561495714958149591496014961149621496314964149651496614967149681496914970149711497214973149741497514976149771497814979149801498114982149831498414985149861498714988149891499014991149921499314994149951499614997149981499915000150011500215003150041500515006150071500815009150101501115012150131501415015150161501715018150191502015021150221502315024150251502615027150281502915030150311503215033150341503515036150371503815039150401504115042150431504415045150461504715048150491505015051150521505315054150551505615057150581505915060150611506215063150641506515066150671506815069150701507115072150731507415075150761507715078150791508015081150821508315084150851508615087150881508915090150911509215093150941509515096150971509815099151001510115102151031510415105151061510715108151091511015111151121511315114151151511615117151181511915120151211512215123151241512515126151271512815129151301513115132151331513415135151361513715138151391514015141151421514315144151451514615147151481514915150151511515215153151541515515156151571515815159151601516115162151631516415165151661516715168151691517015171151721517315174151751517615177151781517915180151811518215183151841518515186151871518815189151901519115192151931519415195151961519715198151991520015201152021520315204152051520615207152081520915210152111521215213152141521515216152171521815219152201522115222152231522415225152261522715228152291523015231152321523315234152351523615237152381523915240152411524215243152441524515246152471524815249152501525115252152531525415255152561525715258152591526015261152621526315264152651526615267152681526915270152711527215273152741527515276152771527815279152801528115282152831528415285152861528715288152891529015291152921529315294152951529615297152981529915300153011530215303153041530515306153071530815309153101531115312153131531415315153161531715318153191532015321153221532315324153251532615327153281532915330153311533215333153341533515336153371533815339153401534115342153431534415345153461534715348153491535015351153521535315354153551535615357153581535915360153611536215363153641536515366153671536815369153701537115372153731537415375153761537715378153791538015381153821538315384153851538615387153881538915390153911539215393153941539515396153971539815399154001540115402154031540415405154061540715408154091541015411154121541315414154151541615417154181541915420154211542215423154241542515426154271542815429154301543115432154331543415435154361543715438154391544015441154421544315444154451544615447154481544915450154511545215453154541545515456154571545815459154601546115462154631546415465154661546715468154691547015471154721547315474154751547615477154781547915480154811548215483154841548515486154871548815489154901549115492154931549415495154961549715498154991550015501155021550315504155051550615507155081550915510155111551215513155141551515516155171551815519155201552115522155231552415525155261552715528155291553015531155321553315534155351553615537155381553915540155411554215543155441554515546155471554815549155501555115552155531555415555155561555715558155591556015561155621556315564155651556615567155681556915570155711557215573155741557515576155771557815579155801558115582155831558415585155861558715588155891559015591155921559315594155951559615597155981559915600156011560215603156041560515606156071560815609156101561115612156131561415615156161561715618156191562015621156221562315624156251562615627156281562915630156311563215633156341563515636156371563815639156401564115642156431564415645156461564715648156491565015651156521565315654156551565615657156581565915660156611566215663156641566515666156671566815669156701567115672156731567415675156761567715678156791568015681156821568315684156851568615687156881568915690156911569215693156941569515696156971569815699157001570115702157031570415705157061570715708157091571015711157121571315714157151571615717157181571915720157211572215723157241572515726157271572815729157301573115732157331573415735157361573715738157391574015741157421574315744157451574615747157481574915750157511575215753157541575515756157571575815759157601576115762157631576415765157661576715768157691577015771157721577315774157751577615777157781577915780157811578215783157841578515786157871578815789157901579115792157931579415795157961579715798157991580015801158021580315804158051580615807158081580915810158111581215813158141581515816158171581815819158201582115822158231582415825158261582715828158291583015831158321583315834158351583615837158381583915840158411584215843158441584515846158471584815849158501585115852158531585415855158561585715858158591586015861158621586315864158651586615867158681586915870158711587215873158741587515876158771587815879158801588115882158831588415885158861588715888158891589015891158921589315894158951589615897158981589915900159011590215903159041590515906159071590815909159101591115912159131591415915159161591715918159191592015921159221592315924159251592615927159281592915930159311593215933159341593515936159371593815939159401594115942159431594415945159461594715948159491595015951159521595315954159551595615957159581595915960159611596215963159641596515966159671596815969159701597115972159731597415975159761597715978159791598015981159821598315984159851598615987159881598915990159911599215993159941599515996159971599815999160001600116002160031600416005160061600716008160091601016011160121601316014160151601616017160181601916020160211602216023160241602516026160271602816029160301603116032160331603416035160361603716038160391604016041160421604316044160451604616047160481604916050160511605216053160541605516056160571605816059160601606116062160631606416065160661606716068160691607016071160721607316074160751607616077160781607916080160811608216083160841608516086160871608816089160901609116092160931609416095160961609716098160991610016101161021610316104161051610616107161081610916110161111611216113161141611516116161171611816119161201612116122161231612416125161261612716128161291613016131161321613316134161351613616137161381613916140161411614216143161441614516146161471614816149161501615116152161531615416155161561615716158161591616016161161621616316164161651616616167161681616916170161711617216173161741617516176161771617816179161801618116182161831618416185161861618716188161891619016191161921619316194161951619616197161981619916200162011620216203162041620516206162071620816209162101621116212162131621416215162161621716218162191622016221162221622316224162251622616227162281622916230162311623216233162341623516236162371623816239162401624116242162431624416245162461624716248162491625016251162521625316254162551625616257162581625916260162611626216263162641626516266162671626816269162701627116272162731627416275162761627716278162791628016281162821628316284162851628616287162881628916290162911629216293162941629516296162971629816299163001630116302163031630416305163061630716308163091631016311163121631316314163151631616317163181631916320163211632216323163241632516326163271632816329163301633116332163331633416335163361633716338163391634016341163421634316344163451634616347163481634916350163511635216353163541635516356163571635816359163601636116362163631636416365163661636716368163691637016371163721637316374163751637616377163781637916380163811638216383163841638516386163871638816389163901639116392163931639416395163961639716398163991640016401164021640316404164051640616407164081640916410164111641216413164141641516416164171641816419164201642116422164231642416425164261642716428164291643016431164321643316434164351643616437164381643916440164411644216443164441644516446164471644816449164501645116452164531645416455164561645716458164591646016461164621646316464164651646616467164681646916470164711647216473164741647516476164771647816479164801648116482164831648416485164861648716488164891649016491164921649316494164951649616497164981649916500165011650216503165041650516506165071650816509165101651116512165131651416515165161651716518165191652016521165221652316524165251652616527165281652916530165311653216533165341653516536165371653816539165401654116542165431654416545165461654716548165491655016551165521655316554165551655616557165581655916560165611656216563165641656516566165671656816569165701657116572165731657416575165761657716578165791658016581165821658316584165851658616587165881658916590165911659216593165941659516596165971659816599166001660116602166031660416605166061660716608166091661016611166121661316614166151661616617166181661916620166211662216623166241662516626166271662816629166301663116632166331663416635166361663716638166391664016641166421664316644166451664616647166481664916650166511665216653166541665516656166571665816659166601666116662166631666416665166661666716668166691667016671166721667316674166751667616677166781667916680166811668216683166841668516686166871668816689166901669116692166931669416695166961669716698166991670016701167021670316704167051670616707167081670916710167111671216713167141671516716167171671816719167201672116722167231672416725167261672716728167291673016731167321673316734167351673616737167381673916740167411674216743167441674516746167471674816749167501675116752167531675416755167561675716758167591676016761167621676316764167651676616767167681676916770167711677216773167741677516776167771677816779167801678116782167831678416785167861678716788167891679016791167921679316794167951679616797167981679916800168011680216803168041680516806168071680816809168101681116812168131681416815168161681716818168191682016821168221682316824168251682616827168281682916830168311683216833168341683516836168371683816839168401684116842168431684416845168461684716848168491685016851168521685316854168551685616857168581685916860168611686216863168641686516866168671686816869168701687116872168731687416875168761687716878168791688016881168821688316884168851688616887168881688916890168911689216893168941689516896168971689816899169001690116902169031690416905169061690716908169091691016911169121691316914169151691616917169181691916920169211692216923169241692516926169271692816929169301693116932169331693416935169361693716938169391694016941169421694316944169451694616947169481694916950169511695216953169541695516956169571695816959169601696116962169631696416965169661696716968169691697016971169721697316974169751697616977169781697916980169811698216983169841698516986169871698816989169901699116992169931699416995169961699716998169991700017001170021700317004170051700617007170081700917010170111701217013170141701517016170171701817019170201702117022170231702417025170261702717028170291703017031170321703317034170351703617037170381703917040170411704217043170441704517046170471704817049170501705117052170531705417055170561705717058170591706017061170621706317064170651706617067170681706917070170711707217073170741707517076170771707817079170801708117082170831708417085170861708717088170891709017091170921709317094170951709617097170981709917100171011710217103171041710517106171071710817109171101711117112171131711417115171161711717118171191712017121171221712317124171251712617127171281712917130171311713217133171341713517136171371713817139171401714117142171431714417145171461714717148171491715017151171521715317154171551715617157171581715917160171611716217163171641716517166171671716817169171701717117172171731717417175171761717717178171791718017181171821718317184171851718617187171881718917190171911719217193171941719517196171971719817199172001720117202172031720417205172061720717208172091721017211172121721317214172151721617217172181721917220172211722217223172241722517226172271722817229172301723117232172331723417235172361723717238172391724017241172421724317244172451724617247172481724917250172511725217253172541725517256172571725817259172601726117262172631726417265172661726717268172691727017271172721727317274172751727617277172781727917280172811728217283172841728517286172871728817289172901729117292172931729417295172961729717298172991730017301173021730317304173051730617307173081730917310173111731217313173141731517316173171731817319173201732117322173231732417325173261732717328173291733017331173321733317334173351733617337173381733917340173411734217343173441734517346173471734817349173501735117352173531735417355173561735717358173591736017361173621736317364173651736617367173681736917370173711737217373173741737517376173771737817379173801738117382173831738417385173861738717388173891739017391173921739317394173951739617397173981739917400174011740217403174041740517406174071740817409174101741117412174131741417415174161741717418174191742017421174221742317424174251742617427174281742917430174311743217433174341743517436174371743817439174401744117442174431744417445174461744717448174491745017451174521745317454174551745617457174581745917460174611746217463174641746517466174671746817469174701747117472174731747417475174761747717478174791748017481174821748317484174851748617487174881748917490174911749217493174941749517496174971749817499175001750117502175031750417505175061750717508175091751017511175121751317514175151751617517175181751917520175211752217523175241752517526175271752817529175301753117532175331753417535175361753717538175391754017541175421754317544175451754617547175481754917550175511755217553175541755517556175571755817559175601756117562175631756417565175661756717568175691757017571175721757317574175751757617577175781757917580175811758217583175841758517586175871758817589175901759117592175931759417595175961759717598175991760017601176021760317604176051760617607176081760917610176111761217613176141761517616176171761817619176201762117622176231762417625176261762717628176291763017631176321763317634176351763617637176381763917640176411764217643176441764517646176471764817649176501765117652176531765417655176561765717658176591766017661176621766317664176651766617667176681766917670176711767217673176741767517676176771767817679176801768117682176831768417685176861768717688176891769017691176921769317694176951769617697176981769917700177011770217703177041770517706177071770817709177101771117712177131771417715177161771717718177191772017721177221772317724177251772617727177281772917730177311773217733177341773517736177371773817739177401774117742177431774417745177461774717748177491775017751177521775317754177551775617757177581775917760177611776217763177641776517766177671776817769177701777117772177731777417775177761777717778177791778017781177821778317784177851778617787177881778917790177911779217793177941779517796177971779817799178001780117802178031780417805178061780717808178091781017811178121781317814178151781617817178181781917820178211782217823178241782517826178271782817829178301783117832178331783417835178361783717838178391784017841178421784317844178451784617847178481784917850178511785217853178541785517856178571785817859178601786117862178631786417865178661786717868178691787017871178721787317874178751787617877178781787917880178811788217883178841788517886178871788817889178901789117892178931789417895178961789717898178991790017901179021790317904179051790617907179081790917910179111791217913179141791517916179171791817919179201792117922179231792417925179261792717928179291793017931179321793317934179351793617937179381793917940179411794217943179441794517946179471794817949179501795117952179531795417955179561795717958179591796017961179621796317964179651796617967179681796917970179711797217973179741797517976179771797817979179801798117982179831798417985179861798717988179891799017991179921799317994179951799617997179981799918000180011800218003180041800518006180071800818009180101801118012180131801418015180161801718018180191802018021180221802318024180251802618027180281802918030180311803218033180341803518036180371803818039180401804118042180431804418045180461804718048180491805018051180521805318054180551805618057180581805918060180611806218063180641806518066180671806818069180701807118072180731807418075180761807718078180791808018081180821808318084180851808618087180881808918090180911809218093180941809518096180971809818099181001810118102181031810418105181061810718108181091811018111181121811318114181151811618117181181811918120181211812218123181241812518126181271812818129181301813118132181331813418135181361813718138181391814018141181421814318144181451814618147181481814918150181511815218153181541815518156181571815818159181601816118162181631816418165181661816718168181691817018171181721817318174181751817618177181781817918180181811818218183181841818518186181871818818189181901819118192181931819418195181961819718198181991820018201182021820318204182051820618207182081820918210182111821218213182141821518216182171821818219182201822118222182231822418225182261822718228182291823018231182321823318234182351823618237182381823918240182411824218243182441824518246182471824818249182501825118252182531825418255182561825718258182591826018261182621826318264182651826618267182681826918270182711827218273182741827518276182771827818279182801828118282182831828418285182861828718288182891829018291182921829318294182951829618297182981829918300183011830218303183041830518306183071830818309183101831118312183131831418315183161831718318183191832018321183221832318324183251832618327183281832918330183311833218333183341833518336183371833818339183401834118342183431834418345183461834718348183491835018351183521835318354183551835618357183581835918360183611836218363183641836518366183671836818369183701837118372183731837418375183761837718378183791838018381183821838318384183851838618387183881838918390183911839218393183941839518396183971839818399184001840118402184031840418405184061840718408184091841018411184121841318414184151841618417184181841918420184211842218423184241842518426184271842818429184301843118432184331843418435184361843718438184391844018441184421844318444184451844618447184481844918450184511845218453184541845518456184571845818459184601846118462184631846418465184661846718468184691847018471184721847318474184751847618477184781847918480184811848218483184841848518486184871848818489184901849118492184931849418495184961849718498184991850018501185021850318504185051850618507185081850918510185111851218513185141851518516185171851818519185201852118522185231852418525185261852718528185291853018531185321853318534185351853618537185381853918540185411854218543185441854518546185471854818549185501855118552185531855418555185561855718558185591856018561185621856318564185651856618567185681856918570185711857218573185741857518576185771857818579185801858118582185831858418585185861858718588185891859018591185921859318594185951859618597185981859918600186011860218603186041860518606186071860818609186101861118612186131861418615186161861718618186191862018621186221862318624186251862618627186281862918630186311863218633186341863518636186371863818639186401864118642186431864418645186461864718648186491865018651186521865318654186551865618657186581865918660186611866218663186641866518666186671866818669186701867118672186731867418675186761867718678186791868018681186821868318684186851868618687186881868918690186911869218693186941869518696186971869818699187001870118702187031870418705187061870718708187091871018711187121871318714187151871618717187181871918720187211872218723187241872518726187271872818729187301873118732187331873418735187361873718738187391874018741187421874318744187451874618747187481874918750187511875218753187541875518756187571875818759187601876118762187631876418765187661876718768187691877018771187721877318774187751877618777187781877918780187811878218783187841878518786187871878818789187901879118792187931879418795187961879718798187991880018801188021880318804188051880618807188081880918810188111881218813188141881518816188171881818819188201882118822188231882418825188261882718828188291883018831188321883318834188351883618837188381883918840188411884218843188441884518846188471884818849188501885118852188531885418855188561885718858188591886018861188621886318864188651886618867188681886918870188711887218873188741887518876188771887818879188801888118882188831888418885188861888718888188891889018891188921889318894188951889618897188981889918900189011890218903189041890518906189071890818909189101891118912189131891418915189161891718918189191892018921189221892318924189251892618927189281892918930189311893218933189341893518936189371893818939189401894118942189431894418945189461894718948189491895018951189521895318954189551895618957189581895918960189611896218963189641896518966189671896818969189701897118972189731897418975189761897718978189791898018981189821898318984189851898618987189881898918990189911899218993189941899518996189971899818999190001900119002190031900419005190061900719008190091901019011190121901319014190151901619017190181901919020190211902219023190241902519026190271902819029190301903119032190331903419035190361903719038190391904019041190421904319044190451904619047190481904919050190511905219053190541905519056190571905819059190601906119062190631906419065190661906719068190691907019071190721907319074190751907619077190781907919080190811908219083190841908519086190871908819089190901909119092190931909419095190961909719098190991910019101191021910319104191051910619107191081910919110191111911219113191141911519116191171911819119191201912119122191231912419125191261912719128191291913019131191321913319134191351913619137191381913919140191411914219143191441914519146191471914819149191501915119152191531915419155191561915719158191591916019161191621916319164191651916619167191681916919170191711917219173191741917519176191771917819179191801918119182191831918419185191861918719188191891919019191191921919319194191951919619197191981919919200192011920219203192041920519206192071920819209192101921119212192131921419215192161921719218192191922019221192221922319224192251922619227192281922919230192311923219233192341923519236192371923819239192401924119242192431924419245192461924719248192491925019251192521925319254192551925619257192581925919260192611926219263192641926519266192671926819269192701927119272192731927419275192761927719278192791928019281192821928319284192851928619287192881928919290192911929219293192941929519296192971929819299193001930119302193031930419305193061930719308193091931019311193121931319314193151931619317193181931919320193211932219323193241932519326193271932819329193301933119332193331933419335193361933719338193391934019341193421934319344193451934619347193481934919350193511935219353193541935519356193571935819359193601936119362193631936419365193661936719368193691937019371193721937319374193751937619377193781937919380193811938219383193841938519386193871938819389193901939119392193931939419395193961939719398193991940019401194021940319404194051940619407194081940919410194111941219413194141941519416194171941819419194201942119422194231942419425194261942719428194291943019431194321943319434194351943619437194381943919440194411944219443194441944519446194471944819449194501945119452194531945419455194561945719458194591946019461194621946319464194651946619467194681946919470194711947219473194741947519476194771947819479194801948119482194831948419485194861948719488194891949019491194921949319494194951949619497194981949919500195011950219503195041950519506195071950819509195101951119512195131951419515195161951719518195191952019521195221952319524195251952619527195281952919530195311953219533195341953519536195371953819539195401954119542195431954419545195461954719548195491955019551195521955319554195551955619557195581955919560195611956219563195641956519566195671956819569195701957119572195731957419575195761957719578195791958019581195821958319584195851958619587195881958919590195911959219593195941959519596195971959819599196001960119602196031960419605196061960719608196091961019611196121961319614196151961619617196181961919620196211962219623196241962519626196271962819629196301963119632196331963419635196361963719638196391964019641196421964319644196451964619647196481964919650196511965219653196541965519656196571965819659196601966119662196631966419665196661966719668196691967019671196721967319674196751967619677196781967919680196811968219683196841968519686196871968819689196901969119692196931969419695196961969719698196991970019701197021970319704197051970619707197081970919710197111971219713197141971519716197171971819719197201972119722197231972419725197261972719728197291973019731197321973319734197351973619737197381973919740197411974219743197441974519746197471974819749197501975119752197531975419755197561975719758197591976019761197621976319764197651976619767197681976919770197711977219773197741977519776197771977819779197801978119782197831978419785197861978719788197891979019791197921979319794197951979619797197981979919800198011980219803198041980519806198071980819809198101981119812198131981419815198161981719818198191982019821198221982319824198251982619827198281982919830198311983219833198341983519836198371983819839198401984119842198431984419845198461984719848198491985019851198521985319854198551985619857198581985919860198611986219863198641986519866198671986819869198701987119872198731987419875198761987719878198791988019881198821988319884198851988619887198881988919890198911989219893198941989519896198971989819899199001990119902199031990419905199061990719908199091991019911199121991319914199151991619917199181991919920199211992219923199241992519926199271992819929199301993119932199331993419935199361993719938199391994019941199421994319944199451994619947199481994919950199511995219953199541995519956199571995819959199601996119962199631996419965199661996719968199691997019971199721997319974199751997619977199781997919980199811998219983199841998519986199871998819989199901999119992199931999419995199961999719998199992000020001200022000320004200052000620007200082000920010200112001220013200142001520016200172001820019200202002120022200232002420025200262002720028200292003020031200322003320034200352003620037200382003920040200412004220043200442004520046200472004820049200502005120052200532005420055200562005720058200592006020061200622006320064200652006620067200682006920070200712007220073200742007520076200772007820079200802008120082200832008420085200862008720088200892009020091200922009320094200952009620097200982009920100201012010220103201042010520106201072010820109201102011120112201132011420115201162011720118201192012020121201222012320124201252012620127201282012920130201312013220133201342013520136201372013820139201402014120142201432014420145201462014720148201492015020151201522015320154201552015620157201582015920160201612016220163201642016520166201672016820169201702017120172201732017420175201762017720178201792018020181201822018320184201852018620187201882018920190201912019220193201942019520196201972019820199202002020120202202032020420205202062020720208202092021020211202122021320214202152021620217202182021920220202212022220223202242022520226202272022820229202302023120232202332023420235202362023720238202392024020241202422024320244202452024620247202482024920250202512025220253202542025520256202572025820259202602026120262202632026420265202662026720268202692027020271202722027320274202752027620277202782027920280202812028220283202842028520286202872028820289202902029120292202932029420295202962029720298202992030020301203022030320304203052030620307203082030920310203112031220313203142031520316203172031820319203202032120322203232032420325203262032720328
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) YEAR Dpkg Developers
  3. # This file is distributed under the same license as the dpkg-man package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: dpkg-man 1.18.23\n"
  10. "Report-Msgid-Bugs-To: debian-dpkg@lists.debian.org\n"
  11. "POT-Creation-Date: 2017-03-06 06:25+0100\n"
  12. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  13. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  14. "Language-Team: LANGUAGE <LL@li.org>\n"
  15. "Language: \n"
  16. "MIME-Version: 1.0\n"
  17. "Content-Type: text/plain; charset=UTF-8\n"
  18. "Content-Transfer-Encoding: 8bit\n"
  19. #. type: TH
  20. #: deb.man:1
  21. #, no-wrap
  22. msgid "deb"
  23. msgstr ""
  24. #. type: TH
  25. #: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
  26. #: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
  27. #: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
  28. #: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  29. #: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
  30. #: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
  31. #: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
  32. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  33. #: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
  34. #: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  35. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
  36. #: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  37. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
  38. #: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
  39. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  40. #: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
  41. #, no-wrap
  42. msgid "%RELEASE_DATE%"
  43. msgstr ""
  44. #. type: TH
  45. #: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
  46. #: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
  47. #: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
  48. #: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  49. #: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
  50. #: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
  51. #: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
  52. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  53. #: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
  54. #: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  55. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
  56. #: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  57. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
  58. #: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
  59. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  60. #: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
  61. #, no-wrap
  62. msgid "%VERSION%"
  63. msgstr ""
  64. #. type: TH
  65. #: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
  66. #: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
  67. #: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
  68. #: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  69. #: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
  70. #: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
  71. #: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
  72. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  73. #: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
  74. #: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  75. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
  76. #: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  77. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
  78. #: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
  79. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  80. #: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
  81. #, no-wrap
  82. msgid "dpkg suite"
  83. msgstr ""
  84. #. type: SH
  85. #: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
  86. #: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
  87. #: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
  88. #: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  89. #: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
  90. #: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
  91. #: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
  92. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  93. #: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
  94. #: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  95. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
  96. #: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  97. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
  98. #: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
  99. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  100. #: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
  101. #, no-wrap
  102. msgid "NAME"
  103. msgstr ""
  104. #. type: Plain text
  105. #: deb.man:1
  106. msgid "deb - Debian binary package format"
  107. msgstr ""
  108. #. type: SH
  109. #: deb.man:1 deb-buildinfo.man:1 deb-changelog.man:1 deb-changes.man:1
  110. #: deb-control.man:1 deb-conffiles.man:1 deb-src-control.man:1
  111. #: deb-src-files.man:1 deb-split.man:1 deb-version.man:1 deb-old.man:1
  112. #: deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  113. #: deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1 deb-postrm.man:1
  114. #: deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1 dsc.man:1 dpkg.man:1
  115. #: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
  116. #: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
  117. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  118. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
  119. #: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  120. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
  121. #: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
  122. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  123. #: start-stop-daemon.man:1 update-alternatives.man:1
  124. #, no-wrap
  125. msgid "SYNOPSIS"
  126. msgstr ""
  127. #. type: Plain text
  128. #: deb.man:1 deb-split.man:1 deb-old.man:1
  129. msgid "I<filename>B<.deb>"
  130. msgstr ""
  131. #. type: SH
  132. #: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
  133. #: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
  134. #: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
  135. #: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  136. #: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
  137. #: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
  138. #: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
  139. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  140. #: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
  141. #: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  142. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
  143. #: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  144. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
  145. #: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
  146. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  147. #: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
  148. #, no-wrap
  149. msgid "DESCRIPTION"
  150. msgstr ""
  151. #. type: Plain text
  152. #: deb.man:1
  153. msgid ""
  154. "The B<.deb> format is the Debian binary package file format. It is "
  155. "understood since dpkg 0.93.76, and is generated by default since dpkg 1.2.0 "
  156. "and 1.1.1elf (i386/ELF builds)."
  157. msgstr ""
  158. #. type: Plain text
  159. #: deb.man:1
  160. msgid ""
  161. "The format described here is used since Debian 0.93; details of the old "
  162. "format are described in B<deb-old>(5)."
  163. msgstr ""
  164. #. type: SH
  165. #: deb.man:1 deb-split.man:1 deb-old.man:1
  166. #, no-wrap
  167. msgid "FORMAT"
  168. msgstr ""
  169. #. type: Plain text
  170. #: deb.man:1
  171. msgid ""
  172. "The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>. Only "
  173. "the common B<ar> archive format is supported, with no long file name "
  174. "extensions, but with file names containing an optional trailing slash, which "
  175. "limits their length to 15 characters (from the 16 allowed). File sizes are "
  176. "limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 "
  177. "MiB member files."
  178. msgstr ""
  179. #. type: Plain text
  180. #: deb.man:1
  181. msgid ""
  182. "The B<tar> archives currently allowed are, the old-style (v7) format, the "
  183. "pre-POSIX ustar format, a subset of the GNU format (only the new style long "
  184. "pathnames and long linknames, supported since dpkg 1.4.1.17), and the POSIX "
  185. "ustar format (long names supported since dpkg 1.15.0). Unrecognized tar "
  186. "typeflags are considered an error. Each tar entry size inside a tar archive "
  187. "is limited to 11 ASCII octal digits, allowing for up to 8 GiB tar entries."
  188. msgstr ""
  189. #. type: Plain text
  190. #: deb.man:1
  191. msgid ""
  192. "The first member is named B<debian-binary> and contains a series of lines, "
  193. "separated by newlines. Currently only one line is present, the format "
  194. "version number, B<2.0> at the time this manual page was written. Programs "
  195. "which read new-format archives should be prepared for the minor number to be "
  196. "increased and new lines to be present, and should ignore these if this is "
  197. "the case."
  198. msgstr ""
  199. #. type: Plain text
  200. #: deb.man:1
  201. msgid ""
  202. "If the major number has changed, an incompatible change has been made and "
  203. "the program should stop. If it has not, then the program should be able to "
  204. "safely continue, unless it encounters an unexpected member in the archive "
  205. "(except at the end), as described below."
  206. msgstr ""
  207. #. type: Plain text
  208. #: deb.man:1
  209. msgid ""
  210. "The second required member is named B<control.tar>. It is a tar archive "
  211. "containing the package control information, either not compressed (supported "
  212. "since dpkg 1.17.6), or compressed with gzip (with B<.gz> extension) or xz "
  213. "(with B<.xz> extension, supported since 1.17.6), as a series of plain files, "
  214. "of which the file B<control> is mandatory and contains the core control "
  215. "information, the B<conffiles>, B<triggers>, B<shlibs> and B<symbols> files "
  216. "contain optional control information, and the B<preinst>, B<postinst>, "
  217. "B<prerm> and B<postrm> files are optional maintainer scripts. The control "
  218. "tarball may optionally contain an entry for ‘B<.>’, the current directory."
  219. msgstr ""
  220. #. type: Plain text
  221. #: deb.man:1
  222. msgid ""
  223. "The third, last required member is named B<data.tar>. It contains the "
  224. "filesystem as a tar archive, either not compressed (supported since dpkg "
  225. "1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> "
  226. "extension, supported since dpkg 1.15.6), bzip2 (with B<.bz2> extension, "
  227. "supported since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported "
  228. "since dpkg 1.13.25)."
  229. msgstr ""
  230. #. type: Plain text
  231. #: deb.man:1
  232. msgid ""
  233. "These members must occur in this exact order. Current implementations should "
  234. "ignore any additional members after B<data.tar>. Further members may be "
  235. "defined in the future, and (if possible) will be placed after these "
  236. "three. Any additional members that may need to be inserted after "
  237. "B<debian-binary> and before B<control.tar> or B<data.tar> and which should "
  238. "be safely ignored by older programs, will have names starting with an "
  239. "underscore, ‘B<_>’."
  240. msgstr ""
  241. #. type: Plain text
  242. #: deb.man:1
  243. msgid ""
  244. "Those new members which won't be able to be safely ignored will be inserted "
  245. "before B<data.tar> with names starting with something other than "
  246. "underscores, or will (more likely) cause the major version number to be "
  247. "increased."
  248. msgstr ""
  249. #. type: SH
  250. #: deb.man:1
  251. #, no-wrap
  252. msgid "MEDIA TYPE"
  253. msgstr ""
  254. #. type: SS
  255. #: deb.man:1
  256. #, no-wrap
  257. msgid "Current"
  258. msgstr ""
  259. #. type: Plain text
  260. #: deb.man:1
  261. msgid "application/vnd.debian.binary-package"
  262. msgstr ""
  263. #. type: SS
  264. #: deb.man:1
  265. #, no-wrap
  266. msgid "Deprecated"
  267. msgstr ""
  268. #. type: Plain text
  269. #: deb.man:1
  270. msgid "application/x-debian-package"
  271. msgstr ""
  272. #. type: Plain text
  273. #: deb.man:1
  274. msgid "application/x-deb"
  275. msgstr ""
  276. #. type: SH
  277. #: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
  278. #: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
  279. #: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
  280. #: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
  281. #: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
  282. #: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
  283. #: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
  284. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1
  285. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  286. #: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1 dpkg-name.man:1
  287. #: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
  288. #: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
  289. #: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1
  290. #: dpkg-vendor.man:1 dselect.man:1 dselect.cfg.man:1 update-alternatives.man:1
  291. #, no-wrap
  292. msgid "SEE ALSO"
  293. msgstr ""
  294. #. type: Plain text
  295. #: deb.man:1
  296. msgid ""
  297. "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5), B<deb-conffiles>(5) "
  298. "B<deb-triggers>(5), B<deb-shlibs>(5), B<deb-symbols>(5), B<deb-preinst>(5), "
  299. "B<deb-postinst>(5), B<deb-prerm>(5), B<deb-postrm>(5)."
  300. msgstr ""
  301. #. type: TH
  302. #: deb822.man:1
  303. #, no-wrap
  304. msgid "deb822"
  305. msgstr ""
  306. #. type: Plain text
  307. #: deb822.man:1
  308. msgid "deb822 - Debian RFC822 control data format"
  309. msgstr ""
  310. #. type: Plain text
  311. #: deb822.man:1
  312. msgid ""
  313. "The package management system manipulates data represented in a common "
  314. "format, known as I<control data>, stored in I<control files>. Control files "
  315. "are used for source packages, binary packages and the B<.changes> files "
  316. "which control the installation of uploaded files (B<dpkg>'s internal "
  317. "databases are in a similar format)."
  318. msgstr ""
  319. #. type: SH
  320. #: deb822.man:1
  321. #, no-wrap
  322. msgid "SYNTAX"
  323. msgstr ""
  324. #. type: Plain text
  325. #: deb822.man:1
  326. msgid ""
  327. "A control file consists of one or more paragraphs of fields (the paragraphs "
  328. "are also sometimes referred to as stanzas). The paragraphs are separated by "
  329. "empty lines. Parsers may accept lines consisting solely of U+0020 B<SPACE> "
  330. "and U+0009 B<TAB> as paragraph separators, but control files should use "
  331. "empty lines. Some control files allow only one paragraph; others allow "
  332. "several, in which case each paragraph usually refers to a different "
  333. "package. (For example, in source packages, the first paragraph refers to "
  334. "the source package, and later paragraphs refer to binary packages generated "
  335. "from the source.) The ordering of the paragraphs in control files is "
  336. "significant."
  337. msgstr ""
  338. #. type: Plain text
  339. #: deb822.man:1
  340. msgid ""
  341. "Each paragraph consists of a series of data fields. Each field consists of "
  342. "the field name followed by a colon (U+003A ‘B<:>’), and then the data/value "
  343. "associated with that field. The field name is composed of US-ASCII "
  344. "characters excluding control characters, space, and colon (i.e., characters "
  345. "in the ranges U+0021 ‘B<!>’ through U+0039 ‘B<9>’, and U+003B ‘B<;>’ through "
  346. "U+007E ‘B<~>’, inclusive). Field names must not begin with the comment "
  347. "character (U+0023 ‘B<#>’), nor with the hyphen character (U+002D ‘B<->’)."
  348. msgstr ""
  349. #. type: Plain text
  350. #: deb822.man:1
  351. msgid ""
  352. "The field ends at the end of the line or at the end of the last continuation "
  353. "line (see below). Horizontal whitespace (U+0020 B<SPACE> and U+0009 B<TAB>) "
  354. "may occur immediately before or after the value and is ignored there; it is "
  355. "conventional to put a single space after the colon. For example, a field "
  356. "might be:"
  357. msgstr ""
  358. #. type: Plain text
  359. #: deb822.man:1
  360. #, no-wrap
  361. msgid "Package: dpkg\n"
  362. msgstr ""
  363. #. type: Plain text
  364. #: deb822.man:1
  365. msgid "the field name is B<Package> and the field value B<dpkg>."
  366. msgstr ""
  367. #. type: Plain text
  368. #: deb822.man:1
  369. msgid ""
  370. "Empty field values are only permitted in source package control files "
  371. "(I<debian/control>). Such fields are ignored."
  372. msgstr ""
  373. #. type: Plain text
  374. #: deb822.man:1
  375. msgid ""
  376. "A paragraph must not contain more than one instance of a particular field "
  377. "name."
  378. msgstr ""
  379. #. type: Plain text
  380. #: deb822.man:1
  381. msgid "There are three types of fields:"
  382. msgstr ""
  383. #. type: TP
  384. #: deb822.man:1
  385. #, no-wrap
  386. msgid "B<simple>"
  387. msgstr ""
  388. #. type: Plain text
  389. #: deb822.man:1
  390. msgid ""
  391. "The field, including its value, must be a single line. Folding of the field "
  392. "is not permitted. This is the default field type if the definition of the "
  393. "field does not specify a different type."
  394. msgstr ""
  395. #. type: TP
  396. #: deb822.man:1
  397. #, no-wrap
  398. msgid "B<folded>"
  399. msgstr ""
  400. #. type: Plain text
  401. #: deb822.man:1
  402. msgid ""
  403. "The value of a folded field is a logical line that may span several lines. "
  404. "The lines after the first are called continuation lines and must start with "
  405. "a U+0020 B<SPACE> or a U+0009 B<TAB>. Whitespace, including any newlines, "
  406. "is not significant in the field values of folded fields."
  407. msgstr ""
  408. #. type: Plain text
  409. #: deb822.man:1
  410. msgid ""
  411. "This folding method is similar to RFC5322, allowing control files that "
  412. "contain only one paragraph and no multiline fields to be read by parsers "
  413. "written for RFC5322."
  414. msgstr ""
  415. #. type: TP
  416. #: deb822.man:1
  417. #, no-wrap
  418. msgid "B<multiline>"
  419. msgstr ""
  420. #. type: Plain text
  421. #: deb822.man:1
  422. msgid ""
  423. "The value of a multiline field may comprise multiple continuation lines. "
  424. "The first line of the value, the part on the same line as the field name, "
  425. "often has special significance or may have to be empty. Other lines are "
  426. "added following the same syntax as the continuation lines of the folded "
  427. "fields. Whitespace, including newlines, is significant in the values of "
  428. "multiline fields."
  429. msgstr ""
  430. #. type: Plain text
  431. #: deb822.man:1
  432. msgid ""
  433. "Whitespace must not appear inside names (of packages, architectures, files "
  434. "or anything else) or version numbers, or between the characters of "
  435. "multi-character version relationships."
  436. msgstr ""
  437. #. type: Plain text
  438. #: deb822.man:1
  439. msgid ""
  440. "The presence and purpose of a field, and the syntax of its value may differ "
  441. "between types of control files."
  442. msgstr ""
  443. #. type: Plain text
  444. #: deb822.man:1
  445. msgid ""
  446. "Field names are not case-sensitive, but it is usual to capitalize the field "
  447. "names using mixed case as shown below. Field values are case-sensitive "
  448. "unless the description of the field says otherwise."
  449. msgstr ""
  450. #. type: Plain text
  451. #: deb822.man:1
  452. msgid ""
  453. "Paragraph separators (empty lines) and lines consisting only of U+0020 "
  454. "B<SPACE> and U+0009 B<TAB>, are not allowed within field values or between "
  455. "fields. Empty lines in field values are usually escaped by representing "
  456. "them by a U+0020 B<SPACE> followed by a dot (U+002E ‘B<.>’)."
  457. msgstr ""
  458. #. type: Plain text
  459. #: deb822.man:1
  460. msgid ""
  461. "Lines starting with U+0023 ‘B<#>’, without any preceding whitespace are "
  462. "comments lines that are only permitted in source package control files "
  463. "(I<debian/control>) and in B<deb-origin>(5) files. These comment lines are "
  464. "ignored, even between two continuation lines. They do not end logical "
  465. "lines."
  466. msgstr ""
  467. #. type: Plain text
  468. #: deb822.man:1
  469. msgid "All control files must be encoded in UTF-8."
  470. msgstr ""
  471. #. type: Plain text
  472. #: deb822.man:1
  473. msgid "B<RFC822>, B<RFC5322>."
  474. msgstr ""
  475. #. type: TH
  476. #: deb-buildinfo.man:1
  477. #, no-wrap
  478. msgid "deb-buildinfo"
  479. msgstr ""
  480. #. type: Plain text
  481. #: deb-buildinfo.man:1
  482. msgid "deb-buildinfo - Debian build information file format"
  483. msgstr ""
  484. #. type: Plain text
  485. #: deb-buildinfo.man:1
  486. msgid "I<filename>B<.buildinfo>"
  487. msgstr ""
  488. #. type: Plain text
  489. #: deb-buildinfo.man:1
  490. msgid ""
  491. "Each Debian source package build can record the build information in a "
  492. "B<.buildinfo> control file, which contains a number of fields. Each field "
  493. "begins with a tag, such as B<Source> or B<Binary> (case insensitive), "
  494. "followed by a colon, and the body of the field. Fields are delimited only "
  495. "by field tags. In other words, field text may be multiple lines in length, "
  496. "but the installation tools will generally join lines when processing the "
  497. "body of the field (except in case of the multiline fields "
  498. "B<Binary-Only-Changes>, B<Installed-Build-Depends>, B<Environment>, "
  499. "B<Checksums-Md5>, B<Checksums-Sha1> and B<Checksums-Sha256>, see below)."
  500. msgstr ""
  501. #. type: Plain text
  502. #: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
  503. msgid ""
  504. "The control data might be enclosed in an OpenPGP ASCII Armored signature, as "
  505. "specified in RFC4880."
  506. msgstr ""
  507. #. type: Plain text
  508. #: deb-buildinfo.man:1
  509. msgid ""
  510. "The name of the B<.buildinfo> file will depend on the type of build and will "
  511. "be as specific as necessary but not more; for a build that includes B<any> "
  512. "the name will be "
  513. "I<source-name>B<_>I<source-version>B<_>I<arch>B<.buildinfo>, or otherwise "
  514. "for a build that includes B<all> the name will be "
  515. "I<source-name>B<_>I<source-version>B<_>B<all.buildinfo>, or otherwise for a "
  516. "build that includes B<source> the name will be "
  517. "I<source-name>B<_>I<source-version>B<_>B<source.buildinfo>."
  518. msgstr ""
  519. #. type: SH
  520. #: deb-buildinfo.man:1 deb-changes.man:1 deb-control.man:1 deb-origin.man:1
  521. #: dsc.man:1
  522. #, no-wrap
  523. msgid "FIELDS"
  524. msgstr ""
  525. #. type: TP
  526. #: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
  527. #, no-wrap
  528. msgid "B<Format:> I<format-version> (required)"
  529. msgstr ""
  530. #. type: Plain text
  531. #: deb-buildinfo.man:1
  532. msgid ""
  533. "The value of this field declares the format version of the file. The syntax "
  534. "of the field value is a version number with a major and minor component. "
  535. "Backward incompatible changes to the format will bump the major version, and "
  536. "backward compatible changes (such as field additions) will bump the minor "
  537. "version. The current format version is B<1.0>."
  538. msgstr ""
  539. #. type: TP
  540. #: deb-buildinfo.man:1 deb-changes.man:1
  541. #, no-wrap
  542. msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>] (required)"
  543. msgstr ""
  544. #. type: Plain text
  545. #: deb-buildinfo.man:1
  546. msgid ""
  547. "The name of the source package. If the source version differs from the "
  548. "binary version, then the I<source-name> will be followed by a "
  549. "I<source-version> in parenthesis. This can happen when the build is for a "
  550. "binary-only non-maintainer upload."
  551. msgstr ""
  552. #. type: TP
  553. #: deb-buildinfo.man:1 deb-changes.man:1
  554. #, no-wrap
  555. msgid "B<Binary:> I<binary-package-list> (required)"
  556. msgstr ""
  557. #. type: Plain text
  558. #: deb-buildinfo.man:1
  559. msgid "This folded field is a space-separated list of binary packages built."
  560. msgstr ""
  561. #. type: TP
  562. #: deb-buildinfo.man:1
  563. #, no-wrap
  564. msgid "B<Architecture:> I<arch-list> (required)"
  565. msgstr ""
  566. #. type: Plain text
  567. #: deb-buildinfo.man:1
  568. msgid ""
  569. "This space-separated field lists the architectures of the files currently "
  570. "being built. Common architectures are B<amd64>, B<armel>, B<i386>, etc. "
  571. "Note that the B<all> value is meant for packages that are architecture "
  572. "independent. If the source for the package is also being built, the special "
  573. "entry B<source> is also present. Architecture wildcards must never be "
  574. "present in the list."
  575. msgstr ""
  576. #. type: TP
  577. #: deb-buildinfo.man:1 deb-changes.man:1 deb-control.man:1 dsc.man:1
  578. #, no-wrap
  579. msgid "B<Version:> I<version-string> (required)"
  580. msgstr ""
  581. #. type: Plain text
  582. #: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
  583. msgid ""
  584. "Typically, this is the original package's version number in whatever form "
  585. "the program's author uses. It may also include a Debian revision number "
  586. "(for non-native packages). The exact format and sorting algorithm are "
  587. "described in B<deb-version>(5)."
  588. msgstr ""
  589. #. type: TP
  590. #: deb-buildinfo.man:1
  591. #, no-wrap
  592. msgid "B<Binary-Only-Changes:>"
  593. msgstr ""
  594. #. type: TQ
  595. #: deb-buildinfo.man:1
  596. #, no-wrap
  597. msgid "I<changelog-entry>"
  598. msgstr ""
  599. #. type: Plain text
  600. #: deb-buildinfo.man:1
  601. msgid ""
  602. "This multiline field contains the concatenated text of the changelog entry "
  603. "for a binary-only non-maintainer upload (binNMU) if that is the case. To "
  604. "make this a valid multiline field empty lines are replaced with a single "
  605. "full stop (‘.’) and all lines are indented by one space character. The "
  606. "exact content depends on the changelog format."
  607. msgstr ""
  608. #. type: TP
  609. #: deb-buildinfo.man:1
  610. #, no-wrap
  611. msgid "B<Checksums-Md5:> (required)"
  612. msgstr ""
  613. #. type: TQ
  614. #: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
  615. #, no-wrap
  616. msgid "B<Checksums-Sha1:> (required)"
  617. msgstr ""
  618. #. type: TQ
  619. #: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
  620. #, no-wrap
  621. msgid "B<Checksums-Sha256:> (required)"
  622. msgstr ""
  623. #. type: TQ
  624. #: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
  625. #, no-wrap
  626. msgid " I<checksum> I<size> I<filename>"
  627. msgstr ""
  628. #. type: Plain text
  629. #: deb-buildinfo.man:1
  630. msgid ""
  631. "These multiline fields contain a list of files with a checksum and size for "
  632. "each one. These fields have the same syntax and differ only in the checksum "
  633. "algorithm used: MD5 for B<Checksums-Md5>, SHA-1 for B<Checksums-Sha1> and "
  634. "SHA-256 for B<Checksums-Sha256>."
  635. msgstr ""
  636. #. type: Plain text
  637. #: deb-buildinfo.man:1 deb-changes.man:1
  638. msgid ""
  639. "The first line of the field value (the part on the same line as the field "
  640. "name followed by a colon) is always empty. The content of the field is "
  641. "expressed as continuation lines, one line per file. Each line consists of "
  642. "space-separated entries describing the file: the checksum, the file size, "
  643. "and the file name."
  644. msgstr ""
  645. #. type: Plain text
  646. #: deb-buildinfo.man:1
  647. msgid "These fields list all files that make up the build."
  648. msgstr ""
  649. #. type: TP
  650. #: deb-buildinfo.man:1
  651. #, no-wrap
  652. msgid "B<Build-Origin:> I<name>"
  653. msgstr ""
  654. #. type: Plain text
  655. #: deb-buildinfo.man:1 deb-control.man:1 dsc.man:1
  656. msgid "The name of the distribution this package is originating from."
  657. msgstr ""
  658. #. type: TP
  659. #: deb-buildinfo.man:1
  660. #, no-wrap
  661. msgid "B<Build-Architecture:> I<arch> (required)"
  662. msgstr ""
  663. #. type: Plain text
  664. #: deb-buildinfo.man:1
  665. msgid ""
  666. "The Debian architecture for the installation the packages is being built "
  667. "in. Common architectures are B<amd64>, B<armel>, B<i386>, etc."
  668. msgstr ""
  669. #. type: TP
  670. #: deb-buildinfo.man:1
  671. #, no-wrap
  672. msgid "B<Build-Date:> I<build-date>"
  673. msgstr ""
  674. #. type: Plain text
  675. #: deb-buildinfo.man:1
  676. msgid ""
  677. "The date the package was built. It must be in the same format as the date "
  678. "in a B<deb-changelog>(5) entry."
  679. msgstr ""
  680. #. type: TP
  681. #: deb-buildinfo.man:1
  682. #, no-wrap
  683. msgid "B<Build-Path:> I<build-path>"
  684. msgstr ""
  685. #. type: Plain text
  686. #: deb-buildinfo.man:1
  687. msgid ""
  688. "The absolute build path, which correspond to the unpacked source tree. This "
  689. "field is only going to be present if the vendor has whitelisted it via some "
  690. "pattern match to avoid leaking possibly sensitive information."
  691. msgstr ""
  692. #. type: Plain text
  693. #: deb-buildinfo.man:1
  694. msgid ""
  695. "On Debian and derivaties only build paths starting with I</build/> will emit "
  696. "this field."
  697. msgstr ""
  698. #. type: TP
  699. #: deb-buildinfo.man:1
  700. #, no-wrap
  701. msgid "B<Installed-Build-Depends:> (required)"
  702. msgstr ""
  703. #. type: TQ
  704. #: deb-buildinfo.man:1
  705. #, no-wrap
  706. msgid "I<package-list>"
  707. msgstr ""
  708. #. type: Plain text
  709. #: deb-buildinfo.man:1
  710. msgid ""
  711. "The list of installed and configured packages that might affect the package "
  712. "build process."
  713. msgstr ""
  714. #. type: Plain text
  715. #: deb-buildinfo.man:1
  716. msgid ""
  717. "The list consists of each package name, optionally arch-qualified for "
  718. "foreign architectures, with an exact version restriction, separated by "
  719. "commas."
  720. msgstr ""
  721. #. type: Plain text
  722. #: deb-buildinfo.man:1
  723. msgid ""
  724. "The list includes all essential packages, packages listed in "
  725. "B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> source "
  726. "control fields, any vendor specific builtin dependencies, and all their "
  727. "recursive dependencies. On Debian and derivatives the dependency builtin is "
  728. "B<build-essential>."
  729. msgstr ""
  730. #. type: Plain text
  731. #: deb-buildinfo.man:1
  732. msgid ""
  733. "For dependencies coming from the source control fields, all dependency "
  734. "alternatives and all providers of virtual packages depended on will be "
  735. "included."
  736. msgstr ""
  737. #. type: TP
  738. #: deb-buildinfo.man:1
  739. #, no-wrap
  740. msgid "B<Environment:>"
  741. msgstr ""
  742. #. type: TQ
  743. #: deb-buildinfo.man:1
  744. #, no-wrap
  745. msgid "I<variable-list>"
  746. msgstr ""
  747. #. type: Plain text
  748. #: deb-buildinfo.man:1
  749. msgid ""
  750. "The list of environment variables that are known to affect the package build "
  751. "process, with each environment variable followed by an equal sign (‘=’) and "
  752. "the variable's quoted value, using double quotes (‘\"’), and backslashes "
  753. "escaped (‘\\e\\e’)."
  754. msgstr ""
  755. #. type: Plain text
  756. #: deb-buildinfo.man:1
  757. msgid "B<deb-changes>(5), B<deb-version>(5), B<dpkg-genbuildinfo>(1)."
  758. msgstr ""
  759. #. type: TH
  760. #: deb-changelog.man:1
  761. #, no-wrap
  762. msgid "deb-changelog"
  763. msgstr ""
  764. #. type: Plain text
  765. #: deb-changelog.man:1
  766. msgid "deb-changelog - dpkg source packages' changelog file format"
  767. msgstr ""
  768. #. type: Plain text
  769. #: deb-changelog.man:1
  770. msgid "changelog"
  771. msgstr ""
  772. #. type: Plain text
  773. #: deb-changelog.man:1
  774. msgid ""
  775. "Changes in the packaged version of a project are explained in the changelog "
  776. "file I<debian/changelog>. This includes modifications made in the source "
  777. "package compared to the upstream one as well as other changes and updates to "
  778. "the package."
  779. msgstr ""
  780. #. type: Plain text
  781. #: deb-changelog.man:1
  782. msgid ""
  783. "The format of the I<debian/changelog> allows the package building tools to "
  784. "discover which version of the package is being built and find out other "
  785. "release-specific information."
  786. msgstr ""
  787. #. type: Plain text
  788. #: deb-changelog.man:1
  789. msgid "That format is a series of entries like this:"
  790. msgstr ""
  791. #. type: Plain text
  792. #: deb-changelog.man:1
  793. #, no-wrap
  794. msgid ""
  795. "I<package> (I<version>) I<distributions>; I<metadata>\n"
  796. " [optional blank line(s), stripped]\n"
  797. " * I<change-details>\n"
  798. " I<more-change-details>\n"
  799. " [blank line(s), included in output of B<dpkg-parsechangelog>(1)]\n"
  800. " * I<even-more-change-details>\n"
  801. " [optional blank line(s), stripped]\n"
  802. " -- I<maintainer-name> E<lt>I<email-address>E<gt> I<date>\n"
  803. msgstr ""
  804. #. type: Plain text
  805. #: deb-changelog.man:1
  806. msgid "I<package> and I<version> are the source package name and version number."
  807. msgstr ""
  808. #. type: Plain text
  809. #: deb-changelog.man:1
  810. msgid ""
  811. "I<distributions> lists one or more space-separated distributions where this "
  812. "version should be installed when it is uploaded; it is copied to the "
  813. "B<Distribution> field in the I<.changes> file."
  814. msgstr ""
  815. #. type: Plain text
  816. #: deb-changelog.man:1
  817. msgid ""
  818. "I<metadata> is a comma-separated list of I<keyword>=I<value> items. The "
  819. "only I<keyword>s currently supported by B<dpkg> are B<urgency> and "
  820. "B<binary-only>. B<urgency>'s value is used for the B<Urgency> field in the "
  821. "I<.changes> file for the upload. B<binary-only> with a B<yes> value, is "
  822. "used to denote that this changelog entry is for a binary-only non-maintainer "
  823. "upload (an automatic binary rebuild with the only change being the changelog "
  824. "entry)."
  825. msgstr ""
  826. #. type: Plain text
  827. #: deb-changelog.man:1
  828. msgid ""
  829. "The change details may in fact be any series of lines starting with at least "
  830. "two spaces, but conventionally each change starts with an asterisk and a "
  831. "separating space and continuation lines are indented so as to bring them in "
  832. "line with the start of the text above. Blank lines may be used here to "
  833. "separate groups of changes, if desired."
  834. msgstr ""
  835. #. type: Plain text
  836. #: deb-changelog.man:1
  837. msgid ""
  838. "If this upload resolves bugs recorded in the distribution bug tracking "
  839. "system, they may be automatically closed on the inclusion of this package "
  840. "into the distribution archive by including the string:"
  841. msgstr ""
  842. #. type: Plain text
  843. #: deb-changelog.man:1
  844. #, no-wrap
  845. msgid " B<Closes: Bug#>I<nnnnn>\n"
  846. msgstr ""
  847. #. type: Plain text
  848. #: deb-changelog.man:1
  849. msgid ""
  850. "in the change details (the exact Perl regular expression is "
  851. "B</closes:\\es*(?:bug)?\\e#?\\es?\\ed+(?:,\\es*(?:bug)?\\e#?\\es?\\ed+)*/i>). "
  852. "This information is conveyed via the B<Closes> field in the I<.changes> "
  853. "file."
  854. msgstr ""
  855. #. type: Plain text
  856. #: deb-changelog.man:1
  857. msgid ""
  858. "The maintainer name and email address used in the changelog should be the "
  859. "details of the person who prepared this release of the package. They are "
  860. "B<not> necessarily those of the uploader or usual package maintainer. The "
  861. "information here will be copied to the B<Changed-By> field in the "
  862. "I<.changes> file, and then later might be used to send an acknowledgement "
  863. "when the upload has been installed in the distribution archive."
  864. msgstr ""
  865. #. type: Plain text
  866. #: deb-changelog.man:1
  867. msgid ""
  868. "The I<date> has the following format (compatible and with the same semantics "
  869. "of RFC2822 and RFC5322, or what «date -R» generates):"
  870. msgstr ""
  871. #. type: Plain text
  872. #: deb-changelog.man:1
  873. msgid ""
  874. "I<day-of-week>B<,> I<dd> I<month> I<yyyy> I<hh>B<:>I<mm>B<:>I<ss> "
  875. "B<+>I<zzzz>"
  876. msgstr ""
  877. #. type: Plain text
  878. #: deb-changelog.man:1
  879. msgid "where:"
  880. msgstr ""
  881. #. type: TP
  882. #: deb-changelog.man:1
  883. #, no-wrap
  884. msgid "I<day-of-week>"
  885. msgstr ""
  886. #. type: Plain text
  887. #: deb-changelog.man:1
  888. msgid "Is one of: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>."
  889. msgstr ""
  890. #. type: TP
  891. #: deb-changelog.man:1
  892. #, no-wrap
  893. msgid "I<dd>"
  894. msgstr ""
  895. #. type: Plain text
  896. #: deb-changelog.man:1
  897. msgid "Is a one- or two-digit day of the month (B<01>-B<31>)."
  898. msgstr ""
  899. #. type: TP
  900. #: deb-changelog.man:1
  901. #, no-wrap
  902. msgid "I<month>"
  903. msgstr ""
  904. #. type: Plain text
  905. #: deb-changelog.man:1
  906. msgid ""
  907. "Is one of: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, "
  908. "B<Sep>, B<Oct>, B<Nov>, B<Dec>."
  909. msgstr ""
  910. #. type: TP
  911. #: deb-changelog.man:1
  912. #, no-wrap
  913. msgid "I<yyyy>"
  914. msgstr ""
  915. #. type: Plain text
  916. #: deb-changelog.man:1
  917. msgid "Is the four-digit year (e.g. 2010)."
  918. msgstr ""
  919. #. type: TP
  920. #: deb-changelog.man:1
  921. #, no-wrap
  922. msgid "I<hh>"
  923. msgstr ""
  924. #. type: Plain text
  925. #: deb-changelog.man:1
  926. msgid "Is the two-digit hour (B<00>-B<23>)."
  927. msgstr ""
  928. #. type: TP
  929. #: deb-changelog.man:1
  930. #, no-wrap
  931. msgid "I<mm>"
  932. msgstr ""
  933. #. type: Plain text
  934. #: deb-changelog.man:1
  935. msgid "Is the two-digit minutes (B<00>-B<59>)."
  936. msgstr ""
  937. #. type: TP
  938. #: deb-changelog.man:1
  939. #, no-wrap
  940. msgid "I<ss>"
  941. msgstr ""
  942. #. type: Plain text
  943. #: deb-changelog.man:1
  944. msgid "Is the two-digit seconds (B<00>-B<60>)."
  945. msgstr ""
  946. #. type: TP
  947. #: deb-changelog.man:1
  948. #, no-wrap
  949. msgid "[B<+->]I<zzzz>"
  950. msgstr ""
  951. #. type: Plain text
  952. #: deb-changelog.man:1
  953. msgid ""
  954. "Is the time zone offset from Coordinated Universal Time (UTC). ‘B<+>’ "
  955. "indicates that the time is ahead of (i.e., east of) UTC and ‘B<->’ indicates "
  956. "that the time is behind (i.e., west of) UTC. The first two digits indicate "
  957. "the hour difference from UTC and the last two digits indicate the number of "
  958. "additional minutes difference from UTC. The last two digits must be in the "
  959. "range B<00>-B<59>."
  960. msgstr ""
  961. #. type: Plain text
  962. #: deb-changelog.man:1
  963. msgid ""
  964. "The first “title” line with the package name must start at the left hand "
  965. "margin. The “trailer” line with the maintainer and date details must be "
  966. "preceded by exactly one space. The maintainer details and the date must be "
  967. "separated by exactly two spaces."
  968. msgstr ""
  969. #. type: Plain text
  970. #: deb-changelog.man:1
  971. msgid "The entire changelog must be encoded in UTF-8."
  972. msgstr ""
  973. #. type: SH
  974. #: deb-changelog.man:1 deb-substvars.man:1 dpkg.man:1 dpkg-architecture.man:1
  975. #: dpkg.cfg.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
  976. #: dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1 dpkg-divert.man:1
  977. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-parsechangelog.man:1
  978. #: dpkg-source.man:1 dpkg-split.man:1 dpkg-statoverride.man:1 dselect.cfg.man:1
  979. #: update-alternatives.man:1
  980. #, no-wrap
  981. msgid "FILES"
  982. msgstr ""
  983. #. type: TP
  984. #: deb-changelog.man:1
  985. #, no-wrap
  986. msgid "I<debian/changelog>"
  987. msgstr ""
  988. #. type: SH
  989. #: deb-changelog.man:1 deb-shlibs.man:1 deb-symbols.man:1 dpkg.man:1
  990. #: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-divert.man:1
  991. #: dpkg-name.man:1 update-alternatives.man:1
  992. #, no-wrap
  993. msgid "EXAMPLES"
  994. msgstr ""
  995. #. type: Plain text
  996. #: deb-changelog.man:1
  997. #, no-wrap
  998. msgid "dpkg (1.17.18) unstable; urgency=low\n"
  999. msgstr ""
  1000. #. type: Plain text
  1001. #: deb-changelog.man:1
  1002. #, no-wrap
  1003. msgid ""
  1004. " [ Guillem Jover ]\n"
  1005. " * Handle empty minimum versions when initializing dependency versions,\n"
  1006. " as the code is mapping the minimum version 0 to '' to avoid outputting\n"
  1007. " useless versions. Regression introduced in dpkg 1.17.17. Closes: "
  1008. "#764929\n"
  1009. msgstr ""
  1010. #. type: Plain text
  1011. #: deb-changelog.man:1
  1012. #, no-wrap
  1013. msgid ""
  1014. " [ Updated programs translations ]\n"
  1015. " * Catalan (Guillem Jover).\n"
  1016. msgstr ""
  1017. #. type: Plain text
  1018. #: deb-changelog.man:1
  1019. #, no-wrap
  1020. msgid ""
  1021. " [ Updated dselect translations ]\n"
  1022. " * Catalan (Guillem Jover).\n"
  1023. " * German (Sven Joachim).\n"
  1024. msgstr ""
  1025. #. type: Plain text
  1026. #: deb-changelog.man:1
  1027. #, no-wrap
  1028. msgid ""
  1029. " -- Guillem Jover E<lt>guillem@debian.orgE<gt> Sun, 12 Oct 2014 15:47:44 "
  1030. "+0200\n"
  1031. msgstr ""
  1032. #. type: Plain text
  1033. #: deb-changelog.man:1
  1034. msgid "B<deb-version>(5), B<deb-changes>(5), B<dpkg-parsechangelog>(1)."
  1035. msgstr ""
  1036. #. type: TH
  1037. #: deb-changes.man:1
  1038. #, no-wrap
  1039. msgid "deb-changes"
  1040. msgstr ""
  1041. #. type: Plain text
  1042. #: deb-changes.man:1
  1043. msgid "deb-changes - Debian changes file format"
  1044. msgstr ""
  1045. #. type: Plain text
  1046. #: deb-changes.man:1
  1047. msgid "I<filename>B<.changes>"
  1048. msgstr ""
  1049. #. type: Plain text
  1050. #: deb-changes.man:1
  1051. msgid ""
  1052. "Each Debian upload is composed of a .changes control file, which contains a "
  1053. "number of fields. Each field begins with a tag, such as B<Source> or "
  1054. "B<Binary> (case insensitive), followed by a colon, and the body of the "
  1055. "field. Fields are delimited only by field tags. In other words, field text "
  1056. "may be multiple lines in length, but the installation tools will generally "
  1057. "join lines when processing the body of the field (except in case of the "
  1058. "multiline fields B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> and "
  1059. "B<Checksums-Sha256>, see below)."
  1060. msgstr ""
  1061. #. type: Plain text
  1062. #: deb-changes.man:1
  1063. msgid ""
  1064. "The value of this field declares the format version of the file. The syntax "
  1065. "of the field value is a version number with a major and minor component. "
  1066. "Backward incompatible changes to the format will bump the major version, and "
  1067. "backward compatible changes (such as field additions) will bump the minor "
  1068. "version. The current format version is B<1.8>."
  1069. msgstr ""
  1070. #. type: TP
  1071. #: deb-changes.man:1
  1072. #, no-wrap
  1073. msgid "B<Date:> I<release-date> (required)"
  1074. msgstr ""
  1075. #. type: Plain text
  1076. #: deb-changes.man:1
  1077. msgid ""
  1078. "The date the package was built or last edited. It must be in the same "
  1079. "format as the date in a B<deb-changelog>(5) entry."
  1080. msgstr ""
  1081. #. type: Plain text
  1082. #: deb-changes.man:1
  1083. msgid ""
  1084. "The value of this field is usually extracted from the I<debian/changelog> "
  1085. "file."
  1086. msgstr ""
  1087. #. type: Plain text
  1088. #: deb-changes.man:1
  1089. msgid ""
  1090. "The name of the source package. If the source version differs from the "
  1091. "binary version, then the I<source-name> will be followed by a "
  1092. "I<source-version> in parenthesis. This can happen when the upload is a "
  1093. "binary-only non-maintainer upload."
  1094. msgstr ""
  1095. #. type: Plain text
  1096. #: deb-changes.man:1
  1097. msgid "This folded field is a space-separated list of binary packages to upload."
  1098. msgstr ""
  1099. #. type: TP
  1100. #: deb-changes.man:1
  1101. #, no-wrap
  1102. msgid "B<Architecture:> I<arch-list>"
  1103. msgstr ""
  1104. #. type: Plain text
  1105. #: deb-changes.man:1
  1106. msgid ""
  1107. "Lists the architectures of the files currently being uploaded. Common "
  1108. "architectures are B<amd64>, B<armel>, B<i386>, etc. Note that the B<all> "
  1109. "value is meant for packages that are architecture independent. If the "
  1110. "source for the package is also being uploaded, the special entry B<source> "
  1111. "is also present. Architecture wildcards must never be present in the list."
  1112. msgstr ""
  1113. #. type: TP
  1114. #: deb-changes.man:1
  1115. #, no-wrap
  1116. msgid "B<Distribution:> I<distribution>s (required)"
  1117. msgstr ""
  1118. #. type: Plain text
  1119. #: deb-changes.man:1
  1120. msgid ""
  1121. "Lists one or more space-separated distributions where this version should be "
  1122. "installed when it is uploaded to the archive."
  1123. msgstr ""
  1124. #. type: TP
  1125. #: deb-changes.man:1
  1126. #, no-wrap
  1127. msgid "B<Urgency:> I<urgency> (recommended)"
  1128. msgstr ""
  1129. #. type: Plain text
  1130. #: deb-changes.man:1
  1131. msgid ""
  1132. "The urgency of the upload. The currently known values, in increasing order "
  1133. "of urgency, are: B<low>, B<medium>, B<high>, B<critical> and B<emergency>."
  1134. msgstr ""
  1135. #. type: TP
  1136. #: deb-changes.man:1
  1137. #, no-wrap
  1138. msgid "B<Maintainer:> I<fullname-email> (required)"
  1139. msgstr ""
  1140. #. type: Plain text
  1141. #: deb-changes.man:1
  1142. msgid ""
  1143. "Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is "
  1144. "typically the person who created the package, as opposed to the author of "
  1145. "the software that was packaged."
  1146. msgstr ""
  1147. #. type: TP
  1148. #: deb-changes.man:1
  1149. #, no-wrap
  1150. msgid "B<Changed-By:>I< fullname-email>"
  1151. msgstr ""
  1152. #. type: Plain text
  1153. #: deb-changes.man:1
  1154. msgid ""
  1155. "Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is "
  1156. "typically the person who prepared the package changes for this release."
  1157. msgstr ""
  1158. #. type: TP
  1159. #: deb-changes.man:1
  1160. #, no-wrap
  1161. msgid "B<Description:> (recommended)"
  1162. msgstr ""
  1163. #. type: TQ
  1164. #: deb-changes.man:1
  1165. #, no-wrap
  1166. msgid " I<binary-package-name> B<-> I<binary-package-summary>"
  1167. msgstr ""
  1168. #. type: Plain text
  1169. #: deb-changes.man:1
  1170. msgid ""
  1171. "This multiline field contains a list of binary package names followed by a "
  1172. "space, a dash (‘B<->’) and their possibly truncated short descriptions."
  1173. msgstr ""
  1174. #. type: TP
  1175. #: deb-changes.man:1
  1176. #, no-wrap
  1177. msgid "B<Closes:>I< bug-number-list>"
  1178. msgstr ""
  1179. #. type: Plain text
  1180. #: deb-changes.man:1
  1181. msgid ""
  1182. "A space-separated list of bug report numbers that have been resolved with "
  1183. "this upload. The distribution archive software might use this field to "
  1184. "automatically close the referred bug numbers in the distribution bug "
  1185. "tracking system."
  1186. msgstr ""
  1187. #. type: TP
  1188. #: deb-changes.man:1
  1189. #, no-wrap
  1190. msgid "B<Binary-Only: yes>"
  1191. msgstr ""
  1192. #. type: Plain text
  1193. #: deb-changes.man:1
  1194. msgid ""
  1195. "This field denotes that the upload is a binary-only non-maintainer build. "
  1196. "It originates from the B<binary-only=yes> key/value from the changelog "
  1197. "matadata entry."
  1198. msgstr ""
  1199. #. type: TP
  1200. #: deb-changes.man:1
  1201. #, no-wrap
  1202. msgid "B<Built-For-Profiles:>I< profile-list>"
  1203. msgstr ""
  1204. #. type: Plain text
  1205. #: deb-changes.man:1
  1206. msgid ""
  1207. "This field specifies a whitespace separated list of build profiles that this "
  1208. "upload was built with."
  1209. msgstr ""
  1210. #. type: TP
  1211. #: deb-changes.man:1
  1212. #, no-wrap
  1213. msgid "B<Changes:> (required)"
  1214. msgstr ""
  1215. #. type: TQ
  1216. #: deb-changes.man:1
  1217. #, no-wrap
  1218. msgid "I<changelog-entries>"
  1219. msgstr ""
  1220. #. type: Plain text
  1221. #: deb-changes.man:1
  1222. msgid ""
  1223. "This multiline field contains the concatenated text of all changelog entries "
  1224. "that are part of the upload. To make this a valid multiline field empty "
  1225. "lines are replaced with a single full stop (‘.’) and all lines are indented "
  1226. "by one space character. The exact content depends on the changelog format."
  1227. msgstr ""
  1228. #. type: TP
  1229. #: deb-changes.man:1 dsc.man:1
  1230. #, no-wrap
  1231. msgid "B<Files:> (required)"
  1232. msgstr ""
  1233. #. type: TQ
  1234. #: deb-changes.man:1
  1235. #, no-wrap
  1236. msgid " I<md5sum> I<size> I<section> I<priority> I<filename>"
  1237. msgstr ""
  1238. #. type: Plain text
  1239. #: deb-changes.man:1
  1240. msgid ""
  1241. "This multiline field contains a list of files with an md5sum, size, section "
  1242. "and priority for each one."
  1243. msgstr ""
  1244. #. type: Plain text
  1245. #: deb-changes.man:1
  1246. msgid ""
  1247. "The first line of the field value (the part on the same line as the field "
  1248. "name followed by a colon) is always empty. The content of the field is "
  1249. "expressed as continuation lines, one line per file. Each line consists of "
  1250. "space-separated entries describing the file: the md5sum, the file size, the "
  1251. "file section, the file priority, and the file name."
  1252. msgstr ""
  1253. #. type: Plain text
  1254. #: deb-changes.man:1
  1255. msgid ""
  1256. "This field lists all files that make up the upload. The list of files in "
  1257. "this field must match the list of files in the other related B<Checksums> "
  1258. "fields."
  1259. msgstr ""
  1260. #. type: Plain text
  1261. #: deb-changes.man:1
  1262. msgid ""
  1263. "These multiline fields contain a list of files with a checksum and size for "
  1264. "each one. These fields have the same syntax and differ only in the checksum "
  1265. "algorithm used: SHA-1 for B<Checksums-Sha1> and SHA-256 for "
  1266. "B<Checksums-Sha256>."
  1267. msgstr ""
  1268. #. type: Plain text
  1269. #: deb-changes.man:1
  1270. msgid ""
  1271. "These fields list all files that make up the upload. The list of files in "
  1272. "these fields must match the list of files in the B<Files> field and the "
  1273. "other related B<Checksums> fields."
  1274. msgstr ""
  1275. #. type: SH
  1276. #: deb-changes.man:1 dsc.man:1 dpkg.man:1 dpkg-buildpackage.man:1
  1277. #: dpkg-deb.man:1 dpkg-name.man:1 dpkg-source.man:1 dpkg-split.man:1
  1278. #: dselect.man:1
  1279. #, no-wrap
  1280. msgid "BUGS"
  1281. msgstr ""
  1282. #. type: Plain text
  1283. #: deb-changes.man:1
  1284. msgid ""
  1285. "The B<Files> field is inconsistent with the other B<Checksums> fields. The "
  1286. "B<Change-By> and B<Maintainer> fields have confusing names. The "
  1287. "B<Distribution> field contains information about what is commonly referred "
  1288. "to as a suite."
  1289. msgstr ""
  1290. #. type: Plain text
  1291. #: deb-changes.man:1
  1292. msgid "B<deb-src-control>(5), B<deb-version>(5)."
  1293. msgstr ""
  1294. #. type: TH
  1295. #: deb-control.man:1
  1296. #, no-wrap
  1297. msgid "deb-control"
  1298. msgstr ""
  1299. #. type: Plain text
  1300. #: deb-control.man:1
  1301. msgid "deb-control - Debian binary packages' master control file format"
  1302. msgstr ""
  1303. #. type: Plain text
  1304. #: deb-control.man:1
  1305. msgid "control"
  1306. msgstr ""
  1307. #. type: Plain text
  1308. #: deb-control.man:1
  1309. msgid ""
  1310. "Each Debian binary package contains the master I<control> file, which "
  1311. "contains a number of fields. Each field begins with a tag, such as "
  1312. "B<Package> or B<Version> (case insensitive), followed by a colon, and the "
  1313. "body of the field. Fields are delimited only by field tags. In other words, "
  1314. "field text may be multiple lines in length, but the installation tools will "
  1315. "generally join lines when processing the body of the field (except in the "
  1316. "case of the B<Description> field, see below)."
  1317. msgstr ""
  1318. #. type: TP
  1319. #: deb-control.man:1
  1320. #, no-wrap
  1321. msgid "B<Package:> I<package-name> (required)"
  1322. msgstr ""
  1323. #. type: Plain text
  1324. #: deb-control.man:1 dsc.man:1
  1325. msgid ""
  1326. "The value of this field determines the package name, and is used to generate "
  1327. "file names by most installation tools."
  1328. msgstr ""
  1329. #. type: Plain text
  1330. #: deb-control.man:1
  1331. msgid ""
  1332. "Typically, this is the original package's version number in whatever form "
  1333. "the program's author uses. It may also include a Debian revision number (for "
  1334. "non-native packages). The exact format and sorting algorithm are described "
  1335. "in B<deb-version>(5)."
  1336. msgstr ""
  1337. #. type: TP
  1338. #: deb-control.man:1 deb-src-control.man:1 dsc.man:1
  1339. #, no-wrap
  1340. msgid "B<Maintainer:> I<fullname-email> (recommended)"
  1341. msgstr ""
  1342. #. type: Plain text
  1343. #: deb-control.man:1 dsc.man:1
  1344. msgid ""
  1345. "Should be in the format “Joe Bloggs E<lt>jbloggs@foo.comE<gt>”, and is "
  1346. "typically the person who created the package, as opposed to the author of "
  1347. "the software that was packaged."
  1348. msgstr ""
  1349. #. type: TQ
  1350. #: deb-control.man:1 deb-src-control.man:1
  1351. #, no-wrap
  1352. msgid "B<Description:> I<short-description> (recommended)"
  1353. msgstr ""
  1354. #. type: TQ
  1355. #: deb-control.man:1
  1356. #, no-wrap
  1357. msgid "B< >I<long-description>"
  1358. msgstr ""
  1359. #. type: Plain text
  1360. #: deb-control.man:1
  1361. msgid ""
  1362. "The format for the package description is a short brief summary on the first "
  1363. "line (after the B<Description> field). The following lines should be used as "
  1364. "a longer, more detailed description. Each line of the long description must "
  1365. "be preceded by a space, and blank lines in the long description must contain "
  1366. "a single ‘B<.>’ following the preceding space."
  1367. msgstr ""
  1368. #. type: TP
  1369. #: deb-control.man:1 deb-src-control.man:1
  1370. #, no-wrap
  1371. msgid "B<Section:>I< section>"
  1372. msgstr ""
  1373. #. type: Plain text
  1374. #: deb-control.man:1 deb-src-control.man:1
  1375. msgid ""
  1376. "This is a general field that gives the package a category based on the "
  1377. "software that it installs. Some common sections are B<utils>, B<net>, "
  1378. "B<mail>, B<text>, B<x11>, etc."
  1379. msgstr ""
  1380. #. type: TP
  1381. #: deb-control.man:1 deb-src-control.man:1
  1382. #, no-wrap
  1383. msgid "B<Priority:>I< priority>"
  1384. msgstr ""
  1385. #. type: Plain text
  1386. #: deb-control.man:1 deb-src-control.man:1
  1387. msgid ""
  1388. "Sets the importance of this package in relation to the system as a whole. "
  1389. "Common priorities are B<required>, B<standard>, B<optional>, B<extra>, etc."
  1390. msgstr ""
  1391. #. type: Plain text
  1392. #: deb-control.man:1 deb-src-control.man:1
  1393. msgid ""
  1394. "The B<Section> and B<Priority> fields usually have a defined set of accepted "
  1395. "values based on the specific distribution policy."
  1396. msgstr ""
  1397. #. type: TP
  1398. #: deb-control.man:1
  1399. #, no-wrap
  1400. msgid "B<Installed-Size:> size"
  1401. msgstr ""
  1402. #. type: Plain text
  1403. #: deb-control.man:1
  1404. msgid "The approximate total size of the package's installed files, in KiB units."
  1405. msgstr ""
  1406. #. type: TP
  1407. #: deb-control.man:1 deb-src-control.man:1
  1408. #, no-wrap
  1409. msgid "B<Essential:> B<yes>|B<no>"
  1410. msgstr ""
  1411. #. type: Plain text
  1412. #: deb-control.man:1
  1413. msgid ""
  1414. "This field is usually only needed when the answer is B<yes>. It denotes a "
  1415. "package that is required for proper operation of the system. Dpkg or any "
  1416. "other installation tool will not allow an B<Essential> package to be removed "
  1417. "(at least not without using one of the force options)."
  1418. msgstr ""
  1419. #. type: TQ
  1420. #: deb-control.man:1 deb-src-control.man:1
  1421. #, no-wrap
  1422. msgid "B<Build-Essential:> B<yes>|B<no>"
  1423. msgstr ""
  1424. #. type: Plain text
  1425. #: deb-control.man:1
  1426. msgid ""
  1427. "This field is usually only needed when the answer is B<yes>, and is commonly "
  1428. "injected by the archive software. It denotes a package that is required "
  1429. "when building other packages."
  1430. msgstr ""
  1431. #. type: TP
  1432. #: deb-control.man:1
  1433. #, no-wrap
  1434. msgid "B<Architecture:> I<arch>|B<all> (recommended)"
  1435. msgstr ""
  1436. #. type: Plain text
  1437. #: deb-control.man:1
  1438. msgid ""
  1439. "The architecture specifies which type of hardware this package was compiled "
  1440. "for. Common architectures are B<amd64>, B<armel>, B<i386>, B<powerpc>, "
  1441. "etc. Note that the B<all> value is meant for packages that are architecture "
  1442. "independent. Some examples of this are shell and Perl scripts, and "
  1443. "documentation."
  1444. msgstr ""
  1445. #. type: TP
  1446. #: deb-control.man:1 deb-src-control.man:1 dsc.man:1
  1447. #, no-wrap
  1448. msgid "B<Origin:>I< name>"
  1449. msgstr ""
  1450. #. type: TP
  1451. #: deb-control.man:1 deb-src-control.man:1
  1452. #, no-wrap
  1453. msgid "B<Bugs:>I< url>"
  1454. msgstr ""
  1455. #. type: Plain text
  1456. #: deb-control.man:1
  1457. msgid ""
  1458. "The I<url> of the bug tracking system for this package. The current used "
  1459. "format is I<bts-type>B<://>I<bts-address>, like "
  1460. "B<debbugs://bugs.debian.org>."
  1461. msgstr ""
  1462. #. type: TP
  1463. #: deb-control.man:1 deb-src-control.man:1 dsc.man:1
  1464. #, no-wrap
  1465. msgid "B<Homepage:>I< url>"
  1466. msgstr ""
  1467. #. type: Plain text
  1468. #: deb-control.man:1 dsc.man:1
  1469. msgid "The upstream project home page I<url>."
  1470. msgstr ""
  1471. #. type: TQ
  1472. #: deb-control.man:1 deb-src-control.man:1
  1473. #, no-wrap
  1474. msgid "B<Tag:>I< tag-list>"
  1475. msgstr ""
  1476. #. type: Plain text
  1477. #: deb-control.man:1
  1478. msgid ""
  1479. "List of tags describing the qualities of the package. The description and "
  1480. "list of supported tags can be found in the B<debtags> package."
  1481. msgstr ""
  1482. #. type: TP
  1483. #: deb-control.man:1
  1484. #, no-wrap
  1485. msgid "B<Multi-Arch:> B<no>|B<same>|B<foreign>|B<allowed>"
  1486. msgstr ""
  1487. #. type: Plain text
  1488. #: deb-control.man:1
  1489. msgid ""
  1490. "This field is used to indicate how this package should behave on a "
  1491. "multi-arch installations."
  1492. msgstr ""
  1493. #. type: TP
  1494. #: deb-control.man:1
  1495. #, no-wrap
  1496. msgid "B<no>"
  1497. msgstr ""
  1498. #. type: Plain text
  1499. #: deb-control.man:1
  1500. msgid ""
  1501. "This value is the default when the field is omitted, in which case adding "
  1502. "the field with an explicit B<no> value is generally not needed."
  1503. msgstr ""
  1504. #. type: TP
  1505. #: deb-control.man:1
  1506. #, no-wrap
  1507. msgid "B<same>"
  1508. msgstr ""
  1509. #. type: Plain text
  1510. #: deb-control.man:1
  1511. msgid ""
  1512. "This package is co-installable with itself, but it must not be used to "
  1513. "satisfy the dependency of any package of a different architecture from "
  1514. "itself."
  1515. msgstr ""
  1516. #. type: TP
  1517. #: deb-control.man:1
  1518. #, no-wrap
  1519. msgid "B<foreign>"
  1520. msgstr ""
  1521. #. type: Plain text
  1522. #: deb-control.man:1
  1523. msgid ""
  1524. "This package is not co-installable with itself, but should be allowed to "
  1525. "satisfy a non-arch-qualified dependency of a package of a different arch "
  1526. "from itself (if a dependency has an explicit arch-qualifier then the value "
  1527. "B<foreign> is ignored)."
  1528. msgstr ""
  1529. #. type: TP
  1530. #: deb-control.man:1
  1531. #, no-wrap
  1532. msgid "B<allowed>"
  1533. msgstr ""
  1534. #. type: Plain text
  1535. #: deb-control.man:1
  1536. msgid ""
  1537. "This allows reverse-dependencies to indicate in their B<Depends> field that "
  1538. "they accept this package from a foreign architecture by qualifying the "
  1539. "package name with B<:any>, but has no effect otherwise."
  1540. msgstr ""
  1541. #. type: TP
  1542. #: deb-control.man:1
  1543. #, no-wrap
  1544. msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>]"
  1545. msgstr ""
  1546. #. type: Plain text
  1547. #: deb-control.man:1
  1548. msgid ""
  1549. "The name of the source package that this binary package came from, if it is "
  1550. "different than the name of the package itself. If the source version "
  1551. "differs from the binary version, then the I<source-name> will be followed by "
  1552. "a I<source-version> in parenthesis. This can happen for example on a "
  1553. "binary-only non-maintainer upload, or when setting a different binary "
  1554. "version via «B<dpkg-gencontrol -v>»."
  1555. msgstr ""
  1556. #. type: TP
  1557. #: deb-control.man:1 deb-src-control.man:1
  1558. #, no-wrap
  1559. msgid "B<Subarchitecture:>I< value>"
  1560. msgstr ""
  1561. #. type: TQ
  1562. #: deb-control.man:1 deb-src-control.man:1
  1563. #, no-wrap
  1564. msgid "B<Kernel-Version:>I< value>"
  1565. msgstr ""
  1566. #. type: TQ
  1567. #: deb-control.man:1 deb-src-control.man:1
  1568. #, no-wrap
  1569. msgid "B<Installer-Menu-Item:>I< value>"
  1570. msgstr ""
  1571. #. type: Plain text
  1572. #: deb-control.man:1 deb-src-control.man:1
  1573. msgid ""
  1574. "These fields are used by the debian-installer and are usually not needed. "
  1575. "See /usr/share/doc/debian-installer/devel/modules.txt from the "
  1576. "B<debian-installer> package for more details about them."
  1577. msgstr ""
  1578. #. type: TP
  1579. #: deb-control.man:1 deb-src-control.man:1
  1580. #, no-wrap
  1581. msgid "B<Depends:>I< package-list>"
  1582. msgstr ""
  1583. #. type: Plain text
  1584. #: deb-control.man:1
  1585. msgid ""
  1586. "List of packages that are required for this package to provide a non-trivial "
  1587. "amount of functionality. The package maintenance software will not allow a "
  1588. "package to be installed if the packages listed in its B<Depends> field "
  1589. "aren't installed (at least not without using the force options). In an "
  1590. "installation, the postinst scripts of packages listed in B<Depends> fields "
  1591. "are run before those of the packages which depend on them. On the opposite, "
  1592. "in a removal, the prerm script of a package is run before those of the "
  1593. "packages listed in its B<Depends> field."
  1594. msgstr ""
  1595. #. type: TQ
  1596. #: deb-control.man:1 deb-src-control.man:1
  1597. #, no-wrap
  1598. msgid "B<Pre-Depends:>I< package-list>"
  1599. msgstr ""
  1600. #. type: Plain text
  1601. #: deb-control.man:1
  1602. msgid ""
  1603. "List of packages that must be installed B<and> configured before this one "
  1604. "can be installed. This is usually used in the case where this package "
  1605. "requires another package for running its preinst script."
  1606. msgstr ""
  1607. #. type: TQ
  1608. #: deb-control.man:1 deb-src-control.man:1
  1609. #, no-wrap
  1610. msgid "B<Recommends:>I< package-list>"
  1611. msgstr ""
  1612. #. type: Plain text
  1613. #: deb-control.man:1
  1614. msgid ""
  1615. "Lists packages that would be found together with this one in all but unusual "
  1616. "installations. The package maintenance software will warn the user if they "
  1617. "install a package without those listed in its B<Recommends> field."
  1618. msgstr ""
  1619. #. type: TQ
  1620. #: deb-control.man:1 deb-src-control.man:1
  1621. #, no-wrap
  1622. msgid "B<Suggests:>I< package-list>"
  1623. msgstr ""
  1624. #. type: Plain text
  1625. #: deb-control.man:1
  1626. msgid ""
  1627. "Lists packages that are related to this one and can perhaps enhance its "
  1628. "usefulness, but without which installing this package is perfectly "
  1629. "reasonable."
  1630. msgstr ""
  1631. #. type: Plain text
  1632. #: deb-control.man:1
  1633. msgid ""
  1634. "The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> "
  1635. "fields is a list of groups of alternative packages. Each group is a list of "
  1636. "packages separated by vertical bar (or “pipe”) symbols, ‘B<|>’. The groups "
  1637. "are separated by commas. Commas are to be read as “AND”, and pipes as “OR”, "
  1638. "with pipes binding more tightly. Each package name is optionally followed "
  1639. "by an architecture qualifier appended after a colon ‘B<:>’, optionally "
  1640. "followed by a version number specification in parentheses."
  1641. msgstr ""
  1642. #. type: Plain text
  1643. #: deb-control.man:1
  1644. msgid ""
  1645. "An architecture qualifier name can be a real Debian architecture name (since "
  1646. "dpkg 1.16.5) or B<any> (since dpkg 1.16.2). If omitted, the default is the "
  1647. "current binary package architecture. A real Debian architecture name will "
  1648. "match exactly that architecture for that package name, B<any> will match any "
  1649. "architecture for that package name if the package has been marked as "
  1650. "B<Multi-Arch: allowed>."
  1651. msgstr ""
  1652. #. type: Plain text
  1653. #: deb-control.man:1 deb-src-control.man:1
  1654. msgid ""
  1655. "A version number may start with a ‘B<E<gt>E<gt>>’, in which case any later "
  1656. "version will match, and may specify or omit the Debian packaging revision "
  1657. "(separated by a hyphen). Accepted version relationships are ‘B<E<gt>E<gt>>’ "
  1658. "for greater than, ‘B<E<lt>E<lt>>’ for less than, ‘B<E<gt>=>’ for greater "
  1659. "than or equal to, ‘B<E<lt>=>’ for less than or equal to, and ‘B<=>’ for "
  1660. "equal to."
  1661. msgstr ""
  1662. #. type: TQ
  1663. #: deb-control.man:1 deb-src-control.man:1
  1664. #, no-wrap
  1665. msgid "B<Breaks:>I< package-list>"
  1666. msgstr ""
  1667. #. type: Plain text
  1668. #: deb-control.man:1
  1669. msgid ""
  1670. "Lists packages that this one breaks, for example by exposing bugs when the "
  1671. "named packages rely on this one. The package maintenance software will not "
  1672. "allow broken packages to be configured; generally the resolution is to "
  1673. "upgrade the packages named in a B<Breaks> field."
  1674. msgstr ""
  1675. #. type: TQ
  1676. #: deb-control.man:1 deb-src-control.man:1
  1677. #, no-wrap
  1678. msgid "B<Conflicts:>I< package-list>"
  1679. msgstr ""
  1680. #. type: Plain text
  1681. #: deb-control.man:1
  1682. msgid ""
  1683. "Lists packages that conflict with this one, for example by containing files "
  1684. "with the same names. The package maintenance software will not allow "
  1685. "conflicting packages to be installed at the same time. Two conflicting "
  1686. "packages should each include a B<Conflicts> line mentioning the other."
  1687. msgstr ""
  1688. #. type: TQ
  1689. #: deb-control.man:1 deb-src-control.man:1
  1690. #, no-wrap
  1691. msgid "B<Replaces:>I< package-list>"
  1692. msgstr ""
  1693. #. type: Plain text
  1694. #: deb-control.man:1
  1695. msgid ""
  1696. "List of packages files from which this one replaces. This is used for "
  1697. "allowing this package to overwrite the files of another package and is "
  1698. "usually used with the B<Conflicts> field to force removal of the other "
  1699. "package, if this one also has the same files as the conflicted package."
  1700. msgstr ""
  1701. #. type: Plain text
  1702. #: deb-control.man:1
  1703. msgid ""
  1704. "The syntax of B<Breaks>, B<Conflicts> and B<Replaces> is a list of package "
  1705. "names, separated by commas (and optional whitespace). In the B<Breaks> and "
  1706. "B<Conflicts> fields, the comma should be read as “OR”. An optional "
  1707. "architecture qualifier can also be appended to the package name with the "
  1708. "same syntax as above, but the default is B<any> instead of the binary "
  1709. "package architecture. An optional version can also be given with the same "
  1710. "syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields."
  1711. msgstr ""
  1712. #. type: TQ
  1713. #: deb-control.man:1 deb-src-control.man:1
  1714. #, no-wrap
  1715. msgid "B<Provides:>I< package-list>"
  1716. msgstr ""
  1717. #. type: Plain text
  1718. #: deb-control.man:1
  1719. msgid ""
  1720. "This is a list of virtual packages that this one provides. Usually this is "
  1721. "used in the case of several packages all providing the same service. For "
  1722. "example, sendmail and exim can serve as a mail server, so they provide a "
  1723. "common package (“mail-transport-agent”) on which other packages can depend. "
  1724. "This will allow sendmail or exim to serve as a valid option to satisfy the "
  1725. "dependency. This prevents the packages that depend on a mail server from "
  1726. "having to know the package names for all of them, and using ‘B<|>’ to "
  1727. "separate the list."
  1728. msgstr ""
  1729. #. type: Plain text
  1730. #: deb-control.man:1
  1731. msgid ""
  1732. "The syntax of B<Provides> is a list of package names, separated by commas "
  1733. "(and optional whitespace). An optional architecture qualifier can also be "
  1734. "appended to the package name with the same syntax as above. If omitted, the "
  1735. "default is the current binary package architecture. An optional exact "
  1736. "(equal to) version can also be given with the same syntax as above (honored "
  1737. "since dpkg 1.17.11)."
  1738. msgstr ""
  1739. #. type: TQ
  1740. #: deb-control.man:1 deb-src-control.man:1
  1741. #, no-wrap
  1742. msgid "B<Built-Using:>I< package-list>"
  1743. msgstr ""
  1744. #. type: Plain text
  1745. #: deb-control.man:1
  1746. msgid ""
  1747. "This field lists extra source packages that were used during the build of "
  1748. "this binary package. This is an indication to the archive maintenance "
  1749. "software that these extra source packages must be kept whilst this binary "
  1750. "package is maintained. This field must be a list of source package names "
  1751. "with strict ‘B<=>’ version relationships. Note that the archive maintenance "
  1752. "software is likely to refuse to accept an upload which declares a "
  1753. "B<Built-Using> relationship which cannot be satisfied within the archive."
  1754. msgstr ""
  1755. #. type: TP
  1756. #: deb-control.man:1
  1757. #, no-wrap
  1758. msgid "B<Built-For-Profiles:>I< profile-list (obsolete)>"
  1759. msgstr ""
  1760. #. type: Plain text
  1761. #: deb-control.man:1
  1762. msgid ""
  1763. "This field used to specify a whitespace separated list of build profiles "
  1764. "that this binary packages was built with (since dpkg 1.17.2 until 1.18.18). "
  1765. "The information previously found in this field can now be found in the "
  1766. "B<.buildinfo> file, which supersedes it."
  1767. msgstr ""
  1768. #. type: TP
  1769. #: deb-control.man:1
  1770. #, no-wrap
  1771. msgid "B<Auto-Built-Package:>I< reason-list>"
  1772. msgstr ""
  1773. #. type: Plain text
  1774. #: deb-control.man:1
  1775. msgid ""
  1776. "This field specifies a whitespace separated list of reasons why this package "
  1777. "was auto-generated. Binary packages marked with this field will not appear "
  1778. "in the I<debian/control> master source control file. The only currently "
  1779. "used reason is B<debug-symbols>."
  1780. msgstr ""
  1781. #. type: SH
  1782. #: deb-control.man:1 deb-conffiles.man:1 deb-src-control.man:1 deb-origin.man:1
  1783. #: start-stop-daemon.man:1
  1784. #, no-wrap
  1785. msgid "EXAMPLE"
  1786. msgstr ""
  1787. #. type: Plain text
  1788. #: deb-control.man:1
  1789. #, no-wrap
  1790. msgid ""
  1791. "# Comment\n"
  1792. "Package: grep\n"
  1793. "Essential: yes\n"
  1794. "Priority: required\n"
  1795. "Section: base\n"
  1796. "Maintainer: Wichert Akkerman E<lt>wakkerma@debian.orgE<gt>\n"
  1797. "Architecture: sparc\n"
  1798. "Version: 2.4-1\n"
  1799. "Pre-Depends: libc6 (E<gt>= 2.0.105)\n"
  1800. "Provides: rgrep\n"
  1801. "Conflicts: rgrep\n"
  1802. "Description: GNU grep, egrep and fgrep.\n"
  1803. " The GNU family of grep utilities may be the \"fastest grep in the west\".\n"
  1804. " GNU grep is based on a fast lazy-state deterministic matcher (about\n"
  1805. " twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper\n"
  1806. " search for a fixed string that eliminates impossible text from being\n"
  1807. " considered by the full regexp matcher without necessarily having to\n"
  1808. " look at every character. The result is typically many times faster\n"
  1809. " than Unix grep or egrep. (Regular expressions containing backreferencing\n"
  1810. " will run more slowly, however).\n"
  1811. msgstr ""
  1812. #. type: Plain text
  1813. #: deb-control.man:1
  1814. msgid "B<deb>(5), B<deb-version>(5), B<debtags>(1), B<dpkg>(1), B<dpkg-deb>(1)."
  1815. msgstr ""
  1816. #. type: TH
  1817. #: deb-conffiles.man:1
  1818. #, no-wrap
  1819. msgid "deb-conffiles"
  1820. msgstr ""
  1821. #. type: Plain text
  1822. #: deb-conffiles.man:1
  1823. msgid "deb-conffiles - package conffiles"
  1824. msgstr ""
  1825. #. type: Plain text
  1826. #: deb-conffiles.man:1
  1827. msgid "conffiles"
  1828. msgstr ""
  1829. #. type: Plain text
  1830. #: deb-conffiles.man:1
  1831. msgid ""
  1832. "A package declares its list of conffiles by including a I<conffiles> file in "
  1833. "its control archive (i.e. I<DEBIAN/conffiles> during package creation)."
  1834. msgstr ""
  1835. #. type: Plain text
  1836. #: deb-conffiles.man:1
  1837. msgid ""
  1838. "This file contains a list of files, one per line. They should be listed as "
  1839. "absolute pathnames, and should exist in the binary package, otherwise "
  1840. "B<dpkg>(1) will ignore them (although by default B<dpkg-deb>(1) will refuse "
  1841. "to build such binary packages). Trailing whitespace will be trimmed, and "
  1842. "empty lines will be ignored."
  1843. msgstr ""
  1844. #. type: Plain text
  1845. #: deb-conffiles.man:1
  1846. #, no-wrap
  1847. msgid ""
  1848. "%CONFDIR%/alternatives/README\n"
  1849. "%CONFDIR%/cron.daily/dpkg\n"
  1850. "%PKGCONFDIR%/dpkg.cfg\n"
  1851. "%CONFDIR%/logrotate.d/dpkg\n"
  1852. msgstr ""
  1853. #. type: Plain text
  1854. #: deb-conffiles.man:1
  1855. msgid "B<dpkg-deb>(1), B<dpkg>(1)."
  1856. msgstr ""
  1857. #. type: TH
  1858. #: deb-src-control.man:1
  1859. #, no-wrap
  1860. msgid "deb-src-control"
  1861. msgstr ""
  1862. #. type: Plain text
  1863. #: deb-src-control.man:1
  1864. msgid "deb-src-control - Debian source packages' master control file format"
  1865. msgstr ""
  1866. #. type: Plain text
  1867. #: deb-src-control.man:1
  1868. msgid "debian/control"
  1869. msgstr ""
  1870. #. type: Plain text
  1871. #: deb-src-control.man:1
  1872. msgid ""
  1873. "Each Debian source package contains the master «control» file, which "
  1874. "contains at least 2 paragraphs, separated by a blank line. The first "
  1875. "paragraph lists all information about the source package in general, while "
  1876. "each following paragraph describes exactly one binary package. Each "
  1877. "paragraph consists of at least one field. A field starts with a fieldname, "
  1878. "such as B<Package> or B<Section> (case insensitive), followed by a colon, "
  1879. "the body of the field and a newline. Multi-line fields are also allowed, "
  1880. "but each supplementary line, without a fieldname, should start with at least "
  1881. "one space. The content of the multi-line fields is generally joined to a "
  1882. "single line by the tools (except in the case of the B<Description> field, "
  1883. "see below). To insert empty lines into a multi-line field, insert a dot "
  1884. "after the space. Lines starting with a ‘B<#>’ are treated as comments."
  1885. msgstr ""
  1886. #. type: SH
  1887. #: deb-src-control.man:1
  1888. #, no-wrap
  1889. msgid "SOURCE FIELDS"
  1890. msgstr ""
  1891. #. type: TP
  1892. #: deb-src-control.man:1
  1893. #, no-wrap
  1894. msgid "B<Source:> I<source-package-name> (required)"
  1895. msgstr ""
  1896. #. type: Plain text
  1897. #: deb-src-control.man:1
  1898. msgid ""
  1899. "The value of this field is the name of the source package, and should match "
  1900. "the name of the source package in the debian/changelog file. A package name "
  1901. "must consist only of lower case letters (a-z), digits (0-9), plus (+) and "
  1902. "minus (-) signs, and periods (.). Package names must be at least two "
  1903. "characters long and must start with an alphanumeric character."
  1904. msgstr ""
  1905. #. type: Plain text
  1906. #: deb-src-control.man:1
  1907. msgid ""
  1908. "Should be in the format «Joe Bloggs E<lt>jbloggs@foo.comE<gt>», and "
  1909. "references the person who currently maintains the package, as opposed to the "
  1910. "author of the software or the original packager."
  1911. msgstr ""
  1912. #. type: TP
  1913. #: deb-src-control.man:1
  1914. #, no-wrap
  1915. msgid "B<Uploaders:>I< fullname-email>"
  1916. msgstr ""
  1917. #. type: Plain text
  1918. #: deb-src-control.man:1 dsc.man:1
  1919. msgid ""
  1920. "Lists all the names and email addresses of co-maintainers of the package, in "
  1921. "the same format as the B<Maintainer> field. Multiple co-maintainers should "
  1922. "be separated by a comma."
  1923. msgstr ""
  1924. #. type: TP
  1925. #: deb-src-control.man:1
  1926. #, no-wrap
  1927. msgid "B<Standards-Version:>I< version-string>"
  1928. msgstr ""
  1929. #. type: Plain text
  1930. #: deb-src-control.man:1 dsc.man:1
  1931. msgid ""
  1932. "This documents the most recent version of the distribution policy standards "
  1933. "this package complies with."
  1934. msgstr ""
  1935. #. type: Plain text
  1936. #: deb-src-control.man:1
  1937. msgid "The upstream project home page URL."
  1938. msgstr ""
  1939. #. type: Plain text
  1940. #: deb-src-control.man:1
  1941. msgid ""
  1942. "The I<url> of the bug tracking system for this package. The current used "
  1943. "format is I<bts-type>B<://>I<bts-address>, like "
  1944. "B<debbugs://bugs.debian.org>. This field is usually not needed."
  1945. msgstr ""
  1946. #. type: TP
  1947. #: deb-src-control.man:1 dsc.man:1
  1948. #, no-wrap
  1949. msgid "B<Vcs-Arch:>I< url>"
  1950. msgstr ""
  1951. #. type: TQ
  1952. #: deb-src-control.man:1 dsc.man:1
  1953. #, no-wrap
  1954. msgid "B<Vcs-Bzr:>I< url>"
  1955. msgstr ""
  1956. #. type: TQ
  1957. #: deb-src-control.man:1 dsc.man:1
  1958. #, no-wrap
  1959. msgid "B<Vcs-Cvs:>I< url>"
  1960. msgstr ""
  1961. #. type: TQ
  1962. #: deb-src-control.man:1 dsc.man:1
  1963. #, no-wrap
  1964. msgid "B<Vcs-Darcs:>I< url>"
  1965. msgstr ""
  1966. #. type: TQ
  1967. #: deb-src-control.man:1 dsc.man:1
  1968. #, no-wrap
  1969. msgid "B<Vcs-Git:>I< url>"
  1970. msgstr ""
  1971. #. type: TQ
  1972. #: deb-src-control.man:1 dsc.man:1
  1973. #, no-wrap
  1974. msgid "B<Vcs-Hg:>I< url>"
  1975. msgstr ""
  1976. #. type: TQ
  1977. #: deb-src-control.man:1 dsc.man:1
  1978. #, no-wrap
  1979. msgid "B<Vcs-Mtn:>I< url>"
  1980. msgstr ""
  1981. #. type: TQ
  1982. #: deb-src-control.man:1 dsc.man:1
  1983. #, no-wrap
  1984. msgid "B<Vcs-Svn:>I< url>"
  1985. msgstr ""
  1986. #. type: Plain text
  1987. #: deb-src-control.man:1
  1988. msgid ""
  1989. "The I<url> of the Version Control System repository used to maintain this "
  1990. "package. Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, "
  1991. "B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> "
  1992. "(Subversion). Usually this field points to the latest version of the "
  1993. "package, such as the main branch or the trunk."
  1994. msgstr ""
  1995. #. type: TP
  1996. #: deb-src-control.man:1 dsc.man:1
  1997. #, no-wrap
  1998. msgid "B<Vcs-Browser:>I< url>"
  1999. msgstr ""
  2000. #. type: Plain text
  2001. #: deb-src-control.man:1
  2002. msgid ""
  2003. "The I<url> of a webinterface to browse the Version Control System "
  2004. "repository."
  2005. msgstr ""
  2006. #. type: Plain text
  2007. #: deb-src-control.man:1
  2008. msgid ""
  2009. "The name of the distribution this package is originating from. This field is "
  2010. "usually not needed."
  2011. msgstr ""
  2012. #. type: TP
  2013. #: deb-src-control.man:1 dsc.man:1
  2014. #, no-wrap
  2015. msgid "B<Build-Depends:>I< package-list>"
  2016. msgstr ""
  2017. #. type: Plain text
  2018. #: deb-src-control.man:1
  2019. msgid ""
  2020. "A list of packages that need to be installed and configured to be able to "
  2021. "build from source package. These dependencies need to be satisfied when "
  2022. "building binary architecture dependent or independent packages and source "
  2023. "packages. Including a dependency in this field does not have the exact same "
  2024. "effect as including it in both B<Build-Depends-Arch> and "
  2025. "B<Build-Depends-Indep>, because the dependency also needs to be satisfied "
  2026. "when building the source package."
  2027. msgstr ""
  2028. #. type: TQ
  2029. #: deb-src-control.man:1 dsc.man:1
  2030. #, no-wrap
  2031. msgid "B<Build-Depends-Arch:>I< package-list>"
  2032. msgstr ""
  2033. #. type: Plain text
  2034. #: deb-src-control.man:1
  2035. msgid ""
  2036. "Same as B<Build-Depends>, but they are only needed when building the "
  2037. "architecture dependent packages. The B<Build-Depends> are also installed in "
  2038. "this case. This field is supported since dpkg 1.16.4; in order to build with "
  2039. "older dpkg versions, B<Build-Depends> should be used instead."
  2040. msgstr ""
  2041. #. type: TQ
  2042. #: deb-src-control.man:1 dsc.man:1
  2043. #, no-wrap
  2044. msgid "B<Build-Depends-Indep:>I< package-list>"
  2045. msgstr ""
  2046. #. type: Plain text
  2047. #: deb-src-control.man:1
  2048. msgid ""
  2049. "Same as B<Build-Depends>, but they are only needed when building the "
  2050. "architecture independent packages. The B<Build-Depends> are also installed "
  2051. "in this case."
  2052. msgstr ""
  2053. #. type: TQ
  2054. #: deb-src-control.man:1 dsc.man:1
  2055. #, no-wrap
  2056. msgid "B<Build-Conflicts:>I< package-list>"
  2057. msgstr ""
  2058. #. type: Plain text
  2059. #: deb-src-control.man:1
  2060. msgid ""
  2061. "A list of packages that should not be installed when the package is built, "
  2062. "for example because they interfere with the build system used. Including a "
  2063. "dependency in this list has the same effect as including it in both "
  2064. "B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional "
  2065. "effect of being used for source-only builds."
  2066. msgstr ""
  2067. #. type: TQ
  2068. #: deb-src-control.man:1 dsc.man:1
  2069. #, no-wrap
  2070. msgid "B<Build-Conflicts-Arch:>I< package-list>"
  2071. msgstr ""
  2072. #. type: Plain text
  2073. #: deb-src-control.man:1
  2074. msgid ""
  2075. "Same as B<Build-Conflicts>, but only when building the architecture "
  2076. "dependent packages. This field is supported since dpkg 1.16.4; in order to "
  2077. "build with older dpkg versions, B<Build-Conflicts> should be used instead."
  2078. msgstr ""
  2079. #. type: TQ
  2080. #: deb-src-control.man:1 dsc.man:1
  2081. #, no-wrap
  2082. msgid "B<Build-Conflicts-Indep:>I< package-list>"
  2083. msgstr ""
  2084. #. type: Plain text
  2085. #: deb-src-control.man:1
  2086. msgid ""
  2087. "Same as B<Build-Conflicts>, but only when building the architecture "
  2088. "independent packages."
  2089. msgstr ""
  2090. #. type: Plain text
  2091. #: deb-src-control.man:1
  2092. msgid ""
  2093. "The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and "
  2094. "B<Build-Depends-Indep> fields is a list of groups of alternative packages. "
  2095. "Each group is a list of packages separated by vertical bar (or “pipe”) "
  2096. "symbols, ‘B<|>’. The groups are separated by commas. Commas are to be read "
  2097. "as “AND”, and pipes as “OR”, with pipes binding more tightly. Each package "
  2098. "name is optionally followed by an architecture qualifier appended after a "
  2099. "colon ‘B<:>’, optionally followed by a version number specification in "
  2100. "parentheses, an architecture specification in square brackets, and a "
  2101. "restriction formula consisting of one or more lists of profile names in "
  2102. "angle brackets."
  2103. msgstr ""
  2104. #. type: Plain text
  2105. #: deb-src-control.man:1
  2106. msgid ""
  2107. "The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and "
  2108. "B<Build-Conflicts-Indep> fields is a list of comma-separated package names, "
  2109. "where the comma is read as an “AND”. Specifying alternative packages using "
  2110. "a “pipe” is not supported. Each package name is optionally followed by a "
  2111. "version number specification in parentheses, an architecture specification "
  2112. "in square brackets, and a restriction formula consisting of one or more "
  2113. "lists of profile names in angle brackets."
  2114. msgstr ""
  2115. #. type: Plain text
  2116. #: deb-src-control.man:1
  2117. msgid ""
  2118. "An architecture qualifier name can be a real Debian architecture name (since "
  2119. "dpkg 1.16.5), B<any> (since dpkg 1.16.2) or B<native> (since dpkg 1.16.5). "
  2120. "If omitted, the default for B<Build-Depends> fields is the current host "
  2121. "architecture, the default for B<Build-Conflicts> fields is B<any>. A real "
  2122. "Debian architecture name will match exactly that architecture for that "
  2123. "package name, B<any> will match any architecture for that package name if "
  2124. "the package is marked with B<Multi-Arch: allowed>, and B<native> will match "
  2125. "the current build architecture if the package is not marked with "
  2126. "B<Multi-Arch: foreign>."
  2127. msgstr ""
  2128. #. type: Plain text
  2129. #: deb-src-control.man:1
  2130. msgid ""
  2131. "An architecture specification consists of one or more architecture names, "
  2132. "separated by whitespace. Exclamation marks may be prepended to each of the "
  2133. "names, meaning “NOT”."
  2134. msgstr ""
  2135. #. type: Plain text
  2136. #: deb-src-control.man:1
  2137. msgid ""
  2138. "A restriction formula consists of one or more restriction lists, separated "
  2139. "by whitespace. Each restriction list is enclosed in angle brackets. Items in "
  2140. "the restriction list are build profile names, separated by whitespace and "
  2141. "can be prefixed with an exclamation mark, meaning “NOT”. A restriction "
  2142. "formula represents a disjunctive normal form expression."
  2143. msgstr ""
  2144. #. type: Plain text
  2145. #: deb-src-control.man:1
  2146. msgid ""
  2147. "Note that dependencies on packages in the B<build-essential> set can be "
  2148. "omitted and that declaring build conflicts against them is impossible. A "
  2149. "list of these packages is in the build-essential package."
  2150. msgstr ""
  2151. #. type: SH
  2152. #: deb-src-control.man:1
  2153. #, no-wrap
  2154. msgid "BINARY FIELDS"
  2155. msgstr ""
  2156. #. type: Plain text
  2157. #: deb-src-control.man:1
  2158. msgid ""
  2159. "Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in "
  2160. "a binary paragraph to override the global value from the source package."
  2161. msgstr ""
  2162. #. type: TP
  2163. #: deb-src-control.man:1
  2164. #, no-wrap
  2165. msgid "B<Package:> I<binary-package-name> (required)"
  2166. msgstr ""
  2167. #. type: Plain text
  2168. #: deb-src-control.man:1
  2169. msgid ""
  2170. "This field is used to name the binary package name. The same restrictions as "
  2171. "to a source package name apply."
  2172. msgstr ""
  2173. #. type: TP
  2174. #: deb-src-control.man:1
  2175. #, no-wrap
  2176. msgid "B<Architecture:> I<arch>|B<all>|B<any> (required)"
  2177. msgstr ""
  2178. #. type: Plain text
  2179. #: deb-src-control.man:1
  2180. msgid ""
  2181. "The architecture specifies on which type of hardware this package runs. For "
  2182. "packages that run on all architectures, use the B<any> value. For packages "
  2183. "that are architecture independent, such as shell and Perl scripts or "
  2184. "documentation, use the B<all> value. To restrict the packages to a certain "
  2185. "set of architectures, specify the architecture names, separated by a "
  2186. "space. It's also possible to put architecture wildcards in that list (see "
  2187. "B<dpkg-architecture>(1) for more information about them)."
  2188. msgstr ""
  2189. #. type: TP
  2190. #: deb-src-control.man:1
  2191. #, no-wrap
  2192. msgid "B<Build-Profiles:> I<restriction-formula>"
  2193. msgstr ""
  2194. #. type: Plain text
  2195. #: deb-src-control.man:1
  2196. msgid ""
  2197. "This field specifies the conditions for which this binary package does or "
  2198. "does not build. To express that condition, the same restriction formula "
  2199. "syntax from the B<Build-Depends> field is used."
  2200. msgstr ""
  2201. #. type: Plain text
  2202. #: deb-src-control.man:1
  2203. msgid ""
  2204. "If a binary package paragraph does not contain this field, then it "
  2205. "implicitly means that it builds with all build profiles (including none at "
  2206. "all)."
  2207. msgstr ""
  2208. #. type: Plain text
  2209. #: deb-src-control.man:1
  2210. msgid ""
  2211. "In other words, if a binary package paragraph is annotated with a non-empty "
  2212. "B<Build-Profiles> field, then this binary package is generated if and only "
  2213. "if the condition expressed by the conjunctive normal form expression "
  2214. "evaluates to true."
  2215. msgstr ""
  2216. #. type: TP
  2217. #: deb-src-control.man:1
  2218. #, no-wrap
  2219. msgid "B<Package-Type:> B<deb>|B<udeb>"
  2220. msgstr ""
  2221. #. type: Plain text
  2222. #: deb-src-control.man:1
  2223. msgid ""
  2224. "This field defines the type of the package. B<udeb> is for size-constrained "
  2225. "packages used by the debian installer. B<deb> is the default value, it is "
  2226. "assumed if the field is absent. More types might be added in the future."
  2227. msgstr ""
  2228. #. type: TQ
  2229. #: deb-src-control.man:1
  2230. #, no-wrap
  2231. msgid "B<Multi-Arch:> B<same>|B<foreign>|B<allowed>|B<no>"
  2232. msgstr ""
  2233. #. type: Plain text
  2234. #: deb-src-control.man:1
  2235. msgid ""
  2236. "These fields are described in the B<deb-control>(5) manual page, as they "
  2237. "are copied literally to the control file of the binary package."
  2238. msgstr ""
  2239. #. type: TQ
  2240. #: deb-src-control.man:1
  2241. #, no-wrap
  2242. msgid "B<Enhances:>I< package-list>"
  2243. msgstr ""
  2244. #. type: Plain text
  2245. #: deb-src-control.man:1
  2246. msgid ""
  2247. "These fields declare relationships between packages. They are discussed in "
  2248. "the B<deb-control>(5) manpage."
  2249. msgstr ""
  2250. #. type: SH
  2251. #: deb-src-control.man:1
  2252. #, no-wrap
  2253. msgid "USER-DEFINED FIELDS"
  2254. msgstr ""
  2255. #. type: Plain text
  2256. #: deb-src-control.man:1
  2257. msgid ""
  2258. "It is allowed to add additional user-defined fields to the control file. The "
  2259. "tools will ignore these fields. If you want the fields to be copied over to "
  2260. "the output files, such as the binary packages, you need to use a custom "
  2261. "naming scheme: the fields should start with an B<X>, followed by zero or "
  2262. "more of the letters B<BCS> and a hyphen."
  2263. msgstr ""
  2264. #. type: TP
  2265. #: deb-src-control.man:1
  2266. #, no-wrap
  2267. msgid "B<B>"
  2268. msgstr ""
  2269. #. type: Plain text
  2270. #: deb-src-control.man:1
  2271. msgid ""
  2272. "The field will appear in the control file in the binary package, see "
  2273. "B<deb-control>(5)."
  2274. msgstr ""
  2275. #. type: TP
  2276. #: deb-src-control.man:1
  2277. #, no-wrap
  2278. msgid "B<S>"
  2279. msgstr ""
  2280. #. type: Plain text
  2281. #: deb-src-control.man:1
  2282. msgid "The field will appear in the source package control file, see B<dsc>(5)."
  2283. msgstr ""
  2284. #. type: TP
  2285. #: deb-src-control.man:1
  2286. #, no-wrap
  2287. msgid "B<C>"
  2288. msgstr ""
  2289. #. type: Plain text
  2290. #: deb-src-control.man:1
  2291. msgid ""
  2292. "The field will appear in the upload control (.changes) file, see "
  2293. "B<deb-changes>(5)."
  2294. msgstr ""
  2295. #. type: Plain text
  2296. #: deb-src-control.man:1
  2297. msgid ""
  2298. "Note that the B<X>[B<BCS>]B<-> prefixes are stripped when the fields are "
  2299. "copied over to the output files. A field B<XC-Approved-By> will appear as "
  2300. "B<Approved-By> in the changes file and will not appear in the binary or "
  2301. "source package control files."
  2302. msgstr ""
  2303. #. type: Plain text
  2304. #: deb-src-control.man:1
  2305. msgid ""
  2306. "Take into account that these user-defined fields will be using the global "
  2307. "namespace, which might at some point in the future collide with officially "
  2308. "recognized fields. To avoid such potential situation you can prefix those "
  2309. "fields with B<Private->, such as B<XB-Private-New-Field>."
  2310. msgstr ""
  2311. #. type: Plain text
  2312. #: deb-src-control.man:1
  2313. #, no-wrap
  2314. msgid ""
  2315. "# Comment\n"
  2316. "Source: dpkg\n"
  2317. "Section: admin\n"
  2318. "Priority: required\n"
  2319. "Maintainer: Dpkg Developers E<lt>debian-dpkg@lists.debian.orgE<gt>\n"
  2320. "# this field is copied to the binary and source packages\n"
  2321. "XBS-Upstream-Release-Status: stable\n"
  2322. "Homepage: https://wiki.debian.org/Teams/Dpkg\n"
  2323. "Vcs-Browser: https://anonscm.debian.org/cgit/dpkg/dpkg.git\n"
  2324. "Vcs-Git: https://anonscm.debian.org/git/dpkg/dpkg.git\n"
  2325. "Standards-Version: 3.7.3\n"
  2326. "Build-Depends: pkg-config, debhelper (E<gt>= 4.1.81),\n"
  2327. " libselinux1-dev (E<gt>= 1.28-4) [!linux-any]\n"
  2328. msgstr ""
  2329. #. type: Plain text
  2330. #: deb-src-control.man:1
  2331. #, no-wrap
  2332. msgid ""
  2333. "Package: dpkg-dev\n"
  2334. "Section: utils\n"
  2335. "Priority: optional\n"
  2336. "Architecture: all\n"
  2337. "# this is a custom field in the binary package\n"
  2338. "XB-Mentoring-Contact: Raphael Hertzog E<lt>hertzog@debian.orgE<gt>\n"
  2339. "Depends: dpkg (E<gt>= 1.14.6), perl5, perl-modules, cpio (E<gt>= 2.4.2-2),\n"
  2340. " bzip2, lzma, patch (E<gt>= 2.2-1), make, binutils, libtimedate-perl\n"
  2341. "Recommends: gcc | c-compiler, build-essential\n"
  2342. "Suggests: gnupg, debian-keyring\n"
  2343. "Conflicts: dpkg-cross (E<lt>E<lt> 2.0.0), devscripts (E<lt>E<lt> 2.10.26)\n"
  2344. "Replaces: manpages-pl (E<lt>= 20051117-1)\n"
  2345. "Description: Debian package development tools\n"
  2346. " This package provides the development tools (including dpkg-source)\n"
  2347. " required to unpack, build and upload Debian source packages.\n"
  2348. " .\n"
  2349. " Most Debian source packages will require additional tools to build;\n"
  2350. " for example, most packages need make and the C compiler gcc.\n"
  2351. msgstr ""
  2352. #. type: Plain text
  2353. #: deb-src-control.man:1
  2354. msgid "B<deb-control>(5), B<deb-version>(5), B<dpkg-source>(1)"
  2355. msgstr ""
  2356. #. type: TH
  2357. #: deb-src-files.man:1
  2358. #, no-wrap
  2359. msgid "deb-src-files"
  2360. msgstr ""
  2361. #. type: Plain text
  2362. #: deb-src-files.man:1
  2363. msgid "deb-src-files - Debian distribute files format"
  2364. msgstr ""
  2365. #. type: Plain text
  2366. #: deb-src-files.man:1
  2367. msgid "debian/files"
  2368. msgstr ""
  2369. #. type: Plain text
  2370. #: deb-src-files.man:1
  2371. msgid ""
  2372. "This file contains the list of artifacts that are to be distributed via the "
  2373. "B<.changes> control file."
  2374. msgstr ""
  2375. #. type: Plain text
  2376. #: deb-src-files.man:1
  2377. msgid "The I<debian/files> file has a simple whitespace-delimited format."
  2378. msgstr ""
  2379. #. type: Plain text
  2380. #: deb-src-files.man:1
  2381. msgid "I<filename> I<section> I<priority>"
  2382. msgstr ""
  2383. #. type: Plain text
  2384. #: deb-src-files.man:1
  2385. msgid "I<filename> is the name of the artifact to distribute."
  2386. msgstr ""
  2387. #. type: Plain text
  2388. #: deb-src-files.man:1
  2389. msgid ""
  2390. "I<section> and I<priority> correspond to the respective control fields "
  2391. "available in the .deb. The allowed values are specific to each distribution "
  2392. "archive."
  2393. msgstr ""
  2394. #. type: SH
  2395. #: deb-src-files.man:1 deb-version.man:1 dpkg-architecture.man:1
  2396. #: dpkg-buildpackage.man:1 dpkg-deb.man:1 dpkg-divert.man:1
  2397. #: dpkg-parsechangelog.man:1
  2398. #, no-wrap
  2399. msgid "NOTES"
  2400. msgstr ""
  2401. #. type: Plain text
  2402. #: deb-src-files.man:1
  2403. msgid ""
  2404. "This file is not intended to be modified directly, please use one of "
  2405. "B<dpkg-gencontrol> or B<dpkg-distaddfile> to add entries to it."
  2406. msgstr ""
  2407. #. type: Plain text
  2408. #: deb-src-files.man:1
  2409. msgid "B<dpkg-genchanges>(1), B<dpkg-distaddfile>(1)."
  2410. msgstr ""
  2411. #. type: TH
  2412. #: deb-split.man:1
  2413. #, no-wrap
  2414. msgid "deb-split"
  2415. msgstr ""
  2416. #. type: Plain text
  2417. #: deb-split.man:1
  2418. msgid "deb-split - Debian multi-part binary package format"
  2419. msgstr ""
  2420. #. type: Plain text
  2421. #: deb-split.man:1
  2422. msgid ""
  2423. "The multi-part B<.deb> format is used to split big packages into smaller "
  2424. "pieces to ease transport in small media."
  2425. msgstr ""
  2426. #. type: Plain text
  2427. #: deb-split.man:1
  2428. msgid ""
  2429. "The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>. The "
  2430. "file names might contain a trailing slash (since dpkg 1.15.6)."
  2431. msgstr ""
  2432. #. type: Plain text
  2433. #: deb-split.man:1
  2434. msgid ""
  2435. "The first member is named B<debian-split> and contains a series of lines, "
  2436. "separated by newlines. Currently eight lines are present:"
  2437. msgstr ""
  2438. #. type: IP
  2439. #: deb-split.man:1 deb-split.man:1 deb-split.man:1 deb-split.man:1
  2440. #: deb-split.man:1 deb-split.man:1 deb-split.man:1 deb-split.man:1
  2441. #: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
  2442. #: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
  2443. #: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
  2444. #, no-wrap
  2445. msgid "•"
  2446. msgstr ""
  2447. #. type: Plain text
  2448. #: deb-split.man:1
  2449. msgid "The format version number, B<2.1> at the time this manual page was written."
  2450. msgstr ""
  2451. #. type: Plain text
  2452. #: deb-split.man:1
  2453. msgid "The package name."
  2454. msgstr ""
  2455. #. type: Plain text
  2456. #: deb-split.man:1
  2457. msgid "The package version."
  2458. msgstr ""
  2459. #. type: Plain text
  2460. #: deb-split.man:1
  2461. msgid "The md5sum of the package."
  2462. msgstr ""
  2463. #. type: Plain text
  2464. #: deb-split.man:1
  2465. msgid "The total size of the package."
  2466. msgstr ""
  2467. #. type: Plain text
  2468. #: deb-split.man:1
  2469. msgid "The maximum part size."
  2470. msgstr ""
  2471. #. type: Plain text
  2472. #: deb-split.man:1
  2473. msgid ""
  2474. "The current part number, followed by a slash and the total amount of parts "
  2475. "(as in ‘1/10’)."
  2476. msgstr ""
  2477. #. type: Plain text
  2478. #: deb-split.man:1
  2479. msgid "The package architecture (since dpkg 1.16.1)."
  2480. msgstr ""
  2481. #. type: Plain text
  2482. #: deb-split.man:1
  2483. msgid ""
  2484. "Programs which read multi-part archives should be prepared for the minor "
  2485. "format version number to be increased and additional lines to be present, "
  2486. "and should ignore these if this is the case."
  2487. msgstr ""
  2488. #. type: Plain text
  2489. #: deb-split.man:1
  2490. msgid ""
  2491. "If the major format version number has changed, an incompatible change has "
  2492. "been made and the program should stop. If it has not, then the program "
  2493. "should be able to safely continue, unless it encounters an unexpected member "
  2494. "in the archive (except at the end), as described below."
  2495. msgstr ""
  2496. #. type: Plain text
  2497. #: deb-split.man:1
  2498. msgid ""
  2499. "The second, last required member is named B<data.>I<N>, where I<N> denotes "
  2500. "the part number. It contains the raw part data."
  2501. msgstr ""
  2502. #. type: Plain text
  2503. #: deb-split.man:1
  2504. msgid ""
  2505. "These members must occur in this exact order. Current implementations should "
  2506. "ignore any additional members after B<data.>I<N>. Further members may be "
  2507. "defined in the future, and (if possible) will be placed after these two."
  2508. msgstr ""
  2509. #. type: Plain text
  2510. #: deb-split.man:1
  2511. msgid "B<deb>(5), B<dpkg-split>(1)."
  2512. msgstr ""
  2513. #. type: TH
  2514. #: deb-version.man:1
  2515. #, no-wrap
  2516. msgid "deb-version"
  2517. msgstr ""
  2518. #. type: Plain text
  2519. #: deb-version.man:1
  2520. msgid "deb-version - Debian package version number format"
  2521. msgstr ""
  2522. #. type: Plain text
  2523. #: deb-version.man:1
  2524. msgid "[I<epoch>B<:>]I<upstream-version>[B<->I<debian-revision>]"
  2525. msgstr ""
  2526. #. type: Plain text
  2527. #: deb-version.man:1
  2528. msgid ""
  2529. "Version numbers as used for Debian binary and source packages consist of "
  2530. "three components. These are:"
  2531. msgstr ""
  2532. #. type: TP
  2533. #: deb-version.man:1
  2534. #, no-wrap
  2535. msgid "I<epoch>"
  2536. msgstr ""
  2537. #. type: Plain text
  2538. #: deb-version.man:1
  2539. msgid ""
  2540. "This is a single (generally small) unsigned integer. It may be omitted, in "
  2541. "which case zero is assumed. If it is omitted then the I<upstream-version> "
  2542. "may not contain any colons."
  2543. msgstr ""
  2544. #. type: Plain text
  2545. #: deb-version.man:1
  2546. msgid ""
  2547. "It is provided to allow mistakes in the version numbers of older versions of "
  2548. "a package, and also a package's previous version numbering schemes, to be "
  2549. "left behind."
  2550. msgstr ""
  2551. #. type: TP
  2552. #: deb-version.man:1
  2553. #, no-wrap
  2554. msgid "I<upstream-version>"
  2555. msgstr ""
  2556. #. type: Plain text
  2557. #: deb-version.man:1
  2558. msgid ""
  2559. "This is the main part of the version number. It is usually the version "
  2560. "number of the original (“upstream”) package from which the I<.deb> file has "
  2561. "been made, if this is applicable. Usually this will be in the same format "
  2562. "as that specified by the upstream author(s); however, it may need to be "
  2563. "reformatted to fit into the package management system's format and "
  2564. "comparison scheme."
  2565. msgstr ""
  2566. #. type: Plain text
  2567. #: deb-version.man:1
  2568. msgid ""
  2569. "The comparison behavior of the package management system with respect to the "
  2570. "I<upstream-version> is described below. The I<upstream-version> portion of "
  2571. "the version number is mandatory."
  2572. msgstr ""
  2573. #. type: Plain text
  2574. #: deb-version.man:1
  2575. msgid ""
  2576. "The I<upstream-version> may contain only alphanumerics (“A-Za-z0-9”) and the "
  2577. "characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) "
  2578. "and should start with a digit. If there is no I<debian-revision> then "
  2579. "hyphens are not allowed; if there is no I<epoch> then colons are not "
  2580. "allowed."
  2581. msgstr ""
  2582. #. type: TP
  2583. #: deb-version.man:1
  2584. #, no-wrap
  2585. msgid "I<debian-revision>"
  2586. msgstr ""
  2587. #. type: Plain text
  2588. #: deb-version.man:1
  2589. msgid ""
  2590. "This part of the version number specifies the version of the Debian package "
  2591. "based on the upstream version. It may contain only alphanumerics and the "
  2592. "characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the "
  2593. "same way as the I<upstream-version> is."
  2594. msgstr ""
  2595. #. type: Plain text
  2596. #: deb-version.man:1
  2597. msgid ""
  2598. "It is optional; if it isn't present then the I<upstream-version> may not "
  2599. "contain a hyphen. This format represents the case where a piece of software "
  2600. "was written specifically to be turned into a Debian package, and so there is "
  2601. "only one “debianisation” of it and therefore no revision indication is "
  2602. "required."
  2603. msgstr ""
  2604. #. type: Plain text
  2605. #: deb-version.man:1
  2606. msgid ""
  2607. "It is conventional to restart the I<debian-revision> at ‘1’ each time the "
  2608. "I<upstream-version> is increased."
  2609. msgstr ""
  2610. #. type: Plain text
  2611. #: deb-version.man:1
  2612. msgid ""
  2613. "Dpkg will break the version number apart at the last hyphen in the string "
  2614. "(if there is one) to determine the I<upstream-version> and "
  2615. "I<debian-revision>. The absence of a I<debian-revision> compares earlier "
  2616. "than the presence of one (but note that the I<debian-revision> is the least "
  2617. "significant part of the version number)."
  2618. msgstr ""
  2619. #. type: SS
  2620. #: deb-version.man:1
  2621. #, no-wrap
  2622. msgid "Sorting algorithm"
  2623. msgstr ""
  2624. #. type: Plain text
  2625. #: deb-version.man:1
  2626. msgid ""
  2627. "The I<upstream-version> and I<debian-revision> parts are compared by the "
  2628. "package management system using the same algorithm:"
  2629. msgstr ""
  2630. #. type: Plain text
  2631. #: deb-version.man:1
  2632. msgid "The strings are compared from left to right."
  2633. msgstr ""
  2634. #. type: Plain text
  2635. #: deb-version.man:1
  2636. msgid ""
  2637. "First the initial part of each string consisting entirely of non-digit "
  2638. "characters is determined. These two parts (one of which may be empty) are "
  2639. "compared lexically. If a difference is found it is returned. The lexical "
  2640. "comparison is a comparison of ASCII values modified so that all the letters "
  2641. "sort earlier than all the non-letters and so that a tilde sorts before "
  2642. "anything, even the end of a part. For example, the following parts are in "
  2643. "sorted order: ‘~~’, ‘~~a’, ‘~’, the empty part, ‘a’."
  2644. msgstr ""
  2645. #. type: Plain text
  2646. #: deb-version.man:1
  2647. msgid ""
  2648. "Then the initial part of the remainder of each string which consists "
  2649. "entirely of digit characters is determined. The numerical values of these "
  2650. "two parts are compared, and any difference found is returned as the result "
  2651. "of the comparison. For these purposes an empty string (which can only occur "
  2652. "at the end of one or both version strings being compared) counts as zero."
  2653. msgstr ""
  2654. #. type: Plain text
  2655. #: deb-version.man:1
  2656. msgid ""
  2657. "These two steps (comparing and removing initial non-digit strings and "
  2658. "initial digit strings) are repeated until a difference is found or both "
  2659. "strings are exhausted."
  2660. msgstr ""
  2661. #. type: Plain text
  2662. #: deb-version.man:1
  2663. msgid ""
  2664. "Note that the purpose of epochs is to allow us to leave behind mistakes in "
  2665. "version numbering, and to cope with situations where the version numbering "
  2666. "scheme changes. It is B<not> intended to cope with version numbers "
  2667. "containing strings of letters which the package management system cannot "
  2668. "interpret (such as ‘ALPHA’ or ‘pre-’), or with silly orderings."
  2669. msgstr ""
  2670. #. type: Plain text
  2671. #: deb-version.man:1
  2672. msgid ""
  2673. "The tilde character and its special sorting properties were introduced in "
  2674. "dpkg 1.10 and some parts of the dpkg build scripts only gained support for "
  2675. "it later in the 1.10.x series."
  2676. msgstr ""
  2677. #. type: Plain text
  2678. #: deb-version.man:1
  2679. msgid "B<deb-control>(5), B<deb>(5), B<dpkg>(1)"
  2680. msgstr ""
  2681. #. type: TH
  2682. #: deb-old.man:1
  2683. #, no-wrap
  2684. msgid "deb-old"
  2685. msgstr ""
  2686. #. type: Plain text
  2687. #: deb-old.man:1
  2688. msgid "deb-old - old style Debian binary package format"
  2689. msgstr ""
  2690. #. type: Plain text
  2691. #: deb-old.man:1
  2692. msgid ""
  2693. "The B<.deb> format is the Debian binary package file format. This manual "
  2694. "page describes the B<old> format, used before Debian 0.93. Please see "
  2695. "B<deb>(5) for details of the new format."
  2696. msgstr ""
  2697. #. type: Plain text
  2698. #: deb-old.man:1
  2699. msgid ""
  2700. "The file is two lines of format information as ASCII text, followed by two "
  2701. "concatenated gzipped ustar files."
  2702. msgstr ""
  2703. #. type: Plain text
  2704. #: deb-old.man:1
  2705. msgid ""
  2706. "The first line is the format version number padded to 8 digits, and is "
  2707. "B<0.939000> for all old-format archives."
  2708. msgstr ""
  2709. #. type: Plain text
  2710. #: deb-old.man:1
  2711. msgid ""
  2712. "The second line is a decimal string (without leading zeroes) giving the "
  2713. "length of the first gzipped tarfile."
  2714. msgstr ""
  2715. #. type: Plain text
  2716. #: deb-old.man:1
  2717. msgid "Each of these lines is terminated with a single newline character."
  2718. msgstr ""
  2719. #. type: Plain text
  2720. #: deb-old.man:1
  2721. msgid ""
  2722. "The first tarfile contains the control information, as a series of ordinary "
  2723. "files. The file B<control> must be present, as it contains the core control "
  2724. "information."
  2725. msgstr ""
  2726. #. type: Plain text
  2727. #: deb-old.man:1
  2728. msgid ""
  2729. "In some very old archives, the files in the control tarfile may optionally "
  2730. "be in a B<DEBIAN> subdirectory. In that case, the B<DEBIAN> subdirectory "
  2731. "will be in the control tarfile too, and the control tarfile will have only "
  2732. "files in that directory. Optionally the control tarfile may contain an entry "
  2733. "for ‘B<.>’, that is, the current directory."
  2734. msgstr ""
  2735. #. type: Plain text
  2736. #: deb-old.man:1
  2737. msgid ""
  2738. "The second gzipped tarfile is the filesystem archive, containing pathnames "
  2739. "relative to the root directory of the system to be installed on. The "
  2740. "pathnames do not have leading slashes."
  2741. msgstr ""
  2742. #. type: Plain text
  2743. #: deb-old.man:1
  2744. msgid "B<deb>(5), B<dpkg-deb>(1), B<deb-control>(5)."
  2745. msgstr ""
  2746. #. type: TH
  2747. #: deb-origin.man:1
  2748. #, no-wrap
  2749. msgid "deb-origin"
  2750. msgstr ""
  2751. #. type: Plain text
  2752. #: deb-origin.man:1
  2753. msgid "deb-origin - Vendor-specific information files"
  2754. msgstr ""
  2755. #. type: Plain text
  2756. #: deb-origin.man:1
  2757. msgid "B<%PKGCONFDIR%/origins/>I<filename>"
  2758. msgstr ""
  2759. #. type: Plain text
  2760. #: deb-origin.man:1
  2761. msgid ""
  2762. "The files in B<%PKGCONFDIR%/origins> can provide information about various "
  2763. "vendors who are providing Debian packages."
  2764. msgstr ""
  2765. #. type: Plain text
  2766. #: deb-origin.man:1
  2767. msgid ""
  2768. "They contain a number of fields, or comments when the line starts with "
  2769. "‘B<#>’. Each field begins with a tag, such as B<Vendor> or B<Parent>, "
  2770. "followed by a colon and the body of the field. Fields are delimited only by "
  2771. "field tags. In other words, field text may be multiple lines in length, but "
  2772. "the tools will join lines when processing the body of the field."
  2773. msgstr ""
  2774. #. type: Plain text
  2775. #: deb-origin.man:1
  2776. msgid ""
  2777. "The file should be named according to the vendor name. The usual convention "
  2778. "is to name the vendor file using the vendor name in all lowercase, but some "
  2779. "variation is permitted. Namely, spaces are mapped to dashes (‘B<->’), and "
  2780. "the file can have the same casing as the value in B<Vendor> field, or it can "
  2781. "be capitalized."
  2782. msgstr ""
  2783. #. type: TP
  2784. #: deb-origin.man:1
  2785. #, no-wrap
  2786. msgid "B<Vendor:> I<vendor-name> (required)"
  2787. msgstr ""
  2788. #. type: Plain text
  2789. #: deb-origin.man:1
  2790. msgid "The value of this field determines the vendor name."
  2791. msgstr ""
  2792. #. type: TP
  2793. #: deb-origin.man:1
  2794. #, no-wrap
  2795. msgid "B<Vendor-URL:>I< vendor-url>"
  2796. msgstr ""
  2797. #. type: Plain text
  2798. #: deb-origin.man:1
  2799. msgid "The value of this field determines the vendor URL."
  2800. msgstr ""
  2801. #. type: TP
  2802. #: deb-origin.man:1
  2803. #, no-wrap
  2804. msgid "B<Bugs:>I< bug-url>"
  2805. msgstr ""
  2806. #. type: Plain text
  2807. #: deb-origin.man:1
  2808. msgid ""
  2809. "The value of this field determines the type and address of the bug tracking "
  2810. "system used by this vendor. It can be a mailto URL or a debbugs URL (e.g., "
  2811. "debbugs://bugs.debian.org/)."
  2812. msgstr ""
  2813. #. type: TP
  2814. #: deb-origin.man:1
  2815. #, no-wrap
  2816. msgid "B<Parent:>I< vendor-name>"
  2817. msgstr ""
  2818. #. type: Plain text
  2819. #: deb-origin.man:1
  2820. msgid ""
  2821. "The value of this field determines the vendor name of the vendor that this "
  2822. "vendor derives from."
  2823. msgstr ""
  2824. #. type: Plain text
  2825. #: deb-origin.man:1
  2826. #, no-wrap
  2827. msgid ""
  2828. "Vendor: Debian\n"
  2829. "Vendor-URL: https://www.debian.org/\n"
  2830. "Bugs: debbugs://bugs.debian.org\n"
  2831. msgstr ""
  2832. #. type: Plain text
  2833. #: deb-origin.man:1
  2834. msgid "B<dpkg-vendor>(1)"
  2835. msgstr ""
  2836. #. type: TH
  2837. #: deb-override.man:1
  2838. #, no-wrap
  2839. msgid "deb-override"
  2840. msgstr ""
  2841. #. type: Plain text
  2842. #: deb-override.man:1
  2843. msgid "deb-override - Debian archive override file"
  2844. msgstr ""
  2845. #. type: Plain text
  2846. #: deb-override.man:1 deb-extra-override.man:1
  2847. msgid "override"
  2848. msgstr ""
  2849. #. type: Plain text
  2850. #: deb-override.man:1
  2851. msgid ""
  2852. "While most information about a package can be found in the control file, "
  2853. "some is managed centrally by the distribution czars rather than by the "
  2854. "maintainer in order to offer some global consistency. This information is "
  2855. "found in the override file."
  2856. msgstr ""
  2857. #. type: Plain text
  2858. #: deb-override.man:1
  2859. msgid ""
  2860. "The override file has a simple whitespace-delimited format. Comments are "
  2861. "allowed (denoted with a B<#>)."
  2862. msgstr ""
  2863. #. type: Plain text
  2864. #: deb-override.man:1
  2865. msgid "I<package> I<priority> I<section> [I<maintainerinfo>]"
  2866. msgstr ""
  2867. #. type: Plain text
  2868. #: deb-override.man:1
  2869. msgid ""
  2870. "I<package> is the name of the package. Entries in the override file for "
  2871. "packages not found in the tree of binary packages are ignored."
  2872. msgstr ""
  2873. #. type: Plain text
  2874. #: deb-override.man:1
  2875. msgid ""
  2876. "I<priority> and I<section> correspond to the respective control fields "
  2877. "available in the .deb. The allowed values are specific to each distribution "
  2878. "archive."
  2879. msgstr ""
  2880. #. type: Plain text
  2881. #: deb-override.man:1
  2882. msgid ""
  2883. "I<maintainerinfo>, if present, can be either the name of a maintainer for an "
  2884. "unconditional override, or else I<oldmaintainer> B<=E<gt>> I<newmaintainer> "
  2885. "to perform a substitution."
  2886. msgstr ""
  2887. #. type: Plain text
  2888. #: deb-override.man:1
  2889. msgid ""
  2890. "The override files used to make the official Packages lists may be found in "
  2891. "the I<indices> directory on any Debian mirror."
  2892. msgstr ""
  2893. #. type: Plain text
  2894. #: deb-override.man:1 deb-extra-override.man:1
  2895. msgid "B<dpkg-scanpackages>(1), B<dpkg-scansources>(1), B<apt-ftparchive>(1)."
  2896. msgstr ""
  2897. #. type: TH
  2898. #: deb-extra-override.man:1
  2899. #, no-wrap
  2900. msgid "deb-extra-override"
  2901. msgstr ""
  2902. #. type: Plain text
  2903. #: deb-extra-override.man:1
  2904. msgid "deb-extra-override - Debian archive extra override file"
  2905. msgstr ""
  2906. #. type: Plain text
  2907. #: deb-extra-override.man:1
  2908. msgid ""
  2909. "While most information about a binary/source package can be found in the "
  2910. "control/.dsc file, all of it can be overridden when it's exported to "
  2911. "Packages/Sources files. The extra override file contains those overrides."
  2912. msgstr ""
  2913. #. type: Plain text
  2914. #: deb-extra-override.man:1
  2915. msgid ""
  2916. "The extra override file has a simple whitespace-delimited format. Comments "
  2917. "are allowed (denoted with a B<#>)."
  2918. msgstr ""
  2919. #. type: Plain text
  2920. #: deb-extra-override.man:1
  2921. msgid "I<package> I<field-name> I<value>"
  2922. msgstr ""
  2923. #. type: Plain text
  2924. #: deb-extra-override.man:1
  2925. msgid "I<package> is the name of the binary/source package."
  2926. msgstr ""
  2927. #. type: Plain text
  2928. #: deb-extra-override.man:1
  2929. msgid ""
  2930. "I<field-name> is the name of the field that is overridden. I<value> is the "
  2931. "value to put in the field. It can contain spaces as the line is split in no "
  2932. "more than 3 columns when it's parsed."
  2933. msgstr ""
  2934. #. type: Plain text
  2935. #: deb-extra-override.man:1
  2936. msgid ""
  2937. "The extra override files used to make the official Packages lists may be "
  2938. "found in the I<indices> directory on any Debian mirror."
  2939. msgstr ""
  2940. #. type: TH
  2941. #: deb-shlibs.man:1
  2942. #, no-wrap
  2943. msgid "deb-shlibs"
  2944. msgstr ""
  2945. #. type: Plain text
  2946. #: deb-shlibs.man:1
  2947. msgid "deb-shlibs - Debian shared library information file"
  2948. msgstr ""
  2949. #. type: Plain text
  2950. #: deb-shlibs.man:1
  2951. msgid ""
  2952. "B<shlibs> files map shared library names and versions (I<sonames>) to "
  2953. "dependencies suitable for a package control file. There is one entry per "
  2954. "line. Blank lines are B<not> allowed. Lines beginning with an B<#> "
  2955. "character are considered commentary, and are ignored. All other lines must "
  2956. "have the format"
  2957. msgstr ""
  2958. #. type: Plain text
  2959. #: deb-shlibs.man:1
  2960. msgid "[I<type>B<:>] I<library> I<version> I<dependencies>"
  2961. msgstr ""
  2962. #. type: Plain text
  2963. #: deb-shlibs.man:1
  2964. msgid ""
  2965. "The I<library> and I<version> fields are whitespace-delimited, but the "
  2966. "I<dependencies> field extends to the end of the line. The I<type> field is "
  2967. "optional and normally not needed."
  2968. msgstr ""
  2969. #. type: Plain text
  2970. #: deb-shlibs.man:1
  2971. msgid ""
  2972. "The I<dependencies> field has the same syntax as the B<Depends> field in a "
  2973. "binary control file, see B<deb-control>(5)."
  2974. msgstr ""
  2975. #. type: Plain text
  2976. #: deb-shlibs.man:1
  2977. msgid ""
  2978. "The B<shlibs> file for a typical library package, named I<libcrunch1>, that "
  2979. "provides one library whose soname is I<libcrunch.so.1>, might read"
  2980. msgstr ""
  2981. #. type: Plain text
  2982. #: deb-shlibs.man:1
  2983. msgid "libcrunch 1 libcrunch1 (E<gt>= 1.2-1)"
  2984. msgstr ""
  2985. #. type: Plain text
  2986. #: deb-shlibs.man:1
  2987. msgid ""
  2988. "The I<dependencies> must mention the most recent version of the package that "
  2989. "added new symbols to the library: in the above example, new symbols were "
  2990. "added to version 1.2 of I<libcrunch>. This is not the only reason the "
  2991. "dependencies might need to be tightened."
  2992. msgstr ""
  2993. #. type: Plain text
  2994. #: deb-shlibs.man:1
  2995. msgid "B<deb-control>(5), B<dpkg-shlibdeps>(1), B<deb-symbols>(5)."
  2996. msgstr ""
  2997. #. type: TH
  2998. #: deb-substvars.man:1
  2999. #, no-wrap
  3000. msgid "deb-substvars"
  3001. msgstr ""
  3002. #. type: Plain text
  3003. #: deb-substvars.man:1
  3004. msgid "deb-substvars - Debian source substitution variables"
  3005. msgstr ""
  3006. #. type: Plain text
  3007. #: deb-substvars.man:1
  3008. msgid "substvars"
  3009. msgstr ""
  3010. #. type: Plain text
  3011. #: deb-substvars.man:1
  3012. msgid ""
  3013. "Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their "
  3014. "control information (to the source control file B<.dsc> for B<dpkg-source> "
  3015. "and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>) they "
  3016. "perform some variable substitutions on the output file."
  3017. msgstr ""
  3018. #. type: Plain text
  3019. #: deb-substvars.man:1
  3020. msgid ""
  3021. "A variable substitution has the form B<${>I<variable-name>B<}>. Variable "
  3022. "names consist of alphanumerics, hyphens and colons and start with an "
  3023. "alphanumeric. Variable substitutions are performed repeatedly until none are "
  3024. "left; the full text of the field after the substitution is rescanned to look "
  3025. "for more substitutions."
  3026. msgstr ""
  3027. #. type: Plain text
  3028. #: deb-substvars.man:1
  3029. msgid ""
  3030. "After all the substitutions have been done each occurrence of the string "
  3031. "B<${}> (which is not a legal substitution) is replaced with a B<$> sign."
  3032. msgstr ""
  3033. #. type: Plain text
  3034. #: deb-substvars.man:1
  3035. msgid ""
  3036. "While variable substitution is done on all control fields, some of those "
  3037. "fields are used and needed during the build when the substitution did not "
  3038. "yet occur. That's why you can't use variables in the B<Package>, B<Source> "
  3039. "and B<Architecture> fields."
  3040. msgstr ""
  3041. #. type: Plain text
  3042. #: deb-substvars.man:1
  3043. msgid ""
  3044. "Variable substitution happens on the content of the fields after they have "
  3045. "been parsed, thus if you want a variable to expand over multiple lines you "
  3046. "do not have to include a space after the newline. This is done implicitly "
  3047. "when the field is output. For example, if the variable B<${Description}> is "
  3048. "set to \"foo is bar.${Newline}foo is great.\" and if you have the following "
  3049. "field:"
  3050. msgstr ""
  3051. #. type: Plain text
  3052. #: deb-substvars.man:1
  3053. #, no-wrap
  3054. msgid ""
  3055. " Description: foo application\n"
  3056. " ${Description}\n"
  3057. " .\n"
  3058. " More text.\n"
  3059. msgstr ""
  3060. #. type: Plain text
  3061. #: deb-substvars.man:1
  3062. msgid "It will result in:"
  3063. msgstr ""
  3064. #. type: Plain text
  3065. #: deb-substvars.man:1
  3066. #, no-wrap
  3067. msgid ""
  3068. " Description: foo application\n"
  3069. " foo is bar.\n"
  3070. " foo is great.\n"
  3071. " .\n"
  3072. " More text.\n"
  3073. msgstr ""
  3074. #. type: Plain text
  3075. #: deb-substvars.man:1
  3076. msgid ""
  3077. "Variables can be set using the B<-V> common option. They can be also "
  3078. "specified in the file B<debian/substvars> (or whatever other file is "
  3079. "specified using the B<-T> option). This file consists of lines of the form "
  3080. "I<name>B<=>I<value>. Trailing whitespace on each line, blank lines, and "
  3081. "lines starting with a B<#> symbol (comments) are ignored."
  3082. msgstr ""
  3083. #. type: Plain text
  3084. #: deb-substvars.man:1
  3085. msgid "Additionally, the following standard variables are available:"
  3086. msgstr ""
  3087. #. type: TP
  3088. #: deb-substvars.man:1
  3089. #, no-wrap
  3090. msgid "B<Arch>"
  3091. msgstr ""
  3092. #. type: Plain text
  3093. #: deb-substvars.man:1
  3094. msgid ""
  3095. "The current host architecture (i.e. the architecture the package is being "
  3096. "built for, the equivalent of B<DEB_HOST_ARCH>)."
  3097. msgstr ""
  3098. #. type: TP
  3099. #: deb-substvars.man:1 dpkg-query.man:1
  3100. #, no-wrap
  3101. msgid "B<source:Version>"
  3102. msgstr ""
  3103. #. type: Plain text
  3104. #: deb-substvars.man:1
  3105. msgid "The source package version (since dpkg 1.13.19)."
  3106. msgstr ""
  3107. #. type: TP
  3108. #: deb-substvars.man:1 dpkg-query.man:1
  3109. #, no-wrap
  3110. msgid "B<source:Upstream-Version>"
  3111. msgstr ""
  3112. #. type: Plain text
  3113. #: deb-substvars.man:1
  3114. msgid ""
  3115. "The upstream source package version, including the Debian version epoch if "
  3116. "any (since dpkg 1.13.19)."
  3117. msgstr ""
  3118. #. type: TP
  3119. #: deb-substvars.man:1
  3120. #, no-wrap
  3121. msgid "B<binary:Version>"
  3122. msgstr ""
  3123. #. type: Plain text
  3124. #: deb-substvars.man:1
  3125. msgid ""
  3126. "The binary package version (which may differ from source:Version in a binNMU "
  3127. "for example; since dpkg 1.13.19)."
  3128. msgstr ""
  3129. #. type: TP
  3130. #: deb-substvars.man:1
  3131. #, no-wrap
  3132. msgid "B<Source-Version>"
  3133. msgstr ""
  3134. #. type: Plain text
  3135. #: deb-substvars.man:1
  3136. msgid ""
  3137. "The source package version (from the changelog file). This variable is now "
  3138. "B<obsolete> and emits an error when used as its meaning is different from "
  3139. "its function, please use the B<source:Version> or B<binary:Version> as "
  3140. "appropriate."
  3141. msgstr ""
  3142. #. type: TP
  3143. #: deb-substvars.man:1
  3144. #, no-wrap
  3145. msgid "B<Installed-Size>"
  3146. msgstr ""
  3147. #. type: Plain text
  3148. #: deb-substvars.man:1
  3149. msgid ""
  3150. "The approximate total size of the package's installed files. This value is "
  3151. "copied into the corresponding control file field; setting it will modify the "
  3152. "value of that field. If this variable is not set B<dpkg-gencontrol> will "
  3153. "compute the default value by accumulating the size of each regular file and "
  3154. "symlink rounded to 1 KiB used units, and a baseline of 1 KiB for any other "
  3155. "filesystem object type."
  3156. msgstr ""
  3157. #. type: Plain text
  3158. #: deb-substvars.man:1
  3159. msgid ""
  3160. "B<Note:> Take into account that this can only ever be an approximation, as "
  3161. "the actual size used on the installed system will depend greatly on the "
  3162. "filesystem used and its parameters, which might end up using either more or "
  3163. "less space than the specified in this field."
  3164. msgstr ""
  3165. #. type: TP
  3166. #: deb-substvars.man:1
  3167. #, no-wrap
  3168. msgid "B<Extra-Size>"
  3169. msgstr ""
  3170. #. type: Plain text
  3171. #: deb-substvars.man:1
  3172. msgid ""
  3173. "Additional disk space used when the package is installed. If this variable "
  3174. "is set its value is added to that of the B<Installed-Size> variable (whether "
  3175. "set explicitly or using the default value) before it is copied into the "
  3176. "B<Installed-Size> control file field."
  3177. msgstr ""
  3178. #. type: TP
  3179. #: deb-substvars.man:1
  3180. #, no-wrap
  3181. msgid "B<S:>I<fieldname>"
  3182. msgstr ""
  3183. #. type: Plain text
  3184. #: deb-substvars.man:1
  3185. msgid ""
  3186. "The value of the source stanza field I<fieldname> (which must be given in "
  3187. "the canonical capitalisation; since dpkg 1.18.11). Setting these variables "
  3188. "has no effect other than on places where they are expanded explicitly. "
  3189. "These variables are only available when generating binary control files."
  3190. msgstr ""
  3191. #. type: TP
  3192. #: deb-substvars.man:1
  3193. #, no-wrap
  3194. msgid "B<F:>I<fieldname>"
  3195. msgstr ""
  3196. #. type: Plain text
  3197. #: deb-substvars.man:1
  3198. msgid ""
  3199. "The value of the output field I<fieldname> (which must be given in the "
  3200. "canonical capitalisation). Setting these variables has no effect other than "
  3201. "on places where they are expanded explicitly."
  3202. msgstr ""
  3203. #. type: TP
  3204. #: deb-substvars.man:1
  3205. #, no-wrap
  3206. msgid "B<Format>"
  3207. msgstr ""
  3208. #. type: Plain text
  3209. #: deb-substvars.man:1
  3210. msgid ""
  3211. "The B<.changes> file format version generated by this version of the source "
  3212. "packaging scripts. If you set this variable the contents of the B<Format> "
  3213. "field in the B<.changes> file will change too."
  3214. msgstr ""
  3215. #. type: TP
  3216. #: deb-substvars.man:1
  3217. #, no-wrap
  3218. msgid "B<Newline>, B<Space>, B<Tab>"
  3219. msgstr ""
  3220. #. type: Plain text
  3221. #: deb-substvars.man:1
  3222. msgid "These variables each hold the corresponding character."
  3223. msgstr ""
  3224. #. type: TP
  3225. #: deb-substvars.man:1
  3226. #, no-wrap
  3227. msgid "B<shlibs:>I<dependencyfield>"
  3228. msgstr ""
  3229. #. type: Plain text
  3230. #: deb-substvars.man:1
  3231. msgid ""
  3232. "Variable settings with names of this form are generated by "
  3233. "B<dpkg-shlibdeps>."
  3234. msgstr ""
  3235. #. type: TP
  3236. #: deb-substvars.man:1
  3237. #, no-wrap
  3238. msgid "B<dpkg:Upstream-Version>"
  3239. msgstr ""
  3240. #. type: Plain text
  3241. #: deb-substvars.man:1
  3242. msgid "The upstream version of dpkg (since dpkg 1.13.19)."
  3243. msgstr ""
  3244. #. type: TP
  3245. #: deb-substvars.man:1
  3246. #, no-wrap
  3247. msgid "B<dpkg:Version>"
  3248. msgstr ""
  3249. #. type: Plain text
  3250. #: deb-substvars.man:1
  3251. msgid "The full version of dpkg (since dpkg 1.13.19)."
  3252. msgstr ""
  3253. #. type: Plain text
  3254. #: deb-substvars.man:1
  3255. msgid ""
  3256. "If a variable is referred to but not defined it generates a warning and an "
  3257. "empty value is assumed."
  3258. msgstr ""
  3259. #. type: TP
  3260. #: deb-substvars.man:1
  3261. #, no-wrap
  3262. msgid "B<debian/substvars>"
  3263. msgstr ""
  3264. #. type: Plain text
  3265. #: deb-substvars.man:1
  3266. msgid "List of substitution variables and values."
  3267. msgstr ""
  3268. #. type: Plain text
  3269. #: deb-substvars.man:1
  3270. msgid ""
  3271. "B<dpkg>(1), B<dpkg-genchanges>(1), B<dpkg-gencontrol>(1), "
  3272. "B<dpkg-shlibdeps>(1), B<dpkg-source>(1)."
  3273. msgstr ""
  3274. #. type: TH
  3275. #: deb-symbols.man:1
  3276. #, no-wrap
  3277. msgid "deb-symbols"
  3278. msgstr ""
  3279. #. type: Plain text
  3280. #: deb-symbols.man:1
  3281. msgid "deb-symbols - Debian's extended shared library information file"
  3282. msgstr ""
  3283. #. type: Plain text
  3284. #: deb-symbols.man:1
  3285. msgid "symbols"
  3286. msgstr ""
  3287. #. type: Plain text
  3288. #: deb-symbols.man:1
  3289. msgid ""
  3290. "The symbol files are shipped in Debian binary packages, and its format is a "
  3291. "subset of the template symbol files used by B<dpkg-gensymbols>(1) in Debian "
  3292. "source packages."
  3293. msgstr ""
  3294. #. type: Plain text
  3295. #: deb-symbols.man:1
  3296. msgid ""
  3297. "The format for an extended shared library dependency information entry in "
  3298. "these files is:"
  3299. msgstr ""
  3300. #. type: Plain text
  3301. #: deb-symbols.man:1
  3302. msgid "I<library-soname main-dependency-template>"
  3303. msgstr ""
  3304. #. type: Plain text
  3305. #: deb-symbols.man:1
  3306. msgid "[| I<alternative-dependency-template>]"
  3307. msgstr ""
  3308. #. type: Plain text
  3309. #: deb-symbols.man:1
  3310. msgid "[...]"
  3311. msgstr ""
  3312. #. type: Plain text
  3313. #: deb-symbols.man:1
  3314. msgid "[* I<field-name>: I<field-value>]"
  3315. msgstr ""
  3316. #. type: Plain text
  3317. #: deb-symbols.man:1
  3318. #, no-wrap
  3319. msgid ""
  3320. "[...]\n"
  3321. " I<symbol> I<minimal-version> [I<id-of-dependency-template>]\n"
  3322. msgstr ""
  3323. #. type: Plain text
  3324. #: deb-symbols.man:1
  3325. msgid ""
  3326. "The I<library-soname> is exactly the value of the SONAME field as exported "
  3327. "by B<objdump>(1). A I<dependency-template> is a dependency where I<#MINVER#> "
  3328. "is dynamically replaced either by a version check like “(E<gt>= "
  3329. "I<minimal-version>)” or by nothing (if an unversioned dependency is deemed "
  3330. "sufficient)."
  3331. msgstr ""
  3332. #. type: Plain text
  3333. #: deb-symbols.man:1
  3334. msgid ""
  3335. "Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being "
  3336. "“Base” if the library is not versioned) is associated to a "
  3337. "I<minimal-version> of its dependency template (the main dependency template "
  3338. "is always used and will end up being combined with the dependency template "
  3339. "referenced by I<id-of-dependency-template> if present). The first "
  3340. "alternative dependency template is numbered 1, the second one 2, etc."
  3341. msgstr ""
  3342. #. type: Plain text
  3343. #: deb-symbols.man:1
  3344. msgid ""
  3345. "Each entry for a library can also have some fields of meta-information. "
  3346. "Those fields are stored on lines starting with an asterisk. Currently, the "
  3347. "only valid fields are:"
  3348. msgstr ""
  3349. #. type: TP
  3350. #: deb-symbols.man:1
  3351. #, no-wrap
  3352. msgid "B<Build-Depends-Package>"
  3353. msgstr ""
  3354. #. type: Plain text
  3355. #: deb-symbols.man:1
  3356. msgid ""
  3357. "It indicates the name of the “-dev” package associated to the library and is "
  3358. "used by B<dpkg-shlibdeps> to make sure that the dependency generated is at "
  3359. "least as strict as the corresponding build dependency (since dpkg 1.14.13)."
  3360. msgstr ""
  3361. #. type: TP
  3362. #: deb-symbols.man:1
  3363. #, no-wrap
  3364. msgid "B<Ignore-Blacklist-Groups>"
  3365. msgstr ""
  3366. #. type: Plain text
  3367. #: deb-symbols.man:1
  3368. msgid ""
  3369. "It indicates what blacklist groups should be ignored, as a whitespace "
  3370. "separated list, so that the symbols contained in those groups get included "
  3371. "in the output file (since dpkg 1.17.6). This should only be necessary for "
  3372. "toolchain packages providing those blacklisted symbols. The available groups "
  3373. "are system dependent, for ELF and GNU-based systems these are B<aeabi> and "
  3374. "B<gomp>."
  3375. msgstr ""
  3376. #. type: SS
  3377. #: deb-symbols.man:1
  3378. #, no-wrap
  3379. msgid "Simple symbols file"
  3380. msgstr ""
  3381. #. type: Plain text
  3382. #: deb-symbols.man:1
  3383. #, no-wrap
  3384. msgid ""
  3385. "libftp.so.3 libftp3 #MINVER#\n"
  3386. " DefaultNetbuf@Base 3.1-1-6\n"
  3387. " FtpAccess@Base 3.1-1-6\n"
  3388. " [...]\n"
  3389. msgstr ""
  3390. #. type: SS
  3391. #: deb-symbols.man:1
  3392. #, no-wrap
  3393. msgid "Advanced symbols file"
  3394. msgstr ""
  3395. #. type: Plain text
  3396. #: deb-symbols.man:1
  3397. msgid "libGL.so.1 libgl1"
  3398. msgstr ""
  3399. #. type: Plain text
  3400. #: deb-symbols.man:1
  3401. msgid "| libgl1-mesa-glx #MINVER#"
  3402. msgstr ""
  3403. #. type: Plain text
  3404. #: deb-symbols.man:1
  3405. #, no-wrap
  3406. msgid ""
  3407. "* Build-Depends-Package: libgl1-mesa-dev\n"
  3408. " publicGlSymbol@Base 6.3-1\n"
  3409. " [...]\n"
  3410. " implementationSpecificSymbol@Base 6.5.2-7 1\n"
  3411. " [...]\n"
  3412. msgstr ""
  3413. #. type: Plain text
  3414. #: deb-symbols.man:1
  3415. msgid "B<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>"
  3416. msgstr ""
  3417. #. type: Plain text
  3418. #: deb-symbols.man:1
  3419. msgid "B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)."
  3420. msgstr ""
  3421. #. type: TH
  3422. #: deb-postinst.man:1
  3423. #, no-wrap
  3424. msgid "deb-postinst"
  3425. msgstr ""
  3426. #. type: Plain text
  3427. #: deb-postinst.man:1
  3428. msgid "deb-postinst - package post-installation maintainer script"
  3429. msgstr ""
  3430. #. type: Plain text
  3431. #: deb-postinst.man:1
  3432. msgid "postinst"
  3433. msgstr ""
  3434. #. type: Plain text
  3435. #: deb-postinst.man:1
  3436. msgid ""
  3437. "A package can perform several post-installation actions via maintainer "
  3438. "scripts, by including an executable I<postinst> file in its control archive "
  3439. "(i.e. I<DEBIAN/postinst> during package creation)."
  3440. msgstr ""
  3441. #. type: Plain text
  3442. #: deb-postinst.man:1 deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1
  3443. msgid "The script can be called in the following ways:"
  3444. msgstr ""
  3445. #. type: TP
  3446. #: deb-postinst.man:1
  3447. #, no-wrap
  3448. msgid "I<postinst> B<configure> I<old-version>"
  3449. msgstr ""
  3450. #. type: Plain text
  3451. #: deb-postinst.man:1
  3452. msgid "After the package was installed."
  3453. msgstr ""
  3454. #. type: TP
  3455. #: deb-postinst.man:1
  3456. #, no-wrap
  3457. msgid "I<postinst> B<triggered> I<trigger-name...>"
  3458. msgstr ""
  3459. #. type: Plain text
  3460. #: deb-postinst.man:1
  3461. msgid "After the package was triggered."
  3462. msgstr ""
  3463. #. type: TP
  3464. #: deb-postinst.man:1
  3465. #, no-wrap
  3466. msgid "I<old-postinst> B<abort-upgrade> I<new-version>"
  3467. msgstr ""
  3468. #. type: Plain text
  3469. #: deb-postinst.man:1
  3470. msgid "If I<prerm> fails during upgrade or fails on failed upgrade."
  3471. msgstr ""
  3472. #. type: TP
  3473. #: deb-postinst.man:1
  3474. #, no-wrap
  3475. msgid "I<old-postinst> B<abort-remove>"
  3476. msgstr ""
  3477. #. type: Plain text
  3478. #: deb-postinst.man:1
  3479. msgid "If I<prerm> fails during removal."
  3480. msgstr ""
  3481. #. type: TP
  3482. #: deb-postinst.man:1
  3483. #, no-wrap
  3484. msgid "I<postinst> B<abort-deconfigure in-favour> I<new-package new-version>"
  3485. msgstr ""
  3486. #. type: TQ
  3487. #: deb-postinst.man:1
  3488. #, no-wrap
  3489. msgid " [ B<removing> I<old-package old-version> ]"
  3490. msgstr ""
  3491. #. type: Plain text
  3492. #: deb-postinst.man:1
  3493. msgid "If I<prerm> fails during deconfiguration of a package."
  3494. msgstr ""
  3495. #. type: TP
  3496. #: deb-postinst.man:1
  3497. #, no-wrap
  3498. msgid "I<postinst> B<abort-remove in-favour> I<new-package new-version>"
  3499. msgstr ""
  3500. #. type: Plain text
  3501. #: deb-postinst.man:1
  3502. msgid "If I<prerm> fails during replacement due to conflict."
  3503. msgstr ""
  3504. #. type: Plain text
  3505. #: deb-postinst.man:1 deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1
  3506. #: dpkg.cfg.man:1 dpkg-divert.man:1 dpkg-query.man:1 dpkg-statoverride.man:1
  3507. msgid "B<dpkg>(1)."
  3508. msgstr ""
  3509. #. type: TH
  3510. #: deb-postrm.man:1
  3511. #, no-wrap
  3512. msgid "deb-postrm"
  3513. msgstr ""
  3514. #. type: Plain text
  3515. #: deb-postrm.man:1
  3516. msgid "deb-postrm - package post-removal maintainer script"
  3517. msgstr ""
  3518. #. type: Plain text
  3519. #: deb-postrm.man:1
  3520. msgid "postrm"
  3521. msgstr ""
  3522. #. type: Plain text
  3523. #: deb-postrm.man:1
  3524. msgid ""
  3525. "A package can perform several post-removal actions via maintainer scripts, "
  3526. "by including an executable I<postrm> file in its control archive "
  3527. "(i.e. I<DEBIAN/postrm> during package creation)."
  3528. msgstr ""
  3529. #. type: TP
  3530. #: deb-postrm.man:1
  3531. #, no-wrap
  3532. msgid "I<postrm> B<remove>"
  3533. msgstr ""
  3534. #. type: Plain text
  3535. #: deb-postrm.man:1
  3536. msgid "After the package was removed."
  3537. msgstr ""
  3538. #. type: TP
  3539. #: deb-postrm.man:1
  3540. #, no-wrap
  3541. msgid "I<postrm> B<purge>"
  3542. msgstr ""
  3543. #. type: Plain text
  3544. #: deb-postrm.man:1
  3545. msgid "After the package was purged."
  3546. msgstr ""
  3547. #. type: TP
  3548. #: deb-postrm.man:1
  3549. #, no-wrap
  3550. msgid "I<old-postrm> B<upgrade> I<new-version>"
  3551. msgstr ""
  3552. #. type: Plain text
  3553. #: deb-postrm.man:1
  3554. msgid "After the package was upgraded."
  3555. msgstr ""
  3556. #. type: TP
  3557. #: deb-postrm.man:1
  3558. #, no-wrap
  3559. msgid "I<new-postrm >B<failed-upgrade>I< old-version new-version>"
  3560. msgstr ""
  3561. #. type: Plain text
  3562. #: deb-postrm.man:1
  3563. msgid "If the above B<upgrade> call fails."
  3564. msgstr ""
  3565. #. type: TP
  3566. #: deb-postrm.man:1
  3567. #, no-wrap
  3568. msgid "I<postrm> B<disappear> I<overwriter-package> I<overwriter-version>"
  3569. msgstr ""
  3570. #. type: Plain text
  3571. #: deb-postrm.man:1
  3572. msgid "After all of the packages files have been replaced."
  3573. msgstr ""
  3574. #. type: TP
  3575. #: deb-postrm.man:1
  3576. #, no-wrap
  3577. msgid "I<new-postrm> B<abort-install>"
  3578. msgstr ""
  3579. #. type: Plain text
  3580. #: deb-postrm.man:1
  3581. msgid "If I<preinst> fails during install."
  3582. msgstr ""
  3583. #. type: TP
  3584. #: deb-postrm.man:1
  3585. #, no-wrap
  3586. msgid "I<new-postrm> B<abort-install> I<old-version new-version>"
  3587. msgstr ""
  3588. #. type: Plain text
  3589. #: deb-postrm.man:1
  3590. msgid "If I<preinst> fails during upgrade of removed package."
  3591. msgstr ""
  3592. #. type: TP
  3593. #: deb-postrm.man:1
  3594. #, no-wrap
  3595. msgid "I<new-postrm> B<abort-upgrade> I<old-version new-version>"
  3596. msgstr ""
  3597. #. type: Plain text
  3598. #: deb-postrm.man:1
  3599. msgid "If I<preinst> fails during upgrade."
  3600. msgstr ""
  3601. #. type: TH
  3602. #: deb-preinst.man:1
  3603. #, no-wrap
  3604. msgid "deb-preinst"
  3605. msgstr ""
  3606. #. type: Plain text
  3607. #: deb-preinst.man:1
  3608. msgid "deb-preinst - package pre-installation maintainer script"
  3609. msgstr ""
  3610. #. type: Plain text
  3611. #: deb-preinst.man:1
  3612. msgid "preinst"
  3613. msgstr ""
  3614. #. type: Plain text
  3615. #: deb-preinst.man:1
  3616. msgid ""
  3617. "A package can perform several pre-installation actions via maintainer "
  3618. "scripts, by including an executable I<preinst> file in its control archive "
  3619. "(i.e. I<DEBIAN/preinst> during package creation)."
  3620. msgstr ""
  3621. #. type: TP
  3622. #: deb-preinst.man:1
  3623. #, no-wrap
  3624. msgid "I<new-preinst> B<install>"
  3625. msgstr ""
  3626. #. type: Plain text
  3627. #: deb-preinst.man:1
  3628. msgid "Before the package is installed."
  3629. msgstr ""
  3630. #. type: TP
  3631. #: deb-preinst.man:1
  3632. #, no-wrap
  3633. msgid "I<new-preinst> B<install> I<old-version new-version>"
  3634. msgstr ""
  3635. #. type: Plain text
  3636. #: deb-preinst.man:1
  3637. msgid "Before removed package is upgraded."
  3638. msgstr ""
  3639. #. type: TP
  3640. #: deb-preinst.man:1
  3641. #, no-wrap
  3642. msgid "I<new-preinst> B<upgrade> I<old-version new-version>"
  3643. msgstr ""
  3644. #. type: Plain text
  3645. #: deb-preinst.man:1
  3646. msgid "Before the package is upgraded."
  3647. msgstr ""
  3648. #. type: TP
  3649. #: deb-preinst.man:1
  3650. #, no-wrap
  3651. msgid "I<old-preinst> B<abort-upgrade> I<new-version>"
  3652. msgstr ""
  3653. #. type: Plain text
  3654. #: deb-preinst.man:1
  3655. msgid "If I<postrm> fails during upgrade or fails on failed upgrade."
  3656. msgstr ""
  3657. #. type: TH
  3658. #: deb-prerm.man:1
  3659. #, no-wrap
  3660. msgid "deb-prerm"
  3661. msgstr ""
  3662. #. type: Plain text
  3663. #: deb-prerm.man:1
  3664. msgid "deb-prerm - package pre-removal maintainer script"
  3665. msgstr ""
  3666. #. type: Plain text
  3667. #: deb-prerm.man:1
  3668. msgid "prerm"
  3669. msgstr ""
  3670. #. type: Plain text
  3671. #: deb-prerm.man:1
  3672. msgid ""
  3673. "A package can perform several pre-removal actions via maintainer scripts, by "
  3674. "including an executable I<prerm> file in its control archive "
  3675. "(i.e. I<DEBIAN/prerm> during package creation)."
  3676. msgstr ""
  3677. #. type: TP
  3678. #: deb-prerm.man:1
  3679. #, no-wrap
  3680. msgid "I<prerm> B<remove>"
  3681. msgstr ""
  3682. #. type: Plain text
  3683. #: deb-prerm.man:1
  3684. msgid "Before the package is removed."
  3685. msgstr ""
  3686. #. type: TP
  3687. #: deb-prerm.man:1
  3688. #, no-wrap
  3689. msgid "I<old-prerm> B<upgrade> I<new-version>"
  3690. msgstr ""
  3691. #. type: Plain text
  3692. #: deb-prerm.man:1
  3693. msgid "Before an upgrade."
  3694. msgstr ""
  3695. #. type: TP
  3696. #: deb-prerm.man:1
  3697. #, no-wrap
  3698. msgid "I<new-prerm> B<failed-upgrade> I<old-version new-version>"
  3699. msgstr ""
  3700. #. type: Plain text
  3701. #: deb-prerm.man:1
  3702. msgid "If the above B<upgrade> fails."
  3703. msgstr ""
  3704. #. type: TP
  3705. #: deb-prerm.man:1
  3706. #, no-wrap
  3707. msgid "I<prerm> B<deconfigure in-favour> I<new-package new-version>"
  3708. msgstr ""
  3709. #. type: TQ
  3710. #: deb-prerm.man:1
  3711. #, no-wrap
  3712. msgid " [ B<removing> I<old-package old-version> ]"
  3713. msgstr ""
  3714. #. type: Plain text
  3715. #: deb-prerm.man:1
  3716. msgid "Before package is deconfigured while dependency is replaced due to conflict."
  3717. msgstr ""
  3718. #. type: TP
  3719. #: deb-prerm.man:1
  3720. #, no-wrap
  3721. msgid "I<prerm> B<remove in-favour> I<new-package new-version>"
  3722. msgstr ""
  3723. #. type: Plain text
  3724. #: deb-prerm.man:1
  3725. msgid "Before the package is replaced due to conflict."
  3726. msgstr ""
  3727. #. type: TH
  3728. #: deb-triggers.man:1
  3729. #, no-wrap
  3730. msgid "deb-triggers"
  3731. msgstr ""
  3732. #. type: Plain text
  3733. #: deb-triggers.man:1
  3734. msgid "deb-triggers - package triggers"
  3735. msgstr ""
  3736. #. type: Plain text
  3737. #: deb-triggers.man:1
  3738. msgid "triggers"
  3739. msgstr ""
  3740. #. type: Plain text
  3741. #: deb-triggers.man:1
  3742. msgid ""
  3743. "A package declares its relationship to some trigger(s) by including a "
  3744. "I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during "
  3745. "package creation)."
  3746. msgstr ""
  3747. #. type: Plain text
  3748. #: deb-triggers.man:1
  3749. msgid ""
  3750. "This file contains directives, one per line. Leading and trailing whitespace "
  3751. "and everything after the first B<#> on any line will be trimmed, and empty "
  3752. "lines will be ignored."
  3753. msgstr ""
  3754. #. type: Plain text
  3755. #: deb-triggers.man:1
  3756. msgid "The trigger control directives currently supported are:"
  3757. msgstr ""
  3758. #. type: TP
  3759. #: deb-triggers.man:1
  3760. #, no-wrap
  3761. msgid "B<interest> I<trigger-name>"
  3762. msgstr ""
  3763. #. type: TQ
  3764. #: deb-triggers.man:1
  3765. #, no-wrap
  3766. msgid "B<interest-await> I<trigger-name>"
  3767. msgstr ""
  3768. #. type: TQ
  3769. #: deb-triggers.man:1
  3770. #, no-wrap
  3771. msgid "B<interest-noawait> I<trigger-name>"
  3772. msgstr ""
  3773. #. type: Plain text
  3774. #: deb-triggers.man:1
  3775. msgid ""
  3776. "Specifies that the package is interested in the named trigger. All triggers "
  3777. "in which a package is interested must be listed using this directive in the "
  3778. "triggers control file. The “noawait” variant does not put the triggering "
  3779. "packages in triggers-awaited state. This should be used when the "
  3780. "functionality provided by the trigger is not crucial."
  3781. msgstr ""
  3782. #. type: TP
  3783. #: deb-triggers.man:1
  3784. #, no-wrap
  3785. msgid "B<activate> I<trigger-name>"
  3786. msgstr ""
  3787. #. type: TQ
  3788. #: deb-triggers.man:1
  3789. #, no-wrap
  3790. msgid "B<activate-await> I<trigger-name>"
  3791. msgstr ""
  3792. #. type: TQ
  3793. #: deb-triggers.man:1
  3794. #, no-wrap
  3795. msgid "B<activate-noawait> I<trigger-name>"
  3796. msgstr ""
  3797. #. type: Plain text
  3798. #: deb-triggers.man:1
  3799. msgid ""
  3800. "Arranges that changes to this package's state will activate the specified "
  3801. "trigger. The trigger will be activated at the start of the following "
  3802. "operations: unpack, configure, remove (including for the benefit of a "
  3803. "conflicting package), purge and deconfigure. The “noawait” variant does not "
  3804. "put the triggering packages in triggers-awaited state. This should be used "
  3805. "when the functionality provided by the trigger is not crucial."
  3806. msgstr ""
  3807. #. type: Plain text
  3808. #: deb-triggers.man:1
  3809. msgid ""
  3810. "If this package disappears during the unpacking of another package the "
  3811. "trigger will be activated when the disappearance is noted towards the end of "
  3812. "the unpack. Trigger processing, and transition from triggers-awaited to "
  3813. "installed, does not cause activations. In the case of unpack, triggers "
  3814. "mentioned in both the old and new versions of the package will be activated."
  3815. msgstr ""
  3816. #. type: Plain text
  3817. #: deb-triggers.man:1
  3818. msgid ""
  3819. "Unknown directives are an error which will prevent installation of the "
  3820. "package."
  3821. msgstr ""
  3822. #. type: Plain text
  3823. #: deb-triggers.man:1
  3824. msgid ""
  3825. "The “-noawait” variants should always be favored when possible since "
  3826. "triggering packages are not put in triggers-awaited state and can thus be "
  3827. "immediately configured without requiring the processing of the trigger. If "
  3828. "the triggering packages are dependencies of other upgraded packages, it will "
  3829. "avoid an early trigger processing run and make it possible to run the "
  3830. "trigger only once as one of the last steps of the upgrade."
  3831. msgstr ""
  3832. #. type: Plain text
  3833. #: deb-triggers.man:1
  3834. msgid ""
  3835. "The “-noawait” variants are only supported since dpkg 1.16.1, and will lead "
  3836. "to errors if used with an older dpkg. It is thus recommended to add a "
  3837. "“Pre-Depends: dpkg (E<gt>= 1.16.1)” to any package that wish to use those "
  3838. "directives."
  3839. msgstr ""
  3840. #. type: Plain text
  3841. #: deb-triggers.man:1
  3842. msgid ""
  3843. "The “-await” alias variants are only supported since dpkg 1.17.21, and will "
  3844. "lead to errors if used with an older dpkg. It is thus recommended to add a "
  3845. "“Pre-Depends: dpkg (E<gt>= 1.17.21)” to any package that wish to use those "
  3846. "directives."
  3847. msgstr ""
  3848. #. FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev.
  3849. #. type: Plain text
  3850. #: deb-triggers.man:1
  3851. msgid "B<dpkg-trigger>(1), B<dpkg>(1), B</usr/share/doc/dpkg-dev/triggers.txt.gz>."
  3852. msgstr ""
  3853. #. type: TH
  3854. #: dsc.man:1
  3855. #, no-wrap
  3856. msgid "dsc"
  3857. msgstr ""
  3858. #. type: Plain text
  3859. #: dsc.man:1
  3860. msgid "dsc - Debian source packages' control file format"
  3861. msgstr ""
  3862. #. type: Plain text
  3863. #: dsc.man:1
  3864. msgid "I<filename>B<.dsc>"
  3865. msgstr ""
  3866. #. type: Plain text
  3867. #: dsc.man:1
  3868. msgid ""
  3869. "Each Debian source package is composed of a .dsc control file, which "
  3870. "contains a number of fields. Each field begins with a tag, such as "
  3871. "B<Source> or B<Binary> (case insensitive), followed by a colon, and the body "
  3872. "of the field. Fields are delimited only by field tags. In other words, "
  3873. "field text may be multiple lines in length, but the installation tools will "
  3874. "generally join lines when processing the body of the field (except in case "
  3875. "of the multiline fields B<Package-List>, B<Files>, B<Checksums-Sha1> and "
  3876. "B<Checksums-Sha256>, see below)."
  3877. msgstr ""
  3878. #. type: Plain text
  3879. #: dsc.man:1
  3880. msgid ""
  3881. "The value of this field declares the format version of the source package. "
  3882. "The field value is used by programs acting on a source package to interpret "
  3883. "the list of files in the source package and determine how to unpack it. The "
  3884. "syntax of the field value is a numeric major revision, a period, a numeric "
  3885. "minor revision, and then an optional subtype after whitespace, which if "
  3886. "specified is an alphanumeric word in parentheses. The subtype is optional "
  3887. "in the syntax but may be mandatory for particular source format revisions."
  3888. msgstr ""
  3889. #. type: Plain text
  3890. #: dsc.man:1
  3891. msgid ""
  3892. "The source formats currently supported by B<dpkg> are B<1.0>, B<2.0>, B<3.0 "
  3893. "(native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> and B<3.0 (custom)>."
  3894. msgstr ""
  3895. #. type: TP
  3896. #: dsc.man:1
  3897. #, no-wrap
  3898. msgid "B<Source:> I<source-name> (required)"
  3899. msgstr ""
  3900. #. type: TP
  3901. #: dsc.man:1
  3902. #, no-wrap
  3903. msgid "B<Binary:>I< binary-package-list>"
  3904. msgstr ""
  3905. #. type: Plain text
  3906. #: dsc.man:1
  3907. msgid ""
  3908. "This folded field lists binary packages which this source package can "
  3909. "produce, separated by commas."
  3910. msgstr ""
  3911. #. type: Plain text
  3912. #: dsc.man:1
  3913. msgid ""
  3914. "This field has now been superseded by the B<Package-List> field, which gives "
  3915. "enough information about what binary packages are produced on which "
  3916. "architecture, build-profile and other involved restrictions."
  3917. msgstr ""
  3918. #. type: TP
  3919. #: dsc.man:1
  3920. #, no-wrap
  3921. msgid "B<Architecture:> I<arch-list> (recommended)"
  3922. msgstr ""
  3923. #. type: Plain text
  3924. #: dsc.man:1
  3925. msgid ""
  3926. "A list of architectures and architecture wildcards separated by spaces which "
  3927. "specify the type of hardware this package can be compiled for. Common "
  3928. "architecture names and architecture wildcards are B<amd64>, B<armel>, "
  3929. "B<i386>, B<linux-any>, B<any-amd64>, etc."
  3930. msgstr ""
  3931. #. type: Plain text
  3932. #: dsc.man:1
  3933. msgid ""
  3934. "Note that the B<all> value is meant for packages that are architecture "
  3935. "independent, and B<any> for packages that are architecture dependent. The "
  3936. "list may include (or consist solely of) the special value B<all>. When the "
  3937. "list contains the architecture wildcard B<any>, the only other value allowed "
  3938. "in the list is B<all>."
  3939. msgstr ""
  3940. #. type: Plain text
  3941. #: dsc.man:1
  3942. msgid ""
  3943. "The field value is generally generated from B<Architecture> fields from in "
  3944. "the I<debian/control> in the source package."
  3945. msgstr ""
  3946. #. type: TP
  3947. #: dsc.man:1
  3948. #, no-wrap
  3949. msgid "B<Uploaders:>I< fullname-email-list>"
  3950. msgstr ""
  3951. #. type: TP
  3952. #: dsc.man:1
  3953. #, no-wrap
  3954. msgid "B<Standards-Version:> I<version-string> (recommended)"
  3955. msgstr ""
  3956. #. type: Plain text
  3957. #: dsc.man:1
  3958. msgid ""
  3959. "The I<url> of a web interface to browse the Version Control System "
  3960. "repository."
  3961. msgstr ""
  3962. #. type: Plain text
  3963. #: dsc.man:1
  3964. msgid ""
  3965. "These fields declare the I<url> of the Version Control System repository "
  3966. "used to maintain this package. See B<deb-src-control>(5) for more details."
  3967. msgstr ""
  3968. #. type: TP
  3969. #: dsc.man:1
  3970. #, no-wrap
  3971. msgid "B<Testsuite:>I< name-list>"
  3972. msgstr ""
  3973. #. type: Plain text
  3974. #: dsc.man:1
  3975. msgid ""
  3976. "This field declares that the source package contains the specified test "
  3977. "suites. The value is a space-separated list of test suites. If the "
  3978. "B<autopkgtest> value is present, a I<debian/tests/control> is expected to be "
  3979. "present, if the file is present but not the value, then B<dpkg-source> will "
  3980. "automatically add it, preserving previous values."
  3981. msgstr ""
  3982. #. type: TP
  3983. #: dsc.man:1
  3984. #, no-wrap
  3985. msgid "B<Testsuite-Triggers:>I< package-list>"
  3986. msgstr ""
  3987. #. type: Plain text
  3988. #: dsc.man:1
  3989. msgid ""
  3990. "This field declares the comma-separated union of all test dependencies "
  3991. "(B<Depends> fields in I<debian/tests/control> file), with all restrictions "
  3992. "removed, and OR dependencies flattened, except for binaries generated by "
  3993. "this source package and meta-dependencies such as B<@> or B<@builddeps@>."
  3994. msgstr ""
  3995. #. type: Plain text
  3996. #: dsc.man:1
  3997. msgid ""
  3998. "Rationale: this field is needed because otherwise to be able to get the test "
  3999. "dependencies, each source package would need to be unpacked."
  4000. msgstr ""
  4001. #. type: Plain text
  4002. #: dsc.man:1
  4003. msgid ""
  4004. "These fields declare relationships between the source package and packages "
  4005. "used to build it. They are discussed in the B<deb-src-control>(5) manpage."
  4006. msgstr ""
  4007. #. type: TP
  4008. #: dsc.man:1
  4009. #, no-wrap
  4010. msgid "B<Package-List:>"
  4011. msgstr ""
  4012. #. type: TQ
  4013. #: dsc.man:1
  4014. #, no-wrap
  4015. msgid " I<package> I<package-type> I<section> I<priority> I<key-value-list>"
  4016. msgstr ""
  4017. #. type: Plain text
  4018. #: dsc.man:1
  4019. msgid ""
  4020. "This multiline field contains a list of binary packages generated by this "
  4021. "source package."
  4022. msgstr ""
  4023. #. type: Plain text
  4024. #: dsc.man:1
  4025. msgid "The I<package> is the binary package name."
  4026. msgstr ""
  4027. #. type: Plain text
  4028. #: dsc.man:1
  4029. msgid ""
  4030. "The I<package-type> is the binary package type, usually B<deb>, another "
  4031. "common value is B<udeb>."
  4032. msgstr ""
  4033. #. type: Plain text
  4034. #: dsc.man:1
  4035. msgid ""
  4036. "The I<section> and I<priority> match the binary package fields of the same "
  4037. "name."
  4038. msgstr ""
  4039. #. type: Plain text
  4040. #: dsc.man:1
  4041. msgid ""
  4042. "The I<key-value-list> is a space separated I<key>B<=>I<value> list, and the "
  4043. "currently known optional keys are:"
  4044. msgstr ""
  4045. #. type: TP
  4046. #: dsc.man:1
  4047. #, no-wrap
  4048. msgid "B<arch>"
  4049. msgstr ""
  4050. #. type: Plain text
  4051. #: dsc.man:1
  4052. msgid ""
  4053. "The architecture restriction from the binary package B<Architecture> field, "
  4054. "with spaces converted to ‘,’."
  4055. msgstr ""
  4056. #. type: TP
  4057. #: dsc.man:1
  4058. #, no-wrap
  4059. msgid "B<profile>"
  4060. msgstr ""
  4061. #. type: Plain text
  4062. #: dsc.man:1
  4063. msgid ""
  4064. "The normalized build-profile restriction formula from the binary package "
  4065. "B<Build-Profile> field, with ORs converted to ‘+’ and ANDs to ‘,’."
  4066. msgstr ""
  4067. #. type: TP
  4068. #: dsc.man:1
  4069. #, no-wrap
  4070. msgid "B<essential>"
  4071. msgstr ""
  4072. #. type: Plain text
  4073. #: dsc.man:1
  4074. msgid ""
  4075. "If the binary package is essential, this key will contain the value of the "
  4076. "B<Essential> field, that is a B<yes> value."
  4077. msgstr ""
  4078. #. type: Plain text
  4079. #: dsc.man:1
  4080. msgid ""
  4081. "These multiline fields contain a list of files with a checksum and size for "
  4082. "each one. These fields have the same syntax and differ only in the checksum "
  4083. "algorithm used: MD5 for B<Files>, SHA-1 for B<Checksums-Sha1> and SHA-256 "
  4084. "for B<Checksums-Sha256>."
  4085. msgstr ""
  4086. #. type: Plain text
  4087. #: dsc.man:1
  4088. msgid ""
  4089. "The first line of the field value (the part on the same line as the field "
  4090. "name followed by a colon) is always empty. The content of the field is "
  4091. "expressed as continuation lines, one line per file. Each line consists of "
  4092. "the checksum, a space, the file size, a space, and the file name."
  4093. msgstr ""
  4094. #. type: Plain text
  4095. #: dsc.man:1
  4096. msgid ""
  4097. "These fields list all files that make up the source package. The list of "
  4098. "files in these fields must match the list of files in the other related "
  4099. "fields."
  4100. msgstr ""
  4101. #. type: Plain text
  4102. #: dsc.man:1
  4103. msgid ""
  4104. "The B<Format> field conflates the format for the B<.dsc> file itself and the "
  4105. "format of the extracted source package."
  4106. msgstr ""
  4107. #. type: Plain text
  4108. #: dsc.man:1
  4109. msgid "B<deb-src-control>(5), B<deb-version>(5), B<dpkg-source>(1)."
  4110. msgstr ""
  4111. #. type: TH
  4112. #: dpkg.man:1
  4113. #, no-wrap
  4114. msgid "dpkg"
  4115. msgstr ""
  4116. #. type: Plain text
  4117. #: dpkg.man:1
  4118. msgid "dpkg - package manager for Debian"
  4119. msgstr ""
  4120. #. type: Plain text
  4121. #: dpkg.man:1
  4122. msgid "B<dpkg> [I<option>...] I<action>"
  4123. msgstr ""
  4124. #. type: SH
  4125. #: dpkg.man:1
  4126. #, no-wrap
  4127. msgid "WARNING"
  4128. msgstr ""
  4129. #. type: Plain text
  4130. #: dpkg.man:1
  4131. msgid ""
  4132. "This manual is intended for users wishing to understand B<dpkg>'s command "
  4133. "line options and package states in more detail than that provided by B<dpkg "
  4134. "--help>."
  4135. msgstr ""
  4136. #. type: Plain text
  4137. #: dpkg.man:1
  4138. msgid ""
  4139. "It should I<not> be used by package maintainers wishing to understand how "
  4140. "B<dpkg> will install their packages. The descriptions of what B<dpkg> does "
  4141. "when installing and removing packages are particularly inadequate."
  4142. msgstr ""
  4143. #. type: Plain text
  4144. #: dpkg.man:1
  4145. msgid ""
  4146. "B<dpkg> is a tool to install, build, remove and manage Debian packages. The "
  4147. "primary and more user-friendly front-end for B<dpkg> is "
  4148. "B<aptitude>(1). B<dpkg> itself is controlled entirely via command line "
  4149. "parameters, which consist of exactly one action and zero or more "
  4150. "options. The action-parameter tells B<dpkg> what to do and options control "
  4151. "the behavior of the action in some way."
  4152. msgstr ""
  4153. #. type: Plain text
  4154. #: dpkg.man:1
  4155. msgid ""
  4156. "B<dpkg> can also be used as a front-end to B<dpkg-deb>(1) and "
  4157. "B<dpkg-query>(1). The list of supported actions can be found later on in the "
  4158. "B<ACTIONS> section. If any such action is encountered B<dpkg> just runs "
  4159. "B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no "
  4160. "specific options are currently passed to them, to use any such option the "
  4161. "back-ends need to be called directly."
  4162. msgstr ""
  4163. #. type: SH
  4164. #: dpkg.man:1
  4165. #, no-wrap
  4166. msgid "INFORMATION ABOUT PACKAGES"
  4167. msgstr ""
  4168. #. type: Plain text
  4169. #: dpkg.man:1
  4170. msgid ""
  4171. "B<dpkg> maintains some usable information about available packages. The "
  4172. "information is divided in three classes: B<states>, B<selection states> and "
  4173. "B<flags>. These values are intended to be changed mainly with B<dselect>."
  4174. msgstr ""
  4175. #. type: SS
  4176. #: dpkg.man:1
  4177. #, no-wrap
  4178. msgid "Package states"
  4179. msgstr ""
  4180. #. type: TP
  4181. #: dpkg.man:1
  4182. #, no-wrap
  4183. msgid "B<not-installed>"
  4184. msgstr ""
  4185. #. type: Plain text
  4186. #: dpkg.man:1
  4187. msgid "The package is not installed on your system."
  4188. msgstr ""
  4189. #. type: TP
  4190. #: dpkg.man:1
  4191. #, no-wrap
  4192. msgid "B<config-files>"
  4193. msgstr ""
  4194. #. type: Plain text
  4195. #: dpkg.man:1
  4196. msgid "Only the configuration files of the package exist on the system."
  4197. msgstr ""
  4198. #. type: TP
  4199. #: dpkg.man:1
  4200. #, no-wrap
  4201. msgid "B<half-installed>"
  4202. msgstr ""
  4203. #. type: Plain text
  4204. #: dpkg.man:1
  4205. msgid ""
  4206. "The installation of the package has been started, but not completed for some "
  4207. "reason."
  4208. msgstr ""
  4209. #. type: TP
  4210. #: dpkg.man:1
  4211. #, no-wrap
  4212. msgid "B<unpacked>"
  4213. msgstr ""
  4214. #. type: Plain text
  4215. #: dpkg.man:1
  4216. msgid "The package is unpacked, but not configured."
  4217. msgstr ""
  4218. #. type: TP
  4219. #: dpkg.man:1
  4220. #, no-wrap
  4221. msgid "B<half-configured>"
  4222. msgstr ""
  4223. #. type: Plain text
  4224. #: dpkg.man:1
  4225. msgid ""
  4226. "The package is unpacked and configuration has been started, but not yet "
  4227. "completed for some reason."
  4228. msgstr ""
  4229. #. type: TP
  4230. #: dpkg.man:1
  4231. #, no-wrap
  4232. msgid "B<triggers-awaited>"
  4233. msgstr ""
  4234. #. type: Plain text
  4235. #: dpkg.man:1
  4236. msgid "The package awaits trigger processing by another package."
  4237. msgstr ""
  4238. #. type: TP
  4239. #: dpkg.man:1
  4240. #, no-wrap
  4241. msgid "B<triggers-pending>"
  4242. msgstr ""
  4243. #. type: Plain text
  4244. #: dpkg.man:1
  4245. msgid "The package has been triggered."
  4246. msgstr ""
  4247. #. type: TP
  4248. #: dpkg.man:1
  4249. #, no-wrap
  4250. msgid "B<installed>"
  4251. msgstr ""
  4252. #. type: Plain text
  4253. #: dpkg.man:1
  4254. msgid "The package is correctly unpacked and configured."
  4255. msgstr ""
  4256. #. type: SS
  4257. #: dpkg.man:1
  4258. #, no-wrap
  4259. msgid "Package selection states"
  4260. msgstr ""
  4261. #. type: TP
  4262. #: dpkg.man:1
  4263. #, no-wrap
  4264. msgid "B<install>"
  4265. msgstr ""
  4266. #. type: Plain text
  4267. #: dpkg.man:1
  4268. msgid "The package is selected for installation."
  4269. msgstr ""
  4270. #. type: TP
  4271. #: dpkg.man:1
  4272. #, no-wrap
  4273. msgid "B<hold>"
  4274. msgstr ""
  4275. #. type: Plain text
  4276. #: dpkg.man:1
  4277. msgid ""
  4278. "A package marked to be on B<hold> is not handled by B<dpkg>, unless forced "
  4279. "to do that with option B<--force-hold>."
  4280. msgstr ""
  4281. #. type: TP
  4282. #: dpkg.man:1
  4283. #, no-wrap
  4284. msgid "B<deinstall>"
  4285. msgstr ""
  4286. #. type: Plain text
  4287. #: dpkg.man:1
  4288. msgid ""
  4289. "The package is selected for deinstallation (i.e. we want to remove all "
  4290. "files, except configuration files)."
  4291. msgstr ""
  4292. #. type: TP
  4293. #: dpkg.man:1
  4294. #, no-wrap
  4295. msgid "B<purge>"
  4296. msgstr ""
  4297. #. type: Plain text
  4298. #: dpkg.man:1
  4299. msgid ""
  4300. "The package is selected to be purged (i.e. we want to remove everything from "
  4301. "system directories, even configuration files)."
  4302. msgstr ""
  4303. #. type: SS
  4304. #: dpkg.man:1
  4305. #, no-wrap
  4306. msgid "Package flags"
  4307. msgstr ""
  4308. #. type: TP
  4309. #: dpkg.man:1
  4310. #, no-wrap
  4311. msgid "B<ok>"
  4312. msgstr ""
  4313. #. type: Plain text
  4314. #: dpkg.man:1
  4315. msgid ""
  4316. "A package marked B<ok> is in a known state, but might need further "
  4317. "processing."
  4318. msgstr ""
  4319. #. type: TP
  4320. #: dpkg.man:1
  4321. #, no-wrap
  4322. msgid "B<reinstreq>"
  4323. msgstr ""
  4324. #. type: Plain text
  4325. #: dpkg.man:1
  4326. msgid ""
  4327. "A package marked B<reinstreq> is broken and requires reinstallation. These "
  4328. "packages cannot be removed, unless forced with option "
  4329. "B<--force-remove-reinstreq>."
  4330. msgstr ""
  4331. #. type: SH
  4332. #: dpkg.man:1
  4333. #, no-wrap
  4334. msgid "ACTIONS"
  4335. msgstr ""
  4336. #. type: TP
  4337. #: dpkg.man:1
  4338. #, no-wrap
  4339. msgid "B<-i>, B<--install> I<package-file>..."
  4340. msgstr ""
  4341. #. type: Plain text
  4342. #: dpkg.man:1
  4343. msgid ""
  4344. "Install the package. If B<--recursive> or B<-R> option is specified, "
  4345. "I<package-file> must refer to a directory instead."
  4346. msgstr ""
  4347. #. type: Plain text
  4348. #: dpkg.man:1
  4349. msgid "Installation consists of the following steps:"
  4350. msgstr ""
  4351. #. type: Plain text
  4352. #: dpkg.man:1
  4353. msgid "B<1.> Extract the control files of the new package."
  4354. msgstr ""
  4355. #. type: Plain text
  4356. #: dpkg.man:1
  4357. msgid ""
  4358. "B<2.> If another version of the same package was installed before the new "
  4359. "installation, execute I<prerm> script of the old package."
  4360. msgstr ""
  4361. #. type: Plain text
  4362. #: dpkg.man:1
  4363. msgid "B<3.> Run I<preinst> script, if provided by the package."
  4364. msgstr ""
  4365. #. type: Plain text
  4366. #: dpkg.man:1
  4367. msgid ""
  4368. "B<4.> Unpack the new files, and at the same time back up the old files, so "
  4369. "that if something goes wrong, they can be restored."
  4370. msgstr ""
  4371. #. type: Plain text
  4372. #: dpkg.man:1
  4373. msgid ""
  4374. "B<5.> If another version of the same package was installed before the new "
  4375. "installation, execute the I<postrm> script of the old package. Note that "
  4376. "this script is executed after the I<preinst> script of the new package, "
  4377. "because new files are written at the same time old files are removed."
  4378. msgstr ""
  4379. #. type: Plain text
  4380. #: dpkg.man:1
  4381. msgid ""
  4382. "B<6.> Configure the package. See B<--configure> for detailed information "
  4383. "about how this is done."
  4384. msgstr ""
  4385. #. type: TP
  4386. #: dpkg.man:1
  4387. #, no-wrap
  4388. msgid "B<--unpack >I<package-file>..."
  4389. msgstr ""
  4390. #. type: Plain text
  4391. #: dpkg.man:1
  4392. msgid ""
  4393. "Unpack the package, but don't configure it. If B<--recursive> or B<-R> "
  4394. "option is specified, I<package-file> must refer to a directory instead."
  4395. msgstr ""
  4396. #. type: TP
  4397. #: dpkg.man:1
  4398. #, no-wrap
  4399. msgid "B<--configure >I<package>...|B<-a>|B<--pending>"
  4400. msgstr ""
  4401. #. type: Plain text
  4402. #: dpkg.man:1
  4403. msgid ""
  4404. "Configure a package which has been unpacked but not yet configured. If "
  4405. "B<-a> or B<--pending> is given instead of I<package>, all unpacked but "
  4406. "unconfigured packages are configured."
  4407. msgstr ""
  4408. #. type: Plain text
  4409. #: dpkg.man:1
  4410. msgid ""
  4411. "To reconfigure a package which has already been configured, try the "
  4412. "B<dpkg-reconfigure>(8) command instead."
  4413. msgstr ""
  4414. #. type: Plain text
  4415. #: dpkg.man:1
  4416. msgid "Configuring consists of the following steps:"
  4417. msgstr ""
  4418. #. type: Plain text
  4419. #: dpkg.man:1
  4420. msgid ""
  4421. "B<1.> Unpack the conffiles, and at the same time back up the old conffiles, "
  4422. "so that they can be restored if something goes wrong."
  4423. msgstr ""
  4424. #. type: Plain text
  4425. #: dpkg.man:1
  4426. msgid "B<2.> Run I<postinst> script, if provided by the package."
  4427. msgstr ""
  4428. #. type: TP
  4429. #: dpkg.man:1
  4430. #, no-wrap
  4431. msgid "B<--triggers-only> I<package>...|B<-a>|B<--pending>"
  4432. msgstr ""
  4433. #. type: Plain text
  4434. #: dpkg.man:1
  4435. msgid ""
  4436. "Processes only triggers (since dpkg 1.14.17). All pending triggers will be "
  4437. "processed. If package names are supplied only those packages' triggers will "
  4438. "be processed, exactly once each where necessary. Use of this option may "
  4439. "leave packages in the improper B<triggers-awaited> and B<triggers-pending> "
  4440. "states. This can be fixed later by running: B<dpkg --configure --pending>."
  4441. msgstr ""
  4442. #. type: TP
  4443. #: dpkg.man:1
  4444. #, no-wrap
  4445. msgid "B<-r>, B<--remove> I<package>...|B<-a>|B<--pending>"
  4446. msgstr ""
  4447. #. type: Plain text
  4448. #: dpkg.man:1
  4449. msgid ""
  4450. "Remove an installed package. This removes everything except conffiles, which "
  4451. "may avoid having to reconfigure the package if it is reinstalled later "
  4452. "(conffiles are configuration files that are listed in the "
  4453. "I<DEBIAN/conffiles> control file). If B<-a> or B<--pending> is given "
  4454. "instead of a package name, then all packages unpacked, but marked to be "
  4455. "removed in file I<%ADMINDIR%/status>, are removed."
  4456. msgstr ""
  4457. #. type: Plain text
  4458. #: dpkg.man:1
  4459. msgid "Removing of a package consists of the following steps:"
  4460. msgstr ""
  4461. #. type: Plain text
  4462. #: dpkg.man:1
  4463. msgid "B<1.> Run I<prerm> script"
  4464. msgstr ""
  4465. #. type: Plain text
  4466. #: dpkg.man:1
  4467. msgid "B<2.> Remove the installed files"
  4468. msgstr ""
  4469. #. type: Plain text
  4470. #: dpkg.man:1
  4471. msgid "B<3.> Run I<postrm> script"
  4472. msgstr ""
  4473. #. type: TP
  4474. #: dpkg.man:1
  4475. #, no-wrap
  4476. msgid "B<-P>, B<--purge> I<package>...|B<-a>|B<--pending>"
  4477. msgstr ""
  4478. #. type: Plain text
  4479. #: dpkg.man:1
  4480. msgid ""
  4481. "Purge an installed or already removed package. This removes everything, "
  4482. "including conffiles. If B<-a> or B<--pending> is given instead of a package "
  4483. "name, then all packages unpacked or removed, but marked to be purged in file "
  4484. "I<%ADMINDIR%/status>, are purged."
  4485. msgstr ""
  4486. #. type: Plain text
  4487. #: dpkg.man:1
  4488. msgid ""
  4489. "Note: some configuration files might be unknown to B<dpkg> because they are "
  4490. "created and handled separately through the configuration scripts. In that "
  4491. "case, B<dpkg> won't remove them by itself, but the package's I<postrm> "
  4492. "script (which is called by B<dpkg>), has to take care of their removal "
  4493. "during purge. Of course, this only applies to files in system directories, "
  4494. "not configuration files written to individual users' home directories."
  4495. msgstr ""
  4496. #. type: Plain text
  4497. #: dpkg.man:1
  4498. msgid "Purging of a package consists of the following steps:"
  4499. msgstr ""
  4500. #. type: Plain text
  4501. #: dpkg.man:1
  4502. msgid ""
  4503. "B<1.> Remove the package, if not already removed. See B<--remove> for "
  4504. "detailed information about how this is done."
  4505. msgstr ""
  4506. #. type: Plain text
  4507. #: dpkg.man:1
  4508. msgid "B<2.> Run I<postrm> script."
  4509. msgstr ""
  4510. #. type: TP
  4511. #: dpkg.man:1
  4512. #, no-wrap
  4513. msgid "B<-V>, B<--verify> [I<package-name>...]"
  4514. msgstr ""
  4515. #. type: Plain text
  4516. #: dpkg.man:1
  4517. msgid ""
  4518. "Verifies the integrity of I<package-name> or all packages if omitted, by "
  4519. "comparing information from the files installed by a package with the files "
  4520. "metadata information stored in the B<dpkg> database (since dpkg 1.17.2). "
  4521. "The origin of the files metadata information in the database is the binary "
  4522. "packages themselves. That metadata gets collected at package unpack time "
  4523. "during the installation process."
  4524. msgstr ""
  4525. #. type: Plain text
  4526. #: dpkg.man:1
  4527. msgid ""
  4528. "Currently the only functional check performed is an md5sum verification of "
  4529. "the file contents against the stored value in the files database. It will "
  4530. "only get checked if the database contains the file md5sum. To check for any "
  4531. "missing metadata in the database, the B<--audit> command can be used."
  4532. msgstr ""
  4533. #. type: Plain text
  4534. #: dpkg.man:1
  4535. msgid ""
  4536. "The output format is selectable with the B<--verify-format> option, which by "
  4537. "default uses the B<rpm> format, but that might change in the future, and as "
  4538. "such, programs parsing this command output should be explicit about the "
  4539. "format they expect."
  4540. msgstr ""
  4541. #. type: TP
  4542. #: dpkg.man:1
  4543. #, no-wrap
  4544. msgid "B<-C>, B<--audit> [I<package-name>...]"
  4545. msgstr ""
  4546. #. type: Plain text
  4547. #: dpkg.man:1
  4548. msgid ""
  4549. "Performs database sanity and consistency checks for I<package-name> or all "
  4550. "packages if omitted (per package checks since dpkg 1.17.10). For example, "
  4551. "searches for packages that have been installed only partially on your system "
  4552. "or that have missing, wrong or obsolete control data or files. B<dpkg> will "
  4553. "suggest what to do with them to get them fixed."
  4554. msgstr ""
  4555. #. type: TP
  4556. #: dpkg.man:1
  4557. #, no-wrap
  4558. msgid "B<--update-avail> [I<Packages-file>]"
  4559. msgstr ""
  4560. #. type: TQ
  4561. #: dpkg.man:1
  4562. #, no-wrap
  4563. msgid "B<--merge-avail> [I<Packages-file>]"
  4564. msgstr ""
  4565. #. type: Plain text
  4566. #: dpkg.man:1
  4567. msgid ""
  4568. "Update B<dpkg>'s and B<dselect>'s idea of which packages are available. With "
  4569. "action B<--merge-avail>, old information is combined with information from "
  4570. "I<Packages-file>. With action B<--update-avail>, old information is replaced "
  4571. "with the information in the I<Packages-file>. The I<Packages-file> "
  4572. "distributed with Debian is simply named «I<Packages>». If the "
  4573. "I<Packages-file> argument is missing or named «B<->» then it will be read "
  4574. "from standard input (since dpkg 1.17.7). B<dpkg> keeps its record of "
  4575. "available packages in I<%ADMINDIR%/available>."
  4576. msgstr ""
  4577. #. type: Plain text
  4578. #: dpkg.man:1
  4579. msgid ""
  4580. "A simpler one-shot command to retrieve and update the I<available> file is "
  4581. "B<dselect update>. Note that this file is mostly useless if you don't use "
  4582. "B<dselect> but an APT-based frontend: APT has its own system to keep track "
  4583. "of available packages."
  4584. msgstr ""
  4585. #. type: TP
  4586. #: dpkg.man:1
  4587. #, no-wrap
  4588. msgid "B<-A>, B<--record-avail> I<package-file>..."
  4589. msgstr ""
  4590. #. type: Plain text
  4591. #: dpkg.man:1
  4592. msgid ""
  4593. "Update B<dpkg> and B<dselect>'s idea of which packages are available with "
  4594. "information from the package I<package-file>. If B<--recursive> or B<-R> "
  4595. "option is specified, I<package-file> must refer to a directory instead."
  4596. msgstr ""
  4597. #. type: TP
  4598. #: dpkg.man:1
  4599. #, no-wrap
  4600. msgid "B<--forget-old-unavail>"
  4601. msgstr ""
  4602. #. type: Plain text
  4603. #: dpkg.man:1
  4604. msgid ""
  4605. "Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled "
  4606. "unavailable packages (since dpkg 1.15.4), but only those that do not contain "
  4607. "user information such as package selections."
  4608. msgstr ""
  4609. #. type: TP
  4610. #: dpkg.man:1
  4611. #, no-wrap
  4612. msgid "B<--clear-avail>"
  4613. msgstr ""
  4614. #. type: Plain text
  4615. #: dpkg.man:1
  4616. msgid "Erase the existing information about what packages are available."
  4617. msgstr ""
  4618. #. type: TP
  4619. #: dpkg.man:1
  4620. #, no-wrap
  4621. msgid "B<--get-selections> [I<package-name-pattern>...]"
  4622. msgstr ""
  4623. #. type: Plain text
  4624. #: dpkg.man:1
  4625. msgid ""
  4626. "Get list of package selections, and write it to stdout. Without a pattern, "
  4627. "non-installed packages (i.e. those which have been previously purged) will "
  4628. "not be shown."
  4629. msgstr ""
  4630. #. type: TP
  4631. #: dpkg.man:1 update-alternatives.man:1
  4632. #, no-wrap
  4633. msgid "B<--set-selections>"
  4634. msgstr ""
  4635. #. type: Plain text
  4636. #: dpkg.man:1
  4637. msgid ""
  4638. "Set package selections using file read from stdin. This file should be in "
  4639. "the format “I<package> I<state>”, where state is one of B<install>, B<hold>, "
  4640. "B<deinstall> or B<purge>. Blank lines and comment lines beginning with "
  4641. "‘B<#>’ are also permitted."
  4642. msgstr ""
  4643. #. type: Plain text
  4644. #: dpkg.man:1
  4645. msgid ""
  4646. "The I<available> file needs to be up-to-date for this command to be useful, "
  4647. "otherwise unknown packages will be ignored with a warning. See the "
  4648. "B<--update-avail> and B<--merge-avail> commands for more information."
  4649. msgstr ""
  4650. #. type: TP
  4651. #: dpkg.man:1
  4652. #, no-wrap
  4653. msgid "B<--clear-selections>"
  4654. msgstr ""
  4655. #. type: Plain text
  4656. #: dpkg.man:1
  4657. msgid ""
  4658. "Set the requested state of every non-essential package to deinstall (since "
  4659. "dpkg 1.13.18). This is intended to be used immediately before "
  4660. "B<--set-selections>, to deinstall any packages not in list given to "
  4661. "B<--set-selections>."
  4662. msgstr ""
  4663. #. type: TP
  4664. #: dpkg.man:1
  4665. #, no-wrap
  4666. msgid "B<--yet-to-unpack>"
  4667. msgstr ""
  4668. #. type: Plain text
  4669. #: dpkg.man:1
  4670. msgid ""
  4671. "Searches for packages selected for installation, but which for some reason "
  4672. "still haven't been installed."
  4673. msgstr ""
  4674. #. type: TP
  4675. #: dpkg.man:1
  4676. #, no-wrap
  4677. msgid "B<--predep-package>"
  4678. msgstr ""
  4679. #. type: Plain text
  4680. #: dpkg.man:1
  4681. msgid ""
  4682. "Print a single package which is the target of one or more relevant "
  4683. "pre-dependencies and has itself no unsatisfied pre-dependencies."
  4684. msgstr ""
  4685. #. type: Plain text
  4686. #: dpkg.man:1
  4687. msgid ""
  4688. "If such a package is present, output it as a Packages file entry, which can "
  4689. "be massaged as appropriate."
  4690. msgstr ""
  4691. #. type: Plain text
  4692. #: dpkg.man:1
  4693. msgid ""
  4694. "Returns 0 when a package is printed, 1 when no suitable package is available "
  4695. "and 2 on error."
  4696. msgstr ""
  4697. #. type: TP
  4698. #: dpkg.man:1
  4699. #, no-wrap
  4700. msgid "B<--add-architecture >I<architecture>"
  4701. msgstr ""
  4702. #. type: Plain text
  4703. #: dpkg.man:1
  4704. msgid ""
  4705. "Add I<architecture> to the list of architectures for which packages can be "
  4706. "installed without using B<--force-architecture> (since dpkg 1.16.2). The "
  4707. "architecture B<dpkg> is built for (i.e. the output of "
  4708. "B<--print-architecture>) is always part of that list."
  4709. msgstr ""
  4710. #. type: TP
  4711. #: dpkg.man:1
  4712. #, no-wrap
  4713. msgid "B<--remove-architecture >I<architecture>"
  4714. msgstr ""
  4715. #. type: Plain text
  4716. #: dpkg.man:1
  4717. msgid ""
  4718. "Remove I<architecture> from the list of architectures for which packages can "
  4719. "be installed without using B<--force-architecture> (since dpkg 1.16.2). If "
  4720. "the architecture is currently in use in the database then the operation will "
  4721. "be refused, except if B<--force-architecture> is specified. The architecture "
  4722. "B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never "
  4723. "be removed from that list."
  4724. msgstr ""
  4725. #. type: TP
  4726. #: dpkg.man:1
  4727. #, no-wrap
  4728. msgid "B<--print-architecture>"
  4729. msgstr ""
  4730. #. type: Plain text
  4731. #: dpkg.man:1
  4732. msgid "Print architecture of packages B<dpkg> installs (for example, “i386”)."
  4733. msgstr ""
  4734. #. type: TP
  4735. #: dpkg.man:1
  4736. #, no-wrap
  4737. msgid "B<--print-foreign-architectures>"
  4738. msgstr ""
  4739. #. type: Plain text
  4740. #: dpkg.man:1
  4741. msgid ""
  4742. "Print a newline-separated list of the extra architectures B<dpkg> is "
  4743. "configured to allow packages to be installed for (since dpkg 1.16.2)."
  4744. msgstr ""
  4745. #. type: TP
  4746. #: dpkg.man:1
  4747. #, no-wrap
  4748. msgid "B<--assert->I<feature>"
  4749. msgstr ""
  4750. #. type: Plain text
  4751. #: dpkg.man:1
  4752. msgid ""
  4753. "Asserts that B<dpkg> supports the requested feature. Returns 0 if the "
  4754. "feature is fully supported, 1 if the feature is known but B<dpkg> cannot "
  4755. "provide support for it yet, and 2 if the feature is unknown. The current "
  4756. "list of assertable features is:"
  4757. msgstr ""
  4758. #. type: TP
  4759. #: dpkg.man:1
  4760. #, no-wrap
  4761. msgid "B<support-predepends>"
  4762. msgstr ""
  4763. #. type: Plain text
  4764. #: dpkg.man:1
  4765. msgid "Supports the B<Pre-Depends> field (since dpkg 1.1.0)."
  4766. msgstr ""
  4767. #. type: TP
  4768. #: dpkg.man:1
  4769. #, no-wrap
  4770. msgid "B<working-epoch>"
  4771. msgstr ""
  4772. #. type: Plain text
  4773. #: dpkg.man:1
  4774. msgid "Supports epochs in version strings (since dpkg 1.4.0.7)."
  4775. msgstr ""
  4776. #. type: TP
  4777. #: dpkg.man:1
  4778. #, no-wrap
  4779. msgid "B<long-filenames>"
  4780. msgstr ""
  4781. #. type: Plain text
  4782. #: dpkg.man:1
  4783. msgid "Supports long filenames in B<deb>(5) archives (since dpkg 1.4.1.17)."
  4784. msgstr ""
  4785. #. type: TP
  4786. #: dpkg.man:1
  4787. #, no-wrap
  4788. msgid "B<multi-conrep>"
  4789. msgstr ""
  4790. #. type: Plain text
  4791. #: dpkg.man:1
  4792. msgid "Supports multiple B<Conflicts> and B<Replaces> (since dpkg 1.4.1.19)."
  4793. msgstr ""
  4794. #. type: TP
  4795. #: dpkg.man:1
  4796. #, no-wrap
  4797. msgid "B<multi-arch>"
  4798. msgstr ""
  4799. #. type: Plain text
  4800. #: dpkg.man:1
  4801. msgid "Supports multi-arch fields and semantics (since dpkg 1.16.2)."
  4802. msgstr ""
  4803. #. type: TP
  4804. #: dpkg.man:1
  4805. #, no-wrap
  4806. msgid "B<versioned-provides>"
  4807. msgstr ""
  4808. #. type: Plain text
  4809. #: dpkg.man:1
  4810. msgid "Supports versioned B<Provides> (since dpkg 1.17.11)."
  4811. msgstr ""
  4812. #. type: TP
  4813. #: dpkg.man:1
  4814. #, no-wrap
  4815. msgid "B<--validate->I<thing string>"
  4816. msgstr ""
  4817. #. type: Plain text
  4818. #: dpkg.man:1
  4819. msgid ""
  4820. "Validate that the I<thing> I<string> has a correct syntax (since dpkg "
  4821. "1.18.16). Returns 0 if the I<string> is valid, 1 if the I<string> is "
  4822. "invalid but might be accepted in lax contexts, and 2 if the I<string> is "
  4823. "invalid. The current list of validatable I<thing>s is:"
  4824. msgstr ""
  4825. #. type: TP
  4826. #: dpkg.man:1 dpkg.man:1
  4827. #, no-wrap
  4828. msgid "B<pkgname>"
  4829. msgstr ""
  4830. #. type: Plain text
  4831. #: dpkg.man:1
  4832. msgid "Validates the given package name (since dpkg 1.18.16)."
  4833. msgstr ""
  4834. #. type: TP
  4835. #: dpkg.man:1
  4836. #, no-wrap
  4837. msgid "B<trigname>"
  4838. msgstr ""
  4839. #. type: Plain text
  4840. #: dpkg.man:1
  4841. msgid "Validates the given trigger name (since dpkg 1.18.16)."
  4842. msgstr ""
  4843. #. type: Plain text
  4844. #: dpkg.man:1
  4845. msgid "Validates the given architecture name (since dpkg 1.18.16)."
  4846. msgstr ""
  4847. #. type: TP
  4848. #: dpkg.man:1
  4849. #, no-wrap
  4850. msgid "B<version>"
  4851. msgstr ""
  4852. #. type: Plain text
  4853. #: dpkg.man:1
  4854. msgid "Validates the given version (since dpkg 1.18.16)."
  4855. msgstr ""
  4856. #. type: TP
  4857. #: dpkg.man:1
  4858. #, no-wrap
  4859. msgid "B<--compare-versions >I<ver1 op ver2>"
  4860. msgstr ""
  4861. #. .TP
  4862. #. .B \-\-command\-fd \fIn\fP
  4863. #. Accept a series of commands on input file descriptor \fIn\fP. Note:
  4864. #. additional options set on the command line, and through this file descriptor,
  4865. #. are not reset for subsequent commands executed during the same run.
  4866. #. type: Plain text
  4867. #: dpkg.man:1
  4868. msgid ""
  4869. "Compare version numbers, where I<op> is a binary operator. B<dpkg> returns "
  4870. "true (B<0>) if the specified condition is satisfied, and false (B<1>) "
  4871. "otherwise. There are two groups of operators, which differ in how they treat "
  4872. "an empty I<ver1> or I<ver2>. These treat an empty version as earlier than "
  4873. "any version: B<lt le eq ne ge gt>. These treat an empty version as later "
  4874. "than any version: B<lt-nl le-nl ge-nl gt-nl>. These are provided only for "
  4875. "compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= "
  4876. "E<gt>E<gt> E<gt>>. The B<E<lt>> and B<E<gt>> operators are obsolete and "
  4877. "should B<not> be used, due to confusing semantics. To illustrate: B<0.1 "
  4878. "E<lt> 0.1> evaluates to true."
  4879. msgstr ""
  4880. #. type: TP
  4881. #: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildpackage.man:1
  4882. #: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
  4883. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  4884. #: dpkg-gensymbols.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
  4885. #: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-shlibdeps.man:1
  4886. #: dpkg-source.man:1 dpkg-split.man:1 dpkg-trigger.man:1 dselect.man:1
  4887. #, no-wrap
  4888. msgid "B<-?>, B<--help>"
  4889. msgstr ""
  4890. #. type: Plain text
  4891. #: dpkg.man:1
  4892. msgid "Display a brief help message."
  4893. msgstr ""
  4894. #. type: TP
  4895. #: dpkg.man:1
  4896. #, no-wrap
  4897. msgid "B<--force-help>"
  4898. msgstr ""
  4899. #. type: Plain text
  4900. #: dpkg.man:1
  4901. msgid "Give help about the B<--force->I<thing> options."
  4902. msgstr ""
  4903. #. type: TP
  4904. #: dpkg.man:1
  4905. #, no-wrap
  4906. msgid "B<-Dh>, B<--debug=help>"
  4907. msgstr ""
  4908. #. type: Plain text
  4909. #: dpkg.man:1
  4910. msgid "Give help about debugging options."
  4911. msgstr ""
  4912. #. type: TP
  4913. #: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildflags.man:1
  4914. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1
  4915. #: dpkg-distaddfile.man:1 dpkg-deb.man:1 dpkg-divert.man:1
  4916. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-gensymbols.man:1
  4917. #: dpkg-mergechangelogs.man:1 dpkg-parsechangelog.man:1 dpkg-query.man:1
  4918. #: dpkg-scanpackages.man:1 dpkg-scansources.man:1 dpkg-shlibdeps.man:1
  4919. #: dpkg-source.man:1 dpkg-split.man:1 dpkg-statoverride.man:1
  4920. #: dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1 update-alternatives.man:1
  4921. #, no-wrap
  4922. msgid "B<--version>"
  4923. msgstr ""
  4924. #. type: Plain text
  4925. #: dpkg.man:1
  4926. msgid "Display B<dpkg> version information."
  4927. msgstr ""
  4928. #. type: TP
  4929. #: dpkg.man:1
  4930. #, no-wrap
  4931. msgid "B<dpkg-deb actions>"
  4932. msgstr ""
  4933. #. type: Plain text
  4934. #: dpkg.man:1
  4935. msgid "See B<dpkg-deb>(1) for more information about the following actions."
  4936. msgstr ""
  4937. #. type: Plain text
  4938. #: dpkg.man:1
  4939. #, no-wrap
  4940. msgid ""
  4941. "B<-b>, B<--build> I<directory> [I<archive>|I<directory>]\n"
  4942. " Build a deb package.\n"
  4943. "B<-c>, B<--contents> I<archive>\n"
  4944. " List contents of a deb package.\n"
  4945. "B<-e>, B<--control> I<archive> [I<directory>]\n"
  4946. " Extract control-information from a package.\n"
  4947. "B<-x>, B<--extract> I<archive directory>\n"
  4948. " Extract the files contained by package.\n"
  4949. "B<-X>, B<--vextract> I<archive directory>\n"
  4950. " Extract and display the filenames contained by a\n"
  4951. " package.\n"
  4952. "B<-f>, B<--field> I<archive> [I<control-field>...]\n"
  4953. " Display control field(s) of a package.\n"
  4954. "B<--ctrl-tarfile> I<archive>\n"
  4955. " Output the control tar-file contained in a Debian package.\n"
  4956. "B<--fsys-tarfile> I<archive>\n"
  4957. " Output the filesystem tar-file contained by a Debian package.\n"
  4958. "B<-I>, B<--info> I<archive> [I<control-file>...]\n"
  4959. " Show information about a package.\n"
  4960. msgstr ""
  4961. #. type: TP
  4962. #: dpkg.man:1
  4963. #, no-wrap
  4964. msgid "B<dpkg-query actions>"
  4965. msgstr ""
  4966. #. type: Plain text
  4967. #: dpkg.man:1
  4968. msgid "See B<dpkg-query>(1) for more information about the following actions."
  4969. msgstr ""
  4970. #. type: Plain text
  4971. #: dpkg.man:1
  4972. #, no-wrap
  4973. msgid ""
  4974. "B<-l>, B<--list> I<package-name-pattern>...\n"
  4975. " List packages matching given pattern.\n"
  4976. "B<-s>, B<--status> I<package-name>...\n"
  4977. " Report status of specified package.\n"
  4978. "B<-L>, B<--listfiles> I<package-name>...\n"
  4979. " List files installed to your system from I<package-name>.\n"
  4980. "B<-S>, B<--search> I<filename-search-pattern>...\n"
  4981. " Search for a filename from installed packages.\n"
  4982. "B<-p>, B<--print-avail> I<package-name>...\n"
  4983. " Display details about I<package-name>, as found in\n"
  4984. " I<%ADMINDIR%/available>. Users of APT-based frontends\n"
  4985. " should use B<apt-cache show> I<package-name> instead.\n"
  4986. msgstr ""
  4987. #. type: SH
  4988. #: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildpackage.man:1
  4989. #: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
  4990. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  4991. #: dpkg-gensymbols.man:1 dpkg-mergechangelogs.man:1 dpkg-name.man:1
  4992. #: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
  4993. #: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
  4994. #: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1
  4995. #: dpkg-vendor.man:1 dselect.man:1 start-stop-daemon.man:1
  4996. #: update-alternatives.man:1
  4997. #, no-wrap
  4998. msgid "OPTIONS"
  4999. msgstr ""
  5000. #. type: Plain text
  5001. #: dpkg.man:1
  5002. msgid ""
  5003. "All options can be specified both on the command line and in the B<dpkg> "
  5004. "configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names "
  5005. "matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration directory "
  5006. "I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration file is either "
  5007. "an option (exactly the same as the command line option but without leading "
  5008. "hyphens) or a comment (if it starts with a ‘B<#>’)."
  5009. msgstr ""
  5010. #. type: TP
  5011. #: dpkg.man:1
  5012. #, no-wrap
  5013. msgid "B<--abort-after=>I<number>"
  5014. msgstr ""
  5015. #. type: Plain text
  5016. #: dpkg.man:1
  5017. msgid "Change after how many errors B<dpkg> will abort. The default is 50."
  5018. msgstr ""
  5019. #. type: TP
  5020. #: dpkg.man:1
  5021. #, no-wrap
  5022. msgid "B<-B>, B<--auto-deconfigure>"
  5023. msgstr ""
  5024. #. type: Plain text
  5025. #: dpkg.man:1
  5026. msgid ""
  5027. "When a package is removed, there is a possibility that another installed "
  5028. "package depended on the removed package. Specifying this option will cause "
  5029. "automatic deconfiguration of the package which depended on the removed "
  5030. "package."
  5031. msgstr ""
  5032. #. type: TP
  5033. #: dpkg.man:1
  5034. #, no-wrap
  5035. msgid "B<-D>I<octal>B<, --debug=>I<octal>"
  5036. msgstr ""
  5037. #. type: Plain text
  5038. #: dpkg.man:1
  5039. msgid ""
  5040. "Switch debugging on. I<octal> is formed by bitwise-orring desired values "
  5041. "together from the list below (note that these values may change in future "
  5042. "releases). B<-Dh> or B<--debug=help> display these debugging values."
  5043. msgstr ""
  5044. #. type: Plain text
  5045. #: dpkg.man:1
  5046. #, no-wrap
  5047. msgid ""
  5048. " Number Description\n"
  5049. " 1 Generally helpful progress information\n"
  5050. " 2 Invocation and status of maintainer scripts\n"
  5051. " 10 Output for each file processed\n"
  5052. " 100 Lots of output for each file processed\n"
  5053. " 20 Output for each configuration file\n"
  5054. " 200 Lots of output for each configuration file\n"
  5055. " 40 Dependencies and conflicts\n"
  5056. " 400 Lots of dependencies/conflicts output\n"
  5057. " 10000 Trigger activation and processing\n"
  5058. " 20000 Lots of output regarding triggers\n"
  5059. " 40000 Silly amounts of output regarding triggers\n"
  5060. " 1000 Lots of drivel about e.g. the dpkg/info dir\n"
  5061. " 2000 Insane amounts of drivel\n"
  5062. msgstr ""
  5063. #. type: TP
  5064. #: dpkg.man:1
  5065. #, no-wrap
  5066. msgid "B<--force->I<things>"
  5067. msgstr ""
  5068. #. type: TQ
  5069. #: dpkg.man:1
  5070. #, no-wrap
  5071. msgid "B<--no-force->I<things>, B<--refuse->I<things>"
  5072. msgstr ""
  5073. #. type: Plain text
  5074. #: dpkg.man:1
  5075. msgid ""
  5076. "Force or refuse (B<no-force> and B<refuse> mean the same thing) to do some "
  5077. "things. I<things> is a comma separated list of things specified "
  5078. "below. B<--force-help> displays a message describing them. Things marked "
  5079. "with (*) are forced by default."
  5080. msgstr ""
  5081. #. type: Plain text
  5082. #: dpkg.man:1
  5083. msgid ""
  5084. "I<Warning: These options are mostly intended to be used by experts "
  5085. "only. Using them without fully understanding their effects may break your "
  5086. "whole system.>"
  5087. msgstr ""
  5088. #. type: Plain text
  5089. #: dpkg.man:1
  5090. msgid "B<all>: Turns on (or off) all force options."
  5091. msgstr ""
  5092. #. type: Plain text
  5093. #: dpkg.man:1
  5094. msgid ""
  5095. "B<downgrade>(*): Install a package, even if newer version of it is already "
  5096. "installed."
  5097. msgstr ""
  5098. #. type: Plain text
  5099. #: dpkg.man:1
  5100. msgid ""
  5101. "I<Warning: At present >B<dpkg>I< does not do any dependency checking on "
  5102. "downgrades and therefore will not warn you if the downgrade breaks the "
  5103. "dependency of some other package. This can have serious side effects, "
  5104. "downgrading essential system components can even make your whole system "
  5105. "unusable. Use with care.>"
  5106. msgstr ""
  5107. #. type: Plain text
  5108. #: dpkg.man:1
  5109. msgid ""
  5110. "B<configure-any>: Configure also any unpacked but unconfigured packages on "
  5111. "which the current package depends."
  5112. msgstr ""
  5113. #. type: Plain text
  5114. #: dpkg.man:1
  5115. msgid "B<hold>: Process packages even when marked “hold”."
  5116. msgstr ""
  5117. #. type: Plain text
  5118. #: dpkg.man:1
  5119. msgid ""
  5120. "B<remove-reinstreq>: Remove a package, even if it's broken and marked to "
  5121. "require reinstallation. This may, for example, cause parts of the package to "
  5122. "remain on the system, which will then be forgotten by B<dpkg>."
  5123. msgstr ""
  5124. #. type: Plain text
  5125. #: dpkg.man:1
  5126. msgid ""
  5127. "B<remove-essential>: Remove, even if the package is considered "
  5128. "essential. Essential packages contain mostly very basic Unix "
  5129. "commands. Removing them might cause the whole system to stop working, so use "
  5130. "with caution."
  5131. msgstr ""
  5132. #. type: Plain text
  5133. #: dpkg.man:1
  5134. msgid "B<depends>: Turn all dependency problems into warnings."
  5135. msgstr ""
  5136. #. type: Plain text
  5137. #: dpkg.man:1
  5138. msgid "B<depends-version>: Don't care about versions when checking dependencies."
  5139. msgstr ""
  5140. #. type: Plain text
  5141. #: dpkg.man:1
  5142. msgid ""
  5143. "B<breaks>: Install, even if this would break another package (since dpkg "
  5144. "1.14.6)."
  5145. msgstr ""
  5146. #. type: Plain text
  5147. #: dpkg.man:1
  5148. msgid ""
  5149. "B<conflicts>: Install, even if it conflicts with another package. This is "
  5150. "dangerous, for it will usually cause overwriting of some files."
  5151. msgstr ""
  5152. #. type: Plain text
  5153. #: dpkg.man:1
  5154. msgid ""
  5155. "B<confmiss>: Always install the missing conffile without prompting. This is "
  5156. "dangerous, since it means not preserving a change (removing) made to the "
  5157. "file."
  5158. msgstr ""
  5159. #. type: Plain text
  5160. #: dpkg.man:1
  5161. msgid ""
  5162. "B<confnew>: If a conffile has been modified and the version in the package "
  5163. "did change, always install the new version without prompting, unless the "
  5164. "B<--force-confdef> is also specified, in which case the default action is "
  5165. "preferred."
  5166. msgstr ""
  5167. #. type: Plain text
  5168. #: dpkg.man:1
  5169. msgid ""
  5170. "B<confold>: If a conffile has been modified and the version in the package "
  5171. "did change, always keep the old version without prompting, unless the "
  5172. "B<--force-confdef> is also specified, in which case the default action is "
  5173. "preferred."
  5174. msgstr ""
  5175. #. type: Plain text
  5176. #: dpkg.man:1
  5177. msgid ""
  5178. "B<confdef>: If a conffile has been modified and the version in the package "
  5179. "did change, always choose the default action without prompting. If there is "
  5180. "no default action it will stop to ask the user unless B<--force-confnew> or "
  5181. "B<--force-confold> is also been given, in which case it will use that to "
  5182. "decide the final action."
  5183. msgstr ""
  5184. #. type: Plain text
  5185. #: dpkg.man:1
  5186. msgid ""
  5187. "B<confask>: If a conffile has been modified always offer to replace it with "
  5188. "the version in the package, even if the version in the package did not "
  5189. "change (since dpkg 1.15.8). If any of B<--force-confnew>, "
  5190. "B<--force-confold>, or B<--force-confdef> is also given, it will be used to "
  5191. "decide the final action."
  5192. msgstr ""
  5193. #. type: Plain text
  5194. #: dpkg.man:1
  5195. msgid "B<overwrite>: Overwrite one package's file with another's file."
  5196. msgstr ""
  5197. #. type: Plain text
  5198. #: dpkg.man:1
  5199. msgid "B<overwrite-dir>: Overwrite one package's directory with another's file."
  5200. msgstr ""
  5201. #. type: Plain text
  5202. #: dpkg.man:1
  5203. msgid "B<overwrite-diverted>: Overwrite a diverted file with an undiverted version."
  5204. msgstr ""
  5205. #. type: Plain text
  5206. #: dpkg.man:1
  5207. msgid ""
  5208. "B<unsafe-io>: Do not perform safe I/O operations when unpacking (since dpkg "
  5209. "1.15.8.6). Currently this implies not performing file system syncs before "
  5210. "file renames, which is known to cause substantial performance degradation on "
  5211. "some file systems, unfortunately the ones that require the safe I/O on the "
  5212. "first place due to their unreliable behaviour causing zero-length files on "
  5213. "abrupt system crashes."
  5214. msgstr ""
  5215. #. type: Plain text
  5216. #: dpkg.man:1
  5217. msgid ""
  5218. "I<Note>: For ext4, the main offender, consider using instead the mount "
  5219. "option B<nodelalloc>, which will fix both the performance degradation and "
  5220. "the data safety issues, the latter by making the file system not produce "
  5221. "zero-length files on abrupt system crashes with any software not doing syncs "
  5222. "before atomic renames."
  5223. msgstr ""
  5224. #. type: Plain text
  5225. #: dpkg.man:1
  5226. msgid ""
  5227. "I<Warning: Using this option might improve performance at the cost of losing "
  5228. "data, use with care.>"
  5229. msgstr ""
  5230. #. type: Plain text
  5231. #: dpkg.man:1
  5232. msgid ""
  5233. "B<script-chrootless>: Run maintainer scrips without B<chroot>(2)ing into "
  5234. "B<instdir> even if the package does not support this mode of operation "
  5235. "(since dpkg 1.18.5)."
  5236. msgstr ""
  5237. #. type: Plain text
  5238. #: dpkg.man:1
  5239. msgid "I<Warning: This can destroy your host system, use with extreme care.>"
  5240. msgstr ""
  5241. #. type: Plain text
  5242. #: dpkg.man:1
  5243. msgid "B<architecture>: Process even packages with wrong or no architecture."
  5244. msgstr ""
  5245. #. type: Plain text
  5246. #: dpkg.man:1
  5247. msgid ""
  5248. "B<bad-version>: Process even packages with wrong versions (since dpkg "
  5249. "1.16.1)."
  5250. msgstr ""
  5251. #. type: Plain text
  5252. #: dpkg.man:1
  5253. msgid "B<bad-path>: B<PATH> is missing important programs, so problems are likely."
  5254. msgstr ""
  5255. #. type: Plain text
  5256. #: dpkg.man:1
  5257. msgid "B<not-root>: Try to (de)install things even when not root."
  5258. msgstr ""
  5259. #. type: Plain text
  5260. #: dpkg.man:1
  5261. msgid "B<bad-verify>: Install a package even if it fails authenticity check."
  5262. msgstr ""
  5263. #. type: TP
  5264. #: dpkg.man:1
  5265. #, no-wrap
  5266. msgid "B<--ignore-depends>=I<package>,..."
  5267. msgstr ""
  5268. #. type: Plain text
  5269. #: dpkg.man:1
  5270. msgid ""
  5271. "Ignore dependency-checking for specified packages (actually, checking is "
  5272. "performed, but only warnings about conflicts are given, nothing else)."
  5273. msgstr ""
  5274. #. type: TP
  5275. #: dpkg.man:1
  5276. #, no-wrap
  5277. msgid "B<--no-act>, B<--dry-run>, B<--simulate>"
  5278. msgstr ""
  5279. #. type: Plain text
  5280. #: dpkg.man:1
  5281. msgid ""
  5282. "Do everything which is supposed to be done, but don't write any "
  5283. "changes. This is used to see what would happen with the specified action, "
  5284. "without actually modifying anything."
  5285. msgstr ""
  5286. #. type: Plain text
  5287. #: dpkg.man:1
  5288. msgid ""
  5289. "Be sure to give B<--no-act> before the action-parameter, or you might end up "
  5290. "with undesirable results. (e.g. B<dpkg --purge foo --no-act> will first "
  5291. "purge package foo and then try to purge package --no-act, even though you "
  5292. "probably expected it to actually do nothing)"
  5293. msgstr ""
  5294. #. type: TP
  5295. #: dpkg.man:1
  5296. #, no-wrap
  5297. msgid "B<-R>, B<--recursive>"
  5298. msgstr ""
  5299. #. type: Plain text
  5300. #: dpkg.man:1
  5301. msgid ""
  5302. "Recursively handle all regular files matching pattern B<*.deb> found at "
  5303. "specified directories and all of its subdirectories. This can be used with "
  5304. "B<-i>, B<-A>, B<--install>, B<--unpack> and B<--record-avail> actions."
  5305. msgstr ""
  5306. #. type: TP
  5307. #: dpkg.man:1 dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  5308. #, no-wrap
  5309. msgid "B<-G>"
  5310. msgstr ""
  5311. #. type: Plain text
  5312. #: dpkg.man:1
  5313. msgid ""
  5314. "Don't install a package if a newer version of the same package is already "
  5315. "installed. This is an alias of B<--refuse-downgrade>."
  5316. msgstr ""
  5317. #. type: TP
  5318. #: dpkg.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  5319. #: dpkg-checkbuilddeps.man:1 dpkg-query.man:1 dpkg-shlibdeps.man:1
  5320. #: dpkg-trigger.man:1
  5321. #, no-wrap
  5322. msgid "B<--admindir=>I<dir>"
  5323. msgstr ""
  5324. #. type: Plain text
  5325. #: dpkg.man:1
  5326. msgid ""
  5327. "Change default administrative directory, which contains many files that give "
  5328. "information about status of installed or uninstalled packages, etc. "
  5329. "(Defaults to «I<%ADMINDIR%>»)"
  5330. msgstr ""
  5331. #. type: TP
  5332. #: dpkg.man:1
  5333. #, no-wrap
  5334. msgid "B<--instdir=>I<dir>"
  5335. msgstr ""
  5336. #. type: Plain text
  5337. #: dpkg.man:1
  5338. msgid ""
  5339. "Change default installation directory which refers to the directory where "
  5340. "packages are to be installed. B<instdir> is also the directory passed to "
  5341. "B<chroot>(2) before running package's installation scripts, which means that "
  5342. "the scripts see B<instdir> as a root directory. (Defaults to «I</>»)"
  5343. msgstr ""
  5344. #. type: TP
  5345. #: dpkg.man:1
  5346. #, no-wrap
  5347. msgid "B<--root=>I<dir>"
  5348. msgstr ""
  5349. #. type: Plain text
  5350. #: dpkg.man:1
  5351. msgid ""
  5352. "Changing B<root> changes B<instdir> to «I<dir>» and B<admindir> to "
  5353. "«I<dir>B<%ADMINDIR%>»."
  5354. msgstr ""
  5355. #. type: TP
  5356. #: dpkg.man:1
  5357. #, no-wrap
  5358. msgid "B<-O>, B<--selected-only>"
  5359. msgstr ""
  5360. #. type: Plain text
  5361. #: dpkg.man:1
  5362. msgid ""
  5363. "Only process the packages that are selected for installation. The actual "
  5364. "marking is done with B<dselect> or by B<dpkg>, when it handles packages. For "
  5365. "example, when a package is removed, it will be marked selected for "
  5366. "deinstallation."
  5367. msgstr ""
  5368. #. type: TP
  5369. #: dpkg.man:1
  5370. #, no-wrap
  5371. msgid "B<-E>, B<--skip-same-version>"
  5372. msgstr ""
  5373. #. type: Plain text
  5374. #: dpkg.man:1
  5375. msgid ""
  5376. "Don't install the package if the same version of the package is already "
  5377. "installed."
  5378. msgstr ""
  5379. #. type: TP
  5380. #: dpkg.man:1
  5381. #, no-wrap
  5382. msgid "B<--pre-invoke=>I<command>"
  5383. msgstr ""
  5384. #. type: TQ
  5385. #: dpkg.man:1
  5386. #, no-wrap
  5387. msgid "B<--post-invoke=>I<command>"
  5388. msgstr ""
  5389. #. type: Plain text
  5390. #: dpkg.man:1
  5391. msgid ""
  5392. "Set an invoke hook I<command> to be run via ``sh -c'' before or after the "
  5393. "B<dpkg> run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, "
  5394. "I<remove>, I<purge>, I<add-architecture> and I<remove-architecture> B<dpkg> "
  5395. "actions (since dpkg 1.15.4; I<add-architecture> and I<remove-architecture> "
  5396. "actions since dpkg 1.17.19). This option can be specified multiple "
  5397. "times. The order the options are specified is preserved, with the ones from "
  5398. "the configuration files taking precedence. The environment variable "
  5399. "B<DPKG_HOOK_ACTION> is set for the hooks to the current B<dpkg> "
  5400. "action. Note: front-ends might call B<dpkg> several times per invocation, "
  5401. "which might run the hooks more times than expected."
  5402. msgstr ""
  5403. #. type: TP
  5404. #: dpkg.man:1
  5405. #, no-wrap
  5406. msgid "B<--path-exclude=>I<glob-pattern>"
  5407. msgstr ""
  5408. #. type: TQ
  5409. #: dpkg.man:1
  5410. #, no-wrap
  5411. msgid "B<--path-include=>I<glob-pattern>"
  5412. msgstr ""
  5413. #. type: Plain text
  5414. #: dpkg.man:1
  5415. msgid ""
  5416. "Set I<glob-pattern> as a path filter, either by excluding or re-including "
  5417. "previously excluded paths matching the specified patterns during install "
  5418. "(since dpkg 1.15.8)."
  5419. msgstr ""
  5420. #. type: Plain text
  5421. #: dpkg.man:1
  5422. msgid ""
  5423. "I<Warning: take into account that depending on the excluded paths you might "
  5424. "completely break your system, use with caution.>"
  5425. msgstr ""
  5426. #. type: Plain text
  5427. #: dpkg.man:1
  5428. msgid ""
  5429. "The glob patterns use the same wildcards used in the shell, were ‘*’ matches "
  5430. "any sequence of characters, including the empty string and also ‘/’. For "
  5431. "example, «I</usr/*/READ*>» matches «I</usr/share/doc/package/README>». As "
  5432. "usual, ‘?’ matches any single character (again, including ‘/’). And ‘[’ "
  5433. "starts a character class, which can contain a list of characters, ranges and "
  5434. "complementations. See B<glob>(7) for detailed information about "
  5435. "globbing. Note: the current implementation might re-include more directories "
  5436. "and symlinks than needed, to be on the safe side and avoid possible unpack "
  5437. "failures; future work might fix this."
  5438. msgstr ""
  5439. #. type: Plain text
  5440. #: dpkg.man:1
  5441. msgid ""
  5442. "This can be used to remove all paths except some particular ones; a typical "
  5443. "case is:"
  5444. msgstr ""
  5445. #. type: Plain text
  5446. #: dpkg.man:1
  5447. #, no-wrap
  5448. msgid ""
  5449. "B<--path-exclude=/usr/share/doc/*>\n"
  5450. "B<--path-include=/usr/share/doc/*/copyright>\n"
  5451. msgstr ""
  5452. #. type: Plain text
  5453. #: dpkg.man:1
  5454. msgid "to remove all documentation files except the copyright files."
  5455. msgstr ""
  5456. #. type: Plain text
  5457. #: dpkg.man:1
  5458. msgid ""
  5459. "These two options can be specified multiple times, and interleaved with each "
  5460. "other. Both are processed in the given order, with the last rule that "
  5461. "matches a file name making the decision."
  5462. msgstr ""
  5463. #. type: Plain text
  5464. #: dpkg.man:1
  5465. msgid ""
  5466. "The filters are applied when unpacking the binary packages, and as such only "
  5467. "have knowledge of the type of object currently being filtered (e.g. a normal "
  5468. "file or a directory) and have not visibility of what objects will come "
  5469. "next. Because these filters have side effects (in contrast to B<find>(1) "
  5470. "filters), excluding an exact pathname that happens to be a directory object "
  5471. "like I</usr/share/doc> will not have the desired result, and only that "
  5472. "pathname will be excluded (which could be automatically reincluded if the "
  5473. "code sees the need). Any subsequent files contained within that directory "
  5474. "will fail to unpack."
  5475. msgstr ""
  5476. #. type: Plain text
  5477. #: dpkg.man:1
  5478. msgid "Hint: make sure the globs are not expanded by your shell."
  5479. msgstr ""
  5480. #. type: TP
  5481. #: dpkg.man:1
  5482. #, no-wrap
  5483. msgid "B<--verify-format>I< format-name>"
  5484. msgstr ""
  5485. #. type: Plain text
  5486. #: dpkg.man:1
  5487. msgid "Sets the output format for the B<--verify> command (since dpkg 1.17.2)."
  5488. msgstr ""
  5489. #. type: Plain text
  5490. #: dpkg.man:1
  5491. msgid ""
  5492. "The only currently supported output format is B<rpm>, which consists of a "
  5493. "line for every path that failed any check. The lines start with 9 "
  5494. "characters to report each specific check result, a ‘B<?>’ implies the check "
  5495. "could not be done (lack of support, file permissions, etc), ‘B<.>’ implies "
  5496. "the check passed, and an alphanumeric character implies a specific check "
  5497. "failed; the md5sum verification failure (the file contents have changed) is "
  5498. "denoted with a ‘B<5>’ on the third character. The line is followed by a "
  5499. "space and an attribute character (currently ‘B<c>’ for conffiles), another "
  5500. "space and the pathname."
  5501. msgstr ""
  5502. #. type: TP
  5503. #: dpkg.man:1
  5504. #, no-wrap
  5505. msgid "B<--status-fd >I<n>"
  5506. msgstr ""
  5507. #. type: Plain text
  5508. #: dpkg.man:1
  5509. msgid ""
  5510. "Send machine-readable package status and progress information to file "
  5511. "descriptor I<n>. This option can be specified multiple times. The "
  5512. "information is generally one record per line, in one of the following forms:"
  5513. msgstr ""
  5514. #. type: TP
  5515. #: dpkg.man:1
  5516. #, no-wrap
  5517. msgid "B<status: >I<package>B<: >I<status>"
  5518. msgstr ""
  5519. #. type: Plain text
  5520. #: dpkg.man:1
  5521. msgid "Package status changed; I<status> is as in the status file."
  5522. msgstr ""
  5523. #. type: TP
  5524. #: dpkg.man:1
  5525. #, no-wrap
  5526. msgid "B<status: >I<package>B< : error : >I<extended-error-message>"
  5527. msgstr ""
  5528. #. type: Plain text
  5529. #: dpkg.man:1
  5530. msgid ""
  5531. "An error occurred. Any possible newlines in I<extended-error-message> will "
  5532. "be converted to spaces before output."
  5533. msgstr ""
  5534. #. type: TP
  5535. #: dpkg.man:1
  5536. #, no-wrap
  5537. msgid ""
  5538. "B<status: >I<file>B< : conffile-prompt : '>I<real-old>B<' '>I<real-new>B<' "
  5539. ">I<useredited>B< >I<distedited>"
  5540. msgstr ""
  5541. #. type: Plain text
  5542. #: dpkg.man:1
  5543. msgid "User is being asked a conffile question."
  5544. msgstr ""
  5545. #. type: TP
  5546. #: dpkg.man:1
  5547. #, no-wrap
  5548. msgid "B<processing: >I<stage>B<: >I<package>"
  5549. msgstr ""
  5550. #. type: Plain text
  5551. #: dpkg.man:1
  5552. msgid ""
  5553. "Sent just before a processing stage starts. I<stage> is one of B<upgrade>, "
  5554. "B<install> (both sent before unpacking), B<configure>, B<trigproc>, "
  5555. "B<disappear>, B<remove>, B<purge>."
  5556. msgstr ""
  5557. #. type: TP
  5558. #: dpkg.man:1
  5559. #, no-wrap
  5560. msgid "B<--status-logger>=I<command>"
  5561. msgstr ""
  5562. #. type: Plain text
  5563. #: dpkg.man:1
  5564. msgid ""
  5565. "Send machine-readable package status and progress information to the shell "
  5566. "I<command>'s standard input, to be run via ``sh -c'' (since dpkg 1.16.0). "
  5567. "This option can be specified multiple times. The output format used is the "
  5568. "same as in B<--status-fd>."
  5569. msgstr ""
  5570. #. type: TP
  5571. #: dpkg.man:1
  5572. #, no-wrap
  5573. msgid "B<--log=>I<filename>"
  5574. msgstr ""
  5575. #. type: Plain text
  5576. #: dpkg.man:1
  5577. msgid ""
  5578. "Log status change updates and actions to I<filename>, instead of the default "
  5579. "I<%LOGDIR%/dpkg.log>. If this option is given multiple times, the last "
  5580. "filename is used. Log messages are of the form:"
  5581. msgstr ""
  5582. #. type: TP
  5583. #: dpkg.man:1
  5584. #, no-wrap
  5585. msgid "YYYY-MM-DD HH:MM:SS B<startup> I<type> I<command>"
  5586. msgstr ""
  5587. #. type: Plain text
  5588. #: dpkg.man:1
  5589. msgid ""
  5590. "For each dpkg invocation where I<type> is B<archives> (with a I<command> of "
  5591. "B<unpack> or B<install>) or B<packages> (with a I<command> of B<configure>, "
  5592. "B<triggers-only>, B<remove> or B<purge>)."
  5593. msgstr ""
  5594. #. type: TP
  5595. #: dpkg.man:1
  5596. #, no-wrap
  5597. msgid "YYYY-MM-DD HH:MM:SS B<status> I<state> I<pkg> I<installed-version>"
  5598. msgstr ""
  5599. #. type: Plain text
  5600. #: dpkg.man:1
  5601. msgid "For status change updates."
  5602. msgstr ""
  5603. #. type: TP
  5604. #: dpkg.man:1
  5605. #, no-wrap
  5606. msgid ""
  5607. "YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> "
  5608. "I<available-version>"
  5609. msgstr ""
  5610. #. type: Plain text
  5611. #: dpkg.man:1
  5612. msgid ""
  5613. "For actions where I<action> is one of B<install>, B<upgrade>, B<configure>, "
  5614. "B<trigproc>, B<disappear>, B<remove> or B<purge>."
  5615. msgstr ""
  5616. #. type: TP
  5617. #: dpkg.man:1
  5618. #, no-wrap
  5619. msgid "YYYY-MM-DD HH:MM:SS B<conffile> I<filename> I<decision>"
  5620. msgstr ""
  5621. #. type: Plain text
  5622. #: dpkg.man:1
  5623. msgid "For conffile changes where I<decision> is either B<install> or B<keep>."
  5624. msgstr ""
  5625. #. type: TP
  5626. #: dpkg.man:1
  5627. #, no-wrap
  5628. msgid "B<--no-debsig>"
  5629. msgstr ""
  5630. #. type: Plain text
  5631. #: dpkg.man:1
  5632. msgid "Do not try to verify package signatures."
  5633. msgstr ""
  5634. #. type: TP
  5635. #: dpkg.man:1
  5636. #, no-wrap
  5637. msgid "B<--no-triggers>"
  5638. msgstr ""
  5639. #. type: Plain text
  5640. #: dpkg.man:1
  5641. msgid ""
  5642. "Do not run any triggers in this run (since dpkg 1.14.17), but activations "
  5643. "will still be recorded. If used with B<--configure> I<package> or "
  5644. "B<--triggers-only> I<package> then the named package postinst will still be "
  5645. "run even if only a triggers run is needed. Use of this option may leave "
  5646. "packages in the improper B<triggers-awaited> and B<triggers-pending> "
  5647. "states. This can be fixed later by running: B<dpkg --configure --pending>."
  5648. msgstr ""
  5649. #. type: TP
  5650. #: dpkg.man:1
  5651. #, no-wrap
  5652. msgid "B<--triggers>"
  5653. msgstr ""
  5654. #. type: Plain text
  5655. #: dpkg.man:1
  5656. msgid "Cancels a previous B<--no-triggers> (since dpkg 1.14.17)."
  5657. msgstr ""
  5658. #. type: SH
  5659. #: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
  5660. #: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
  5661. #: start-stop-daemon.man:1 update-alternatives.man:1
  5662. #, no-wrap
  5663. msgid "EXIT STATUS"
  5664. msgstr ""
  5665. #. type: TP
  5666. #: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
  5667. #: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
  5668. #: start-stop-daemon.man:1 start-stop-daemon.man:1 update-alternatives.man:1
  5669. #, no-wrap
  5670. msgid "B<0>"
  5671. msgstr ""
  5672. #. type: Plain text
  5673. #: dpkg.man:1 dpkg-trigger.man:1
  5674. msgid ""
  5675. "The requested action was successfully performed. Or a check or assertion "
  5676. "command returned true."
  5677. msgstr ""
  5678. #. type: TP
  5679. #: dpkg.man:1 dpkg-query.man:1 dpkg-split.man:1 dpkg-statoverride.man:1
  5680. #: dpkg-trigger.man:1 start-stop-daemon.man:1 start-stop-daemon.man:1
  5681. #, no-wrap
  5682. msgid "B<1>"
  5683. msgstr ""
  5684. #. type: Plain text
  5685. #: dpkg.man:1 dpkg-trigger.man:1
  5686. msgid "A check or assertion command returned false."
  5687. msgstr ""
  5688. #. type: TP
  5689. #: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
  5690. #: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
  5691. #: start-stop-daemon.man:1 update-alternatives.man:1
  5692. #, no-wrap
  5693. msgid "B<2>"
  5694. msgstr ""
  5695. #. type: Plain text
  5696. #: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
  5697. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
  5698. msgid ""
  5699. "Fatal or unrecoverable error due to invalid command-line usage, or "
  5700. "interactions with the system, such as accesses to the database, memory "
  5701. "allocations, etc."
  5702. msgstr ""
  5703. #. type: SH
  5704. #: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildflags.man:1
  5705. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1
  5706. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-gensymbols.man:1 dpkg-query.man:1
  5707. #: dpkg-source.man:1 dpkg-split.man:1 dpkg-statoverride.man:1
  5708. #: dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1 update-alternatives.man:1
  5709. #, no-wrap
  5710. msgid "ENVIRONMENT"
  5711. msgstr ""
  5712. #. type: SS
  5713. #: dpkg.man:1 dpkg-buildpackage.man:1
  5714. #, no-wrap
  5715. msgid "External environment"
  5716. msgstr ""
  5717. #. type: TP
  5718. #: dpkg.man:1
  5719. #, no-wrap
  5720. msgid "B<PATH>"
  5721. msgstr ""
  5722. #. type: Plain text
  5723. #: dpkg.man:1
  5724. msgid ""
  5725. "This variable is expected to be defined in the environment and point to the "
  5726. "system paths where several required programs are to be found. If it's not "
  5727. "set or the programs are not found, B<dpkg> will abort."
  5728. msgstr ""
  5729. #. type: TP
  5730. #: dpkg.man:1 dselect.man:1
  5731. #, no-wrap
  5732. msgid "B<HOME>"
  5733. msgstr ""
  5734. #. type: Plain text
  5735. #: dpkg.man:1
  5736. msgid ""
  5737. "If set, B<dpkg> will use it as the directory from which to read the user "
  5738. "specific configuration file."
  5739. msgstr ""
  5740. #. type: TP
  5741. #: dpkg.man:1 dpkg-deb.man:1
  5742. #, no-wrap
  5743. msgid "B<TMPDIR>"
  5744. msgstr ""
  5745. #. type: Plain text
  5746. #: dpkg.man:1
  5747. msgid ""
  5748. "If set, B<dpkg> will use it as the directory in which to create temporary "
  5749. "files and directories."
  5750. msgstr ""
  5751. #. type: TP
  5752. #: dpkg.man:1
  5753. #, no-wrap
  5754. msgid "B<PAGER>"
  5755. msgstr ""
  5756. #. type: Plain text
  5757. #: dpkg.man:1
  5758. msgid "The program B<dpkg> will execute when displaying the conffiles."
  5759. msgstr ""
  5760. #. type: TP
  5761. #: dpkg.man:1
  5762. #, no-wrap
  5763. msgid "B<SHELL>"
  5764. msgstr ""
  5765. #. type: Plain text
  5766. #: dpkg.man:1
  5767. msgid "The program B<dpkg> will execute when starting a new interactive shell."
  5768. msgstr ""
  5769. #. type: TP
  5770. #: dpkg.man:1 dpkg-query.man:1
  5771. #, no-wrap
  5772. msgid "B<COLUMNS>"
  5773. msgstr ""
  5774. #. type: Plain text
  5775. #: dpkg.man:1
  5776. msgid ""
  5777. "Sets the number of columns B<dpkg> should use when displaying formatted "
  5778. "text. Currently only used by B<--list>."
  5779. msgstr ""
  5780. #. type: TP
  5781. #: dpkg.man:1 dpkg-buildpackage.man:1
  5782. #, no-wrap
  5783. msgid "B<DPKG_COLORS>"
  5784. msgstr ""
  5785. #. type: Plain text
  5786. #: dpkg.man:1 dpkg-buildpackage.man:1
  5787. msgid ""
  5788. "Sets the color mode (since dpkg 1.18.5). The currently accepted values are: "
  5789. "B<auto> (default), B<always> and B<never>."
  5790. msgstr ""
  5791. #. type: SS
  5792. #: dpkg.man:1 dpkg-buildpackage.man:1
  5793. #, no-wrap
  5794. msgid "Internal environment"
  5795. msgstr ""
  5796. #. type: TP
  5797. #: dpkg.man:1
  5798. #, no-wrap
  5799. msgid "B<DPKG_ROOT>"
  5800. msgstr ""
  5801. #. type: Plain text
  5802. #: dpkg.man:1
  5803. msgid ""
  5804. "Defined by B<dpkg> on the maintainer script environment to indicate which "
  5805. "installation to act on (since dpkg 1.18.5). The value is intended to be "
  5806. "prepended to any path maintainer scripts operate on. During normal "
  5807. "operation, this variable is empty. When installing packages into a "
  5808. "different B<instdir>, B<dpkg> normally invokes maintainer scripts using "
  5809. "B<chroot>(2) and leaves this variable empty, but if "
  5810. "B<--force-script-chrootless> is specified then the B<chroot>(2) call is "
  5811. "skipped and B<instdir> is non-empty."
  5812. msgstr ""
  5813. #. type: TP
  5814. #: dpkg.man:1 dpkg-divert.man:1 dpkg-query.man:1 dpkg-statoverride.man:1
  5815. #: dpkg-trigger.man:1 update-alternatives.man:1
  5816. #, no-wrap
  5817. msgid "B<DPKG_ADMINDIR>"
  5818. msgstr ""
  5819. #. type: Plain text
  5820. #: dpkg.man:1
  5821. msgid ""
  5822. "Defined by B<dpkg> on the maintainer script environment to indicate the "
  5823. "B<dpkg> administrative directory to use (since dpkg 1.16.0). This variable "
  5824. "is always set to the current B<--admindir> value."
  5825. msgstr ""
  5826. #. type: TP
  5827. #: dpkg.man:1
  5828. #, no-wrap
  5829. msgid "B<DPKG_SHELL_REASON>"
  5830. msgstr ""
  5831. #. type: Plain text
  5832. #: dpkg.man:1
  5833. msgid ""
  5834. "Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
  5835. "the situation (since dpkg 1.15.6). Current valid value: B<conffile-prompt>."
  5836. msgstr ""
  5837. #. type: TP
  5838. #: dpkg.man:1
  5839. #, no-wrap
  5840. msgid "B<DPKG_CONFFILE_OLD>"
  5841. msgstr ""
  5842. #. type: Plain text
  5843. #: dpkg.man:1
  5844. msgid ""
  5845. "Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
  5846. "the situation (since dpkg 1.15.6). Contains the path to the old conffile."
  5847. msgstr ""
  5848. #. type: TP
  5849. #: dpkg.man:1
  5850. #, no-wrap
  5851. msgid "B<DPKG_CONFFILE_NEW>"
  5852. msgstr ""
  5853. #. type: Plain text
  5854. #: dpkg.man:1
  5855. msgid ""
  5856. "Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
  5857. "the situation (since dpkg 1.15.6). Contains the path to the new conffile."
  5858. msgstr ""
  5859. #. type: TP
  5860. #: dpkg.man:1
  5861. #, no-wrap
  5862. msgid "B<DPKG_HOOK_ACTION>"
  5863. msgstr ""
  5864. #. type: Plain text
  5865. #: dpkg.man:1
  5866. msgid ""
  5867. "Defined by B<dpkg> on the shell spawned when executing a hook action (since "
  5868. "dpkg 1.15.4). Contains the current B<dpkg> action."
  5869. msgstr ""
  5870. #. type: TP
  5871. #: dpkg.man:1
  5872. #, no-wrap
  5873. msgid "B<DPKG_RUNNING_VERSION>"
  5874. msgstr ""
  5875. #. type: Plain text
  5876. #: dpkg.man:1
  5877. msgid ""
  5878. "Defined by B<dpkg> on the maintainer script environment to the version of "
  5879. "the currently running B<dpkg> instance (since dpkg 1.14.17)."
  5880. msgstr ""
  5881. #. type: TP
  5882. #: dpkg.man:1 dpkg-divert.man:1
  5883. #, no-wrap
  5884. msgid "B<DPKG_MAINTSCRIPT_PACKAGE>"
  5885. msgstr ""
  5886. #. type: Plain text
  5887. #: dpkg.man:1
  5888. msgid ""
  5889. "Defined by B<dpkg> on the maintainer script environment to the "
  5890. "(non-arch-qualified) package name being handled (since dpkg 1.14.17)."
  5891. msgstr ""
  5892. #. type: TP
  5893. #: dpkg.man:1
  5894. #, no-wrap
  5895. msgid "B<DPKG_MAINTSCRIPT_PACKAGE_REFCOUNT>"
  5896. msgstr ""
  5897. #. type: Plain text
  5898. #: dpkg.man:1
  5899. msgid ""
  5900. "Defined by B<dpkg> on the maintainer script environment to the package "
  5901. "reference count, i.e. the number of package instances with a state greater "
  5902. "than B<not-installed> (since dpkg 1.17.2)."
  5903. msgstr ""
  5904. #. type: TP
  5905. #: dpkg.man:1
  5906. #, no-wrap
  5907. msgid "B<DPKG_MAINTSCRIPT_ARCH>"
  5908. msgstr ""
  5909. #. type: Plain text
  5910. #: dpkg.man:1
  5911. msgid ""
  5912. "Defined by B<dpkg> on the maintainer script environment to the architecture "
  5913. "the package got built for (since dpkg 1.15.4)."
  5914. msgstr ""
  5915. #. type: TP
  5916. #: dpkg.man:1
  5917. #, no-wrap
  5918. msgid "B<DPKG_MAINTSCRIPT_NAME>"
  5919. msgstr ""
  5920. #. type: Plain text
  5921. #: dpkg.man:1
  5922. msgid ""
  5923. "Defined by B<dpkg> on the maintainer script environment to the name of the "
  5924. "script running, one of B<preinst>, B<postinst>, B<prerm> or B<postrm> (since "
  5925. "dpkg 1.15.7)."
  5926. msgstr ""
  5927. #. type: TP
  5928. #: dpkg.man:1
  5929. #, no-wrap
  5930. msgid "B<DPKG_MAINTSCRIPT_DEBUG>"
  5931. msgstr ""
  5932. #. type: Plain text
  5933. #: dpkg.man:1
  5934. msgid ""
  5935. "Defined by B<dpkg> on the maintainer script environment to a value (‘B<0>’ "
  5936. "or ‘B<1>’) noting whether debugging has been requested (with the B<--debug> "
  5937. "option) for the maintainer scripts (since dpkg 1.18.4)."
  5938. msgstr ""
  5939. #. type: Plain text
  5940. #: dpkg.man:1 dpkg.cfg.man:1
  5941. #, no-wrap
  5942. msgid "I<%PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*>"
  5943. msgstr ""
  5944. #. type: Plain text
  5945. #: dpkg.man:1
  5946. msgid "Configuration fragment files (since dpkg 1.15.4)."
  5947. msgstr ""
  5948. #. type: Plain text
  5949. #: dpkg.man:1 dpkg.cfg.man:1
  5950. #, no-wrap
  5951. msgid "I<%PKGCONFDIR%/dpkg.cfg>"
  5952. msgstr ""
  5953. #. type: Plain text
  5954. #: dpkg.man:1
  5955. msgid "Configuration file with default options."
  5956. msgstr ""
  5957. #. type: TP
  5958. #: dpkg.man:1
  5959. #, no-wrap
  5960. msgid "I<%LOGDIR%/dpkg.log>"
  5961. msgstr ""
  5962. #. type: Plain text
  5963. #: dpkg.man:1
  5964. msgid "Default log file (see I<%PKGCONFDIR%/dpkg.cfg> and option B<--log>)."
  5965. msgstr ""
  5966. #. type: Plain text
  5967. #: dpkg.man:1
  5968. msgid ""
  5969. "The other files listed below are in their default directories, see option "
  5970. "B<--admindir> to see how to change locations of these files."
  5971. msgstr ""
  5972. #. type: TP
  5973. #: dpkg.man:1
  5974. #, no-wrap
  5975. msgid "I<%ADMINDIR%/available>"
  5976. msgstr ""
  5977. #. type: Plain text
  5978. #: dpkg.man:1
  5979. msgid "List of available packages."
  5980. msgstr ""
  5981. #. type: TP
  5982. #: dpkg.man:1
  5983. #, no-wrap
  5984. msgid "I<%ADMINDIR%/status>"
  5985. msgstr ""
  5986. #. type: Plain text
  5987. #: dpkg.man:1
  5988. msgid ""
  5989. "Statuses of available packages. This file contains information about whether "
  5990. "a package is marked for removing or not, whether it is installed or not, "
  5991. "etc. See section B<INFORMATION ABOUT PACKAGES> for more info."
  5992. msgstr ""
  5993. #. type: Plain text
  5994. #: dpkg.man:1
  5995. msgid ""
  5996. "The status file is backed up daily in I</var/backups>. It can be useful if "
  5997. "it's lost or corrupted due to filesystems troubles."
  5998. msgstr ""
  5999. #. type: Plain text
  6000. #: dpkg.man:1
  6001. msgid "The format and contents of a binary package are described in B<deb>(5)."
  6002. msgstr ""
  6003. #. type: Plain text
  6004. #: dpkg.man:1
  6005. msgid "B<--no-act> usually gives less information than might be helpful."
  6006. msgstr ""
  6007. #. type: Plain text
  6008. #: dpkg.man:1
  6009. msgid ""
  6010. "To list installed packages related to the editor B<vi>(1) (note that "
  6011. "B<dpkg-query> does not load the I<available> file anymore by default, and "
  6012. "the B<dpkg-query> B<--load-avail> option should be used instead for that):"
  6013. msgstr ""
  6014. #. type: Plain text
  6015. #: dpkg.man:1
  6016. #, no-wrap
  6017. msgid " B<dpkg -l '*vi*'>\n"
  6018. msgstr ""
  6019. #. type: Plain text
  6020. #: dpkg.man:1
  6021. msgid "To see the entries in I<%ADMINDIR%/available> of two packages:"
  6022. msgstr ""
  6023. #. type: Plain text
  6024. #: dpkg.man:1
  6025. #, no-wrap
  6026. msgid " B<dpkg --print-avail elvis vim | less>\n"
  6027. msgstr ""
  6028. #. type: Plain text
  6029. #: dpkg.man:1
  6030. msgid "To search the listing of packages yourself:"
  6031. msgstr ""
  6032. #. type: Plain text
  6033. #: dpkg.man:1
  6034. #, no-wrap
  6035. msgid " B<less %ADMINDIR%/available>\n"
  6036. msgstr ""
  6037. #. type: Plain text
  6038. #: dpkg.man:1
  6039. msgid "To remove an installed elvis package:"
  6040. msgstr ""
  6041. #. type: Plain text
  6042. #: dpkg.man:1
  6043. #, no-wrap
  6044. msgid " B<dpkg -r elvis>\n"
  6045. msgstr ""
  6046. #. type: Plain text
  6047. #: dpkg.man:1
  6048. msgid ""
  6049. "To install a package, you first need to find it in an archive or CDROM. The "
  6050. "I<available> file shows that the vim package is in section B<editors>:"
  6051. msgstr ""
  6052. #. type: Plain text
  6053. #: dpkg.man:1
  6054. #, no-wrap
  6055. msgid ""
  6056. " B<cd /media/cdrom/pool/main/v/vim>\n"
  6057. " B<dpkg -i vim_4.5-3.deb>\n"
  6058. msgstr ""
  6059. #. type: Plain text
  6060. #: dpkg.man:1
  6061. msgid "To make a local copy of the package selection states:"
  6062. msgstr ""
  6063. #. type: Plain text
  6064. #: dpkg.man:1
  6065. #, no-wrap
  6066. msgid " B<dpkg --get-selections E<gt>myselections>\n"
  6067. msgstr ""
  6068. #. type: Plain text
  6069. #: dpkg.man:1
  6070. msgid ""
  6071. "You might transfer this file to another computer, and after having updated "
  6072. "the I<available> file there with your package manager frontend of choice "
  6073. "(see https://wiki.debian.org/Teams/Dpkg/FAQ for more details), for example:"
  6074. msgstr ""
  6075. #. type: Plain text
  6076. #: dpkg.man:1
  6077. #, no-wrap
  6078. msgid " B<apt-cache dumpavail | dpkg --merge-avail>\n"
  6079. msgstr ""
  6080. #. type: Plain text
  6081. #: dpkg.man:1
  6082. msgid "or with dpkg 1.17.6 and earlier:"
  6083. msgstr ""
  6084. #. type: Plain text
  6085. #: dpkg.man:1
  6086. #, no-wrap
  6087. msgid ""
  6088. " B<avail=`mktemp`>\n"
  6089. " B<apt-cache dumpavail E<gt>\"$avail\">\n"
  6090. " B<dpkg --merge-avail \"$avail\">\n"
  6091. " B<rm \"$avail\">\n"
  6092. msgstr ""
  6093. #. type: Plain text
  6094. #: dpkg.man:1
  6095. msgid "you can install it with:"
  6096. msgstr ""
  6097. #. type: Plain text
  6098. #: dpkg.man:1
  6099. #, no-wrap
  6100. msgid ""
  6101. " B<dpkg --clear-selections>\n"
  6102. " B<dpkg --set-selections E<lt>myselections>\n"
  6103. msgstr ""
  6104. #. type: Plain text
  6105. #: dpkg.man:1
  6106. msgid ""
  6107. "Note that this will not actually install or remove anything, but just set "
  6108. "the selection state on the requested packages. You will need some other "
  6109. "application to actually download and install the requested packages. For "
  6110. "example, run B<apt-get dselect-upgrade>."
  6111. msgstr ""
  6112. #. type: Plain text
  6113. #: dpkg.man:1
  6114. msgid ""
  6115. "Ordinarily, you will find that B<dselect>(1) provides a more convenient way "
  6116. "to modify the package selection states."
  6117. msgstr ""
  6118. #. type: SH
  6119. #: dpkg.man:1
  6120. #, no-wrap
  6121. msgid "ADDITIONAL FUNCTIONALITY"
  6122. msgstr ""
  6123. #. type: Plain text
  6124. #: dpkg.man:1
  6125. msgid ""
  6126. "Additional functionality can be gained by installing any of the following "
  6127. "packages: B<apt>, B<aptitude> and B<debsums>."
  6128. msgstr ""
  6129. #. type: Plain text
  6130. #: dpkg.man:1
  6131. msgid ""
  6132. "B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), "
  6133. "B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), and B<dpkg-reconfigure>(8)."
  6134. msgstr ""
  6135. #. type: SH
  6136. #: dpkg.man:1
  6137. #, no-wrap
  6138. msgid "AUTHORS"
  6139. msgstr ""
  6140. #. type: Plain text
  6141. #: dpkg.man:1
  6142. msgid ""
  6143. "See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to "
  6144. "B<dpkg>."
  6145. msgstr ""
  6146. #. type: TH
  6147. #: dpkg-architecture.man:1
  6148. #, no-wrap
  6149. msgid "dpkg-architecture"
  6150. msgstr ""
  6151. #. type: Plain text
  6152. #: dpkg-architecture.man:1
  6153. msgid "dpkg-architecture - set and determine the architecture for package building"
  6154. msgstr ""
  6155. #. type: Plain text
  6156. #: dpkg-architecture.man:1
  6157. msgid "B<dpkg-architecture> [I<option>...] [I<command>]"
  6158. msgstr ""
  6159. #. type: Plain text
  6160. #: dpkg-architecture.man:1
  6161. msgid ""
  6162. "B<dpkg-architecture> provides a facility to determine and set the build and "
  6163. "host architecture for package building."
  6164. msgstr ""
  6165. #. type: Plain text
  6166. #: dpkg-architecture.man:1
  6167. msgid ""
  6168. "The build architecture is always determined by an external call to "
  6169. "B<dpkg>(1), and cannot be set at the command line."
  6170. msgstr ""
  6171. #. type: Plain text
  6172. #: dpkg-architecture.man:1
  6173. msgid ""
  6174. "You can specify the host architecture by providing one or both of the "
  6175. "options B<--host-arch> and B<--host-type>. The default is determined by an "
  6176. "external call to B<gcc>(1), or the same as the build architecture if B<CC> "
  6177. "or gcc are both not available. One out of B<--host-arch> and B<--host-type> "
  6178. "is sufficient, the value of the other will be set to a usable "
  6179. "default. Indeed, it is often better to only specify one, because "
  6180. "B<dpkg-architecture> will warn you if your choice does not match the "
  6181. "default."
  6182. msgstr ""
  6183. #. type: SH
  6184. #: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-deb.man:1
  6185. #: dpkg-divert.man:1 dpkg-query.man:1 dpkg-source.man:1 dpkg-split.man:1
  6186. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
  6187. #: start-stop-daemon.man:1 update-alternatives.man:1
  6188. #, no-wrap
  6189. msgid "COMMANDS"
  6190. msgstr ""
  6191. #. type: TP
  6192. #: dpkg-architecture.man:1
  6193. #, no-wrap
  6194. msgid "B<-l>, B<--list>"
  6195. msgstr ""
  6196. #. type: Plain text
  6197. #: dpkg-architecture.man:1
  6198. msgid ""
  6199. "Print the environment variables, one each line, in the format "
  6200. "I<VARIABLE=value>. This is the default action."
  6201. msgstr ""
  6202. #. type: TP
  6203. #: dpkg-architecture.man:1
  6204. #, no-wrap
  6205. msgid "B<-e>, B<--equal> I<architecture>"
  6206. msgstr ""
  6207. #. type: Plain text
  6208. #: dpkg-architecture.man:1
  6209. msgid ""
  6210. "Check for equality of architecture (since dpkg 1.13.13). It compares the "
  6211. "current or specified Debian host architecture against I<architecture>, to "
  6212. "check if they are equal. This action will not expand the architecture "
  6213. "wildcards. Command finishes with an exit status of 0 if matched, 1 if not "
  6214. "matched."
  6215. msgstr ""
  6216. #. type: TP
  6217. #: dpkg-architecture.man:1
  6218. #, no-wrap
  6219. msgid "B<-i>, B<--is> I<architecture-wildcard>"
  6220. msgstr ""
  6221. #. type: Plain text
  6222. #: dpkg-architecture.man:1
  6223. msgid ""
  6224. "Check for identity of architecture (since dpkg 1.13.13). It compares the "
  6225. "current or specified Debian host architecture against "
  6226. "I<architecture-wildcard> after having expanded it as an architecture "
  6227. "wildcard, to check if they match. Command finishes with an exit status of 0 "
  6228. "if matched, 1 if not matched."
  6229. msgstr ""
  6230. #. type: TP
  6231. #: dpkg-architecture.man:1
  6232. #, no-wrap
  6233. msgid "B<-q>, B<--query> I<variable-name>"
  6234. msgstr ""
  6235. #. type: Plain text
  6236. #: dpkg-architecture.man:1
  6237. msgid "Print the value of a single variable."
  6238. msgstr ""
  6239. #. type: TP
  6240. #: dpkg-architecture.man:1
  6241. #, no-wrap
  6242. msgid "B<-s>, B<--print-set>"
  6243. msgstr ""
  6244. #. type: Plain text
  6245. #: dpkg-architecture.man:1
  6246. msgid ""
  6247. "Print an export command. This can be used to set the environment variables "
  6248. "using eval."
  6249. msgstr ""
  6250. #. type: TP
  6251. #: dpkg-architecture.man:1
  6252. #, no-wrap
  6253. msgid "B<-u>, B<--print-unset>"
  6254. msgstr ""
  6255. #. type: Plain text
  6256. #: dpkg-architecture.man:1
  6257. msgid "Print a similar command to B<--print-unset> but to unset all variables."
  6258. msgstr ""
  6259. #. type: TP
  6260. #: dpkg-architecture.man:1
  6261. #, no-wrap
  6262. msgid "B<-c>, B<--command> I<command>"
  6263. msgstr ""
  6264. #. type: Plain text
  6265. #: dpkg-architecture.man:1
  6266. msgid ""
  6267. "Execute a I<command> in an environment which has all variables set to the "
  6268. "determined value."
  6269. msgstr ""
  6270. #. type: TP
  6271. #: dpkg-architecture.man:1
  6272. #, no-wrap
  6273. msgid "B<-L>, B<--list-known>"
  6274. msgstr ""
  6275. #. type: Plain text
  6276. #: dpkg-architecture.man:1
  6277. msgid ""
  6278. "Print a list of valid architecture names. Possibly restricted by one or "
  6279. "more of the matching options B<--match-wildcard>, B<--match-bits> or "
  6280. "B<--match-endian> (since dpkg 1.17.14)."
  6281. msgstr ""
  6282. #. type: Plain text
  6283. #: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
  6284. #: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
  6285. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  6286. #: dpkg-gensymbols.man:1 dpkg-mergechangelogs.man:1 dpkg-name.man:1
  6287. #: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
  6288. #: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-split.man:1
  6289. #: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1
  6290. #: update-alternatives.man:1
  6291. msgid "Show the usage message and exit."
  6292. msgstr ""
  6293. #. type: Plain text
  6294. #: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
  6295. #: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
  6296. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  6297. #: dpkg-gensymbols.man:1 dpkg-mergechangelogs.man:1 dpkg-name.man:1
  6298. #: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
  6299. #: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
  6300. #: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1
  6301. #: dpkg-vendor.man:1 update-alternatives.man:1
  6302. msgid "Show the version and exit."
  6303. msgstr ""
  6304. #. type: TP
  6305. #: dpkg-architecture.man:1 dpkg-buildpackage.man:1
  6306. #, no-wrap
  6307. msgid "B<-a>, B<--host-arch> I<architecture>"
  6308. msgstr ""
  6309. #. type: Plain text
  6310. #: dpkg-architecture.man:1
  6311. msgid "Set the host Debian architecture."
  6312. msgstr ""
  6313. #. type: TP
  6314. #: dpkg-architecture.man:1 dpkg-buildpackage.man:1
  6315. #, no-wrap
  6316. msgid "B<-t>, B<--host-type> I<gnu-system-type>"
  6317. msgstr ""
  6318. #. type: Plain text
  6319. #: dpkg-architecture.man:1
  6320. msgid "Set the host GNU system type."
  6321. msgstr ""
  6322. #. type: TP
  6323. #: dpkg-architecture.man:1
  6324. #, no-wrap
  6325. msgid "B<-A>, B<--target-arch> I<architecture>"
  6326. msgstr ""
  6327. #. type: Plain text
  6328. #: dpkg-architecture.man:1
  6329. msgid "Set the target Debian architecture (since dpkg 1.17.14)."
  6330. msgstr ""
  6331. #. type: TP
  6332. #: dpkg-architecture.man:1
  6333. #, no-wrap
  6334. msgid "B<-T>, B<--target-type> I<gnu-system-type>"
  6335. msgstr ""
  6336. #. type: Plain text
  6337. #: dpkg-architecture.man:1
  6338. msgid "Set the target GNU system type (since dpkg 1.17.14)."
  6339. msgstr ""
  6340. #. type: TP
  6341. #: dpkg-architecture.man:1
  6342. #, no-wrap
  6343. msgid "B<-W>, B<--match-wildcard> I<architecture-wildcard>"
  6344. msgstr ""
  6345. #. type: Plain text
  6346. #: dpkg-architecture.man:1
  6347. msgid ""
  6348. "Restrict the architectures listed by B<--list-known> to ones matching the "
  6349. "specified architecture wildcard (since dpkg 1.17.14)."
  6350. msgstr ""
  6351. #. type: TP
  6352. #: dpkg-architecture.man:1
  6353. #, no-wrap
  6354. msgid "B<-B>, B<--match-bits> I<architecture-bits>"
  6355. msgstr ""
  6356. #. type: Plain text
  6357. #: dpkg-architecture.man:1
  6358. msgid ""
  6359. "Restrict the architectures listed by B<--list-known> to ones with the "
  6360. "specified CPU bits (since dpkg 1.17.14). Either B<32> or B<64>."
  6361. msgstr ""
  6362. #. type: TP
  6363. #: dpkg-architecture.man:1
  6364. #, no-wrap
  6365. msgid "B<-E>, B<--match-endian> I<architecture-endianness>"
  6366. msgstr ""
  6367. #. type: Plain text
  6368. #: dpkg-architecture.man:1
  6369. msgid ""
  6370. "Restrict the architectures listed by B<--list-known> to ones with the "
  6371. "specified endianness (since dpkg 1.17.14). Either B<little> or B<big>."
  6372. msgstr ""
  6373. #. type: TP
  6374. #: dpkg-architecture.man:1
  6375. #, no-wrap
  6376. msgid "B<-f>, B<--force>"
  6377. msgstr ""
  6378. #. type: Plain text
  6379. #: dpkg-architecture.man:1
  6380. msgid ""
  6381. "Values set by existing environment variables with the same name as used by "
  6382. "the scripts are honored (i.e. used by B<dpkg-architecture>), except if this "
  6383. "force flag is present. This allows the user to override a value even when "
  6384. "the call to B<dpkg-architecture> is buried in some other script (for example "
  6385. "B<dpkg-buildpackage>(1))."
  6386. msgstr ""
  6387. #. type: SH
  6388. #: dpkg-architecture.man:1
  6389. #, no-wrap
  6390. msgid "TERMS"
  6391. msgstr ""
  6392. #. type: IP
  6393. #: dpkg-architecture.man:1
  6394. #, no-wrap
  6395. msgid "build machine"
  6396. msgstr ""
  6397. #. type: Plain text
  6398. #: dpkg-architecture.man:1
  6399. msgid "The machine the package is built on."
  6400. msgstr ""
  6401. #. type: IP
  6402. #: dpkg-architecture.man:1
  6403. #, no-wrap
  6404. msgid "host machine"
  6405. msgstr ""
  6406. #. type: Plain text
  6407. #: dpkg-architecture.man:1
  6408. msgid "The machine the package is built for."
  6409. msgstr ""
  6410. #. type: IP
  6411. #: dpkg-architecture.man:1
  6412. #, no-wrap
  6413. msgid "target machine"
  6414. msgstr ""
  6415. #. type: Plain text
  6416. #: dpkg-architecture.man:1
  6417. msgid ""
  6418. "The machine the compiler is building for. This is only needed when building "
  6419. "a cross-toolchain, one that will be built on the build architecture, to be "
  6420. "run on the host architecture, and to build code for the target architecture."
  6421. msgstr ""
  6422. #. type: IP
  6423. #: dpkg-architecture.man:1
  6424. #, no-wrap
  6425. msgid "Debian architecture"
  6426. msgstr ""
  6427. #. type: Plain text
  6428. #: dpkg-architecture.man:1
  6429. msgid ""
  6430. "The Debian architecture string, which specifies the binary tree in the FTP "
  6431. "archive. Examples: i386, sparc, hurd-i386."
  6432. msgstr ""
  6433. #. type: IP
  6434. #: dpkg-architecture.man:1
  6435. #, no-wrap
  6436. msgid "Debian architecture tuple"
  6437. msgstr ""
  6438. #. type: Plain text
  6439. #: dpkg-architecture.man:1
  6440. msgid ""
  6441. "A Debian architecture tuple is the fully qualified architecture with all its "
  6442. "components spelled out. This differs with Debian architectures in that at "
  6443. "least the I<cpu> component does not embed the I<abi>. The current tuple has "
  6444. "the form I<abi>-I<libc>-I<os>-I<cpu>. Examples: base-gnu-linux-amd64, "
  6445. "eabihf-musl-linux-arm."
  6446. msgstr ""
  6447. #. type: IP
  6448. #: dpkg-architecture.man:1
  6449. #, no-wrap
  6450. msgid "Debian architecture wildcard"
  6451. msgstr ""
  6452. #. type: Plain text
  6453. #: dpkg-architecture.man:1
  6454. msgid ""
  6455. "A Debian architecture wildcard is a special architecture string that will "
  6456. "match any real architecture being part of it. The general form is a Debian "
  6457. "architecture tuple with four or less elements, and with at least one of them "
  6458. "being B<any>. Missing elements of the tuple are prefixed implicitly as "
  6459. "B<any>, and thus the following pairs are equivalent:"
  6460. msgstr ""
  6461. #. type: Plain text
  6462. #: dpkg-architecture.man:1
  6463. #, no-wrap
  6464. msgid ""
  6465. " B<any>-B<any>-B<any>-B<any> = B<any>\n"
  6466. " B<any>-B<any>-I<os>-B<any> = I<os>-B<any>\n"
  6467. " B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>\n"
  6468. msgstr ""
  6469. #. type: Plain text
  6470. #: dpkg-architecture.man:1
  6471. msgid "Examples: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any."
  6472. msgstr ""
  6473. #. type: IP
  6474. #: dpkg-architecture.man:1
  6475. #, no-wrap
  6476. msgid "GNU system type"
  6477. msgstr ""
  6478. #. type: Plain text
  6479. #: dpkg-architecture.man:1
  6480. msgid ""
  6481. "An architecture specification string consisting of two parts separated by a "
  6482. "hyphen: cpu and system. Examples: i586-linux-gnu, sparc-linux-gnu, "
  6483. "i686-gnu, x86_64-netbsd."
  6484. msgstr ""
  6485. #. type: IP
  6486. #: dpkg-architecture.man:1
  6487. #, no-wrap
  6488. msgid "multiarch triplet"
  6489. msgstr ""
  6490. #. type: Plain text
  6491. #: dpkg-architecture.man:1
  6492. msgid ""
  6493. "The clarified GNU system type, used for filesystem paths. This triplet does "
  6494. "not change even when the baseline ISA gets bumped, so that the resulting "
  6495. "paths are stable over time. The only current difference with the GNU system "
  6496. "type is that the CPU part for i386 based systems is always i386. Examples: "
  6497. "i386-linux-gnu, x86_64-linux-gnu. Example paths: "
  6498. "/lib/powerpc64le-linux-gnu/, /usr/lib/i386-kfreebsd-gnu/."
  6499. msgstr ""
  6500. #. type: SH
  6501. #: dpkg-architecture.man:1
  6502. #, no-wrap
  6503. msgid "VARIABLES"
  6504. msgstr ""
  6505. #. type: Plain text
  6506. #: dpkg-architecture.man:1
  6507. msgid "The following variables are set by B<dpkg-architecture>:"
  6508. msgstr ""
  6509. #. type: IP
  6510. #: dpkg-architecture.man:1
  6511. #, no-wrap
  6512. msgid "B<DEB_BUILD_ARCH>"
  6513. msgstr ""
  6514. #. type: Plain text
  6515. #: dpkg-architecture.man:1
  6516. msgid "The Debian architecture of the build machine."
  6517. msgstr ""
  6518. #. type: IP
  6519. #: dpkg-architecture.man:1
  6520. #, no-wrap
  6521. msgid "B<DEB_BUILD_ARCH_ABI>"
  6522. msgstr ""
  6523. #. type: Plain text
  6524. #: dpkg-architecture.man:1
  6525. msgid "The Debian abi name of the build machine (since dpkg 1.18.11)."
  6526. msgstr ""
  6527. #. type: IP
  6528. #: dpkg-architecture.man:1
  6529. #, no-wrap
  6530. msgid "B<DEB_BUILD_ARCH_LIBC>"
  6531. msgstr ""
  6532. #. type: Plain text
  6533. #: dpkg-architecture.man:1
  6534. msgid "The Debian libc name of the build machine (since dpkg 1.18.11)."
  6535. msgstr ""
  6536. #. type: IP
  6537. #: dpkg-architecture.man:1
  6538. #, no-wrap
  6539. msgid "B<DEB_BUILD_ARCH_OS>"
  6540. msgstr ""
  6541. #. type: Plain text
  6542. #: dpkg-architecture.man:1
  6543. msgid "The Debian system name of the build machine (since dpkg 1.13.2)."
  6544. msgstr ""
  6545. #. type: IP
  6546. #: dpkg-architecture.man:1
  6547. #, no-wrap
  6548. msgid "B<DEB_BUILD_ARCH_CPU>"
  6549. msgstr ""
  6550. #. type: Plain text
  6551. #: dpkg-architecture.man:1
  6552. msgid "The Debian cpu name of the build machine (since dpkg 1.13.2)."
  6553. msgstr ""
  6554. #. type: IP
  6555. #: dpkg-architecture.man:1
  6556. #, no-wrap
  6557. msgid "B<DEB_BUILD_ARCH_BITS>"
  6558. msgstr ""
  6559. #. type: Plain text
  6560. #: dpkg-architecture.man:1
  6561. msgid "The pointer size of the build machine (in bits; since dpkg 1.15.4)."
  6562. msgstr ""
  6563. #. type: IP
  6564. #: dpkg-architecture.man:1
  6565. #, no-wrap
  6566. msgid "B<DEB_BUILD_ARCH_ENDIAN>"
  6567. msgstr ""
  6568. #. type: Plain text
  6569. #: dpkg-architecture.man:1
  6570. msgid "The endianness of the build machine (little / big; since dpkg 1.15.4)."
  6571. msgstr ""
  6572. #. type: IP
  6573. #: dpkg-architecture.man:1
  6574. #, no-wrap
  6575. msgid "B<DEB_BUILD_GNU_CPU>"
  6576. msgstr ""
  6577. #. type: Plain text
  6578. #: dpkg-architecture.man:1
  6579. msgid "The CPU part of B<DEB_BUILD_GNU_TYPE>."
  6580. msgstr ""
  6581. #. type: IP
  6582. #: dpkg-architecture.man:1
  6583. #, no-wrap
  6584. msgid "B<DEB_BUILD_GNU_SYSTEM>"
  6585. msgstr ""
  6586. #. type: Plain text
  6587. #: dpkg-architecture.man:1
  6588. msgid "The System part of B<DEB_BUILD_GNU_TYPE>."
  6589. msgstr ""
  6590. #. type: IP
  6591. #: dpkg-architecture.man:1
  6592. #, no-wrap
  6593. msgid "B<DEB_BUILD_GNU_TYPE>"
  6594. msgstr ""
  6595. #. type: Plain text
  6596. #: dpkg-architecture.man:1
  6597. msgid "The GNU system type of the build machine."
  6598. msgstr ""
  6599. #. type: IP
  6600. #: dpkg-architecture.man:1
  6601. #, no-wrap
  6602. msgid "B<DEB_BUILD_MULTIARCH>"
  6603. msgstr ""
  6604. #. type: Plain text
  6605. #: dpkg-architecture.man:1
  6606. msgid ""
  6607. "The clarified GNU system type of the build machine, used for filesystem "
  6608. "paths (since dpkg 1.16.0)."
  6609. msgstr ""
  6610. #. type: IP
  6611. #: dpkg-architecture.man:1
  6612. #, no-wrap
  6613. msgid "B<DEB_HOST_ARCH>"
  6614. msgstr ""
  6615. #. type: Plain text
  6616. #: dpkg-architecture.man:1
  6617. msgid "The Debian architecture of the host machine."
  6618. msgstr ""
  6619. #. type: IP
  6620. #: dpkg-architecture.man:1
  6621. #, no-wrap
  6622. msgid "B<DEB_HOST_ARCH_ABI>"
  6623. msgstr ""
  6624. #. type: Plain text
  6625. #: dpkg-architecture.man:1
  6626. msgid "The Debian abi name of the host machine (since dpkg 1.18.11)."
  6627. msgstr ""
  6628. #. type: IP
  6629. #: dpkg-architecture.man:1
  6630. #, no-wrap
  6631. msgid "B<DEB_HOST_ARCH_LIBC>"
  6632. msgstr ""
  6633. #. type: Plain text
  6634. #: dpkg-architecture.man:1
  6635. msgid "The Debian libc name of the host machine (since dpkg 1.18.11)."
  6636. msgstr ""
  6637. #. type: IP
  6638. #: dpkg-architecture.man:1
  6639. #, no-wrap
  6640. msgid "B<DEB_HOST_ARCH_OS>"
  6641. msgstr ""
  6642. #. type: Plain text
  6643. #: dpkg-architecture.man:1
  6644. msgid "The Debian system name of the host machine (since dpkg 1.13.2)."
  6645. msgstr ""
  6646. #. type: IP
  6647. #: dpkg-architecture.man:1
  6648. #, no-wrap
  6649. msgid "B<DEB_HOST_ARCH_CPU>"
  6650. msgstr ""
  6651. #. type: Plain text
  6652. #: dpkg-architecture.man:1
  6653. msgid "The Debian cpu name of the host machine (since dpkg 1.13.2)."
  6654. msgstr ""
  6655. #. type: IP
  6656. #: dpkg-architecture.man:1
  6657. #, no-wrap
  6658. msgid "B<DEB_HOST_ARCH_BITS>"
  6659. msgstr ""
  6660. #. type: Plain text
  6661. #: dpkg-architecture.man:1
  6662. msgid "The pointer size of the host machine (in bits; since dpkg 1.15.4)."
  6663. msgstr ""
  6664. #. type: IP
  6665. #: dpkg-architecture.man:1
  6666. #, no-wrap
  6667. msgid "B<DEB_HOST_ARCH_ENDIAN>"
  6668. msgstr ""
  6669. #. type: Plain text
  6670. #: dpkg-architecture.man:1
  6671. msgid "The endianness of the host machine (little / big; since dpkg 1.15.4)."
  6672. msgstr ""
  6673. #. type: IP
  6674. #: dpkg-architecture.man:1
  6675. #, no-wrap
  6676. msgid "B<DEB_HOST_GNU_CPU>"
  6677. msgstr ""
  6678. #. type: Plain text
  6679. #: dpkg-architecture.man:1
  6680. msgid "The CPU part of B<DEB_HOST_GNU_TYPE>."
  6681. msgstr ""
  6682. #. type: IP
  6683. #: dpkg-architecture.man:1
  6684. #, no-wrap
  6685. msgid "B<DEB_HOST_GNU_SYSTEM>"
  6686. msgstr ""
  6687. #. type: Plain text
  6688. #: dpkg-architecture.man:1
  6689. msgid "The System part of B<DEB_HOST_GNU_TYPE>."
  6690. msgstr ""
  6691. #. type: IP
  6692. #: dpkg-architecture.man:1
  6693. #, no-wrap
  6694. msgid "B<DEB_HOST_GNU_TYPE>"
  6695. msgstr ""
  6696. #. type: Plain text
  6697. #: dpkg-architecture.man:1
  6698. msgid "The GNU system type of the host machine."
  6699. msgstr ""
  6700. #. type: IP
  6701. #: dpkg-architecture.man:1
  6702. #, no-wrap
  6703. msgid "B<DEB_HOST_MULTIARCH>"
  6704. msgstr ""
  6705. #. type: Plain text
  6706. #: dpkg-architecture.man:1
  6707. msgid ""
  6708. "The clarified GNU system type of the host machine, used for filesystem paths "
  6709. "(since dpkg 1.16.0)."
  6710. msgstr ""
  6711. #. type: IP
  6712. #: dpkg-architecture.man:1
  6713. #, no-wrap
  6714. msgid "B<DEB_TARGET_ARCH>"
  6715. msgstr ""
  6716. #. type: Plain text
  6717. #: dpkg-architecture.man:1
  6718. msgid "The Debian architecture of the target machine (since dpkg 1.17.14)."
  6719. msgstr ""
  6720. #. type: IP
  6721. #: dpkg-architecture.man:1
  6722. #, no-wrap
  6723. msgid "B<DEB_TARGET_ARCH_ABI>"
  6724. msgstr ""
  6725. #. type: Plain text
  6726. #: dpkg-architecture.man:1
  6727. msgid "The Debian abi name of the target machine (since dpkg 1.18.11)."
  6728. msgstr ""
  6729. #. type: IP
  6730. #: dpkg-architecture.man:1
  6731. #, no-wrap
  6732. msgid "B<DEB_TARGET_ARCH_LIBC>"
  6733. msgstr ""
  6734. #. type: Plain text
  6735. #: dpkg-architecture.man:1
  6736. msgid "The Debian libc name of the target machine (since dpkg 1.18.11)."
  6737. msgstr ""
  6738. #. type: IP
  6739. #: dpkg-architecture.man:1
  6740. #, no-wrap
  6741. msgid "B<DEB_TARGET_ARCH_OS>"
  6742. msgstr ""
  6743. #. type: Plain text
  6744. #: dpkg-architecture.man:1
  6745. msgid "The Debian system name of the target machine (since dpkg 1.17.14)."
  6746. msgstr ""
  6747. #. type: IP
  6748. #: dpkg-architecture.man:1
  6749. #, no-wrap
  6750. msgid "B<DEB_TARGET_ARCH_CPU>"
  6751. msgstr ""
  6752. #. type: Plain text
  6753. #: dpkg-architecture.man:1
  6754. msgid "The Debian cpu name of the target machine (since dpkg 1.17.14)."
  6755. msgstr ""
  6756. #. type: IP
  6757. #: dpkg-architecture.man:1
  6758. #, no-wrap
  6759. msgid "B<DEB_TARGET_ARCH_BITS>"
  6760. msgstr ""
  6761. #. type: Plain text
  6762. #: dpkg-architecture.man:1
  6763. msgid "The pointer size of the target machine (in bits; since dpkg 1.17.14)."
  6764. msgstr ""
  6765. #. type: IP
  6766. #: dpkg-architecture.man:1
  6767. #, no-wrap
  6768. msgid "B<DEB_TARGET_ARCH_ENDIAN>"
  6769. msgstr ""
  6770. #. type: Plain text
  6771. #: dpkg-architecture.man:1
  6772. msgid "The endianness of the target machine (little / big; since dpkg 1.17.14)."
  6773. msgstr ""
  6774. #. type: IP
  6775. #: dpkg-architecture.man:1
  6776. #, no-wrap
  6777. msgid "B<DEB_TARGET_GNU_CPU>"
  6778. msgstr ""
  6779. #. type: Plain text
  6780. #: dpkg-architecture.man:1
  6781. msgid "The CPU part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
  6782. msgstr ""
  6783. #. type: IP
  6784. #: dpkg-architecture.man:1
  6785. #, no-wrap
  6786. msgid "B<DEB_TARGET_GNU_SYSTEM>"
  6787. msgstr ""
  6788. #. type: Plain text
  6789. #: dpkg-architecture.man:1
  6790. msgid "The System part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
  6791. msgstr ""
  6792. #. type: IP
  6793. #: dpkg-architecture.man:1
  6794. #, no-wrap
  6795. msgid "B<DEB_TARGET_GNU_TYPE>"
  6796. msgstr ""
  6797. #. type: Plain text
  6798. #: dpkg-architecture.man:1
  6799. msgid "The GNU system type of the target machine (since dpkg 1.17.14)."
  6800. msgstr ""
  6801. #. type: IP
  6802. #: dpkg-architecture.man:1
  6803. #, no-wrap
  6804. msgid "B<DEB_TARGET_MULTIARCH>"
  6805. msgstr ""
  6806. #. type: Plain text
  6807. #: dpkg-architecture.man:1
  6808. msgid ""
  6809. "The clarified GNU system type of the target machine, used for filesystem "
  6810. "paths (since dpkg 1.17.14)."
  6811. msgstr ""
  6812. #. type: SS
  6813. #: dpkg-architecture.man:1
  6814. #, no-wrap
  6815. msgid "Architecture tables"
  6816. msgstr ""
  6817. #. type: Plain text
  6818. #: dpkg-architecture.man:1
  6819. msgid ""
  6820. "All these files have to be present for B<dpkg-architecture> to work. Their "
  6821. "location can be overridden at runtime with the environment variable "
  6822. "B<DPKG_DATADIR>. These tables contain a format B<Version> pseudo-field on "
  6823. "their first line to mark their format, so that parsers can check if they "
  6824. "understand it, such as \"# Version=1.0\"."
  6825. msgstr ""
  6826. #. type: TP
  6827. #: dpkg-architecture.man:1
  6828. #, no-wrap
  6829. msgid "I<%PKGDATADIR%/cputable>"
  6830. msgstr ""
  6831. #. type: Plain text
  6832. #: dpkg-architecture.man:1
  6833. msgid ""
  6834. "Table of known CPU names and mapping to their GNU name. Format version 1.0 "
  6835. "(since dpkg 1.13.2)."
  6836. msgstr ""
  6837. #. type: TP
  6838. #: dpkg-architecture.man:1
  6839. #, no-wrap
  6840. msgid "I<%PKGDATADIR%/ostable>"
  6841. msgstr ""
  6842. #. type: Plain text
  6843. #: dpkg-architecture.man:1
  6844. msgid ""
  6845. "Table of known operating system names and mapping to their GNU name. Format "
  6846. "version 2.0 (since dpkg 1.18.11)."
  6847. msgstr ""
  6848. #. type: TP
  6849. #: dpkg-architecture.man:1
  6850. #, no-wrap
  6851. msgid "I<%PKGDATADIR%/tupletable>"
  6852. msgstr ""
  6853. #. type: Plain text
  6854. #: dpkg-architecture.man:1
  6855. msgid ""
  6856. "Mapping between Debian architecture tuples and Debian architecture names. "
  6857. "Format version 1.0 (since dpkg 1.18.11)."
  6858. msgstr ""
  6859. #. type: TP
  6860. #: dpkg-architecture.man:1
  6861. #, no-wrap
  6862. msgid "I<%PKGDATADIR%/abitable>"
  6863. msgstr ""
  6864. #. type: Plain text
  6865. #: dpkg-architecture.man:1
  6866. msgid ""
  6867. "Table of Debian architecture ABI attribute overrides. Format version 2.0 "
  6868. "(since dpkg 1.18.11)."
  6869. msgstr ""
  6870. #. type: SS
  6871. #: dpkg-architecture.man:1 dpkg-buildflags.man:1
  6872. #, no-wrap
  6873. msgid "Packaging support"
  6874. msgstr ""
  6875. #. type: TP
  6876. #: dpkg-architecture.man:1
  6877. #, no-wrap
  6878. msgid "I<%PKGDATADIR%/architecture.mk>"
  6879. msgstr ""
  6880. #. type: Plain text
  6881. #: dpkg-architecture.man:1
  6882. msgid ""
  6883. "Makefile snippet that properly sets and exports all the variables that "
  6884. "B<dpkg-architecture> outputs (since dpkg 1.16.1)."
  6885. msgstr ""
  6886. #. type: Plain text
  6887. #: dpkg-architecture.man:1
  6888. msgid ""
  6889. "B<dpkg-buildpackage> accepts the B<-a> option and passes it to "
  6890. "B<dpkg-architecture>. Other examples:"
  6891. msgstr ""
  6892. #. type: Plain text
  6893. #: dpkg-architecture.man:1
  6894. msgid "CC=i386-gnu-gcc dpkg-architecture -c debian/rules build"
  6895. msgstr ""
  6896. #. type: Plain text
  6897. #: dpkg-architecture.man:1
  6898. msgid "eval \\`dpkg-architecture -u\\`"
  6899. msgstr ""
  6900. #. type: Plain text
  6901. #: dpkg-architecture.man:1
  6902. msgid ""
  6903. "Check if the current or specified host architecture is equal to an "
  6904. "architecture:"
  6905. msgstr ""
  6906. #. type: Plain text
  6907. #: dpkg-architecture.man:1
  6908. msgid "dpkg-architecture -elinux-alpha"
  6909. msgstr ""
  6910. #. type: Plain text
  6911. #: dpkg-architecture.man:1
  6912. msgid "dpkg-architecture -amips -elinux-mips"
  6913. msgstr ""
  6914. #. type: Plain text
  6915. #: dpkg-architecture.man:1
  6916. msgid "Check if the current or specified host architecture is a Linux system:"
  6917. msgstr ""
  6918. #. type: Plain text
  6919. #: dpkg-architecture.man:1
  6920. msgid "dpkg-architecture -ilinux-any"
  6921. msgstr ""
  6922. #. type: Plain text
  6923. #: dpkg-architecture.man:1
  6924. msgid "dpkg-architecture -ai386 -ilinux-any"
  6925. msgstr ""
  6926. #. type: SS
  6927. #: dpkg-architecture.man:1 dpkg-buildflags.man:1
  6928. #, no-wrap
  6929. msgid "Usage in debian/rules"
  6930. msgstr ""
  6931. #. type: Plain text
  6932. #: dpkg-architecture.man:1
  6933. msgid ""
  6934. "The environment variables set by B<dpkg-architecture> are passed to "
  6935. "I<debian/rules> as make variables (see make documentation). However, you "
  6936. "should not rely on them, as this breaks manual invocation of the "
  6937. "script. Instead, you should always initialize them using "
  6938. "B<dpkg-architecture> with the B<-q> option. Here are some examples, which "
  6939. "also show how you can improve the cross compilation support in your package:"
  6940. msgstr ""
  6941. #. type: Plain text
  6942. #: dpkg-architecture.man:1
  6943. msgid "Retrieving the GNU system type and forwarding it to ./configure:"
  6944. msgstr ""
  6945. #. type: Plain text
  6946. #: dpkg-architecture.man:1
  6947. #, no-wrap
  6948. msgid ""
  6949. "DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)\n"
  6950. "DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)\n"
  6951. "[...]\n"
  6952. "ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))\n"
  6953. " confflags += --build=$(DEB_HOST_GNU_TYPE)\n"
  6954. "else\n"
  6955. " confflags += --build=$(DEB_BUILD_GNU_TYPE) \\e\n"
  6956. " --host=$(DEB_HOST_GNU_TYPE)\n"
  6957. "endif\n"
  6958. "[...]\n"
  6959. "\\&./configure $(confflags)\n"
  6960. msgstr ""
  6961. #. type: Plain text
  6962. #: dpkg-architecture.man:1
  6963. msgid "Doing something only for a specific architecture:"
  6964. msgstr ""
  6965. #. type: Plain text
  6966. #: dpkg-architecture.man:1
  6967. #, no-wrap
  6968. msgid "DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)\n"
  6969. msgstr ""
  6970. #. type: Plain text
  6971. #: dpkg-architecture.man:1 dpkg-architecture.man:1
  6972. #, no-wrap
  6973. msgid ""
  6974. "ifeq ($(DEB_HOST_ARCH),alpha)\n"
  6975. " [...]\n"
  6976. "endif\n"
  6977. msgstr ""
  6978. #. type: Plain text
  6979. #: dpkg-architecture.man:1
  6980. msgid ""
  6981. "or if you only need to check the CPU or OS type, use the "
  6982. "B<DEB_HOST_ARCH_CPU> or B<DEB_HOST_ARCH_OS> variables."
  6983. msgstr ""
  6984. #. type: Plain text
  6985. #: dpkg-architecture.man:1
  6986. msgid ""
  6987. "Note that you can also rely on an external Makefile snippet to properly set "
  6988. "all the variables that B<dpkg-architecture> can provide:"
  6989. msgstr ""
  6990. #. type: Plain text
  6991. #: dpkg-architecture.man:1
  6992. #, no-wrap
  6993. msgid "include %PKGDATADIR%/architecture.mk\n"
  6994. msgstr ""
  6995. #. type: Plain text
  6996. #: dpkg-architecture.man:1
  6997. msgid ""
  6998. "In any case, you should never use B<dpkg --print-architecture> to get "
  6999. "architecture information during a package build."
  7000. msgstr ""
  7001. #. type: TP
  7002. #: dpkg-architecture.man:1
  7003. #, no-wrap
  7004. msgid "B<DPKG_DATADIR>"
  7005. msgstr ""
  7006. #. type: Plain text
  7007. #: dpkg-architecture.man:1
  7008. msgid ""
  7009. "If set, it will be used as the B<dpkg> data directory, where the "
  7010. "architecture tables are located (since dpkg 1.14.17). Defaults to "
  7011. "«%PKGDATADIR%»."
  7012. msgstr ""
  7013. #. type: Plain text
  7014. #: dpkg-architecture.man:1
  7015. msgid "All long command and option names available only since dpkg 1.17.17."
  7016. msgstr ""
  7017. #. type: Plain text
  7018. #: dpkg-architecture.man:1
  7019. msgid "B<dpkg-buildpackage>(1), B<dpkg-cross>(1)."
  7020. msgstr ""
  7021. #. type: TH
  7022. #: dpkg.cfg.man:1
  7023. #, no-wrap
  7024. msgid "dpkg.cfg"
  7025. msgstr ""
  7026. #. type: Plain text
  7027. #: dpkg.cfg.man:1
  7028. msgid "dpkg.cfg - dpkg configuration file"
  7029. msgstr ""
  7030. #. type: Plain text
  7031. #: dpkg.cfg.man:1
  7032. msgid ""
  7033. "This file contains default options for dpkg. Each line contains a single "
  7034. "option which is exactly the same as a normal command line option for dpkg "
  7035. "except for the leading hyphens which are not used here. Quotes surrounding "
  7036. "option values are stripped. Comments are allowed by starting a line with a "
  7037. "hash sign (‘B<#>’)."
  7038. msgstr ""
  7039. #. type: Plain text
  7040. #: dpkg.cfg.man:1
  7041. msgid "I<~/.dpkg.cfg>"
  7042. msgstr ""
  7043. #. type: TH
  7044. #: dpkg-buildflags.man:1
  7045. #, no-wrap
  7046. msgid "dpkg-buildflags"
  7047. msgstr ""
  7048. #. type: Plain text
  7049. #: dpkg-buildflags.man:1
  7050. msgid "dpkg-buildflags - returns build flags to use during package build"
  7051. msgstr ""
  7052. #. type: Plain text
  7053. #: dpkg-buildflags.man:1
  7054. msgid "B<dpkg-buildflags> [I<option>...] [I<command>]"
  7055. msgstr ""
  7056. #. type: Plain text
  7057. #: dpkg-buildflags.man:1
  7058. msgid ""
  7059. "B<dpkg-buildflags> is a tool to retrieve compilation flags to use during "
  7060. "build of Debian packages."
  7061. msgstr ""
  7062. #. type: Plain text
  7063. #: dpkg-buildflags.man:1
  7064. msgid ""
  7065. "The default flags are defined by the vendor but they can be "
  7066. "extended/overridden in several ways:"
  7067. msgstr ""
  7068. #. type: IP
  7069. #: dpkg-buildflags.man:1
  7070. #, no-wrap
  7071. msgid "1."
  7072. msgstr ""
  7073. #. type: Plain text
  7074. #: dpkg-buildflags.man:1
  7075. msgid "system-wide with B<%PKGCONFDIR%/buildflags.conf>;"
  7076. msgstr ""
  7077. #. type: IP
  7078. #: dpkg-buildflags.man:1
  7079. #, no-wrap
  7080. msgid "2."
  7081. msgstr ""
  7082. #. type: Plain text
  7083. #: dpkg-buildflags.man:1
  7084. msgid ""
  7085. "for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where "
  7086. "B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;"
  7087. msgstr ""
  7088. #. type: IP
  7089. #: dpkg-buildflags.man:1
  7090. #, no-wrap
  7091. msgid "3."
  7092. msgstr ""
  7093. #. type: Plain text
  7094. #: dpkg-buildflags.man:1
  7095. msgid ""
  7096. "temporarily by the user with environment variables (see section "
  7097. "B<ENVIRONMENT>);"
  7098. msgstr ""
  7099. #. type: IP
  7100. #: dpkg-buildflags.man:1
  7101. #, no-wrap
  7102. msgid "4."
  7103. msgstr ""
  7104. #. type: Plain text
  7105. #: dpkg-buildflags.man:1
  7106. msgid ""
  7107. "dynamically by the package maintainer with environment variables set via "
  7108. "B<debian/rules> (see section B<ENVIRONMENT>)."
  7109. msgstr ""
  7110. #. type: Plain text
  7111. #: dpkg-buildflags.man:1
  7112. msgid "The configuration files can contain four types of directives:"
  7113. msgstr ""
  7114. #. type: TP
  7115. #: dpkg-buildflags.man:1
  7116. #, no-wrap
  7117. msgid "B<SET>I< flag value>"
  7118. msgstr ""
  7119. #. type: Plain text
  7120. #: dpkg-buildflags.man:1
  7121. msgid "Override the flag named I<flag> to have the value I<value>."
  7122. msgstr ""
  7123. #. type: TP
  7124. #: dpkg-buildflags.man:1
  7125. #, no-wrap
  7126. msgid "B<STRIP>I< flag value>"
  7127. msgstr ""
  7128. #. type: Plain text
  7129. #: dpkg-buildflags.man:1
  7130. msgid "Strip from the flag named I<flag> all the build flags listed in I<value>."
  7131. msgstr ""
  7132. #. type: TP
  7133. #: dpkg-buildflags.man:1
  7134. #, no-wrap
  7135. msgid "B<APPEND>I< flag value>"
  7136. msgstr ""
  7137. #. type: Plain text
  7138. #: dpkg-buildflags.man:1
  7139. msgid ""
  7140. "Extend the flag named I<flag> by appending the options given in I<value>. A "
  7141. "space is prepended to the appended value if the flag's current value is "
  7142. "non-empty."
  7143. msgstr ""
  7144. #. type: TP
  7145. #: dpkg-buildflags.man:1
  7146. #, no-wrap
  7147. msgid "B<PREPEND>I< flag value>"
  7148. msgstr ""
  7149. #. type: Plain text
  7150. #: dpkg-buildflags.man:1
  7151. msgid ""
  7152. "Extend the flag named I<flag> by prepending the options given in I<value>. "
  7153. "A space is appended to the prepended value if the flag's current value is "
  7154. "non-empty."
  7155. msgstr ""
  7156. #. type: Plain text
  7157. #: dpkg-buildflags.man:1
  7158. msgid ""
  7159. "The configuration files can contain comments on lines starting with a hash "
  7160. "(#). Empty lines are also ignored."
  7161. msgstr ""
  7162. #. type: TP
  7163. #: dpkg-buildflags.man:1
  7164. #, no-wrap
  7165. msgid "B<--dump>"
  7166. msgstr ""
  7167. #. type: Plain text
  7168. #: dpkg-buildflags.man:1
  7169. msgid ""
  7170. "Print to standard output all compilation flags and their values. It prints "
  7171. "one flag per line separated from its value by an equal sign "
  7172. "(“I<flag>=I<value>”). This is the default action."
  7173. msgstr ""
  7174. #. type: TP
  7175. #: dpkg-buildflags.man:1
  7176. #, no-wrap
  7177. msgid "B<--list>"
  7178. msgstr ""
  7179. #. type: Plain text
  7180. #: dpkg-buildflags.man:1
  7181. msgid ""
  7182. "Print the list of flags supported by the current vendor (one per line). See "
  7183. "the B<SUPPORTED FLAGS> section for more information about them."
  7184. msgstr ""
  7185. #. type: TP
  7186. #: dpkg-buildflags.man:1
  7187. #, no-wrap
  7188. msgid "B<--status>"
  7189. msgstr ""
  7190. #. type: Plain text
  7191. #: dpkg-buildflags.man:1
  7192. msgid ""
  7193. "Display any information that can be useful to explain the behaviour of "
  7194. "B<dpkg-buildflags> (since dpkg 1.16.5): relevant environment variables, "
  7195. "current vendor, state of all feature flags. Also print the resulting "
  7196. "compiler flags with their origin."
  7197. msgstr ""
  7198. #. type: Plain text
  7199. #: dpkg-buildflags.man:1
  7200. msgid ""
  7201. "This is intended to be run from B<debian/rules>, so that the build log keeps "
  7202. "a clear trace of the build flags used. This can be useful to diagnose "
  7203. "problems related to them."
  7204. msgstr ""
  7205. #. type: TP
  7206. #: dpkg-buildflags.man:1
  7207. #, no-wrap
  7208. msgid "B<--export=>I<format>"
  7209. msgstr ""
  7210. #. type: Plain text
  7211. #: dpkg-buildflags.man:1
  7212. msgid ""
  7213. "Print to standard output commands that can be used to export all the "
  7214. "compilation flags for some particular tool. If the I<format> value is not "
  7215. "given, B<sh> is assumed. Only compilation flags starting with an upper case "
  7216. "character are included, others are assumed to not be suitable for the "
  7217. "environment. Supported formats:"
  7218. msgstr ""
  7219. #. type: TP
  7220. #: dpkg-buildflags.man:1
  7221. #, no-wrap
  7222. msgid "B<sh>"
  7223. msgstr ""
  7224. #. type: Plain text
  7225. #: dpkg-buildflags.man:1
  7226. msgid ""
  7227. "Shell commands to set and export all the compilation flags in the "
  7228. "environment. The flag values are quoted so the output is ready for "
  7229. "evaluation by a shell."
  7230. msgstr ""
  7231. #. type: TP
  7232. #: dpkg-buildflags.man:1
  7233. #, no-wrap
  7234. msgid "B<cmdline>"
  7235. msgstr ""
  7236. #. type: Plain text
  7237. #: dpkg-buildflags.man:1
  7238. msgid ""
  7239. "Arguments to pass to a build program's command line to use all the "
  7240. "compilation flags (since dpkg 1.17.0). The flag values are quoted in shell "
  7241. "syntax."
  7242. msgstr ""
  7243. #. type: TP
  7244. #: dpkg-buildflags.man:1
  7245. #, no-wrap
  7246. msgid "B<configure>"
  7247. msgstr ""
  7248. #. type: Plain text
  7249. #: dpkg-buildflags.man:1
  7250. msgid "This is a legacy alias for B<cmdline>."
  7251. msgstr ""
  7252. #. type: TP
  7253. #: dpkg-buildflags.man:1
  7254. #, no-wrap
  7255. msgid "B<make>"
  7256. msgstr ""
  7257. #. type: Plain text
  7258. #: dpkg-buildflags.man:1
  7259. msgid ""
  7260. "Make directives to set and export all the compilation flags in the "
  7261. "environment. Output can be written to a makefile fragment and evaluated "
  7262. "using an B<include> directive."
  7263. msgstr ""
  7264. #. type: TP
  7265. #: dpkg-buildflags.man:1
  7266. #, no-wrap
  7267. msgid "B<--get>I< flag>"
  7268. msgstr ""
  7269. #. type: Plain text
  7270. #: dpkg-buildflags.man:1
  7271. msgid ""
  7272. "Print the value of the flag on standard output. Exits with 0 if the flag is "
  7273. "known otherwise exits with 1."
  7274. msgstr ""
  7275. #. type: TP
  7276. #: dpkg-buildflags.man:1
  7277. #, no-wrap
  7278. msgid "B<--origin>I< flag>"
  7279. msgstr ""
  7280. #. type: Plain text
  7281. #: dpkg-buildflags.man:1
  7282. msgid ""
  7283. "Print the origin of the value that is returned by B<--get>. Exits with 0 if "
  7284. "the flag is known otherwise exits with 1. The origin can be one of the "
  7285. "following values:"
  7286. msgstr ""
  7287. #. type: TP
  7288. #: dpkg-buildflags.man:1
  7289. #, no-wrap
  7290. msgid "B<vendor>"
  7291. msgstr ""
  7292. #. type: Plain text
  7293. #: dpkg-buildflags.man:1
  7294. msgid "the original flag set by the vendor is returned;"
  7295. msgstr ""
  7296. #. type: TP
  7297. #: dpkg-buildflags.man:1
  7298. #, no-wrap
  7299. msgid "B<system>"
  7300. msgstr ""
  7301. #. type: Plain text
  7302. #: dpkg-buildflags.man:1
  7303. msgid "the flag is set/modified by a system-wide configuration;"
  7304. msgstr ""
  7305. #. type: TP
  7306. #: dpkg-buildflags.man:1
  7307. #, no-wrap
  7308. msgid "B<user>"
  7309. msgstr ""
  7310. #. type: Plain text
  7311. #: dpkg-buildflags.man:1
  7312. msgid "the flag is set/modified by a user-specific configuration;"
  7313. msgstr ""
  7314. #. type: TP
  7315. #: dpkg-buildflags.man:1
  7316. #, no-wrap
  7317. msgid "B<env>"
  7318. msgstr ""
  7319. #. type: Plain text
  7320. #: dpkg-buildflags.man:1
  7321. msgid "the flag is set/modified by an environment-specific configuration."
  7322. msgstr ""
  7323. #. type: TP
  7324. #: dpkg-buildflags.man:1
  7325. #, no-wrap
  7326. msgid "B<--query-features>I< area>"
  7327. msgstr ""
  7328. #. type: Plain text
  7329. #: dpkg-buildflags.man:1
  7330. msgid ""
  7331. "Print the features enabled for a given area (since dpkg 1.16.2). The only "
  7332. "currently recognized areas on Debian and derivatives are B<qa>, "
  7333. "B<reproducible>, B<sanitize> and B<hardening>, see the B<FEATURE AREAS> "
  7334. "section for more details. Exits with 0 if the area is known otherwise exits "
  7335. "with 1."
  7336. msgstr ""
  7337. #. type: Plain text
  7338. #: dpkg-buildflags.man:1
  7339. msgid "The output is in RFC822 format, with one section per feature. For example:"
  7340. msgstr ""
  7341. #. type: Plain text
  7342. #: dpkg-buildflags.man:1
  7343. #, no-wrap
  7344. msgid ""
  7345. " Feature: pie\n"
  7346. " Enabled: yes\n"
  7347. msgstr ""
  7348. #. type: Plain text
  7349. #: dpkg-buildflags.man:1
  7350. #, no-wrap
  7351. msgid ""
  7352. " Feature: stackprotector\n"
  7353. " Enabled: yes\n"
  7354. msgstr ""
  7355. #. type: TP
  7356. #: dpkg-buildflags.man:1 dpkg-mergechangelogs.man:1 dpkg-scansources.man:1
  7357. #: dpkg-statoverride.man:1 dpkg-vendor.man:1 update-alternatives.man:1
  7358. #, no-wrap
  7359. msgid "B<--help>"
  7360. msgstr ""
  7361. #. type: SH
  7362. #: dpkg-buildflags.man:1
  7363. #, no-wrap
  7364. msgid "SUPPORTED FLAGS"
  7365. msgstr ""
  7366. #. type: TP
  7367. #: dpkg-buildflags.man:1
  7368. #, no-wrap
  7369. msgid "B<CFLAGS>"
  7370. msgstr ""
  7371. #. type: Plain text
  7372. #: dpkg-buildflags.man:1
  7373. msgid ""
  7374. "Options for the C compiler. The default value set by the vendor includes "
  7375. "B<-g> and the default optimization level (B<-O2> usually, or B<-O0> if the "
  7376. "B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>)."
  7377. msgstr ""
  7378. #. type: TP
  7379. #: dpkg-buildflags.man:1
  7380. #, no-wrap
  7381. msgid "B<CPPFLAGS>"
  7382. msgstr ""
  7383. #. type: Plain text
  7384. #: dpkg-buildflags.man:1
  7385. msgid "Options for the C preprocessor. Default value: empty."
  7386. msgstr ""
  7387. #. type: TP
  7388. #: dpkg-buildflags.man:1
  7389. #, no-wrap
  7390. msgid "B<CXXFLAGS>"
  7391. msgstr ""
  7392. #. type: Plain text
  7393. #: dpkg-buildflags.man:1
  7394. msgid "Options for the C++ compiler. Same as B<CFLAGS>."
  7395. msgstr ""
  7396. #. type: TP
  7397. #: dpkg-buildflags.man:1
  7398. #, no-wrap
  7399. msgid "B<OBJCFLAGS>"
  7400. msgstr ""
  7401. #. type: Plain text
  7402. #: dpkg-buildflags.man:1
  7403. msgid "Options for the Objective C compiler. Same as B<CFLAGS>."
  7404. msgstr ""
  7405. #. type: TP
  7406. #: dpkg-buildflags.man:1
  7407. #, no-wrap
  7408. msgid "B<OBJCXXFLAGS>"
  7409. msgstr ""
  7410. #. type: Plain text
  7411. #: dpkg-buildflags.man:1
  7412. msgid "Options for the Objective C++ compiler. Same as B<CXXFLAGS>."
  7413. msgstr ""
  7414. #. type: TP
  7415. #: dpkg-buildflags.man:1
  7416. #, no-wrap
  7417. msgid "B<GCJFLAGS>"
  7418. msgstr ""
  7419. #. type: Plain text
  7420. #: dpkg-buildflags.man:1
  7421. msgid "Options for the GNU Java compiler (gcj). A subset of B<CFLAGS>."
  7422. msgstr ""
  7423. #. type: TP
  7424. #: dpkg-buildflags.man:1
  7425. #, no-wrap
  7426. msgid "B<FFLAGS>"
  7427. msgstr ""
  7428. #. type: Plain text
  7429. #: dpkg-buildflags.man:1
  7430. msgid "Options for the Fortran 77 compiler. A subset of B<CFLAGS>."
  7431. msgstr ""
  7432. #. type: TP
  7433. #: dpkg-buildflags.man:1
  7434. #, no-wrap
  7435. msgid "B<FCFLAGS>"
  7436. msgstr ""
  7437. #. type: Plain text
  7438. #: dpkg-buildflags.man:1
  7439. msgid "Options for the Fortran 9x compiler. Same as B<FFLAGS>."
  7440. msgstr ""
  7441. #. type: TP
  7442. #: dpkg-buildflags.man:1
  7443. #, no-wrap
  7444. msgid "B<LDFLAGS>"
  7445. msgstr ""
  7446. #. type: Plain text
  7447. #: dpkg-buildflags.man:1
  7448. msgid ""
  7449. "Options passed to the compiler when linking executables or shared objects "
  7450. "(if the linker is called directly, then B<-Wl> and B<,> have to be stripped "
  7451. "from these options). Default value: empty."
  7452. msgstr ""
  7453. #. type: Plain text
  7454. #: dpkg-buildflags.man:1
  7455. msgid ""
  7456. "New flags might be added in the future if the need arises (for example to "
  7457. "support other languages)."
  7458. msgstr ""
  7459. #. type: SH
  7460. #: dpkg-buildflags.man:1
  7461. #, no-wrap
  7462. msgid "FEATURE AREAS"
  7463. msgstr ""
  7464. #. type: Plain text
  7465. #: dpkg-buildflags.man:1
  7466. msgid ""
  7467. "Each area feature can be enabled and disabled in the B<DEB_BUILD_OPTIONS> "
  7468. "and B<DEB_BUILD_MAINT_OPTIONS> environment variable's area value with the "
  7469. "‘B<+>’ and ‘B<->’ modifier. For example, to enable the B<hardening> “pie” "
  7470. "feature and disable the “fortify” feature you can do this in "
  7471. "B<debian/rules>:"
  7472. msgstr ""
  7473. #. type: Plain text
  7474. #: dpkg-buildflags.man:1
  7475. #, no-wrap
  7476. msgid " export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify\n"
  7477. msgstr ""
  7478. #. type: Plain text
  7479. #: dpkg-buildflags.man:1
  7480. msgid ""
  7481. "The special feature B<all> (valid in any area) can be used to enable or "
  7482. "disable all area features at the same time. Thus disabling everything in "
  7483. "the B<hardening> area and enabling only “format” and “fortify” can be "
  7484. "achieved with:"
  7485. msgstr ""
  7486. #. type: Plain text
  7487. #: dpkg-buildflags.man:1
  7488. #, no-wrap
  7489. msgid " export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify\n"
  7490. msgstr ""
  7491. #. type: SS
  7492. #: dpkg-buildflags.man:1
  7493. #, no-wrap
  7494. msgid "qa"
  7495. msgstr ""
  7496. #. type: Plain text
  7497. #: dpkg-buildflags.man:1
  7498. msgid ""
  7499. "Several compile-time options (detailed below) can be used to help detect "
  7500. "problems in the source code or build system."
  7501. msgstr ""
  7502. #. type: TP
  7503. #: dpkg-buildflags.man:1
  7504. #, no-wrap
  7505. msgid "B<bug>"
  7506. msgstr ""
  7507. #. type: Plain text
  7508. #: dpkg-buildflags.man:1
  7509. msgid ""
  7510. "This setting (disabled by default) adds any warning option that reliably "
  7511. "detects problematic source code. The warnings are fatal. The only currently "
  7512. "supported flags are B<CFLAGS> and B<CXXFLAGS> with flags set to "
  7513. "B<-Werror=array-bounds>, B<-Werror=clobbered>, "
  7514. "B<-Werror=implicit-function-declaration> and "
  7515. "B<-Werror=volatile-register-var>."
  7516. msgstr ""
  7517. #. type: TP
  7518. #: dpkg-buildflags.man:1
  7519. #, no-wrap
  7520. msgid "B<canary>"
  7521. msgstr ""
  7522. #. type: Plain text
  7523. #: dpkg-buildflags.man:1
  7524. msgid ""
  7525. "This setting (disabled by default) adds dummy canary options to the build "
  7526. "flags, so that the build logs can be checked for how the build flags "
  7527. "propagate and to allow finding any omission of normal build flag settings. "
  7528. "The only currently supported flags are B<CPPFLAGS>, B<CFLAGS>, B<OBJCFLAGS>, "
  7529. "B<CXXFLAGS> and B<OBJCXXFLAGS> with flags set to "
  7530. "B<-D__DEB_CANARY_>I<flag>_I<random-id>B<__>, and B<LDFLAGS> set to "
  7531. "B<-Wl,-z,deb-canary->I<random-id>."
  7532. msgstr ""
  7533. #. type: SS
  7534. #: dpkg-buildflags.man:1
  7535. #, no-wrap
  7536. msgid "sanitize"
  7537. msgstr ""
  7538. #. type: Plain text
  7539. #: dpkg-buildflags.man:1
  7540. msgid ""
  7541. "Several compile-time options (detailed below) can be used to help sanitize a "
  7542. "resulting binary against memory corruptions, memory leaks, use after free, "
  7543. "threading data races and undefined behavior bugs."
  7544. msgstr ""
  7545. #. type: TP
  7546. #: dpkg-buildflags.man:1
  7547. #, no-wrap
  7548. msgid "B<address>"
  7549. msgstr ""
  7550. #. type: Plain text
  7551. #: dpkg-buildflags.man:1
  7552. msgid ""
  7553. "This setting (disabled by default) adds B<-fsanitize=address> to B<LDFLAGS> "
  7554. "and B<-fsanitize=address -fno-omit-frame-pointer> to B<CFLAGS> and "
  7555. "B<CXXFLAGS>."
  7556. msgstr ""
  7557. #. type: TP
  7558. #: dpkg-buildflags.man:1
  7559. #, no-wrap
  7560. msgid "B<thread>"
  7561. msgstr ""
  7562. #. type: Plain text
  7563. #: dpkg-buildflags.man:1
  7564. msgid ""
  7565. "This setting (disabled by default) adds B<-fsanitize=thread> to B<CFLAGS>, "
  7566. "B<CXXFLAGS> and B<LDFLAGS>."
  7567. msgstr ""
  7568. #. type: TP
  7569. #: dpkg-buildflags.man:1
  7570. #, no-wrap
  7571. msgid "B<leak>"
  7572. msgstr ""
  7573. #. type: Plain text
  7574. #: dpkg-buildflags.man:1
  7575. msgid ""
  7576. "This setting (disabled by default) adds B<-fsanitize=leak> to B<LDFLAGS>. It "
  7577. "gets automatically disabled if either the B<address> or the B<thread> "
  7578. "features are enabled, as they imply it."
  7579. msgstr ""
  7580. #. type: TP
  7581. #: dpkg-buildflags.man:1
  7582. #, no-wrap
  7583. msgid "B<undefined>"
  7584. msgstr ""
  7585. #. type: Plain text
  7586. #: dpkg-buildflags.man:1
  7587. msgid ""
  7588. "This setting (disabled by default) adds B<-fsanitize=undefined> to "
  7589. "B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>."
  7590. msgstr ""
  7591. #. type: SS
  7592. #: dpkg-buildflags.man:1
  7593. #, no-wrap
  7594. msgid "hardening"
  7595. msgstr ""
  7596. #. type: Plain text
  7597. #: dpkg-buildflags.man:1
  7598. msgid ""
  7599. "Several compile-time options (detailed below) can be used to help harden a "
  7600. "resulting binary against memory corruption attacks, or provide additional "
  7601. "warning messages during compilation. Except as noted below, these are "
  7602. "enabled by default for architectures that support them."
  7603. msgstr ""
  7604. #. type: TP
  7605. #: dpkg-buildflags.man:1
  7606. #, no-wrap
  7607. msgid "B<format>"
  7608. msgstr ""
  7609. #. type: Plain text
  7610. #: dpkg-buildflags.man:1
  7611. msgid ""
  7612. "This setting (enabled by default) adds B<-Wformat -Werror=format-security> "
  7613. "to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS> and B<OBJCXXFLAGS>. This will warn "
  7614. "about improper format string uses, and will fail when format functions are "
  7615. "used in a way that represent possible security problems. At present, this "
  7616. "warns about calls to B<printf> and B<scanf> functions where the format "
  7617. "string is not a string literal and there are no format arguments, as in "
  7618. "B<printf(foo);> instead of B<printf(\"%s\", foo);> This may be a security "
  7619. "hole if the format string came from untrusted input and contains ‘%n’."
  7620. msgstr ""
  7621. #. type: TP
  7622. #: dpkg-buildflags.man:1
  7623. #, no-wrap
  7624. msgid "B<fortify>"
  7625. msgstr ""
  7626. #. type: Plain text
  7627. #: dpkg-buildflags.man:1
  7628. msgid ""
  7629. "This setting (enabled by default) adds B<-D_FORTIFY_SOURCE=2> to "
  7630. "B<CPPFLAGS>. During code generation the compiler knows a great deal of "
  7631. "information about buffer sizes (where possible), and attempts to replace "
  7632. "insecure unlimited length buffer function calls with length-limited "
  7633. "ones. This is especially useful for old, crufty code. Additionally, format "
  7634. "strings in writable memory that contain ‘%n’ are blocked. If an application "
  7635. "depends on such a format string, it will need to be worked around."
  7636. msgstr ""
  7637. #. type: Plain text
  7638. #: dpkg-buildflags.man:1
  7639. msgid ""
  7640. "Note that for this option to have any effect, the source must also be "
  7641. "compiled with B<-O1> or higher. If the environment variable "
  7642. "B<DEB_BUILD_OPTIONS> contains I<noopt>, then B<fortify> support will be "
  7643. "disabled, due to new warnings being issued by glibc 2.16 and later."
  7644. msgstr ""
  7645. #. type: TP
  7646. #: dpkg-buildflags.man:1
  7647. #, no-wrap
  7648. msgid "B<stackprotector>"
  7649. msgstr ""
  7650. #. type: Plain text
  7651. #: dpkg-buildflags.man:1
  7652. msgid ""
  7653. "This setting (enabled by default if stackprotectorstrong is not in use) adds "
  7654. "B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS>, B<CXXFLAGS>, "
  7655. "B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>. This "
  7656. "adds safety checks against stack overwrites. This renders many potential "
  7657. "code injection attacks into aborting situations. In the best case this turns "
  7658. "code injection vulnerabilities into denial of service or into non-issues "
  7659. "(depending on the application)."
  7660. msgstr ""
  7661. #. type: Plain text
  7662. #: dpkg-buildflags.man:1
  7663. msgid ""
  7664. "This feature requires linking against glibc (or another provider of "
  7665. "B<__stack_chk_fail>), so needs to be disabled when building with "
  7666. "B<-nostdlib> or B<-ffreestanding> or similar."
  7667. msgstr ""
  7668. #. type: TP
  7669. #: dpkg-buildflags.man:1
  7670. #, no-wrap
  7671. msgid "B<stackprotectorstrong>"
  7672. msgstr ""
  7673. #. type: Plain text
  7674. #: dpkg-buildflags.man:1
  7675. msgid ""
  7676. "This setting (enabled by default) adds B<-fstack-protector-strong> to "
  7677. "B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> "
  7678. "and B<FCFLAGS>. This is a stronger variant of B<stackprotector>, but "
  7679. "without significant performance penalties."
  7680. msgstr ""
  7681. #. type: Plain text
  7682. #: dpkg-buildflags.man:1
  7683. msgid "Disabling B<stackprotector> will also disable this setting."
  7684. msgstr ""
  7685. #. type: Plain text
  7686. #: dpkg-buildflags.man:1
  7687. msgid ""
  7688. "This feature has the same requirements as B<stackprotector>, and in addition "
  7689. "also requires gcc 4.9 and later."
  7690. msgstr ""
  7691. #. type: TP
  7692. #: dpkg-buildflags.man:1
  7693. #, no-wrap
  7694. msgid "B<relro>"
  7695. msgstr ""
  7696. #. type: Plain text
  7697. #: dpkg-buildflags.man:1
  7698. msgid ""
  7699. "This setting (enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>. "
  7700. "During program load, several ELF memory sections need to be written to by "
  7701. "the linker. This flags the loader to turn these sections read-only before "
  7702. "turning over control to the program. Most notably this prevents GOT "
  7703. "overwrite attacks. If this option is disabled, B<bindnow> will become "
  7704. "disabled as well."
  7705. msgstr ""
  7706. #. type: TP
  7707. #: dpkg-buildflags.man:1
  7708. #, no-wrap
  7709. msgid "B<bindnow>"
  7710. msgstr ""
  7711. #. type: Plain text
  7712. #: dpkg-buildflags.man:1
  7713. msgid ""
  7714. "This setting (disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>. During "
  7715. "program load, all dynamic symbols are resolved, allowing for the entire PLT "
  7716. "to be marked read-only (due to B<relro> above). The option cannot become "
  7717. "enabled if B<relro> is not enabled."
  7718. msgstr ""
  7719. #. type: TP
  7720. #: dpkg-buildflags.man:1
  7721. #, no-wrap
  7722. msgid "B<pie>"
  7723. msgstr ""
  7724. #. type: Plain text
  7725. #: dpkg-buildflags.man:1
  7726. msgid ""
  7727. "This setting (with no default since dpkg 1.18.23, and injected by default by "
  7728. "gcc on the amd64, arm64, armel, armhf, i386, kfreebsd-amd64, kfreebsd-i386, "
  7729. "mips, mipsel, mips64el, ppc64el, s390x, sparc and sparc64 Debian "
  7730. "architectures) adds the required options via gcc specs files if needed to "
  7731. "enable or disable PIE. When enabled and injected by gcc, adds nothing. When "
  7732. "enabled and not injected by gcc, adds B<-fPIE> to B<CFLAGS>, B<CXXFLAGS>, "
  7733. "B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>, and "
  7734. "B<-fPIE -pie> to B<LDFLAGS>. When disabled and injected by gcc, adds "
  7735. "B<-fno-PIE> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, "
  7736. "B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>, and B<-fno-PIE -no-pie> to "
  7737. "B<LDFLAGS>."
  7738. msgstr ""
  7739. #. type: Plain text
  7740. #: dpkg-buildflags.man:1
  7741. msgid ""
  7742. "Position Independent Executable are needed to take advantage of Address "
  7743. "Space Layout Randomization, supported by some kernel versions. While ASLR "
  7744. "can already be enforced for data areas in the stack and heap (brk and mmap), "
  7745. "the code areas must be compiled as position-independent. Shared libraries "
  7746. "already do this (B<-fPIC>), so they gain ASLR automatically, but binary "
  7747. ".text regions need to be build PIE to gain ASLR. When this happens, ROP "
  7748. "(Return Oriented Programming) attacks are much harder since there are no "
  7749. "static locations to bounce off of during a memory corruption attack."
  7750. msgstr ""
  7751. #. type: Plain text
  7752. #: dpkg-buildflags.man:1
  7753. msgid ""
  7754. "PIE is not compatible with B<-fPIC>, so in general care must be taken when "
  7755. "building shared objects. But because the PIE flags emitted get injected via "
  7756. "gcc specs files, it should always be safe to unconditionally set them "
  7757. "regardless of the object type being compiled or linked."
  7758. msgstr ""
  7759. #. type: Plain text
  7760. #: dpkg-buildflags.man:1
  7761. msgid ""
  7762. "Static libraries can be used by programs or other shared libraries. "
  7763. "Depending on the flags used to compile all the objects within a static "
  7764. "library, these libraries will be usable by different sets of objects:"
  7765. msgstr ""
  7766. #. type: TP
  7767. #: dpkg-buildflags.man:1
  7768. #, no-wrap
  7769. msgid "none"
  7770. msgstr ""
  7771. #. type: Plain text
  7772. #: dpkg-buildflags.man:1
  7773. msgid "Cannot be linked into a PIE program, nor a shared library."
  7774. msgstr ""
  7775. #. type: TP
  7776. #: dpkg-buildflags.man:1
  7777. #, no-wrap
  7778. msgid "B<-fPIE>"
  7779. msgstr ""
  7780. #. type: Plain text
  7781. #: dpkg-buildflags.man:1
  7782. msgid "Can be linked into any program, but not a shared library (recommended)."
  7783. msgstr ""
  7784. #. type: TP
  7785. #: dpkg-buildflags.man:1
  7786. #, no-wrap
  7787. msgid "B<-fPIC>"
  7788. msgstr ""
  7789. #. type: Plain text
  7790. #: dpkg-buildflags.man:1
  7791. msgid "Can be linked into any program and shared library."
  7792. msgstr ""
  7793. #. type: Plain text
  7794. #: dpkg-buildflags.man:1
  7795. msgid ""
  7796. "If there is a need to set these flags manually, bypassing the gcc specs "
  7797. "injection, there are several things to take into account. Unconditionally "
  7798. "and explicitly passing B<-fPIE>, B<-fpie> or B<-pie> to a build-system using "
  7799. "libtool is safe as these flags will get stripped when building shared "
  7800. "libraries. Otherwise on projects that build both programs and shared "
  7801. "libraries you might need to make sure that when building the shared "
  7802. "libraries B<-fPIC> is always passed last (so that it overrides any previous "
  7803. "B<-PIE>) to compilation flags such as B<CFLAGS>, and B<-shared> is passed "
  7804. "last (so that it overrides any previous B<-pie>) to linking flags such as "
  7805. "B<LDFLAGS>. B<Note:> This should not be needed with the default gcc specs "
  7806. "machinery."
  7807. msgstr ""
  7808. #. type: Plain text
  7809. #: dpkg-buildflags.man:1
  7810. msgid ""
  7811. "Additionally, since PIE is implemented via a general register, some register "
  7812. "starved architectures (but not including i386 anymore since optimizations "
  7813. "implemented in gcc E<gt>= 5) can see performance losses of up to 15% in very "
  7814. "text-segment-heavy application workloads; most workloads see less than "
  7815. "1%. Architectures with more general registers (e.g. amd64) do not see as "
  7816. "high a worst-case penalty."
  7817. msgstr ""
  7818. #. type: SS
  7819. #: dpkg-buildflags.man:1
  7820. #, no-wrap
  7821. msgid "reproducible"
  7822. msgstr ""
  7823. #. type: Plain text
  7824. #: dpkg-buildflags.man:1
  7825. msgid ""
  7826. "The compile-time options detailed below can be used to help improve build "
  7827. "reproducibility or provide additional warning messages during "
  7828. "compilation. Except as noted below, these are enabled by default for "
  7829. "architectures that support them."
  7830. msgstr ""
  7831. #. type: TP
  7832. #: dpkg-buildflags.man:1
  7833. #, no-wrap
  7834. msgid "B<timeless>"
  7835. msgstr ""
  7836. #. type: Plain text
  7837. #: dpkg-buildflags.man:1
  7838. msgid ""
  7839. "This setting (enabled by default) adds B<-Wdate-time> to B<CPPFLAGS>. This "
  7840. "will cause warnings when the B<__TIME__>, B<__DATE__> and B<__TIMESTAMP__> "
  7841. "macros are used."
  7842. msgstr ""
  7843. #. type: TP
  7844. #: dpkg-buildflags.man:1
  7845. #, no-wrap
  7846. msgid "B<fixdebugpath>"
  7847. msgstr ""
  7848. #. type: Plain text
  7849. #: dpkg-buildflags.man:1
  7850. msgid ""
  7851. "This setting (enabled by default) adds "
  7852. "B<-fdebug-prefix-map=>I<BUILDPATH>B<=.> to B<CFLAGS>, B<CXXFLAGS>, "
  7853. "B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS> where "
  7854. "B<BUILDPATH> is set to the top-level directory of the package being built. "
  7855. "This has the effect of removing the build path from any generated debug "
  7856. "symbols."
  7857. msgstr ""
  7858. #. type: Plain text
  7859. #: dpkg-buildflags.man:1
  7860. msgid ""
  7861. "There are 2 sets of environment variables doing the same operations, the "
  7862. "first one (DEB_I<flag>_I<op>) should never be used within "
  7863. "B<debian/rules>. It's meant for any user that wants to rebuild the source "
  7864. "package with different build flags. The second set (DEB_I<flag>_MAINT_I<op>) "
  7865. "should only be used in B<debian/rules> by package maintainers to change the "
  7866. "resulting build flags."
  7867. msgstr ""
  7868. #. type: TP
  7869. #: dpkg-buildflags.man:1
  7870. #, no-wrap
  7871. msgid "B<DEB_>I<flag>B<_SET>"
  7872. msgstr ""
  7873. #. type: TQ
  7874. #: dpkg-buildflags.man:1
  7875. #, no-wrap
  7876. msgid "B<DEB_>I<flag>B<_MAINT_SET>"
  7877. msgstr ""
  7878. #. type: Plain text
  7879. #: dpkg-buildflags.man:1
  7880. msgid "This variable can be used to force the value returned for the given I<flag>."
  7881. msgstr ""
  7882. #. type: TP
  7883. #: dpkg-buildflags.man:1
  7884. #, no-wrap
  7885. msgid "B<DEB_>I<flag>B<_STRIP>"
  7886. msgstr ""
  7887. #. type: TQ
  7888. #: dpkg-buildflags.man:1
  7889. #, no-wrap
  7890. msgid "B<DEB_>I<flag>B<_MAINT_STRIP>"
  7891. msgstr ""
  7892. #. type: Plain text
  7893. #: dpkg-buildflags.man:1
  7894. msgid ""
  7895. "This variable can be used to provide a space separated list of options that "
  7896. "will be stripped from the set of flags returned for the given I<flag>."
  7897. msgstr ""
  7898. #. type: TP
  7899. #: dpkg-buildflags.man:1
  7900. #, no-wrap
  7901. msgid "B<DEB_>I<flag>B<_APPEND>"
  7902. msgstr ""
  7903. #. type: TQ
  7904. #: dpkg-buildflags.man:1
  7905. #, no-wrap
  7906. msgid "B<DEB_>I<flag>B<_MAINT_APPEND>"
  7907. msgstr ""
  7908. #. type: Plain text
  7909. #: dpkg-buildflags.man:1
  7910. msgid ""
  7911. "This variable can be used to append supplementary options to the value "
  7912. "returned for the given I<flag>."
  7913. msgstr ""
  7914. #. type: TP
  7915. #: dpkg-buildflags.man:1
  7916. #, no-wrap
  7917. msgid "B<DEB_>I<flag>B<_PREPEND>"
  7918. msgstr ""
  7919. #. type: TQ
  7920. #: dpkg-buildflags.man:1
  7921. #, no-wrap
  7922. msgid "B<DEB_>I<flag>B<_MAINT_PREPEND>"
  7923. msgstr ""
  7924. #. type: Plain text
  7925. #: dpkg-buildflags.man:1
  7926. msgid ""
  7927. "This variable can be used to prepend supplementary options to the value "
  7928. "returned for the given I<flag>."
  7929. msgstr ""
  7930. #. type: TP
  7931. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
  7932. #, no-wrap
  7933. msgid "B<DEB_BUILD_OPTIONS>"
  7934. msgstr ""
  7935. #. type: TQ
  7936. #: dpkg-buildflags.man:1
  7937. #, no-wrap
  7938. msgid "B<DEB_BUILD_MAINT_OPTIONS>"
  7939. msgstr ""
  7940. #. type: Plain text
  7941. #: dpkg-buildflags.man:1
  7942. msgid ""
  7943. "These variables can be used by a user or maintainer to disable/enable "
  7944. "various area features that affect build flags. The "
  7945. "B<DEB_BUILD_MAINT_OPTIONS> variable overrides any setting in the "
  7946. "B<DEB_BUILD_OPTIONS> feature areas. See the B<FEATURE AREAS> section for "
  7947. "details."
  7948. msgstr ""
  7949. #. type: TP
  7950. #: dpkg-buildflags.man:1 dpkg-vendor.man:1
  7951. #, no-wrap
  7952. msgid "B<DEB_VENDOR>"
  7953. msgstr ""
  7954. #. type: Plain text
  7955. #: dpkg-buildflags.man:1
  7956. msgid ""
  7957. "This setting defines the current vendor. If not set, it will discover the "
  7958. "current vendor by reading B<%PKGCONFDIR%/origins/default>."
  7959. msgstr ""
  7960. #. type: TP
  7961. #: dpkg-buildflags.man:1
  7962. #, no-wrap
  7963. msgid "B<DEB_BUILD_PATH>"
  7964. msgstr ""
  7965. #. type: Plain text
  7966. #: dpkg-buildflags.man:1
  7967. msgid ""
  7968. "This variable sets the build path (since dpkg 1.18.8) to use in features "
  7969. "such as B<fixdebugpath> so that they can be controlled by the caller. This "
  7970. "variable is currently Debian and derivatives-specific."
  7971. msgstr ""
  7972. #. type: SS
  7973. #: dpkg-buildflags.man:1
  7974. #, no-wrap
  7975. msgid "Configuration files"
  7976. msgstr ""
  7977. #. type: TP
  7978. #: dpkg-buildflags.man:1
  7979. #, no-wrap
  7980. msgid "B<%PKGCONFDIR%/buildflags.conf>"
  7981. msgstr ""
  7982. #. type: Plain text
  7983. #: dpkg-buildflags.man:1
  7984. msgid "System wide configuration file."
  7985. msgstr ""
  7986. #. type: TP
  7987. #: dpkg-buildflags.man:1
  7988. #, no-wrap
  7989. msgid "B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or "
  7990. msgstr ""
  7991. #. type: TQ
  7992. #: dpkg-buildflags.man:1
  7993. #, no-wrap
  7994. msgid "B<$HOME/.config/dpkg/buildflags.conf>"
  7995. msgstr ""
  7996. #. type: Plain text
  7997. #: dpkg-buildflags.man:1 dpkg-buildpackage.man:1
  7998. msgid "User configuration file."
  7999. msgstr ""
  8000. #. type: TP
  8001. #: dpkg-buildflags.man:1
  8002. #, no-wrap
  8003. msgid "B<%PKGDATADIR%/buildflags.mk>"
  8004. msgstr ""
  8005. #. type: Plain text
  8006. #: dpkg-buildflags.man:1
  8007. msgid ""
  8008. "Makefile snippet that will load (and optionally export) all flags supported "
  8009. "by B<dpkg-buildflags> into variables (since dpkg 1.16.1)."
  8010. msgstr ""
  8011. #. type: Plain text
  8012. #: dpkg-buildflags.man:1
  8013. msgid "To pass build flags to a build command in a makefile:"
  8014. msgstr ""
  8015. #. type: Plain text
  8016. #: dpkg-buildflags.man:1
  8017. #, no-wrap
  8018. msgid "$(MAKE) $(shell dpkg-buildflags --export=cmdline)\n"
  8019. msgstr ""
  8020. #. type: Plain text
  8021. #: dpkg-buildflags.man:1
  8022. #, no-wrap
  8023. msgid "\\&./configure $(shell dpkg-buildflags --export=cmdline)\n"
  8024. msgstr ""
  8025. #. type: Plain text
  8026. #: dpkg-buildflags.man:1
  8027. msgid ""
  8028. "To set build flags in a shell script or shell fragment, B<eval> can be used "
  8029. "to interpret the output and to export the flags in the environment:"
  8030. msgstr ""
  8031. #. type: Plain text
  8032. #: dpkg-buildflags.man:1
  8033. #, no-wrap
  8034. msgid "eval \"$(dpkg-buildflags --export=sh)\" && make\n"
  8035. msgstr ""
  8036. #. type: Plain text
  8037. #: dpkg-buildflags.man:1
  8038. msgid "or to set the positional parameters to pass to a command:"
  8039. msgstr ""
  8040. #. type: Plain text
  8041. #: dpkg-buildflags.man:1
  8042. #, no-wrap
  8043. msgid ""
  8044. "eval \"set -- $(dpkg-buildflags --export=cmdline)\"\n"
  8045. "for dir in a b c; do (cd $dir && ./configure \"$@\" && make); done\n"
  8046. msgstr ""
  8047. #. type: Plain text
  8048. #: dpkg-buildflags.man:1
  8049. msgid ""
  8050. "You should call B<dpkg-buildflags> or include B<buildflags.mk> from the "
  8051. "B<debian/rules> file to obtain the needed build flags to pass to the build "
  8052. "system. Note that older versions of B<dpkg-buildpackage> (before dpkg "
  8053. "1.16.1) exported these flags automatically. However, you should not rely on "
  8054. "this, since this breaks manual invocation of B<debian/rules>."
  8055. msgstr ""
  8056. #. type: Plain text
  8057. #: dpkg-buildflags.man:1
  8058. msgid ""
  8059. "For packages with autoconf-like build systems, you can pass the relevant "
  8060. "options to configure or B<make>(1) directly, as shown above."
  8061. msgstr ""
  8062. #. type: Plain text
  8063. #: dpkg-buildflags.man:1
  8064. msgid ""
  8065. "For other build systems, or when you need more fine-grained control about "
  8066. "which flags are passed where, you can use B<--get>. Or you can include "
  8067. "B<buildflags.mk> instead, which takes care of calling B<dpkg-buildflags> and "
  8068. "storing the build flags in make variables."
  8069. msgstr ""
  8070. #. type: Plain text
  8071. #: dpkg-buildflags.man:1
  8072. msgid ""
  8073. "If you want to export all buildflags into the environment (where they can be "
  8074. "picked up by your build system):"
  8075. msgstr ""
  8076. #. type: Plain text
  8077. #: dpkg-buildflags.man:1
  8078. #, no-wrap
  8079. msgid ""
  8080. "DPKG_EXPORT_BUILDFLAGS = 1\n"
  8081. "include %PKGDATADIR%/buildflags.mk\n"
  8082. msgstr ""
  8083. #. type: Plain text
  8084. #: dpkg-buildflags.man:1
  8085. msgid ""
  8086. "For some extra control over what is exported, you can manually export the "
  8087. "variables (as none are exported by default):"
  8088. msgstr ""
  8089. #. type: Plain text
  8090. #: dpkg-buildflags.man:1
  8091. #, no-wrap
  8092. msgid ""
  8093. "include %PKGDATADIR%/buildflags.mk\n"
  8094. "export CPPFLAGS CFLAGS LDFLAGS\n"
  8095. msgstr ""
  8096. #. type: Plain text
  8097. #: dpkg-buildflags.man:1
  8098. msgid "And you can of course pass the flags to commands manually:"
  8099. msgstr ""
  8100. #. type: Plain text
  8101. #: dpkg-buildflags.man:1
  8102. #, no-wrap
  8103. msgid ""
  8104. "include %PKGDATADIR%/buildflags.mk\n"
  8105. "build-arch:\n"
  8106. "\\&\t$(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)\n"
  8107. msgstr ""
  8108. #. type: TH
  8109. #: dpkg-buildpackage.man:1
  8110. #, no-wrap
  8111. msgid "dpkg-buildpackage"
  8112. msgstr ""
  8113. #. type: Plain text
  8114. #: dpkg-buildpackage.man:1
  8115. msgid "dpkg-buildpackage - build binary or source packages from sources"
  8116. msgstr ""
  8117. #. type: Plain text
  8118. #: dpkg-buildpackage.man:1
  8119. msgid "B<dpkg-buildpackage> [I<option>...]"
  8120. msgstr ""
  8121. #. type: Plain text
  8122. #: dpkg-buildpackage.man:1
  8123. msgid ""
  8124. "B<dpkg-buildpackage> is a program that automates the process of building a "
  8125. "Debian package. It consists of the following steps:"
  8126. msgstr ""
  8127. #. type: IP
  8128. #: dpkg-buildpackage.man:1
  8129. #, no-wrap
  8130. msgid "B<1.>"
  8131. msgstr ""
  8132. #. type: Plain text
  8133. #: dpkg-buildpackage.man:1
  8134. msgid ""
  8135. "It prepares the build environment by setting various environment variables "
  8136. "(see B<ENVIRONMENT>), runs the B<init> hook, and calls B<dpkg-source "
  8137. "--before-build> (unless B<-T> or B<--target> has been used)."
  8138. msgstr ""
  8139. #. type: IP
  8140. #: dpkg-buildpackage.man:1
  8141. #, no-wrap
  8142. msgid "B<2.>"
  8143. msgstr ""
  8144. #. type: Plain text
  8145. #: dpkg-buildpackage.man:1
  8146. msgid ""
  8147. "It checks that the build-dependencies and build-conflicts are satisfied "
  8148. "(unless B<-d> or B<--no-check-builddeps> is specified)."
  8149. msgstr ""
  8150. #. type: IP
  8151. #: dpkg-buildpackage.man:1
  8152. #, no-wrap
  8153. msgid "B<3.>"
  8154. msgstr ""
  8155. #. type: Plain text
  8156. #: dpkg-buildpackage.man:1
  8157. msgid ""
  8158. "If one or more specific targets have been selected with the B<-T> or "
  8159. "B<--target> option, it calls those targets and stops here. Otherwise it runs "
  8160. "the B<preclean> hook and calls B<fakeroot debian/rules clean> to clean the "
  8161. "build-tree (unless B<-nc> or B<--no-pre-clean> is specified)."
  8162. msgstr ""
  8163. #. type: IP
  8164. #: dpkg-buildpackage.man:1
  8165. #, no-wrap
  8166. msgid "B<4.>"
  8167. msgstr ""
  8168. #. type: Plain text
  8169. #: dpkg-buildpackage.man:1
  8170. msgid ""
  8171. "It runs the B<source> hook and calls B<dpkg-source -b> to generate the "
  8172. "source package (if a B<source> build has been requested with B<--build> or "
  8173. "equivalent options)."
  8174. msgstr ""
  8175. #. type: IP
  8176. #: dpkg-buildpackage.man:1
  8177. #, no-wrap
  8178. msgid "B<5.>"
  8179. msgstr ""
  8180. #. type: Plain text
  8181. #: dpkg-buildpackage.man:1
  8182. msgid ""
  8183. "It runs the B<build> hook and calls B<debian/rules> I<build-target>, then "
  8184. "runs the B<binary> hook followed by B<fakeroot debian/rules> "
  8185. "I<binary-target> (unless a source-only build has been requested with "
  8186. "B<--build=source> or equivalent options). Note that I<build-target> and "
  8187. "I<binary-target> are either B<build> and B<binary> (default case, or if an "
  8188. "B<any> and B<all> build has been requested with B<--build> or equivalent "
  8189. "options), or B<build-arch> and B<binary-arch> (if an B<any> and not B<all> "
  8190. "build has been requested with B<--build> or equivalent options), or "
  8191. "B<build-indep> and B<binary-indep> (if an B<all> and not B<any> build has "
  8192. "been requested with B<--build> or equivalent options)."
  8193. msgstr ""
  8194. #. type: IP
  8195. #: dpkg-buildpackage.man:1
  8196. #, no-wrap
  8197. msgid "B<6.>"
  8198. msgstr ""
  8199. #. type: Plain text
  8200. #: dpkg-buildpackage.man:1
  8201. msgid ""
  8202. "Unless a source-only build has been requested, it runs the B<buildinfo> hook "
  8203. "and calls B<dpkg-genbuildinfo> to generate a B<.buildinfo> file. Several "
  8204. "B<dpkg-buildpackage> options are forwarded to B<dpkg-genbuildinfo>."
  8205. msgstr ""
  8206. #. type: IP
  8207. #: dpkg-buildpackage.man:1
  8208. #, no-wrap
  8209. msgid "B<7.>"
  8210. msgstr ""
  8211. #. type: Plain text
  8212. #: dpkg-buildpackage.man:1
  8213. msgid ""
  8214. "It runs the B<changes> hook and calls B<dpkg-genchanges> to generate a "
  8215. "B<.changes> file. The name of the B<.changes> file will depend on the type "
  8216. "of build and will be as specific as necessary but not more; for a build that "
  8217. "includes B<any> the name will be "
  8218. "I<source-name>B<_>I<source-version>B<_>I<arch>B<.changes>, or otherwise for "
  8219. "a build that includes B<all> the name will be "
  8220. "I<source-name>B<_>I<source-version>B<_>B<all.changes>, or otherwise for a "
  8221. "build that includes B<source> the name will be "
  8222. "I<source-name>B<_>I<source-version>B<_>B<source.changes>. Many "
  8223. "B<dpkg-buildpackage> options are forwarded to B<dpkg-genchanges>."
  8224. msgstr ""
  8225. #. type: IP
  8226. #: dpkg-buildpackage.man:1
  8227. #, no-wrap
  8228. msgid "B<8.>"
  8229. msgstr ""
  8230. #. type: Plain text
  8231. #: dpkg-buildpackage.man:1
  8232. msgid ""
  8233. "It runs the B<postclean> hook and if B<-tc> or B<--post-clean> is specified, "
  8234. "it will call B<fakeroot debian/rules clean> again."
  8235. msgstr ""
  8236. #. type: IP
  8237. #: dpkg-buildpackage.man:1
  8238. #, no-wrap
  8239. msgid "B<9.>"
  8240. msgstr ""
  8241. #. type: Plain text
  8242. #: dpkg-buildpackage.man:1
  8243. msgid "It calls B<dpkg-source --after-build>."
  8244. msgstr ""
  8245. #. type: IP
  8246. #: dpkg-buildpackage.man:1
  8247. #, no-wrap
  8248. msgid "B<10.>"
  8249. msgstr ""
  8250. #. type: Plain text
  8251. #: dpkg-buildpackage.man:1
  8252. msgid ""
  8253. "It runs the B<check> hook and calls a package checker for the B<.changes> "
  8254. "file (if a command is specified in B<DEB_CHECK_COMMAND> or with "
  8255. "B<--check-command>)."
  8256. msgstr ""
  8257. #. type: IP
  8258. #: dpkg-buildpackage.man:1
  8259. #, no-wrap
  8260. msgid "B<11.>"
  8261. msgstr ""
  8262. #. type: Plain text
  8263. #: dpkg-buildpackage.man:1
  8264. msgid ""
  8265. "It runs the B<sign> hook and calls B<gpg2> or B<gpg> (as long as it is not "
  8266. "an UNRELEASED build, or B<--no-sign> is specified) to sign the B<.dsc> file "
  8267. "(if any, unless B<-us> or B<--unsigned-source> is specified), the "
  8268. "B<.buildinfo> file (unless B<-ui>, B<--unsigned-buildinfo>, B<-uc> or "
  8269. "B<--unsigned-changes> is specified) and the B<.changes> file (unless B<-uc> "
  8270. "or B<--unsigned-changes> is specified)."
  8271. msgstr ""
  8272. #. type: IP
  8273. #: dpkg-buildpackage.man:1
  8274. #, no-wrap
  8275. msgid "B<12.>"
  8276. msgstr ""
  8277. #. type: Plain text
  8278. #: dpkg-buildpackage.man:1
  8279. msgid "It runs the B<done> hook."
  8280. msgstr ""
  8281. #. type: Plain text
  8282. #: dpkg-buildpackage.man:1
  8283. msgid ""
  8284. "All long options can be specified both on the command line and in the "
  8285. "B<dpkg-buildpackage> system and user configuration files. Each line in the "
  8286. "configuration file is either an option (exactly the same as the command line "
  8287. "option but without leading hyphens) or a comment (if it starts with a "
  8288. "‘B<#>’)."
  8289. msgstr ""
  8290. #. type: TP
  8291. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8292. #, no-wrap
  8293. msgid "B<--build=>I<type>"
  8294. msgstr ""
  8295. #. type: Plain text
  8296. #: dpkg-buildpackage.man:1
  8297. msgid ""
  8298. "Specifies the build I<type> from a comma-separated list of components (since "
  8299. "dpkg 1.18.5). Passed to B<dpkg-genchanges>."
  8300. msgstr ""
  8301. #. type: Plain text
  8302. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8303. msgid "The allowed values are:"
  8304. msgstr ""
  8305. #. type: TP
  8306. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8307. #, no-wrap
  8308. msgid "B<source>"
  8309. msgstr ""
  8310. #. type: Plain text
  8311. #: dpkg-buildpackage.man:1
  8312. msgid ""
  8313. "Builds the source package. Note: when using this value standalone and if "
  8314. "what you want is simply to (re-)build the source package, using "
  8315. "B<dpkg-source> is always better as it does not require any build "
  8316. "dependencies to be installed to be able to call the B<clean> target."
  8317. msgstr ""
  8318. #. type: TP
  8319. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8320. #, no-wrap
  8321. msgid "B<any>"
  8322. msgstr ""
  8323. #. type: Plain text
  8324. #: dpkg-buildpackage.man:1
  8325. msgid "Builds the architecture specific binary packages."
  8326. msgstr ""
  8327. #. type: TP
  8328. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8329. #, no-wrap
  8330. msgid "B<all>"
  8331. msgstr ""
  8332. #. type: Plain text
  8333. #: dpkg-buildpackage.man:1
  8334. msgid "Builds the architecture independent binary packages."
  8335. msgstr ""
  8336. #. type: TP
  8337. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8338. #, no-wrap
  8339. msgid "B<binary>"
  8340. msgstr ""
  8341. #. type: Plain text
  8342. #: dpkg-buildpackage.man:1
  8343. msgid ""
  8344. "Builds the architecture specific and independent binary packages. This is "
  8345. "an alias for B<any,all>."
  8346. msgstr ""
  8347. #. type: TP
  8348. #: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  8349. #, no-wrap
  8350. msgid "B<full>"
  8351. msgstr ""
  8352. #. type: Plain text
  8353. #: dpkg-buildpackage.man:1
  8354. msgid ""
  8355. "Builds everything. This is an alias for B<source,any,all>, and the same as "
  8356. "the default case when no build option is specified."
  8357. msgstr ""
  8358. #. type: TP
  8359. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8360. #, no-wrap
  8361. msgid "B<-g>"
  8362. msgstr ""
  8363. #. type: Plain text
  8364. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8365. msgid "Equivalent to B<--build=source,all> (since dpkg 1.17.11)."
  8366. msgstr ""
  8367. #. type: Plain text
  8368. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8369. msgid "Equivalent to B<--build=source,any> (since dpkg 1.17.11)."
  8370. msgstr ""
  8371. #. type: TP
  8372. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8373. #, no-wrap
  8374. msgid "B<-b>"
  8375. msgstr ""
  8376. #. type: Plain text
  8377. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8378. msgid "Equivalent to B<--build=binary> or B<--build=any,all>."
  8379. msgstr ""
  8380. #. type: TP
  8381. #: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1 dpkg-genchanges.man:1
  8382. #, no-wrap
  8383. msgid "B<-B>"
  8384. msgstr ""
  8385. #. type: Plain text
  8386. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8387. msgid "Equivalent to B<--build=any>."
  8388. msgstr ""
  8389. #. type: TP
  8390. #: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1 dpkg-genchanges.man:1
  8391. #, no-wrap
  8392. msgid "B<-A>"
  8393. msgstr ""
  8394. #. type: Plain text
  8395. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8396. msgid "Equivalent to B<--build=all>."
  8397. msgstr ""
  8398. #. type: TP
  8399. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8400. #, no-wrap
  8401. msgid "B<-S>"
  8402. msgstr ""
  8403. #. type: Plain text
  8404. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8405. msgid "Equivalent to B<--build=source>."
  8406. msgstr ""
  8407. #. type: TP
  8408. #: dpkg-buildpackage.man:1
  8409. #, no-wrap
  8410. msgid "B<-F>"
  8411. msgstr ""
  8412. #. type: Plain text
  8413. #: dpkg-buildpackage.man:1
  8414. msgid ""
  8415. "Equivalent to B<--build=full>, B<--build=source,binary> or "
  8416. "B<--build=source,any,all> (since dpkg 1.15.8)."
  8417. msgstr ""
  8418. #. type: TP
  8419. #: dpkg-buildpackage.man:1
  8420. #, no-wrap
  8421. msgid "B<--target=>I<target>[,...]"
  8422. msgstr ""
  8423. #. type: TQ
  8424. #: dpkg-buildpackage.man:1
  8425. #, no-wrap
  8426. msgid "B<--target >I<target>[,...]"
  8427. msgstr ""
  8428. #. type: TQ
  8429. #: dpkg-buildpackage.man:1
  8430. #, no-wrap
  8431. msgid "B<-T>, B<--rules-target=>I<target>[,...]"
  8432. msgstr ""
  8433. #. type: Plain text
  8434. #: dpkg-buildpackage.man:1
  8435. msgid ""
  8436. "Calls B<debian/rules> I<target> once per target specified, after having "
  8437. "setup the build environment (except for calling B<dpkg-source "
  8438. "--before-build>), and stops the package build process here (since dpkg "
  8439. "1.15.0, long option since dpkg 1.18.8, multi-target support since dpkg "
  8440. "1.18.16). If B<--as-root> is also given, then the command is executed as "
  8441. "root (see B<--root-command>). Note that known targets that are required to "
  8442. "be run as root do not need this option (i.e. the B<clean>, B<binary>, "
  8443. "B<binary-arch> and B<binary-indep> targets)."
  8444. msgstr ""
  8445. #. type: TP
  8446. #: dpkg-buildpackage.man:1
  8447. #, no-wrap
  8448. msgid "B<--as-root>"
  8449. msgstr ""
  8450. #. type: Plain text
  8451. #: dpkg-buildpackage.man:1
  8452. msgid ""
  8453. "Only meaningful together with B<--target> (since dpkg 1.15.0). Requires "
  8454. "that the target be run with root rights."
  8455. msgstr ""
  8456. #. type: TP
  8457. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8458. #, no-wrap
  8459. msgid "B<-si>"
  8460. msgstr ""
  8461. #. type: TP
  8462. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8463. #, no-wrap
  8464. msgid "B<-sa>"
  8465. msgstr ""
  8466. #. type: TP
  8467. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8468. #, no-wrap
  8469. msgid "B<-sd>"
  8470. msgstr ""
  8471. #. type: TP
  8472. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  8473. #: dpkg-gensymbols.man:1
  8474. #, no-wrap
  8475. msgid "B<-v>I<version>"
  8476. msgstr ""
  8477. #. type: TP
  8478. #: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
  8479. #, no-wrap
  8480. msgid "B<-C>I<changes-description>"
  8481. msgstr ""
  8482. #. type: TQ
  8483. #: dpkg-buildpackage.man:1
  8484. #, no-wrap
  8485. msgid "B<-m>, B<--release-by=>I<maintainer-address>"
  8486. msgstr ""
  8487. #. type: TQ
  8488. #: dpkg-buildpackage.man:1
  8489. #, no-wrap
  8490. msgid "B<-e>, B<--build-by=>I<maintainer-address>"
  8491. msgstr ""
  8492. #. type: Plain text
  8493. #: dpkg-buildpackage.man:1
  8494. msgid "Passed unchanged to B<dpkg-genchanges>. See its manual page."
  8495. msgstr ""
  8496. #. type: Plain text
  8497. #: dpkg-buildpackage.man:1
  8498. msgid ""
  8499. "Specify the Debian architecture we build for (long option since dpkg "
  8500. "1.17.17). The architecture of the machine we build on is determined "
  8501. "automatically, and is also the default for the host machine."
  8502. msgstr ""
  8503. #. type: Plain text
  8504. #: dpkg-buildpackage.man:1
  8505. msgid ""
  8506. "Specify the GNU system type we build for (long option since dpkg 1.17.17). "
  8507. "It can be used in place of B<--host-arch> or as a complement to override the "
  8508. "default GNU system type of the host Debian architecture."
  8509. msgstr ""
  8510. #. type: TP
  8511. #: dpkg-buildpackage.man:1
  8512. #, no-wrap
  8513. msgid "B<--target-arch> I<architecture>"
  8514. msgstr ""
  8515. #. type: Plain text
  8516. #: dpkg-buildpackage.man:1
  8517. msgid ""
  8518. "Specify the Debian architecture the binaries built will build for (since "
  8519. "dpkg 1.17.17). The default value is the host machine."
  8520. msgstr ""
  8521. #. type: TP
  8522. #: dpkg-buildpackage.man:1
  8523. #, no-wrap
  8524. msgid "B<--target-type> I<gnu-system-type>"
  8525. msgstr ""
  8526. #. type: Plain text
  8527. #: dpkg-buildpackage.man:1
  8528. msgid ""
  8529. "Specify the GNU system type the binaries built will build for (since dpkg "
  8530. "1.17.17). It can be used in place of B<--target-arch> or as a complement to "
  8531. "override the default GNU system type of the target Debian architecture."
  8532. msgstr ""
  8533. #. type: TP
  8534. #: dpkg-buildpackage.man:1
  8535. #, no-wrap
  8536. msgid "B<-P>, B<--build-profiles=>I<profile>[B<,>...]"
  8537. msgstr ""
  8538. #. type: Plain text
  8539. #: dpkg-buildpackage.man:1
  8540. msgid ""
  8541. "Specify the profile(s) we build, as a comma-separated list (since dpkg "
  8542. "1.17.2, long option since dpkg 1.18.8). The default behavior is to build "
  8543. "for no specific profile. Also sets them (as a space separated list) as the "
  8544. "B<DEB_BUILD_PROFILES> environment variable which allows, for example, "
  8545. "B<debian/rules> files to use this information for conditional builds."
  8546. msgstr ""
  8547. #. type: TP
  8548. #: dpkg-buildpackage.man:1
  8549. #, no-wrap
  8550. msgid "B<-j>, B<--jobs>[=I<jobs>|B<auto>]"
  8551. msgstr ""
  8552. #. type: Plain text
  8553. #: dpkg-buildpackage.man:1
  8554. msgid ""
  8555. "Number of jobs allowed to be run simultaneously, number of jobs matching the "
  8556. "number of online processors if B<auto> is specified (since dpkg 1.17.10), or "
  8557. "unlimited number if I<jobs> is not specified, equivalent to the B<make>(1) "
  8558. "option of the same name (since dpkg 1.14.7, long option since dpkg 1.18.8). "
  8559. "Will add itself to the B<MAKEFLAGS> environment variable, which should cause "
  8560. "all subsequent make invocations to inherit the option, thus forcing the "
  8561. "parallel setting on the packaging (and possibly the upstream build system if "
  8562. "that uses make) regardless of their support for parallel builds, which "
  8563. "might cause build failures. Also adds B<parallel=>I<jobs> or B<parallel> to "
  8564. "the B<DEB_BUILD_OPTIONS> environment variable which allows debian/rules "
  8565. "files to use this information for their own purposes. The B<-j> value will "
  8566. "override the B<parallel=>I<jobs> or B<parallel> option in the "
  8567. "B<DEB_BUILD_OPTIONS> environment variable. Note that the B<auto> value will "
  8568. "get replaced by the actual number of currently active processors, and as "
  8569. "such will not get propagated to any child process. If the number of online "
  8570. "processors cannot be inferred then the code will fallback to using serial "
  8571. "execution (since dpkg 1.18.15), although this should only happen on exotic "
  8572. "and unsupported systems."
  8573. msgstr ""
  8574. #. type: TP
  8575. #: dpkg-buildpackage.man:1
  8576. #, no-wrap
  8577. msgid "B<-J>, B<--jobs-try>[=I<jobs>|B<auto>]"
  8578. msgstr ""
  8579. #. type: Plain text
  8580. #: dpkg-buildpackage.man:1
  8581. msgid ""
  8582. "This option (since dpkg 1.18.2, long option since dpkg 1.18.8) is equivalent "
  8583. "to the B<-j> option except that it does not set the B<MAKEFLAGS> environment "
  8584. "variable, and as such it is safer to use with any package including those "
  8585. "that are not parallel-build safe."
  8586. msgstr ""
  8587. #. type: Plain text
  8588. #: dpkg-buildpackage.man:1
  8589. msgid ""
  8590. "B<auto> is the default behavior (since dpkg 1.18.11). Setting the number of "
  8591. "jobs to 1 will restore a serial behavior."
  8592. msgstr ""
  8593. #. type: TP
  8594. #: dpkg-buildpackage.man:1
  8595. #, no-wrap
  8596. msgid "B<-D>, B<--check-builddeps>"
  8597. msgstr ""
  8598. #. type: Plain text
  8599. #: dpkg-buildpackage.man:1
  8600. msgid ""
  8601. "Check build dependencies and conflicts; abort if unsatisfied (long option "
  8602. "since dpkg 1.18.8). This is the default behavior."
  8603. msgstr ""
  8604. #. type: TP
  8605. #: dpkg-buildpackage.man:1
  8606. #, no-wrap
  8607. msgid "B<-d>, B<--no-check-builddeps>"
  8608. msgstr ""
  8609. #. type: Plain text
  8610. #: dpkg-buildpackage.man:1
  8611. msgid ""
  8612. "Do not check build dependencies and conflicts (long option since dpkg "
  8613. "1.18.8)."
  8614. msgstr ""
  8615. #. type: TP
  8616. #: dpkg-buildpackage.man:1
  8617. #, no-wrap
  8618. msgid "B<--ignore-builtin-builddeps>"
  8619. msgstr ""
  8620. #. type: Plain text
  8621. #: dpkg-buildpackage.man:1
  8622. msgid ""
  8623. "Do not check built-in build dependencies and conflicts (since dpkg 1.18.2). "
  8624. "These are the distribution specific implicit build dependencies usually "
  8625. "required in a build environment, the so called Build-Essential package set."
  8626. msgstr ""
  8627. #. type: TP
  8628. #: dpkg-buildpackage.man:1
  8629. #, no-wrap
  8630. msgid "B<-nc>, B<--no-pre-clean>"
  8631. msgstr ""
  8632. #. type: Plain text
  8633. #: dpkg-buildpackage.man:1
  8634. msgid ""
  8635. "Do not clean the source tree (long option since dpkg 1.18.8). Implies B<-b> "
  8636. "if nothing else has been selected among B<-F>, B<-g>, B<-G>, B<-B>, B<-A> or "
  8637. "B<-S>. Implies B<-d> with B<-S> (since dpkg 1.18.0)."
  8638. msgstr ""
  8639. #. type: TP
  8640. #: dpkg-buildpackage.man:1
  8641. #, no-wrap
  8642. msgid "B<--pre-clean>"
  8643. msgstr ""
  8644. #. type: Plain text
  8645. #: dpkg-buildpackage.man:1
  8646. msgid "Clean the source tree before building (since dpkg 1.18.8)."
  8647. msgstr ""
  8648. #. type: TP
  8649. #: dpkg-buildpackage.man:1
  8650. #, no-wrap
  8651. msgid "B<-tc>, B<--post-clean>"
  8652. msgstr ""
  8653. #. type: Plain text
  8654. #: dpkg-buildpackage.man:1
  8655. msgid ""
  8656. "Clean the source tree (using I<gain-root-command> B<debian/rules clean>) "
  8657. "after the package has been built (long option since dpkg 1.18.8)."
  8658. msgstr ""
  8659. #. type: TP
  8660. #: dpkg-buildpackage.man:1
  8661. #, no-wrap
  8662. msgid "B<-r>, B<--root-command=>I<gain-root-command>"
  8663. msgstr ""
  8664. #. type: Plain text
  8665. #: dpkg-buildpackage.man:1
  8666. msgid ""
  8667. "When B<dpkg-buildpackage> needs to execute part of the build process as "
  8668. "root, it prefixes the command it executes with I<gain-root-command> if one "
  8669. "has been specified (long option since dpkg 1.18.8). Otherwise, if none has "
  8670. "been specified, B<fakeroot> will be used by default, if the command is "
  8671. "present. I<gain-root-command> should start with the name of a program on "
  8672. "the B<PATH> and will get as arguments the name of the real command to run "
  8673. "and the arguments it should take. I<gain-root-command> can include "
  8674. "parameters (they must be space-separated) but no shell metacharacters. "
  8675. "I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or "
  8676. "B<really>. B<su> is not suitable, since it can only invoke the user's shell "
  8677. "with B<-c> instead of passing arguments individually to the command to be "
  8678. "run."
  8679. msgstr ""
  8680. #. type: TP
  8681. #: dpkg-buildpackage.man:1
  8682. #, no-wrap
  8683. msgid "B<-R>, B<--rules-file=>I<rules-file>"
  8684. msgstr ""
  8685. #. type: Plain text
  8686. #: dpkg-buildpackage.man:1
  8687. msgid ""
  8688. "Building a Debian package usually involves invoking B<debian/rules> as a "
  8689. "command with several standard parameters (since dpkg 1.14.17, long option "
  8690. "since dpkg 1.18.8). With this option it's possible to use another program "
  8691. "invocation to build the package (it can include space separated "
  8692. "parameters). Alternatively it can be used to execute the standard rules "
  8693. "file with another make program (for example by using B</usr/local/bin/make "
  8694. "-f debian/rules> as I<rules-file>)."
  8695. msgstr ""
  8696. #. type: TP
  8697. #: dpkg-buildpackage.man:1
  8698. #, no-wrap
  8699. msgid "B<--check-command=>I<check-command>"
  8700. msgstr ""
  8701. #. type: Plain text
  8702. #: dpkg-buildpackage.man:1
  8703. msgid ""
  8704. "Command used to check the B<.changes> file itself and any artifact built "
  8705. "referenced in the file (since dpkg 1.17.6). The command should take the "
  8706. "B<.changes> pathname as an argument. This command will usually be "
  8707. "B<lintian>."
  8708. msgstr ""
  8709. #. type: TP
  8710. #: dpkg-buildpackage.man:1
  8711. #, no-wrap
  8712. msgid "B<--check-option=>I<opt>"
  8713. msgstr ""
  8714. #. type: Plain text
  8715. #: dpkg-buildpackage.man:1
  8716. msgid ""
  8717. "Pass option I<opt> to the I<check-command> specified with "
  8718. "B<DEB_CHECK_COMMAND> or B<--check-command> (since dpkg 1.17.6). Can be used "
  8719. "multiple times."
  8720. msgstr ""
  8721. #. type: TP
  8722. #: dpkg-buildpackage.man:1
  8723. #, no-wrap
  8724. msgid "B<--hook->I<hook-name>B<=>I<hook-command>"
  8725. msgstr ""
  8726. #. type: Plain text
  8727. #: dpkg-buildpackage.man:1
  8728. msgid ""
  8729. "Set the specified shell code I<hook-command> as the hook I<hook-name>, which "
  8730. "will run at the times specified in the run steps (since dpkg 1.17.6). The "
  8731. "hooks will always be executed even if the following action is not performed "
  8732. "(except for the B<binary> hook). All the hooks will run in the unpacked "
  8733. "source directory."
  8734. msgstr ""
  8735. #. type: Plain text
  8736. #: dpkg-buildpackage.man:1
  8737. msgid ""
  8738. "Note: Hooks can affect the build process, and cause build failures if their "
  8739. "commands fail, so watch out for unintended consequences."
  8740. msgstr ""
  8741. #. type: Plain text
  8742. #: dpkg-buildpackage.man:1
  8743. msgid "The current I<hook-name> supported are:"
  8744. msgstr ""
  8745. #. type: Plain text
  8746. #: dpkg-buildpackage.man:1
  8747. msgid "B<init preclean source build binary changes postclean check sign done>"
  8748. msgstr ""
  8749. #. type: Plain text
  8750. #: dpkg-buildpackage.man:1
  8751. msgid ""
  8752. "The I<hook-command> supports the following substitution format string, which "
  8753. "will get applied to it before execution:"
  8754. msgstr ""
  8755. #. type: TP
  8756. #: dpkg-buildpackage.man:1
  8757. #, no-wrap
  8758. msgid "B<%%>"
  8759. msgstr ""
  8760. #. type: Plain text
  8761. #: dpkg-buildpackage.man:1
  8762. msgid "A single % character."
  8763. msgstr ""
  8764. #. type: TP
  8765. #: dpkg-buildpackage.man:1
  8766. #, no-wrap
  8767. msgid "B<%a>"
  8768. msgstr ""
  8769. #. type: Plain text
  8770. #: dpkg-buildpackage.man:1
  8771. msgid ""
  8772. "A boolean value (0 or 1), representing whether the following action is being "
  8773. "performed."
  8774. msgstr ""
  8775. #. type: TP
  8776. #: dpkg-buildpackage.man:1
  8777. #, no-wrap
  8778. msgid "B<%p>"
  8779. msgstr ""
  8780. #. type: Plain text
  8781. #: dpkg-buildpackage.man:1
  8782. msgid "The source package name."
  8783. msgstr ""
  8784. #. type: TP
  8785. #: dpkg-buildpackage.man:1
  8786. #, no-wrap
  8787. msgid "B<%v>"
  8788. msgstr ""
  8789. #. type: Plain text
  8790. #: dpkg-buildpackage.man:1
  8791. msgid "The source package version."
  8792. msgstr ""
  8793. #. type: TP
  8794. #: dpkg-buildpackage.man:1
  8795. #, no-wrap
  8796. msgid "B<%s>"
  8797. msgstr ""
  8798. #. type: Plain text
  8799. #: dpkg-buildpackage.man:1
  8800. msgid "The source package version (without the epoch)."
  8801. msgstr ""
  8802. #. type: TP
  8803. #: dpkg-buildpackage.man:1
  8804. #, no-wrap
  8805. msgid "B<%u>"
  8806. msgstr ""
  8807. #. type: Plain text
  8808. #: dpkg-buildpackage.man:1
  8809. msgid "The upstream version."
  8810. msgstr ""
  8811. #. type: TP
  8812. #: dpkg-buildpackage.man:1
  8813. #, no-wrap
  8814. msgid "B<--buildinfo-option=>I<opt>"
  8815. msgstr ""
  8816. #. type: Plain text
  8817. #: dpkg-buildpackage.man:1
  8818. msgid ""
  8819. "Pass option I<opt> to B<dpkg-genbuildinfo> (since dpkg 1.18.11). Can be "
  8820. "used multiple times."
  8821. msgstr ""
  8822. #. type: TP
  8823. #: dpkg-buildpackage.man:1
  8824. #, no-wrap
  8825. msgid "B<-p>, B<--sign-command=>I<sign-command>"
  8826. msgstr ""
  8827. #. type: Plain text
  8828. #: dpkg-buildpackage.man:1
  8829. msgid ""
  8830. "When B<dpkg-buildpackage> needs to execute GPG to sign a source control "
  8831. "(B<.dsc>) file or a B<.changes> file it will run I<sign-command> (searching "
  8832. "the B<PATH> if necessary) instead of B<gpg2> or B<gpg> (long option since "
  8833. "dpkg 1.18.8). I<sign-command> will get all the arguments that B<gpg2> or "
  8834. "B<gpg> would have gotten. I<sign-command> should not contain spaces or any "
  8835. "other shell metacharacters."
  8836. msgstr ""
  8837. #. type: TP
  8838. #: dpkg-buildpackage.man:1
  8839. #, no-wrap
  8840. msgid "B<-k>, B<--sign-key=>I<key-id>"
  8841. msgstr ""
  8842. #. type: Plain text
  8843. #: dpkg-buildpackage.man:1
  8844. msgid ""
  8845. "Specify a key-ID to use when signing packages (long option since dpkg "
  8846. "1.18.8)."
  8847. msgstr ""
  8848. #. type: TP
  8849. #: dpkg-buildpackage.man:1
  8850. #, no-wrap
  8851. msgid "B<-us>, B<--unsigned-source>"
  8852. msgstr ""
  8853. #. type: Plain text
  8854. #: dpkg-buildpackage.man:1
  8855. msgid "Do not sign the source package (long option since dpkg 1.18.8)."
  8856. msgstr ""
  8857. #. type: TP
  8858. #: dpkg-buildpackage.man:1
  8859. #, no-wrap
  8860. msgid "B<-ui>, B<--unsigned-buildinfo>"
  8861. msgstr ""
  8862. #. type: Plain text
  8863. #: dpkg-buildpackage.man:1
  8864. msgid "Do not sign the B<.buildinfo> file (since dpkg 1.18.19)."
  8865. msgstr ""
  8866. #. type: TP
  8867. #: dpkg-buildpackage.man:1
  8868. #, no-wrap
  8869. msgid "B<-uc>, B<--unsigned-changes>"
  8870. msgstr ""
  8871. #. type: Plain text
  8872. #: dpkg-buildpackage.man:1
  8873. msgid ""
  8874. "Do not sign the B<.buildinfo> and B<.changes> files (long option since dpkg "
  8875. "1.18.8)."
  8876. msgstr ""
  8877. #. type: TP
  8878. #: dpkg-buildpackage.man:1
  8879. #, no-wrap
  8880. msgid "B<--no-sign>"
  8881. msgstr ""
  8882. #. type: Plain text
  8883. #: dpkg-buildpackage.man:1
  8884. msgid ""
  8885. "Do not sign any file, this includes the source package, the B<.buildinfo> "
  8886. "file and the B<.changes> file (since dpkg 1.18.20)."
  8887. msgstr ""
  8888. #. type: TP
  8889. #: dpkg-buildpackage.man:1
  8890. #, no-wrap
  8891. msgid "B<--force-sign>"
  8892. msgstr ""
  8893. #. type: Plain text
  8894. #: dpkg-buildpackage.man:1
  8895. msgid ""
  8896. "Force the signing of the resulting files (since dpkg 1.17.0), regardless of "
  8897. "B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, "
  8898. "B<--unsigned-changes> or other internal heuristics."
  8899. msgstr ""
  8900. #. type: TP
  8901. #: dpkg-buildpackage.man:1 dpkg-source.man:1 dpkg-source.man:1
  8902. #, no-wrap
  8903. msgid "B<-sn>"
  8904. msgstr ""
  8905. #. type: TP
  8906. #: dpkg-buildpackage.man:1 dpkg-source.man:1
  8907. #, no-wrap
  8908. msgid "B<-ss>"
  8909. msgstr ""
  8910. #. type: TQ
  8911. #: dpkg-buildpackage.man:1
  8912. #, no-wrap
  8913. msgid "B<-sA>"
  8914. msgstr ""
  8915. #. type: TP
  8916. #: dpkg-buildpackage.man:1 dpkg-source.man:1
  8917. #, no-wrap
  8918. msgid "B<-sk>"
  8919. msgstr ""
  8920. #. type: TP
  8921. #: dpkg-buildpackage.man:1 dpkg-source.man:1 dpkg-source.man:1
  8922. #, no-wrap
  8923. msgid "B<-su>"
  8924. msgstr ""
  8925. #. type: TP
  8926. #: dpkg-buildpackage.man:1 dpkg-source.man:1
  8927. #, no-wrap
  8928. msgid "B<-sr>"
  8929. msgstr ""
  8930. #. type: TQ
  8931. #: dpkg-buildpackage.man:1
  8932. #, no-wrap
  8933. msgid "B<-sK>"
  8934. msgstr ""
  8935. #. type: TQ
  8936. #: dpkg-buildpackage.man:1
  8937. #, no-wrap
  8938. msgid "B<-sU>"
  8939. msgstr ""
  8940. #. type: TQ
  8941. #: dpkg-buildpackage.man:1
  8942. #, no-wrap
  8943. msgid "B<-sR>"
  8944. msgstr ""
  8945. #. type: TQ
  8946. #: dpkg-buildpackage.man:1
  8947. #, no-wrap
  8948. msgid "B<-i>, B<--diff-ignore>[=I<regex>]"
  8949. msgstr ""
  8950. #. type: TQ
  8951. #: dpkg-buildpackage.man:1
  8952. #, no-wrap
  8953. msgid "B<-I>, B<--tar-ignore>[=I<pattern>]"
  8954. msgstr ""
  8955. #. type: TQ
  8956. #: dpkg-buildpackage.man:1
  8957. #, no-wrap
  8958. msgid "B<-z>, B<--compression-level=>I<level>"
  8959. msgstr ""
  8960. #. type: TQ
  8961. #: dpkg-buildpackage.man:1
  8962. #, no-wrap
  8963. msgid "B<-Z>, B<--compression=>I<compressor>"
  8964. msgstr ""
  8965. #. type: Plain text
  8966. #: dpkg-buildpackage.man:1
  8967. msgid "Passed unchanged to B<dpkg-source>. See its manual page."
  8968. msgstr ""
  8969. #. type: TP
  8970. #: dpkg-buildpackage.man:1
  8971. #, no-wrap
  8972. msgid "B<--source-option=>I<opt>"
  8973. msgstr ""
  8974. #. type: Plain text
  8975. #: dpkg-buildpackage.man:1
  8976. msgid ""
  8977. "Pass option I<opt> to B<dpkg-source> (since dpkg 1.15.6). Can be used "
  8978. "multiple times."
  8979. msgstr ""
  8980. #. type: TP
  8981. #: dpkg-buildpackage.man:1
  8982. #, no-wrap
  8983. msgid "B<--changes-option=>I<opt>"
  8984. msgstr ""
  8985. #. type: Plain text
  8986. #: dpkg-buildpackage.man:1
  8987. msgid ""
  8988. "Pass option I<opt> to B<dpkg-genchanges> (since dpkg 1.15.6). Can be used "
  8989. "multiple times."
  8990. msgstr ""
  8991. #. type: TQ
  8992. #: dpkg-buildpackage.man:1
  8993. #, no-wrap
  8994. msgid "B<--admindir >I<dir>"
  8995. msgstr ""
  8996. #. type: Plain text
  8997. #: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1 dpkg-shlibdeps.man:1
  8998. msgid ""
  8999. "Change the location of the B<dpkg> database (since dpkg 1.14.0). The "
  9000. "default location is I<%ADMINDIR%>."
  9001. msgstr ""
  9002. #. type: TP
  9003. #: dpkg-buildpackage.man:1
  9004. #, no-wrap
  9005. msgid "B<DEB_CHECK_COMMAND>"
  9006. msgstr ""
  9007. #. type: Plain text
  9008. #: dpkg-buildpackage.man:1
  9009. msgid ""
  9010. "If set, it will be used as the command to check the B<.changes> file (since "
  9011. "dpkg 1.17.6). Overridden by the B<--check-command> option."
  9012. msgstr ""
  9013. #. type: TP
  9014. #: dpkg-buildpackage.man:1
  9015. #, no-wrap
  9016. msgid "B<DEB_SIGN_KEYID>"
  9017. msgstr ""
  9018. #. type: Plain text
  9019. #: dpkg-buildpackage.man:1
  9020. msgid ""
  9021. "If set, it will be used to sign the B<.changes> and B<.dsc> files (since "
  9022. "dpkg 1.17.2). Overridden by the B<--sign-key> option."
  9023. msgstr ""
  9024. #. type: Plain text
  9025. #: dpkg-buildpackage.man:1
  9026. msgid ""
  9027. "If set, it will contain a space-separated list of options that might affect "
  9028. "the build process in I<debian/rules>, and the behavior of some dpkg "
  9029. "commands."
  9030. msgstr ""
  9031. #. type: Plain text
  9032. #: dpkg-buildpackage.man:1
  9033. msgid ""
  9034. "With B<nocheck> the B<DEB_CHECK_COMMAND> variable will be ignored. With "
  9035. "B<parallel=>I<N> the parallel jobs will be set to I<N>, overridden by the "
  9036. "B<--jobs-try> option."
  9037. msgstr ""
  9038. #. type: TP
  9039. #: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1
  9040. #, no-wrap
  9041. msgid "B<DEB_BUILD_PROFILES>"
  9042. msgstr ""
  9043. #. type: Plain text
  9044. #: dpkg-buildpackage.man:1
  9045. msgid ""
  9046. "If set, it will be used as the active build profile(s) for the package being "
  9047. "built (since dpkg 1.17.2). It is a space separated list of profile names. "
  9048. "Overridden by the B<-P> option."
  9049. msgstr ""
  9050. #. type: Plain text
  9051. #: dpkg-buildpackage.man:1
  9052. msgid ""
  9053. "Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should "
  9054. "not rely on their presence and should instead use the respective interface "
  9055. "to retrieve the needed values, because that file is the main entry point to "
  9056. "build packages and running it standalone should be supported."
  9057. msgstr ""
  9058. #. type: TP
  9059. #: dpkg-buildpackage.man:1
  9060. #, no-wrap
  9061. msgid "B<DEB_BUILD_*>"
  9062. msgstr ""
  9063. #. type: TQ
  9064. #: dpkg-buildpackage.man:1
  9065. #, no-wrap
  9066. msgid "B<DEB_HOST_*>"
  9067. msgstr ""
  9068. #. type: TQ
  9069. #: dpkg-buildpackage.man:1
  9070. #, no-wrap
  9071. msgid "B<DEB_TARGET_*>"
  9072. msgstr ""
  9073. #. type: Plain text
  9074. #: dpkg-buildpackage.man:1
  9075. msgid ""
  9076. "B<dpkg-architecture> is called with the B<-a> and B<-t> parameters "
  9077. "forwarded. Any variable that is output by its B<-s> option is integrated in "
  9078. "the build environment."
  9079. msgstr ""
  9080. #. type: TP
  9081. #: dpkg-buildpackage.man:1 dpkg-deb.man:1 dpkg-source.man:1 dpkg-split.man:1
  9082. #, no-wrap
  9083. msgid "B<SOURCE_DATE_EPOCH>"
  9084. msgstr ""
  9085. #. type: Plain text
  9086. #: dpkg-buildpackage.man:1
  9087. msgid ""
  9088. "This variable is set to the Unix timestamp since the epoch of the latest "
  9089. "entry in I<debian/changelog>, if it is not already defined."
  9090. msgstr ""
  9091. #. type: TP
  9092. #: dpkg-buildpackage.man:1
  9093. #, no-wrap
  9094. msgid "I<%PKGCONFDIR%/buildpackage.conf>"
  9095. msgstr ""
  9096. #. type: Plain text
  9097. #: dpkg-buildpackage.man:1
  9098. msgid "System wide configuration file"
  9099. msgstr ""
  9100. #. type: TP
  9101. #: dpkg-buildpackage.man:1
  9102. #, no-wrap
  9103. msgid "I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> or"
  9104. msgstr ""
  9105. #. type: TQ
  9106. #: dpkg-buildpackage.man:1
  9107. #, no-wrap
  9108. msgid "I<$HOME/.config/dpkg/buildpackage.conf>"
  9109. msgstr ""
  9110. #. type: SS
  9111. #: dpkg-buildpackage.man:1
  9112. #, no-wrap
  9113. msgid "Compiler flags are no longer exported"
  9114. msgstr ""
  9115. #. type: Plain text
  9116. #: dpkg-buildpackage.man:1
  9117. msgid ""
  9118. "Between dpkg 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler "
  9119. "flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with "
  9120. "values as returned by B<dpkg-buildflags>. This is no longer the case."
  9121. msgstr ""
  9122. #. type: SS
  9123. #: dpkg-buildpackage.man:1
  9124. #, no-wrap
  9125. msgid "Default build targets"
  9126. msgstr ""
  9127. #. type: Plain text
  9128. #: dpkg-buildpackage.man:1
  9129. msgid ""
  9130. "B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets "
  9131. "since dpkg 1.16.2. Those targets are thus mandatory. But to avoid breakages "
  9132. "of existing packages, and ease the transition, if the source package does "
  9133. "not build both architecture independent and dependent binary packages (since "
  9134. "dpkg 1.18.8) it will fallback to use the B<build> target if B<make -f "
  9135. "debian/rules -qn> I<build-target> returns 2 as exit code."
  9136. msgstr ""
  9137. #. type: Plain text
  9138. #: dpkg-buildpackage.man:1
  9139. msgid ""
  9140. "It should be possible to specify spaces and shell metacharacters and initial "
  9141. "arguments for I<gain-root-command> and I<sign-command>."
  9142. msgstr ""
  9143. #. type: Plain text
  9144. #: dpkg-buildpackage.man:1
  9145. msgid ""
  9146. "B<dpkg-source>(1), B<dpkg-architecture>(1), B<dpkg-buildflags>(1), "
  9147. "B<dpkg-genbuildinfo>(1), B<dpkg-genchanges>(1), B<fakeroot>(1), "
  9148. "B<lintian>(1), B<gpg2>(1), B<gpg>(1)."
  9149. msgstr ""
  9150. #. type: TH
  9151. #: dpkg-genbuildinfo.man:1
  9152. #, no-wrap
  9153. msgid "dpkg-genbuildinfo"
  9154. msgstr ""
  9155. #. type: Plain text
  9156. #: dpkg-genbuildinfo.man:1
  9157. msgid "dpkg-genbuildinfo - generate Debian .buildinfo files"
  9158. msgstr ""
  9159. #. type: Plain text
  9160. #: dpkg-genbuildinfo.man:1
  9161. msgid "B<dpkg-genbuildinfo> [I<option>...]"
  9162. msgstr ""
  9163. #. type: Plain text
  9164. #: dpkg-genbuildinfo.man:1
  9165. msgid ""
  9166. "B<dpkg-genbuildinfo> reads information from an unpacked and built Debian "
  9167. "source tree and from the files it has generated and generates a Debian "
  9168. "control file describing the build environment and the build artifacts "
  9169. "(B<.buildinfo> file)."
  9170. msgstr ""
  9171. #. type: Plain text
  9172. #: dpkg-genbuildinfo.man:1
  9173. msgid "This command was introduced in dpkg 1.18.11."
  9174. msgstr ""
  9175. #. type: Plain text
  9176. #: dpkg-genbuildinfo.man:1
  9177. msgid "Specifies the build I<type> from a comma-separated list of components."
  9178. msgstr ""
  9179. #. type: Plain text
  9180. #: dpkg-genbuildinfo.man:1
  9181. msgid ""
  9182. "Generate build information including unqualified build dependencies "
  9183. "(B<Build-Depends>) and architecture specific build dependencies "
  9184. "(B<Build-Depends-Arch>)."
  9185. msgstr ""
  9186. #. type: Plain text
  9187. #: dpkg-genbuildinfo.man:1
  9188. msgid ""
  9189. "Generate build information including unqualified build dependencies "
  9190. "(B<Build-Depends>) and architecture independent build dependencies "
  9191. "(B<Build-Depends-Indep>)."
  9192. msgstr ""
  9193. #. type: Plain text
  9194. #: dpkg-genbuildinfo.man:1
  9195. msgid ""
  9196. "Effectively ignored; generate build information with just the unqualified "
  9197. "build dependencies (B<Build-Depends>)."
  9198. msgstr ""
  9199. #. type: Plain text
  9200. #: dpkg-genbuildinfo.man:1
  9201. msgid ""
  9202. "Generate build information with all three types of build dependencies. This "
  9203. "is an alias for B<any,all>."
  9204. msgstr ""
  9205. #. type: Plain text
  9206. #: dpkg-genbuildinfo.man:1
  9207. msgid ""
  9208. "Generate build information with all three types of build dependencies. This "
  9209. "is an alias for B<any,all,source>, and the same as the default case when no "
  9210. "build option is specified."
  9211. msgstr ""
  9212. #. type: TP
  9213. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  9214. #, no-wrap
  9215. msgid "B<-c>I<controlfile>"
  9216. msgstr ""
  9217. #. type: Plain text
  9218. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  9219. msgid ""
  9220. "Specifies the main source control file to read information from. The default "
  9221. "is B<debian/control>."
  9222. msgstr ""
  9223. #. type: TP
  9224. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  9225. #: dpkg-source.man:1
  9226. #, no-wrap
  9227. msgid "B<-l>I<changelog-file>"
  9228. msgstr ""
  9229. #. type: Plain text
  9230. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  9231. msgid ""
  9232. "Specifies the changelog file to read information from. The default is "
  9233. "B<debian/changelog>."
  9234. msgstr ""
  9235. #. type: TP
  9236. #: dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1 dpkg-genchanges.man:1
  9237. #: dpkg-gencontrol.man:1
  9238. #, no-wrap
  9239. msgid "B<-f>I<files-list-file>"
  9240. msgstr ""
  9241. #. type: Plain text
  9242. #: dpkg-genbuildinfo.man:1
  9243. msgid ""
  9244. "Specifies where is the list of files that have been produced by the build, "
  9245. "rather than using B<debian/files>."
  9246. msgstr ""
  9247. #. type: TP
  9248. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  9249. #: dpkg-source.man:1
  9250. #, no-wrap
  9251. msgid "B<-F>I<changelog-format>"
  9252. msgstr ""
  9253. #. type: Plain text
  9254. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  9255. #: dpkg-source.man:1
  9256. msgid ""
  9257. "Specifies the format of the changelog. See B<dpkg-parsechangelog>(1) for "
  9258. "information about alternative formats."
  9259. msgstr ""
  9260. #. type: TP
  9261. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
  9262. #: dpkg-gensymbols.man:1 dpkg-shlibdeps.man:1
  9263. #, no-wrap
  9264. msgid "B<-O>[I<filename>]"
  9265. msgstr ""
  9266. #. type: Plain text
  9267. #: dpkg-genbuildinfo.man:1
  9268. msgid ""
  9269. "Print the buildinfo file to standard output (or I<filename> if specified) "
  9270. "rather than to "
  9271. "I<dir>B</>I<source-name>B<_>I<source-version>B<_>I<arch>B<.buildinfo> (where "
  9272. "I<dir> is B<..> by default or I<upload-files-dir> if B<-u> was used)."
  9273. msgstr ""
  9274. #. type: TP
  9275. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
  9276. #, no-wrap
  9277. msgid "B<-u>I<upload-files-dir>"
  9278. msgstr ""
  9279. #. type: Plain text
  9280. #: dpkg-genbuildinfo.man:1
  9281. msgid ""
  9282. "Look for the files to be uploaded in I<upload-files-dir> rather than B<..> "
  9283. "(B<dpkg-genbuildinfo> needs to find these files so that it can include their "
  9284. "sizes and checksums in the B<.buildinfo> file)."
  9285. msgstr ""
  9286. #. type: TP
  9287. #: dpkg-genbuildinfo.man:1
  9288. #, no-wrap
  9289. msgid "B<--always-include-path>"
  9290. msgstr ""
  9291. #. type: Plain text
  9292. #: dpkg-genbuildinfo.man:1
  9293. msgid ""
  9294. "By default, the B<Build-Path> field will only be written if the current "
  9295. "directory starts with a whitelisted pattern."
  9296. msgstr ""
  9297. #. type: Plain text
  9298. #: dpkg-genbuildinfo.man:1
  9299. msgid ""
  9300. "On Debian and derivatives the pattern matches on B</build/> at the start of "
  9301. "the pathname."
  9302. msgstr ""
  9303. #. type: Plain text
  9304. #: dpkg-genbuildinfo.man:1
  9305. msgid ""
  9306. "Specify this option to always write a B<Build-Path> field when generating "
  9307. "the B<.buildinfo>."
  9308. msgstr ""
  9309. #. type: Plain text
  9310. #: dpkg-genbuildinfo.man:1
  9311. msgid ""
  9312. "Change the location of the B<dpkg> database. The default location is "
  9313. "I</var/lib/dpkg>."
  9314. msgstr ""
  9315. #. type: TP
  9316. #: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gensymbols.man:1
  9317. #, no-wrap
  9318. msgid "B<-q>"
  9319. msgstr ""
  9320. #. type: Plain text
  9321. #: dpkg-genbuildinfo.man:1
  9322. msgid ""
  9323. "B<dpkg-genbuildinfo> might produce informative messages on standard error. "
  9324. "B<-q> suppresses these messages."
  9325. msgstr ""
  9326. #. type: Plain text
  9327. #: dpkg-genbuildinfo.man:1
  9328. msgid ""
  9329. "This variable can be used to enable or disable various features that affect "
  9330. "the information included in the .buildinfo file, via the B<buildinfo> option "
  9331. "(since dpkg 1.18.19). This option contains a comma-separated list of "
  9332. "features, prefixed with the ‘B<+>’ or ‘B<->’ modifiers, to denote whether to "
  9333. "enable or disable them. The special feature “B<all>” can be used to enable "
  9334. "or disable all other features. The feature “B<path>” controls whether to "
  9335. "unconditionally include the B<Build-Path> field."
  9336. msgstr ""
  9337. #. type: TP
  9338. #: dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1 dpkg-genchanges.man:1
  9339. #: dpkg-gencontrol.man:1
  9340. #, no-wrap
  9341. msgid "B<debian/files>"
  9342. msgstr ""
  9343. #. type: Plain text
  9344. #: dpkg-genbuildinfo.man:1
  9345. msgid ""
  9346. "The list of generated files. B<dpkg-genbuildinfo> reads the data here when "
  9347. "producing a B<.buildinfo> file."
  9348. msgstr ""
  9349. #. type: Plain text
  9350. #: dpkg-genbuildinfo.man:1
  9351. msgid "B<deb-buildinfo>(5)."
  9352. msgstr ""
  9353. #. type: TH
  9354. #: dpkg-checkbuilddeps.man:1
  9355. #, no-wrap
  9356. msgid "dpkg-checkbuilddeps"
  9357. msgstr ""
  9358. #. type: Plain text
  9359. #: dpkg-checkbuilddeps.man:1
  9360. msgid "dpkg-checkbuilddeps - check build dependencies and conflicts"
  9361. msgstr ""
  9362. #. type: Plain text
  9363. #: dpkg-checkbuilddeps.man:1
  9364. msgid "B<dpkg-checkbuilddeps> [I<option>...] [I<control-file>]"
  9365. msgstr ""
  9366. #. type: Plain text
  9367. #: dpkg-checkbuilddeps.man:1
  9368. msgid ""
  9369. "This program checks the installed packages in the system against the build "
  9370. "dependencies and build conflicts listed in the control file. If any are not "
  9371. "met, it displays them and exits with a nonzero return code."
  9372. msgstr ""
  9373. #. type: Plain text
  9374. #: dpkg-checkbuilddeps.man:1
  9375. msgid ""
  9376. "By default, B<debian/control> is read, but an alternate control filename may "
  9377. "be specified on the command line."
  9378. msgstr ""
  9379. #. type: Plain text
  9380. #: dpkg-checkbuilddeps.man:1
  9381. msgid ""
  9382. "Ignore B<Build-Depends-Arch> and B<Build-Conflicts-Arch> lines (since dpkg "
  9383. "1.16.4). Use when only arch-indep packages will be built, or combine with "
  9384. "B<-B> when only a source package is to be built."
  9385. msgstr ""
  9386. #. type: Plain text
  9387. #: dpkg-checkbuilddeps.man:1
  9388. msgid ""
  9389. "Ignore B<Build-Depends-Indep> and B<Build-Conflicts-Indep> lines. Use when "
  9390. "only arch-dep packages will be built, or combine with B<-A> when only a "
  9391. "source package is to be built."
  9392. msgstr ""
  9393. #. type: TP
  9394. #: dpkg-checkbuilddeps.man:1
  9395. #, no-wrap
  9396. msgid "B<-I>"
  9397. msgstr ""
  9398. #. type: Plain text
  9399. #: dpkg-checkbuilddeps.man:1
  9400. msgid ""
  9401. "Ignore built-in build depends and conflicts (since dpkg 1.18.2). These are "
  9402. "implicit dependencies that are usually required on a specific distribution, "
  9403. "the so called Build-Essential package set."
  9404. msgstr ""
  9405. #. type: TP
  9406. #: dpkg-checkbuilddeps.man:1
  9407. #, no-wrap
  9408. msgid "B<-d >I<build-depends-string>"
  9409. msgstr ""
  9410. #. type: TP
  9411. #: dpkg-checkbuilddeps.man:1
  9412. #, no-wrap
  9413. msgid "B<-c >I<build-conflicts-string>"
  9414. msgstr ""
  9415. #. type: Plain text
  9416. #: dpkg-checkbuilddeps.man:1
  9417. msgid ""
  9418. "Use the given build dependencies/conflicts instead of those contained in the "
  9419. "I<debian/control> file (since dpkg 1.14.17)."
  9420. msgstr ""
  9421. #. type: TP
  9422. #: dpkg-checkbuilddeps.man:1
  9423. #, no-wrap
  9424. msgid "B<-a >I<arch>"
  9425. msgstr ""
  9426. #. type: Plain text
  9427. #: dpkg-checkbuilddeps.man:1
  9428. msgid ""
  9429. "Check build dependencies/conflicts assuming that the package described in "
  9430. "the control file is to be built for the given host architecture instead of "
  9431. "the architecture of the current system (since dpkg 1.16.2)."
  9432. msgstr ""
  9433. #. type: TP
  9434. #: dpkg-checkbuilddeps.man:1
  9435. #, no-wrap
  9436. msgid "B<-P >I<profile>[B<,>...]"
  9437. msgstr ""
  9438. #. type: Plain text
  9439. #: dpkg-checkbuilddeps.man:1
  9440. msgid ""
  9441. "Check build dependencies/conflicts assuming that the package described in "
  9442. "the control file is to be built for the given build profile(s) (since dpkg "
  9443. "1.17.2). The argument is a comma-separated list of profile names."
  9444. msgstr ""
  9445. #. type: Plain text
  9446. #: dpkg-checkbuilddeps.man:1
  9447. msgid ""
  9448. "If set, it will be used as the active build profile(s) for the package being "
  9449. "built. It is a space separated list of profile names. Overridden by the "
  9450. "B<-P> option."
  9451. msgstr ""
  9452. #. type: TH
  9453. #: dpkg-distaddfile.man:1
  9454. #, no-wrap
  9455. msgid "dpkg-distaddfile"
  9456. msgstr ""
  9457. #. type: Plain text
  9458. #: dpkg-distaddfile.man:1
  9459. msgid "dpkg-distaddfile - add entries to debian/files"
  9460. msgstr ""
  9461. #. type: Plain text
  9462. #: dpkg-distaddfile.man:1
  9463. msgid "B<dpkg-distaddfile> [I<option>...]I< filename section priority>"
  9464. msgstr ""
  9465. #. type: Plain text
  9466. #: dpkg-distaddfile.man:1
  9467. msgid "B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>."
  9468. msgstr ""
  9469. #. type: Plain text
  9470. #: dpkg-distaddfile.man:1
  9471. msgid ""
  9472. "It takes three non-option arguments, the filename and the section and "
  9473. "priority for the B<.changes> file."
  9474. msgstr ""
  9475. #. type: Plain text
  9476. #: dpkg-distaddfile.man:1
  9477. msgid ""
  9478. "The filename should be specified relative to the directory where "
  9479. "B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than "
  9480. "being a pathname relative to the current directory when B<dpkg-distaddfile> "
  9481. "is run."
  9482. msgstr ""
  9483. #. type: Plain text
  9484. #: dpkg-distaddfile.man:1 dpkg-gencontrol.man:1
  9485. msgid ""
  9486. "Read or write the list of files to be uploaded here, rather than using "
  9487. "B<debian/files>."
  9488. msgstr ""
  9489. #. type: Plain text
  9490. #: dpkg-distaddfile.man:1
  9491. msgid ""
  9492. "The list of generated files which are part of the upload being prepared. "
  9493. "B<dpkg-distaddfile> can be used to add additional files."
  9494. msgstr ""
  9495. #. type: Plain text
  9496. #: dpkg-distaddfile.man:1
  9497. msgid "B<deb-src-files>(5)."
  9498. msgstr ""
  9499. #. type: TH
  9500. #: dpkg-deb.man:1
  9501. #, no-wrap
  9502. msgid "dpkg-deb"
  9503. msgstr ""
  9504. #. type: Plain text
  9505. #: dpkg-deb.man:1
  9506. msgid "dpkg-deb - Debian package archive (.deb) manipulation tool"
  9507. msgstr ""
  9508. #. type: Plain text
  9509. #: dpkg-deb.man:1
  9510. msgid "B<dpkg-deb> [I<option>...] I<command>"
  9511. msgstr ""
  9512. #. type: Plain text
  9513. #: dpkg-deb.man:1
  9514. msgid "B<dpkg-deb> packs, unpacks and provides information about Debian archives."
  9515. msgstr ""
  9516. #. type: Plain text
  9517. #: dpkg-deb.man:1
  9518. msgid "Use B<dpkg> to install and remove packages from your system."
  9519. msgstr ""
  9520. #. type: Plain text
  9521. #: dpkg-deb.man:1
  9522. msgid ""
  9523. "You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you "
  9524. "want to pass to B<dpkg-deb>. B<dpkg> will spot that you wanted B<dpkg-deb> "
  9525. "and run it for you."
  9526. msgstr ""
  9527. #. type: Plain text
  9528. #: dpkg-deb.man:1
  9529. msgid ""
  9530. "For most commands taking an input archive argument, the archive can be read "
  9531. "from standard input if the archive name is given as a single minus character "
  9532. "(«B<->»); otherwise lack of support will be documented in their respective "
  9533. "command description."
  9534. msgstr ""
  9535. #. type: TP
  9536. #: dpkg-deb.man:1
  9537. #, no-wrap
  9538. msgid "B<-b>, B<--build> I<binary-directory> [I<archive>|I<directory>]"
  9539. msgstr ""
  9540. #. type: Plain text
  9541. #: dpkg-deb.man:1
  9542. msgid ""
  9543. "Creates a debian archive from the filesystem tree stored in "
  9544. "I<binary-directory>. I<binary-directory> must have a B<DEBIAN> subdirectory, "
  9545. "which contains the control information files such as the control file "
  9546. "itself. This directory will I<not> appear in the binary package's filesystem "
  9547. "archive, but instead the files in it will be put in the binary package's "
  9548. "control information area."
  9549. msgstr ""
  9550. #. type: Plain text
  9551. #: dpkg-deb.man:1
  9552. msgid ""
  9553. "Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and "
  9554. "parse it. It will check the file for syntax errors and other problems, and "
  9555. "display the name of the binary package being built. B<dpkg-deb> will also "
  9556. "check the permissions of the maintainer scripts and other files found in the "
  9557. "B<DEBIAN> control information directory."
  9558. msgstr ""
  9559. #. type: Plain text
  9560. #: dpkg-deb.man:1
  9561. msgid ""
  9562. "If no I<archive> is specified then B<dpkg-deb> will write the package into "
  9563. "the file I<binary-directory>B<.deb>."
  9564. msgstr ""
  9565. #. type: Plain text
  9566. #: dpkg-deb.man:1
  9567. msgid "If the archive to be created already exists it will be overwritten."
  9568. msgstr ""
  9569. #. type: Plain text
  9570. #: dpkg-deb.man:1
  9571. msgid ""
  9572. "If the second argument is a directory then B<dpkg-deb> will write to the "
  9573. "file I<directory>B</>I<package>B<_>I<version>B<_>I<arch>B<.deb.> When a "
  9574. "target directory is specified, rather than a file, the B<--nocheck> option "
  9575. "may not be used (since B<dpkg-deb> needs to read and parse the package "
  9576. "control file to determine which filename to use)."
  9577. msgstr ""
  9578. #. type: TP
  9579. #: dpkg-deb.man:1
  9580. #, no-wrap
  9581. msgid "B<-I>, B<--info> I<archive> [I<control-file-name>...]"
  9582. msgstr ""
  9583. #. type: Plain text
  9584. #: dpkg-deb.man:1
  9585. msgid "Provides information about a binary package archive."
  9586. msgstr ""
  9587. #. type: Plain text
  9588. #: dpkg-deb.man:1
  9589. msgid ""
  9590. "If no I<control-file-name>s are specified then it will print a summary of "
  9591. "the contents of the package as well as its control file."
  9592. msgstr ""
  9593. #. type: Plain text
  9594. #: dpkg-deb.man:1
  9595. msgid ""
  9596. "If any I<control-file-name>s are specified then B<dpkg-deb> will print them "
  9597. "in the order they were specified; if any of the components weren't present "
  9598. "it will print an error message to stderr about each one and exit with status "
  9599. "2."
  9600. msgstr ""
  9601. #. type: TP
  9602. #: dpkg-deb.man:1
  9603. #, no-wrap
  9604. msgid "B<-W>, B<--show> I<archive>"
  9605. msgstr ""
  9606. #. type: Plain text
  9607. #: dpkg-deb.man:1
  9608. msgid ""
  9609. "Provides information about a binary package archive in the format specified "
  9610. "by the B<--showformat> argument. The default format displays the package's "
  9611. "name and version on one line, separated by a tabulator."
  9612. msgstr ""
  9613. #. type: TP
  9614. #: dpkg-deb.man:1
  9615. #, no-wrap
  9616. msgid "B<-f>, B<--field> I<archive> [I<control-field-name>...]"
  9617. msgstr ""
  9618. #. type: Plain text
  9619. #: dpkg-deb.man:1
  9620. msgid "Extracts control file information from a binary package archive."
  9621. msgstr ""
  9622. #. type: Plain text
  9623. #: dpkg-deb.man:1
  9624. msgid ""
  9625. "If no I<control-field-name>s are specified then it will print the whole "
  9626. "control file."
  9627. msgstr ""
  9628. #. type: Plain text
  9629. #: dpkg-deb.man:1
  9630. msgid ""
  9631. "If any are specified then B<dpkg-deb> will print their contents, in the "
  9632. "order in which they appear in the control file. If more than one "
  9633. "I<control-field-name> is specified then B<dpkg-deb> will precede each with "
  9634. "its field name (and a colon and space)."
  9635. msgstr ""
  9636. #. type: Plain text
  9637. #: dpkg-deb.man:1
  9638. msgid "No errors are reported for fields requested but not found."
  9639. msgstr ""
  9640. #. type: TP
  9641. #: dpkg-deb.man:1
  9642. #, no-wrap
  9643. msgid "B<-c>, B<--contents> I<archive>"
  9644. msgstr ""
  9645. #. type: Plain text
  9646. #: dpkg-deb.man:1
  9647. msgid ""
  9648. "Lists the contents of the filesystem tree archive portion of the package "
  9649. "archive. It is currently produced in the format generated by B<tar>'s "
  9650. "verbose listing."
  9651. msgstr ""
  9652. #. type: TP
  9653. #: dpkg-deb.man:1
  9654. #, no-wrap
  9655. msgid "B<-x>, B<--extract> I<archive directory>"
  9656. msgstr ""
  9657. #. type: Plain text
  9658. #: dpkg-deb.man:1
  9659. msgid ""
  9660. "Extracts the filesystem tree from a package archive into the specified "
  9661. "directory."
  9662. msgstr ""
  9663. #. type: Plain text
  9664. #: dpkg-deb.man:1
  9665. msgid ""
  9666. "Note that extracting a package to the root directory will I<not> result in a "
  9667. "correct installation! Use B<dpkg> to install packages."
  9668. msgstr ""
  9669. #. type: Plain text
  9670. #: dpkg-deb.man:1
  9671. msgid ""
  9672. "I<directory> (but not its parents) will be created if necessary, and its "
  9673. "permissions modified to match the contents of the package."
  9674. msgstr ""
  9675. #. type: TP
  9676. #: dpkg-deb.man:1
  9677. #, no-wrap
  9678. msgid "B<-X>, B<--vextract> I<archive directory>"
  9679. msgstr ""
  9680. #. type: Plain text
  9681. #: dpkg-deb.man:1
  9682. msgid ""
  9683. "Is like B<--extract> (B<-x>) with B<--verbose> (B<-v>) which prints a "
  9684. "listing of the files extracted as it goes."
  9685. msgstr ""
  9686. #. type: TP
  9687. #: dpkg-deb.man:1
  9688. #, no-wrap
  9689. msgid "B<-R>, B<--raw-extract> I<archive directory>"
  9690. msgstr ""
  9691. #. type: Plain text
  9692. #: dpkg-deb.man:1
  9693. msgid ""
  9694. "Extracts the filesystem tree from a package archive into a specified "
  9695. "directory, and the control information files into a B<DEBIAN> subdirectory "
  9696. "of the specified directory (since dpkg 1.16.1)."
  9697. msgstr ""
  9698. #. type: Plain text
  9699. #: dpkg-deb.man:1 dpkg-deb.man:1
  9700. msgid "The target directory (but not its parents) will be created if necessary."
  9701. msgstr ""
  9702. #. type: Plain text
  9703. #: dpkg-deb.man:1
  9704. msgid ""
  9705. "The input archive is not (currently) processed sequentially, so reading it "
  9706. "from standard input («B<->») is B<not> supported."
  9707. msgstr ""
  9708. #. type: TP
  9709. #: dpkg-deb.man:1
  9710. #, no-wrap
  9711. msgid "B<--ctrl-tarfile> I<archive>"
  9712. msgstr ""
  9713. #. type: Plain text
  9714. #: dpkg-deb.man:1
  9715. msgid ""
  9716. "Extracts the control data from a binary package and sends it to standard "
  9717. "output in B<tar> format (since dpkg 1.17.14). Together with B<tar>(1) this "
  9718. "can be used to extract a particular control file from a package archive. "
  9719. "The input archive will always be processed sequentially."
  9720. msgstr ""
  9721. #. type: TP
  9722. #: dpkg-deb.man:1
  9723. #, no-wrap
  9724. msgid "B<--fsys-tarfile> I<archive>"
  9725. msgstr ""
  9726. #. type: Plain text
  9727. #: dpkg-deb.man:1
  9728. msgid ""
  9729. "Extracts the filesystem tree data from a binary package and sends it to "
  9730. "standard output in B<tar> format. Together with B<tar>(1) this can be used "
  9731. "to extract a particular file from a package archive. The input archive will "
  9732. "always be processed sequentially."
  9733. msgstr ""
  9734. #. type: TP
  9735. #: dpkg-deb.man:1
  9736. #, no-wrap
  9737. msgid "B<-e>, B<--control> I<archive> [I<directory>]"
  9738. msgstr ""
  9739. #. type: Plain text
  9740. #: dpkg-deb.man:1
  9741. msgid ""
  9742. "Extracts the control information files from a package archive into the "
  9743. "specified directory."
  9744. msgstr ""
  9745. #. type: Plain text
  9746. #: dpkg-deb.man:1
  9747. msgid ""
  9748. "If no directory is specified then a subdirectory B<DEBIAN> in the current "
  9749. "directory is used."
  9750. msgstr ""
  9751. #. type: TP
  9752. #: dpkg-deb.man:1
  9753. #, no-wrap
  9754. msgid "B<--showformat=>I<format>"
  9755. msgstr ""
  9756. #. type: Plain text
  9757. #: dpkg-deb.man:1 dpkg-query.man:1
  9758. msgid ""
  9759. "This option is used to specify the format of the output B<--show> will "
  9760. "produce. The format is a string that will be output for each package listed."
  9761. msgstr ""
  9762. #. type: Plain text
  9763. #: dpkg-deb.man:1
  9764. msgid ""
  9765. "The string may reference any status field using the “${I<field-name>}” form, "
  9766. "a list of the valid fields can be easily produced using B<-I> on the same "
  9767. "package. A complete explanation of the formatting options (including escape "
  9768. "sequences and field tabbing) can be found in the explanation of the "
  9769. "B<--showformat> option in B<dpkg-query>(1)."
  9770. msgstr ""
  9771. #. type: Plain text
  9772. #: dpkg-deb.man:1
  9773. msgid "The default for this field is “${Package}\\et${Version}\\en”."
  9774. msgstr ""
  9775. #. type: TP
  9776. #: dpkg-deb.man:1
  9777. #, no-wrap
  9778. msgid "B<-z>I<compress-level>"
  9779. msgstr ""
  9780. #. type: Plain text
  9781. #: dpkg-deb.man:1
  9782. msgid ""
  9783. "Specify which compression level to use on the compressor backend, when "
  9784. "building a package (default is 9 for gzip, 6 for xz). The accepted values "
  9785. "are 0-9 with: 0 being mapped to compressor none for gzip. Before dpkg "
  9786. "1.16.2 level 0 was equivalent to compressor none for all compressors."
  9787. msgstr ""
  9788. #. type: TP
  9789. #: dpkg-deb.man:1
  9790. #, no-wrap
  9791. msgid "B<-S>I<compress-strategy>"
  9792. msgstr ""
  9793. #. type: Plain text
  9794. #: dpkg-deb.man:1
  9795. msgid ""
  9796. "Specify which compression strategy to use on the compressor backend, when "
  9797. "building a package (since dpkg 1.16.2). Allowed values are B<none> (since "
  9798. "dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> and B<fixed> for gzip (since "
  9799. "dpkg 1.17.0) and B<extreme> for xz."
  9800. msgstr ""
  9801. #. type: TP
  9802. #: dpkg-deb.man:1
  9803. #, no-wrap
  9804. msgid "B<-Z>I<compress-type>"
  9805. msgstr ""
  9806. #. type: Plain text
  9807. #: dpkg-deb.man:1
  9808. msgid ""
  9809. "Specify which compression type to use when building a package. Allowed "
  9810. "values are B<gzip>, B<xz> (since dpkg 1.15.6), and B<none> (default is "
  9811. "B<xz>)."
  9812. msgstr ""
  9813. #. type: TP
  9814. #: dpkg-deb.man:1
  9815. #, no-wrap
  9816. msgid "B<--uniform-compression>"
  9817. msgstr ""
  9818. #. type: Plain text
  9819. #: dpkg-deb.man:1
  9820. msgid ""
  9821. "Specify that the same compression parameters should be used for all archive "
  9822. "members (i.e. B<control.tar> and B<data.tar>; since dpkg 1.17.6). Otherwise "
  9823. "only the B<data.tar> member will use those parameters. The only supported "
  9824. "compression types allowed to be uniformly used are B<none>, B<gzip> and "
  9825. "B<xz>."
  9826. msgstr ""
  9827. #. type: TP
  9828. #: dpkg-deb.man:1
  9829. #, no-wrap
  9830. msgid "B<--deb-format=>I<format>"
  9831. msgstr ""
  9832. #. type: Plain text
  9833. #: dpkg-deb.man:1
  9834. msgid ""
  9835. "Set the archive format version used when building (since dpkg 1.17.0). "
  9836. "Allowed values are B<2.0> for the new format, and B<0.939000> for the old "
  9837. "one (default is B<2.0>)."
  9838. msgstr ""
  9839. #. type: Plain text
  9840. #: dpkg-deb.man:1
  9841. msgid ""
  9842. "The old archive format is less easily parsed by non-Debian tools and is now "
  9843. "obsolete; its only use is when building packages to be parsed by versions of "
  9844. "dpkg older than 0.93.76 (September 1995), which was released as i386 a.out "
  9845. "only."
  9846. msgstr ""
  9847. #. type: TP
  9848. #: dpkg-deb.man:1
  9849. #, no-wrap
  9850. msgid "B<--nocheck>"
  9851. msgstr ""
  9852. #. type: Plain text
  9853. #: dpkg-deb.man:1
  9854. msgid ""
  9855. "Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an "
  9856. "archive. You can build any archive you want, no matter how broken, this way."
  9857. msgstr ""
  9858. #. type: TP
  9859. #: dpkg-deb.man:1 start-stop-daemon.man:1
  9860. #, no-wrap
  9861. msgid "B<-v>, B<--verbose>"
  9862. msgstr ""
  9863. #. type: Plain text
  9864. #: dpkg-deb.man:1
  9865. msgid ""
  9866. "Enables verbose output (since dpkg 1.16.1). This currently only affects "
  9867. "B<--extract> making it behave like B<--vextract>."
  9868. msgstr ""
  9869. #. type: TP
  9870. #: dpkg-deb.man:1
  9871. #, no-wrap
  9872. msgid "B<-D>, B<--debug>"
  9873. msgstr ""
  9874. #. type: Plain text
  9875. #: dpkg-deb.man:1
  9876. msgid "Enables debugging output. This is not very interesting."
  9877. msgstr ""
  9878. #. type: Plain text
  9879. #: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-statoverride.man:1
  9880. #: update-alternatives.man:1
  9881. msgid "The requested action was successfully performed."
  9882. msgstr ""
  9883. #. type: Plain text
  9884. #: dpkg-deb.man:1
  9885. msgid ""
  9886. "If set, B<dpkg-deb> will use it as the directory in which to create "
  9887. "temporary files and directories."
  9888. msgstr ""
  9889. #. type: Plain text
  9890. #: dpkg-deb.man:1
  9891. msgid ""
  9892. "If set, it will be used as the timestamp (as seconds since the epoch) in the "
  9893. "B<deb>(5)'s B<ar>(5) container and used to clamp the mtime in the B<tar>(5) "
  9894. "file entries."
  9895. msgstr ""
  9896. #. type: Plain text
  9897. #: dpkg-deb.man:1
  9898. msgid ""
  9899. "Do not attempt to use just B<dpkg-deb> to install software! You must use "
  9900. "B<dpkg> proper to ensure that all the files are correctly placed and the "
  9901. "package's scripts run and its status and contents recorded."
  9902. msgstr ""
  9903. #. type: Plain text
  9904. #: dpkg-deb.man:1
  9905. msgid "B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing."
  9906. msgstr ""
  9907. #. type: Plain text
  9908. #: dpkg-deb.man:1
  9909. msgid ""
  9910. "There is no authentication on B<.deb> files; in fact, there isn't even a "
  9911. "straightforward checksum. (Higher level tools like APT support "
  9912. "authenticating B<.deb> packages retrieved from a given repository, and most "
  9913. "packages nowadays provide an md5sum control file generated by "
  9914. "debian/rules. Though this is not directly supported by the lower level "
  9915. "tools.)"
  9916. msgstr ""
  9917. #. type: Plain text
  9918. #: dpkg-deb.man:1
  9919. msgid "B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dselect>(1)."
  9920. msgstr ""
  9921. #. type: TH
  9922. #: dpkg-divert.man:1
  9923. #, no-wrap
  9924. msgid "dpkg-divert"
  9925. msgstr ""
  9926. #. type: Plain text
  9927. #: dpkg-divert.man:1
  9928. msgid "dpkg-divert - override a package's version of a file"
  9929. msgstr ""
  9930. #. type: Plain text
  9931. #: dpkg-divert.man:1
  9932. msgid "B<dpkg-divert> [I<option>...] I<command>"
  9933. msgstr ""
  9934. #. type: Plain text
  9935. #: dpkg-divert.man:1
  9936. msgid ""
  9937. "B<dpkg-divert> is the utility used to set up and update the list of "
  9938. "diversions."
  9939. msgstr ""
  9940. #. type: Plain text
  9941. #: dpkg-divert.man:1
  9942. msgid ""
  9943. "File I<diversions> are a way of forcing B<dpkg>(1) not to install a file "
  9944. "into its location, but to a I<diverted> location. Diversions can be used "
  9945. "through the Debian package scripts to move a file away when it causes a "
  9946. "conflict. System administrators can also use it to override some package's "
  9947. "configuration file, or whenever some files (which aren't marked as "
  9948. "“conffiles”) need to be preserved by B<dpkg>, when installing a newer "
  9949. "version of a package which contains those files."
  9950. msgstr ""
  9951. #. type: TP
  9952. #: dpkg-divert.man:1
  9953. #, no-wrap
  9954. msgid "[B<--add>] I<file>"
  9955. msgstr ""
  9956. #. type: Plain text
  9957. #: dpkg-divert.man:1
  9958. msgid "Add a diversion for I<file>."
  9959. msgstr ""
  9960. #. type: TP
  9961. #: dpkg-divert.man:1
  9962. #, no-wrap
  9963. msgid "B<--remove>I< file>"
  9964. msgstr ""
  9965. #. type: Plain text
  9966. #: dpkg-divert.man:1
  9967. msgid "Remove a diversion for I<file>."
  9968. msgstr ""
  9969. #. type: TP
  9970. #: dpkg-divert.man:1
  9971. #, no-wrap
  9972. msgid "B<--list>I< glob-pattern>"
  9973. msgstr ""
  9974. #. type: Plain text
  9975. #: dpkg-divert.man:1
  9976. msgid "List diversions matching I<glob-pattern>."
  9977. msgstr ""
  9978. #. type: TP
  9979. #: dpkg-divert.man:1
  9980. #, no-wrap
  9981. msgid "B<--listpackage>I< file>"
  9982. msgstr ""
  9983. #. type: Plain text
  9984. #: dpkg-divert.man:1
  9985. msgid ""
  9986. "Print the name of the package that diverts I<file> (since dpkg 1.15.0). "
  9987. "Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not "
  9988. "diverted."
  9989. msgstr ""
  9990. #. type: TP
  9991. #: dpkg-divert.man:1
  9992. #, no-wrap
  9993. msgid "B<--truename>I< file>"
  9994. msgstr ""
  9995. #. type: Plain text
  9996. #: dpkg-divert.man:1
  9997. msgid "Print the real name for a diverted file."
  9998. msgstr ""
  9999. #. type: TP
  10000. #: dpkg-divert.man:1 dpkg-statoverride.man:1 dselect.man:1
  10001. #: update-alternatives.man:1
  10002. #, no-wrap
  10003. msgid "B<--admindir>I< directory>"
  10004. msgstr ""
  10005. #. type: Plain text
  10006. #: dpkg-divert.man:1
  10007. msgid "Set the B<dpkg> data directory to I<directory> (default: I<%ADMINDIR%>)."
  10008. msgstr ""
  10009. #. type: TP
  10010. #: dpkg-divert.man:1
  10011. #, no-wrap
  10012. msgid "B<--divert>I< divert-to>"
  10013. msgstr ""
  10014. #. type: Plain text
  10015. #: dpkg-divert.man:1
  10016. msgid ""
  10017. "I<divert-to> is the location where the versions of I<file>, as provided by "
  10018. "other packages, will be diverted."
  10019. msgstr ""
  10020. #. type: TP
  10021. #: dpkg-divert.man:1
  10022. #, no-wrap
  10023. msgid "B<--local>"
  10024. msgstr ""
  10025. #. type: Plain text
  10026. #: dpkg-divert.man:1
  10027. msgid ""
  10028. "Specifies that all packages' versions of this file are diverted. This "
  10029. "means, that there are no exceptions, and whatever package is installed, the "
  10030. "file is diverted. This can be used by an admin to install a locally modified "
  10031. "version."
  10032. msgstr ""
  10033. #. type: TP
  10034. #: dpkg-divert.man:1
  10035. #, no-wrap
  10036. msgid "B<--package>I< package>"
  10037. msgstr ""
  10038. #. type: Plain text
  10039. #: dpkg-divert.man:1
  10040. msgid ""
  10041. "I<package> is the name of a package whose copy of I<file> will not be "
  10042. "diverted. i.e. I<file> will be diverted for all packages except I<package>."
  10043. msgstr ""
  10044. #. type: TP
  10045. #: dpkg-divert.man:1 dpkg-statoverride.man:1 update-alternatives.man:1
  10046. #, no-wrap
  10047. msgid "B<--quiet>"
  10048. msgstr ""
  10049. #. type: Plain text
  10050. #: dpkg-divert.man:1
  10051. msgid "Quiet mode, i.e. no verbose output."
  10052. msgstr ""
  10053. #. type: TP
  10054. #: dpkg-divert.man:1
  10055. #, no-wrap
  10056. msgid "B<--rename>"
  10057. msgstr ""
  10058. #. type: Plain text
  10059. #: dpkg-divert.man:1
  10060. msgid ""
  10061. "Actually move the file aside (or back). B<dpkg-divert> will abort operation "
  10062. "in case the destination file already exists."
  10063. msgstr ""
  10064. #. type: TP
  10065. #: dpkg-divert.man:1
  10066. #, no-wrap
  10067. msgid "B<--test>"
  10068. msgstr ""
  10069. #. type: Plain text
  10070. #: dpkg-divert.man:1
  10071. msgid "Test mode, i.e. don't actually perform any changes, just demonstrate."
  10072. msgstr ""
  10073. #. type: Plain text
  10074. #: dpkg-divert.man:1 dpkg-query.man:1 dpkg-statoverride.man:1
  10075. #: dpkg-trigger.man:1
  10076. msgid ""
  10077. "If set and the B<--admindir> option has not been specified, it will be used "
  10078. "as the B<dpkg> data directory."
  10079. msgstr ""
  10080. #. type: Plain text
  10081. #: dpkg-divert.man:1
  10082. msgid ""
  10083. "If set and the B<--local> and B<--package> options have not been specified, "
  10084. "B<dpkg-divert> will use it as the package name."
  10085. msgstr ""
  10086. #. type: TP
  10087. #: dpkg-divert.man:1
  10088. #, no-wrap
  10089. msgid "I<%ADMINDIR%/diversions>"
  10090. msgstr ""
  10091. #. type: Plain text
  10092. #: dpkg-divert.man:1
  10093. msgid ""
  10094. "File which contains the current list of diversions of the system. It is "
  10095. "located in the B<dpkg> administration directory, along with other files "
  10096. "important to B<dpkg>, such as I<status> or I<available>."
  10097. msgstr ""
  10098. #. type: Plain text
  10099. #: dpkg-divert.man:1
  10100. msgid ""
  10101. "Note: B<dpkg-divert> preserves the old copy of this file, with extension "
  10102. "I<-old>, before replacing it with the new one."
  10103. msgstr ""
  10104. #. type: Plain text
  10105. #: dpkg-divert.man:1
  10106. msgid ""
  10107. "When adding, default is B<--local> and B<--divert> "
  10108. "I<original>B<.distrib>. When removing, B<--package> or B<--local> and "
  10109. "B<--divert> must match if specified."
  10110. msgstr ""
  10111. #. type: Plain text
  10112. #: dpkg-divert.man:1
  10113. msgid "Directories can't be diverted with B<dpkg-divert>."
  10114. msgstr ""
  10115. #. type: Plain text
  10116. #: dpkg-divert.man:1
  10117. msgid ""
  10118. "Care should be taken when diverting shared libraries, B<ldconfig>(8) "
  10119. "creates a symbolic link based on the DT_SONAME field embedded in the "
  10120. "library. Because B<ldconfig> doesn't honour diverts (only B<dpkg> does), "
  10121. "the symlink may end up pointing at the diverted library, if a diverted "
  10122. "library has the same SONAME as the undiverted one."
  10123. msgstr ""
  10124. #. type: Plain text
  10125. #: dpkg-divert.man:1
  10126. msgid ""
  10127. "To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, "
  10128. "i.e. directs all packages providing I</usr/bin/example> to install it as "
  10129. "I</usr/bin/example.foo>, performing the rename if required:"
  10130. msgstr ""
  10131. #. type: Plain text
  10132. #: dpkg-divert.man:1
  10133. msgid "dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example"
  10134. msgstr ""
  10135. #. type: Plain text
  10136. #: dpkg-divert.man:1 dpkg-divert.man:1
  10137. msgid "To remove that diversion:"
  10138. msgstr ""
  10139. #. type: Plain text
  10140. #: dpkg-divert.man:1
  10141. msgid "dpkg-divert --rename --remove /usr/bin/example"
  10142. msgstr ""
  10143. #. type: Plain text
  10144. #: dpkg-divert.man:1
  10145. msgid ""
  10146. "To divert any package trying to install I</usr/bin/example> to "
  10147. "I</usr/bin/example.foo>, except your own I<wibble> package:"
  10148. msgstr ""
  10149. #. type: Plain text
  10150. #: dpkg-divert.man:1
  10151. msgid ""
  10152. "dpkg-divert --package wibble --divert /usr/bin/example.foo --rename "
  10153. "/usr/bin/example"
  10154. msgstr ""
  10155. #. type: Plain text
  10156. #: dpkg-divert.man:1
  10157. msgid "dpkg-divert --package wibble --rename --remove /usr/bin/example"
  10158. msgstr ""
  10159. #. type: TH
  10160. #: dpkg-genchanges.man:1
  10161. #, no-wrap
  10162. msgid "dpkg-genchanges"
  10163. msgstr ""
  10164. #. type: Plain text
  10165. #: dpkg-genchanges.man:1
  10166. msgid "dpkg-genchanges - generate Debian .changes files"
  10167. msgstr ""
  10168. #. type: Plain text
  10169. #: dpkg-genchanges.man:1
  10170. msgid "B<dpkg-genchanges> [I<option>...]"
  10171. msgstr ""
  10172. #. type: Plain text
  10173. #: dpkg-genchanges.man:1
  10174. msgid ""
  10175. "B<dpkg-genchanges> reads information from an unpacked and built Debian "
  10176. "source tree and from the files it has generated and generates a Debian "
  10177. "upload control file (B<.changes> file)."
  10178. msgstr ""
  10179. #. type: Plain text
  10180. #: dpkg-genchanges.man:1
  10181. msgid ""
  10182. "Specifies the build I<type> from a comma-separated list of components (since "
  10183. "dpkg 1.18.5)."
  10184. msgstr ""
  10185. #. type: Plain text
  10186. #: dpkg-genchanges.man:1
  10187. msgid "Upload the source package."
  10188. msgstr ""
  10189. #. type: Plain text
  10190. #: dpkg-genchanges.man:1
  10191. msgid "Upload the architecture specific binary packages."
  10192. msgstr ""
  10193. #. type: Plain text
  10194. #: dpkg-genchanges.man:1
  10195. msgid "Upload the architecture independent binary packages."
  10196. msgstr ""
  10197. #. type: Plain text
  10198. #: dpkg-genchanges.man:1
  10199. msgid ""
  10200. "Upload the architecture specific and independent binary packages. This is "
  10201. "an alias for B<any,all>."
  10202. msgstr ""
  10203. #. type: Plain text
  10204. #: dpkg-genchanges.man:1
  10205. msgid ""
  10206. "Upload everything. This is alias for B<source,any,all>, and the same as the "
  10207. "default case when no build option is specified."
  10208. msgstr ""
  10209. #. type: Plain text
  10210. #: dpkg-genchanges.man:1
  10211. msgid ""
  10212. "The B<-s>I<x> options control whether the original source archive is "
  10213. "included in the upload if any source is being generated (i.e. B<-b> or "
  10214. "B<-B> haven't been used)."
  10215. msgstr ""
  10216. #. type: Plain text
  10217. #: dpkg-genchanges.man:1
  10218. msgid ""
  10219. "By default, or if specified, the original source will be included only if "
  10220. "the upstream version number (the version without epoch and without Debian "
  10221. "revision) differs from the upstream version number of the previous changelog "
  10222. "entry."
  10223. msgstr ""
  10224. #. type: Plain text
  10225. #: dpkg-genchanges.man:1
  10226. msgid "Forces the inclusion of the original source."
  10227. msgstr ""
  10228. #. type: Plain text
  10229. #: dpkg-genchanges.man:1
  10230. msgid "Forces the exclusion of the original source and includes only the diff."
  10231. msgstr ""
  10232. #. type: Plain text
  10233. #: dpkg-genchanges.man:1
  10234. msgid ""
  10235. "Causes changelog information from all versions strictly later than "
  10236. "I<version> to be used."
  10237. msgstr ""
  10238. #. type: Plain text
  10239. #: dpkg-genchanges.man:1
  10240. msgid ""
  10241. "Read the description of the changes from the file I<changes-description> "
  10242. "rather than using the information from the source tree's changelog file."
  10243. msgstr ""
  10244. #. type: TP
  10245. #: dpkg-genchanges.man:1
  10246. #, no-wrap
  10247. msgid "B<-m>I<maintainer-address>"
  10248. msgstr ""
  10249. #. type: Plain text
  10250. #: dpkg-genchanges.man:1
  10251. msgid ""
  10252. "Use I<maintainer-address> as the name and email address of the maintainer "
  10253. "for this package, rather than using the information from the source tree's "
  10254. "control file."
  10255. msgstr ""
  10256. #. type: TP
  10257. #: dpkg-genchanges.man:1
  10258. #, no-wrap
  10259. msgid "B<-e>I<maintainer-address>"
  10260. msgstr ""
  10261. #. type: Plain text
  10262. #: dpkg-genchanges.man:1
  10263. msgid ""
  10264. "Use I<maintainer-address> as the name and email address of the maintainer "
  10265. "for this upload, rather than using the information from the source tree's "
  10266. "changelog."
  10267. msgstr ""
  10268. #. type: TP
  10269. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
  10270. #, no-wrap
  10271. msgid "B<-V>I<name>B<=>I<value>"
  10272. msgstr ""
  10273. #. type: Plain text
  10274. #: dpkg-genchanges.man:1 dpkg-source.man:1
  10275. msgid ""
  10276. "Set an output substitution variable. See B<deb-substvars>(5) for a "
  10277. "discussion of output substitution."
  10278. msgstr ""
  10279. #. type: TP
  10280. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-shlibdeps.man:1
  10281. #: dpkg-source.man:1
  10282. #, no-wrap
  10283. msgid "B<-T>I<substvars-file>"
  10284. msgstr ""
  10285. #. type: Plain text
  10286. #: dpkg-genchanges.man:1
  10287. msgid ""
  10288. "Read substitution variables in I<substvars-file>; the default is "
  10289. "B<debian/substvars>. No variable substitution is done on any of the fields "
  10290. "that are output, however the special variable I<Format> will override the "
  10291. "field of the same name. This option can be used multiple times to read "
  10292. "substitution variables from multiple files (since dpkg 1.15.6)."
  10293. msgstr ""
  10294. #. type: TP
  10295. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
  10296. #, no-wrap
  10297. msgid "B<-D>I<field>B<=>I<value>"
  10298. msgstr ""
  10299. #. type: Plain text
  10300. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
  10301. msgid "Override or add an output control file field."
  10302. msgstr ""
  10303. #. type: TP
  10304. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
  10305. #, no-wrap
  10306. msgid "B<-U>I<field>"
  10307. msgstr ""
  10308. #. type: Plain text
  10309. #: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
  10310. msgid "Remove an output control file field."
  10311. msgstr ""
  10312. #. type: Plain text
  10313. #: dpkg-genchanges.man:1
  10314. msgid ""
  10315. "Read the list of files to be uploaded here, rather than using "
  10316. "B<debian/files>."
  10317. msgstr ""
  10318. #. type: Plain text
  10319. #: dpkg-genchanges.man:1
  10320. msgid ""
  10321. "Look for the files to be uploaded in I<upload-files-dir> rather than B<..> "
  10322. "(B<dpkg-genchanges> needs to find these files so that it can include their "
  10323. "sizes and checksums in the B<.changes> file)."
  10324. msgstr ""
  10325. #. type: Plain text
  10326. #: dpkg-genchanges.man:1
  10327. msgid ""
  10328. "Usually B<dpkg-genchanges> will produce informative messages on standard "
  10329. "error, for example about how many of the package's source files are being "
  10330. "uploaded. B<-q> suppresses these messages."
  10331. msgstr ""
  10332. #. type: Plain text
  10333. #: dpkg-genchanges.man:1
  10334. msgid ""
  10335. "Print the changes file to standard output (the default) or to I<filename> if "
  10336. "specified (since dpkg 1.18.5)."
  10337. msgstr ""
  10338. #. type: Plain text
  10339. #: dpkg-genchanges.man:1
  10340. msgid ""
  10341. "The list of generated files which are part of the upload being prepared. "
  10342. "B<dpkg-genchanges> reads the data here when producing a B<.changes> file."
  10343. msgstr ""
  10344. #. type: Plain text
  10345. #: dpkg-genchanges.man:1
  10346. msgid ""
  10347. "B<deb-substvars>(5), B<deb-src-control>(5), B<deb-src-files>(5), "
  10348. "B<deb-changelog>(5), B<deb-changes>(5)."
  10349. msgstr ""
  10350. #. type: TH
  10351. #: dpkg-gencontrol.man:1
  10352. #, no-wrap
  10353. msgid "dpkg-gencontrol"
  10354. msgstr ""
  10355. #. type: Plain text
  10356. #: dpkg-gencontrol.man:1
  10357. msgid "dpkg-gencontrol - generate Debian control files"
  10358. msgstr ""
  10359. #. type: Plain text
  10360. #: dpkg-gencontrol.man:1
  10361. msgid "B<dpkg-gencontrol> [I<option>...]"
  10362. msgstr ""
  10363. #. type: Plain text
  10364. #: dpkg-gencontrol.man:1
  10365. msgid ""
  10366. "B<dpkg-gencontrol> reads information from an unpacked Debian source tree and "
  10367. "generates a binary package control file (which defaults to "
  10368. "debian/tmp/DEBIAN/control); during this process it will simplify the "
  10369. "relation fields."
  10370. msgstr ""
  10371. #. type: Plain text
  10372. #: dpkg-gencontrol.man:1
  10373. msgid ""
  10374. "Thus B<Pre-Depends>, B<Depends>, B<Recommends> and B<Suggests> are "
  10375. "simplified in this order by removing dependencies which are known to be true "
  10376. "according to the stronger dependencies already parsed. It will also remove "
  10377. "any self-dependency (in fact it will remove any dependency which evaluates "
  10378. "to true given the current version of the package as installed). Logically it "
  10379. "keeps the intersection of multiple dependencies on the same package. The "
  10380. "order of dependencies is preserved as best as possible: if any dependency "
  10381. "must be discarded due to another dependency appearing further in the field, "
  10382. "the superseding dependency will take the place of the discarded one."
  10383. msgstr ""
  10384. #. type: Plain text
  10385. #: dpkg-gencontrol.man:1
  10386. msgid ""
  10387. "The other relation fields (B<Enhances>, B<Conflicts>, B<Breaks>, B<Replaces> "
  10388. "and B<Provides>) are also simplified individually by computing the union of "
  10389. "the various dependencies when a package is listed multiple times in the "
  10390. "field."
  10391. msgstr ""
  10392. #. type: Plain text
  10393. #: dpkg-gencontrol.man:1
  10394. msgid ""
  10395. "B<dpkg-gencontrol> also adds an entry for the binary package to "
  10396. "B<debian/files>."
  10397. msgstr ""
  10398. #. type: Plain text
  10399. #: dpkg-gencontrol.man:1
  10400. msgid "Sets the version number of the binary package which will be generated."
  10401. msgstr ""
  10402. #. type: Plain text
  10403. #: dpkg-gencontrol.man:1
  10404. msgid ""
  10405. "Set an output substitution variable. See B<deb-substvars>(5) for discussion "
  10406. "of output substitution."
  10407. msgstr ""
  10408. #. type: Plain text
  10409. #: dpkg-gencontrol.man:1
  10410. msgid ""
  10411. "Read substitution variables in I<substvars-file>; the default is "
  10412. "B<debian/substvars>. This option can be used multiple times to read "
  10413. "substitution variables from multiple files (since dpkg 1.15.6)."
  10414. msgstr ""
  10415. #. type: TP
  10416. #: dpkg-gencontrol.man:1 dpkg-source.man:1
  10417. #, no-wrap
  10418. msgid "B<-c>I<control-file>"
  10419. msgstr ""
  10420. #. type: TP
  10421. #: dpkg-gencontrol.man:1 dpkg-gensymbols.man:1
  10422. #, no-wrap
  10423. msgid "B<-p>I<package>"
  10424. msgstr ""
  10425. #. type: Plain text
  10426. #: dpkg-gencontrol.man:1
  10427. msgid ""
  10428. "Generate information for the binary package I<package>. If the source "
  10429. "control file lists only one binary package then this option may be omitted; "
  10430. "otherwise it is essential to select which binary package's information to "
  10431. "generate."
  10432. msgstr ""
  10433. #. type: TP
  10434. #: dpkg-gencontrol.man:1
  10435. #, no-wrap
  10436. msgid "B<-n>I<filename>"
  10437. msgstr ""
  10438. #. type: Plain text
  10439. #: dpkg-gencontrol.man:1
  10440. msgid ""
  10441. "Assume the filename of the package will be I<filename> instead of the normal "
  10442. "package_version_arch.deb filename."
  10443. msgstr ""
  10444. #. type: TP
  10445. #: dpkg-gencontrol.man:1
  10446. #, no-wrap
  10447. msgid "B<-is>, B<-ip>, B<-isp>"
  10448. msgstr ""
  10449. #. type: Plain text
  10450. #: dpkg-gencontrol.man:1
  10451. msgid ""
  10452. "These options are ignored for compatibility with older versions of the dpkg "
  10453. "build scripts but are now deprecated. Previously they were used to tell "
  10454. "B<dpkg-gencontrol> to include the Section and Priority fields in the control "
  10455. "file. This is now the default behaviour. If you want to get the old "
  10456. "behaviour you can use the B<-U> option to delete the fields from the control "
  10457. "file."
  10458. msgstr ""
  10459. #. type: TP
  10460. #: dpkg-gencontrol.man:1 dpkg-gensymbols.man:1
  10461. #, no-wrap
  10462. msgid "B<-P>I<package-build-dir>"
  10463. msgstr ""
  10464. #. type: Plain text
  10465. #: dpkg-gencontrol.man:1
  10466. msgid ""
  10467. "Tells B<dpkg-source> that the package is being built in I<package-build-dir> "
  10468. "instead of B<debian/tmp>. This value is used to find the default value of "
  10469. "the B<Installed-Size> substitution variable and control file field (using "
  10470. "B<du>), and for the default location of the output file."
  10471. msgstr ""
  10472. #. type: Plain text
  10473. #: dpkg-gencontrol.man:1
  10474. msgid ""
  10475. "Print the control file to standard output (or I<filename> if specified, "
  10476. "since dpkg 1.17.2), rather than to B<debian/tmp/DEBIAN/control> (or "
  10477. "I<package-build-dir>B</DEBIAN/control> if B<-P> was used)."
  10478. msgstr ""
  10479. #. type: TP
  10480. #: dpkg-gencontrol.man:1
  10481. #, no-wrap
  10482. msgid "B<debian/control>"
  10483. msgstr ""
  10484. #. type: Plain text
  10485. #: dpkg-gencontrol.man:1
  10486. msgid ""
  10487. "The main source control information file, giving version-independent "
  10488. "information about the source package and the binary packages it can produce."
  10489. msgstr ""
  10490. #. type: Plain text
  10491. #: dpkg-gencontrol.man:1
  10492. msgid ""
  10493. "The list of generated files which are part of the upload being prepared. "
  10494. "B<dpkg-gencontrol> adds the presumed filenames of binary packages whose "
  10495. "control files it generates here."
  10496. msgstr ""
  10497. #. type: Plain text
  10498. #: dpkg-gencontrol.man:1
  10499. msgid ""
  10500. "B<deb-substvars>(5), B<deb-src-control>(5), B<deb-changelog>(5), "
  10501. "B<deb-control>(5)."
  10502. msgstr ""
  10503. #. type: TH
  10504. #: dpkg-gensymbols.man:1
  10505. #, no-wrap
  10506. msgid "dpkg-gensymbols"
  10507. msgstr ""
  10508. #. type: Plain text
  10509. #: dpkg-gensymbols.man:1
  10510. msgid ""
  10511. "dpkg-gensymbols - generate symbols files (shared library dependency "
  10512. "information)"
  10513. msgstr ""
  10514. #. type: Plain text
  10515. #: dpkg-gensymbols.man:1
  10516. msgid "B<dpkg-gensymbols> [I<option>...]"
  10517. msgstr ""
  10518. #. type: Plain text
  10519. #: dpkg-gensymbols.man:1
  10520. msgid ""
  10521. "B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) "
  10522. "looking for libraries and generates a I<symbols> file describing them. This "
  10523. "file, if non-empty, is then installed in the DEBIAN subdirectory of the "
  10524. "build tree so that it ends up included in the control information of the "
  10525. "package."
  10526. msgstr ""
  10527. #. type: Plain text
  10528. #: dpkg-gensymbols.man:1
  10529. msgid ""
  10530. "When generating those files, it uses as input some symbols files provided by "
  10531. "the maintainer. It looks for the following files (and uses the first that is "
  10532. "found):"
  10533. msgstr ""
  10534. #. type: Plain text
  10535. #: dpkg-gensymbols.man:1
  10536. msgid "debian/I<package>.symbols.I<arch>"
  10537. msgstr ""
  10538. #. type: Plain text
  10539. #: dpkg-gensymbols.man:1
  10540. msgid "debian/symbols.I<arch>"
  10541. msgstr ""
  10542. #. type: Plain text
  10543. #: dpkg-gensymbols.man:1
  10544. msgid "debian/I<package>.symbols"
  10545. msgstr ""
  10546. #. type: Plain text
  10547. #: dpkg-gensymbols.man:1
  10548. msgid "debian/symbols"
  10549. msgstr ""
  10550. #. type: Plain text
  10551. #: dpkg-gensymbols.man:1
  10552. msgid ""
  10553. "The main interest of those files is to provide the minimal version "
  10554. "associated to each symbol provided by the libraries. Usually it corresponds "
  10555. "to the first version of that package that provided the symbol, but it can be "
  10556. "manually incremented by the maintainer if the ABI of the symbol is extended "
  10557. "without breaking backwards compatibility. It's the responsibility of the "
  10558. "maintainer to keep those files up-to-date and accurate, but "
  10559. "B<dpkg-gensymbols> helps with that."
  10560. msgstr ""
  10561. #. type: Plain text
  10562. #: dpkg-gensymbols.man:1
  10563. msgid ""
  10564. "When the generated symbols files differ from the maintainer supplied one, "
  10565. "B<dpkg-gensymbols> will print a diff between the two versions. Furthermore "
  10566. "if the difference is too significant, it will even fail (you can customize "
  10567. "how much difference you can tolerate, see the B<-c> option)."
  10568. msgstr ""
  10569. #. type: SH
  10570. #: dpkg-gensymbols.man:1
  10571. #, no-wrap
  10572. msgid "MAINTAINING SYMBOLS FILES"
  10573. msgstr ""
  10574. #. type: Plain text
  10575. #: dpkg-gensymbols.man:1
  10576. msgid ""
  10577. "The symbols files are really useful only if they reflect the evolution of "
  10578. "the package through several releases. Thus the maintainer has to update them "
  10579. "every time that a new symbol is added so that its associated minimal version "
  10580. "matches reality. The diffs contained in the build logs can be used as a "
  10581. "starting point, but the maintainer, additionally, has to make sure that the "
  10582. "behaviour of those symbols has not changed in a way that would make anything "
  10583. "using those symbols and linking against the new version, stop working with "
  10584. "the old version. In most cases, the diff applies directly to the "
  10585. "debian/I<package>.symbols file. That said, further tweaks are usually "
  10586. "needed: it's recommended for example to drop the Debian revision from the "
  10587. "minimal version so that backports with a lower version number but the same "
  10588. "upstream version still satisfy the generated dependencies. If the Debian "
  10589. "revision can't be dropped because the symbol really got added by the Debian "
  10590. "specific change, then one should suffix the version with ‘B<~>’."
  10591. msgstr ""
  10592. #. type: Plain text
  10593. #: dpkg-gensymbols.man:1
  10594. msgid ""
  10595. "Before applying any patch to the symbols file, the maintainer should "
  10596. "double-check that it's sane. Public symbols are not supposed to disappear, "
  10597. "so the patch should ideally only add new lines."
  10598. msgstr ""
  10599. #. type: Plain text
  10600. #: dpkg-gensymbols.man:1
  10601. msgid ""
  10602. "Note that you can put comments in symbols files: any line with ‘#’ as the "
  10603. "first character is a comment except if it starts with ‘#include’ (see "
  10604. "section B<Using includes>). Lines starting with ‘#MISSING:’ are special "
  10605. "comments documenting symbols that have disappeared."
  10606. msgstr ""
  10607. #. type: Plain text
  10608. #: dpkg-gensymbols.man:1
  10609. msgid ""
  10610. "Do not forget to check if old symbol versions need to be increased. There "
  10611. "is no way B<dpkg-gensymbols> can warn about this. Blindly applying the diff "
  10612. "or assuming there is nothing to change if there is no diff, without checking "
  10613. "for such changes, can lead to packages with loose dependencies that claim "
  10614. "they can work with older packages they cannot work with. This will introduce "
  10615. "hard to find bugs with (partial) upgrades."
  10616. msgstr ""
  10617. #. type: SS
  10618. #: dpkg-gensymbols.man:1
  10619. #, no-wrap
  10620. msgid "Using #PACKAGE# substitution"
  10621. msgstr ""
  10622. #. type: Plain text
  10623. #: dpkg-gensymbols.man:1
  10624. msgid ""
  10625. "In some rare cases, the name of the library varies between architectures. "
  10626. "To avoid hardcoding the name of the package in the symbols file, you can use "
  10627. "the marker I<#PACKAGE#>. It will be replaced by the real package name during "
  10628. "installation of the symbols files. Contrary to the I<#MINVER#> marker, "
  10629. "I<#PACKAGE#> will never appear in a symbols file inside a binary package."
  10630. msgstr ""
  10631. #. type: SS
  10632. #: dpkg-gensymbols.man:1
  10633. #, no-wrap
  10634. msgid "Using symbol tags"
  10635. msgstr ""
  10636. #. type: Plain text
  10637. #: dpkg-gensymbols.man:1
  10638. msgid ""
  10639. "Symbol tagging is useful for marking symbols that are special in some way. "
  10640. "Any symbol can have an arbitrary number of tags associated with it. While "
  10641. "all tags are parsed and stored, only some of them are understood by "
  10642. "B<dpkg-gensymbols> and trigger special handling of the symbols. See "
  10643. "subsection B<Standard symbol tags> for reference of these tags."
  10644. msgstr ""
  10645. #. type: Plain text
  10646. #: dpkg-gensymbols.man:1
  10647. msgid ""
  10648. "Tag specification comes right before the symbol name (no whitespace is "
  10649. "allowed in between). It always starts with an opening bracket B<(>, ends "
  10650. "with a closing bracket B<)> and must contain at least one tag. Multiple tags "
  10651. "are separated by the B<|> character. Each tag can optionally have a value "
  10652. "which is separated form the tag name by the B<=> character. Tag names and "
  10653. "values can be arbitrary strings except they cannot contain any of the "
  10654. "special B<)> B<|> B<=> characters. Symbol names following a tag "
  10655. "specification can optionally be quoted with either B<'> or B<\"> characters "
  10656. "to allow whitespaces in them. However, if there are no tags specified for "
  10657. "the symbol, quotes are treated as part of the symbol name which continues up "
  10658. "until the first space."
  10659. msgstr ""
  10660. #. type: Plain text
  10661. #: dpkg-gensymbols.man:1
  10662. #, no-wrap
  10663. msgid ""
  10664. " (tag1=i am marked|tag name with space)\"tagged quoted symbol\"@Base 1.0\n"
  10665. " (optional)tagged_unquoted_symbol@Base 1.0 1\n"
  10666. " untagged_symbol@Base 1.0\n"
  10667. msgstr ""
  10668. #. type: Plain text
  10669. #: dpkg-gensymbols.man:1
  10670. msgid ""
  10671. "The first symbol in the example is named I<tagged quoted symbol> and has two "
  10672. "tags: I<tag1> with value I<i am marked> and I<tag name with space> that has "
  10673. "no value. The second symbol named I<tagged_unquoted_symbol> is only tagged "
  10674. "with the tag named I<optional>. The last symbol is an example of the normal "
  10675. "untagged symbol."
  10676. msgstr ""
  10677. #. type: Plain text
  10678. #: dpkg-gensymbols.man:1
  10679. msgid ""
  10680. "Since symbol tags are an extension of the B<deb-symbols>(5) format, they can "
  10681. "only be part of the symbols files used in source packages (those files "
  10682. "should then be seen as templates used to build the symbols files that are "
  10683. "embedded in binary packages). When B<dpkg-gensymbols> is called without the "
  10684. "B<-t> option, it will output symbols files compatible to the "
  10685. "B<deb-symbols>(5) format: it fully processes symbols according to the "
  10686. "requirements of their standard tags and strips all tags from the output. On "
  10687. "the contrary, in template mode (B<-t>) all symbols and their tags (both "
  10688. "standard and unknown ones) are kept in the output and are written in their "
  10689. "original form as they were loaded."
  10690. msgstr ""
  10691. #. type: SS
  10692. #: dpkg-gensymbols.man:1
  10693. #, no-wrap
  10694. msgid "Standard symbol tags"
  10695. msgstr ""
  10696. #. type: TP
  10697. #: dpkg-gensymbols.man:1
  10698. #, no-wrap
  10699. msgid "B<optional>"
  10700. msgstr ""
  10701. #. type: Plain text
  10702. #: dpkg-gensymbols.man:1
  10703. msgid ""
  10704. "A symbol marked as optional can disappear from the library at any time and "
  10705. "that will never cause B<dpkg-gensymbols> to fail. However, disappeared "
  10706. "optional symbols will continuously appear as MISSING in the diff in each new "
  10707. "package revision. This behaviour serves as a reminder for the maintainer "
  10708. "that such a symbol needs to be removed from the symbol file or readded to "
  10709. "the library. When the optional symbol, which was previously declared as "
  10710. "MISSING, suddenly reappears in the next revision, it will be upgraded back "
  10711. "to the “existing” status with its minimum version unchanged."
  10712. msgstr ""
  10713. #. type: Plain text
  10714. #: dpkg-gensymbols.man:1
  10715. msgid ""
  10716. "This tag is useful for symbols which are private where their disappearance "
  10717. "do not cause ABI breakage. For example, most of C++ template instantiations "
  10718. "fall into this category. Like any other tag, this one may also have an "
  10719. "arbitrary value: it could be used to indicate why the symbol is considered "
  10720. "optional."
  10721. msgstr ""
  10722. #. type: TP
  10723. #: dpkg-gensymbols.man:1
  10724. #, no-wrap
  10725. msgid "B<arch=>I<architecture-list>"
  10726. msgstr ""
  10727. #. type: TQ
  10728. #: dpkg-gensymbols.man:1
  10729. #, no-wrap
  10730. msgid "B<arch-bits=>I<architecture-bits>"
  10731. msgstr ""
  10732. #. type: TQ
  10733. #: dpkg-gensymbols.man:1
  10734. #, no-wrap
  10735. msgid "B<arch-endian=>I<architecture-endianness>"
  10736. msgstr ""
  10737. #. type: Plain text
  10738. #: dpkg-gensymbols.man:1
  10739. msgid ""
  10740. "These tags allow one to restrict the set of architectures where the symbol "
  10741. "is supposed to exist. The B<arch-bits> and B<arch-endian> tags are supported "
  10742. "since dpkg 1.18.0. When the symbols list is updated with the symbols "
  10743. "discovered in the library, all arch-specific symbols which do not concern "
  10744. "the current host architecture are treated as if they did not exist. If an "
  10745. "arch-specific symbol matching the current host architecture does not exist "
  10746. "in the library, normal procedures for missing symbols apply and it may cause "
  10747. "B<dpkg-gensymbols> to fail. On the other hand, if the arch-specific symbol "
  10748. "is found when it was not supposed to exist (because the current host "
  10749. "architecture is not listed in the tag or does not match the endianness and "
  10750. "bits), it is made arch neutral (i.e. the arch, arch-bits and arch-endian "
  10751. "tags are dropped and the symbol will appear in the diff due to this change), "
  10752. "but it is not considered as new."
  10753. msgstr ""
  10754. #. type: Plain text
  10755. #: dpkg-gensymbols.man:1
  10756. msgid ""
  10757. "When operating in the default non-template mode, among arch-specific symbols "
  10758. "only those that match the current host architecture are written to the "
  10759. "symbols file. On the contrary, all arch-specific symbols (including those "
  10760. "from foreign arches) are always written to the symbol file when operating in "
  10761. "template mode."
  10762. msgstr ""
  10763. #. type: Plain text
  10764. #: dpkg-gensymbols.man:1
  10765. msgid ""
  10766. "The format of I<architecture-list> is the same as the one used in the "
  10767. "B<Build-Depends> field of I<debian/control> (except the enclosing square "
  10768. "brackets []). For example, the first symbol from the list below will be "
  10769. "considered only on alpha, any-amd64 and ia64 architectures, the second only "
  10770. "on linux architectures, while the third one anywhere except on armel."
  10771. msgstr ""
  10772. #. type: Plain text
  10773. #: dpkg-gensymbols.man:1
  10774. #, no-wrap
  10775. msgid ""
  10776. " (arch=alpha any-amd64 ia64)64bit_specific_symbol@Base 1.0\n"
  10777. " (arch=linux-any)linux_specific_symbol@Base 1.0\n"
  10778. " (arch=!armel)symbol_armel_does_not_have@Base 1.0\n"
  10779. msgstr ""
  10780. #. type: Plain text
  10781. #: dpkg-gensymbols.man:1
  10782. msgid "The I<architecture-bits> is either B<32> or B<64>."
  10783. msgstr ""
  10784. #. type: Plain text
  10785. #: dpkg-gensymbols.man:1
  10786. #, no-wrap
  10787. msgid ""
  10788. " (arch-bits=32)32bit_specific_symbol@Base 1.0\n"
  10789. " (arch-bits=64)64bit_specific_symbol@Base 1.0\n"
  10790. msgstr ""
  10791. #. type: Plain text
  10792. #: dpkg-gensymbols.man:1
  10793. msgid "The I<architecture-endianness> is either B<little> or B<big>."
  10794. msgstr ""
  10795. #. type: Plain text
  10796. #: dpkg-gensymbols.man:1
  10797. #, no-wrap
  10798. msgid ""
  10799. " (arch-endian=little)little_endian_specific_symbol@Base 1.0\n"
  10800. " (arch-endian=big)big_endian_specific_symbol@Base 1.0\n"
  10801. msgstr ""
  10802. #. type: Plain text
  10803. #: dpkg-gensymbols.man:1
  10804. msgid "Multiple restrictions can be chained."
  10805. msgstr ""
  10806. #. type: Plain text
  10807. #: dpkg-gensymbols.man:1
  10808. #, no-wrap
  10809. msgid " (arch-bits=32|arch-endian=little)32bit_le_symbol@Base 1.0\n"
  10810. msgstr ""
  10811. #. type: TP
  10812. #: dpkg-gensymbols.man:1
  10813. #, no-wrap
  10814. msgid "B<ignore-blacklist>"
  10815. msgstr ""
  10816. #. type: Plain text
  10817. #: dpkg-gensymbols.man:1
  10818. msgid ""
  10819. "dpkg-gensymbols has an internal blacklist of symbols that should not appear "
  10820. "in symbols files as they are usually only side-effects of implementation "
  10821. "details of the toolchain. If for some reason, you really want one of those "
  10822. "symbols to be included in the symbols file, you should tag the symbol with "
  10823. "B<ignore-blacklist>. It can be necessary for some low level toolchain "
  10824. "libraries like libgcc."
  10825. msgstr ""
  10826. #. type: TP
  10827. #: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
  10828. #, no-wrap
  10829. msgid "B<c++>"
  10830. msgstr ""
  10831. #. type: Plain text
  10832. #: dpkg-gensymbols.man:1
  10833. msgid ""
  10834. "Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection "
  10835. "below."
  10836. msgstr ""
  10837. #. type: TP
  10838. #: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
  10839. #, no-wrap
  10840. msgid "B<symver>"
  10841. msgstr ""
  10842. #. type: Plain text
  10843. #: dpkg-gensymbols.man:1
  10844. msgid ""
  10845. "Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol "
  10846. "patterns> subsection below."
  10847. msgstr ""
  10848. #. type: TP
  10849. #: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
  10850. #, no-wrap
  10851. msgid "B<regex>"
  10852. msgstr ""
  10853. #. type: Plain text
  10854. #: dpkg-gensymbols.man:1
  10855. msgid ""
  10856. "Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection "
  10857. "below."
  10858. msgstr ""
  10859. #. type: SS
  10860. #: dpkg-gensymbols.man:1
  10861. #, no-wrap
  10862. msgid "Using symbol patterns"
  10863. msgstr ""
  10864. #. type: Plain text
  10865. #: dpkg-gensymbols.man:1
  10866. msgid ""
  10867. "Unlike a standard symbol specification, a pattern may cover multiple real "
  10868. "symbols from the library. B<dpkg-gensymbols> will attempt to match each "
  10869. "pattern against each real symbol that does I<not> have a specific symbol "
  10870. "counterpart defined in the symbol file. Whenever the first matching pattern "
  10871. "is found, all its tags and properties will be used as a basis specification "
  10872. "of the symbol. If none of the patterns matches, the symbol will be "
  10873. "considered as new."
  10874. msgstr ""
  10875. #. type: Plain text
  10876. #: dpkg-gensymbols.man:1
  10877. msgid ""
  10878. "A pattern is considered lost if it does not match any symbol in the "
  10879. "library. By default this will trigger a B<dpkg-gensymbols> failure under "
  10880. "B<-c1> or higher level. However, if the failure is undesired, the pattern "
  10881. "may be marked with the I<optional> tag. Then if the pattern does not match "
  10882. "anything, it will only appear in the diff as MISSING. Moreover, like any "
  10883. "symbol, the pattern may be limited to the specific architectures with the "
  10884. "I<arch> tag. Please refer to B<Standard symbol tags> subsection above for "
  10885. "more information."
  10886. msgstr ""
  10887. #. type: Plain text
  10888. #: dpkg-gensymbols.man:1
  10889. msgid ""
  10890. "Patterns are an extension of the B<deb-symbols>(5) format hence they are "
  10891. "only valid in symbol file templates. Pattern specification syntax is not any "
  10892. "different from the one of a specific symbol. However, symbol name part of "
  10893. "the specification serves as an expression to be matched against "
  10894. "I<name@version> of the real symbol. In order to distinguish among different "
  10895. "pattern types, a pattern will typically be tagged with a special tag."
  10896. msgstr ""
  10897. #. type: Plain text
  10898. #: dpkg-gensymbols.man:1
  10899. msgid "At the moment, B<dpkg-gensymbols> supports three basic pattern types:"
  10900. msgstr ""
  10901. #. type: Plain text
  10902. #: dpkg-gensymbols.man:1
  10903. msgid ""
  10904. "This pattern is denoted by the I<c++> tag. It matches only C++ symbols by "
  10905. "their demangled symbol name (as emitted by B<c++filt>(1) utility). This "
  10906. "pattern is very handy for matching symbols which mangled names might vary "
  10907. "across different architectures while their demangled names remain the "
  10908. "same. One group of such symbols is I<non-virtual thunks> which have "
  10909. "architecture specific offsets embedded in their mangled names. A common "
  10910. "instance of this case is a virtual destructor which under diamond "
  10911. "inheritance needs a non-virtual thunk symbol. For example, even if "
  10912. "_ZThn8_N3NSB6ClassDD1Ev@Base on 32bit architectures will probably be "
  10913. "_ZThn16_N3NSB6ClassDD1Ev@Base on 64bit ones, it can be matched with a single "
  10914. "I<c++> pattern:"
  10915. msgstr ""
  10916. #. type: Plain text
  10917. #: dpkg-gensymbols.man:1
  10918. #, no-wrap
  10919. msgid ""
  10920. "libdummy.so.1 libdummy1 #MINVER#\n"
  10921. " [...]\n"
  10922. " (c++)\"non-virtual thunk to NSB::ClassD::~ClassD()@Base\" 1.0\n"
  10923. " [...]\n"
  10924. msgstr ""
  10925. #. type: Plain text
  10926. #: dpkg-gensymbols.man:1
  10927. msgid "The demangled name above can be obtained by executing the following command:"
  10928. msgstr ""
  10929. #. type: Plain text
  10930. #: dpkg-gensymbols.man:1
  10931. #, no-wrap
  10932. msgid " $ echo '_ZThn8_N3NSB6ClassDD1Ev@Base' | c++filt\n"
  10933. msgstr ""
  10934. #. type: Plain text
  10935. #: dpkg-gensymbols.man:1
  10936. msgid ""
  10937. "Please note that while mangled name is unique in the library by definition, "
  10938. "this is not necessarily true for demangled names. A couple of distinct real "
  10939. "symbols may have the same demangled name. For example, that's the case with "
  10940. "non-virtual thunk symbols in complex inheritance configurations or with most "
  10941. "constructors and destructors (since g++ typically generates two real symbols "
  10942. "for them). However, as these collisions happen on the ABI level, they should "
  10943. "not degrade quality of the symbol file."
  10944. msgstr ""
  10945. #. type: Plain text
  10946. #: dpkg-gensymbols.man:1
  10947. msgid ""
  10948. "This pattern is denoted by the I<symver> tag. Well maintained libraries have "
  10949. "versioned symbols where each version corresponds to the upstream version "
  10950. "where the symbol got added. If that's the case, you can use a I<symver> "
  10951. "pattern to match any symbol associated to the specific version. For example:"
  10952. msgstr ""
  10953. #. type: Plain text
  10954. #: dpkg-gensymbols.man:1
  10955. #, no-wrap
  10956. msgid ""
  10957. "libc.so.6 libc6 #MINVER#\n"
  10958. " (symver)GLIBC_2.0 2.0\n"
  10959. " [...]\n"
  10960. " (symver)GLIBC_2.7 2.7\n"
  10961. " access@GLIBC_2.0 2.2\n"
  10962. msgstr ""
  10963. #. type: Plain text
  10964. #: dpkg-gensymbols.man:1
  10965. msgid ""
  10966. "All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to "
  10967. "minimal version of 2.0 and 2.7 respectively with the exception of the symbol "
  10968. "access@GLIBC_2.0. The latter will lead to a minimal dependency on libc6 "
  10969. "version 2.2 despite being in the scope of the \"(symver)GLIBC_2.0\" pattern "
  10970. "because specific symbols take precedence over patterns."
  10971. msgstr ""
  10972. #. type: Plain text
  10973. #: dpkg-gensymbols.man:1
  10974. msgid ""
  10975. "Please note that while old style wildcard patterns (denoted by \"*@version\" "
  10976. "in the symbol name field) are still supported, they have been deprecated by "
  10977. "new style syntax \"(symver|optional)version\". For example, \"*@GLIBC_2.0 "
  10978. "2.0\" should be written as \"(symver|optional)GLIBC_2.0 2.0\" if the same "
  10979. "behaviour is needed."
  10980. msgstr ""
  10981. #. type: Plain text
  10982. #: dpkg-gensymbols.man:1
  10983. msgid ""
  10984. "Regular expression patterns are denoted by the I<regex> tag. They match by "
  10985. "the perl regular expression specified in the symbol name field. A regular "
  10986. "expression is matched as it is, therefore do not forget to start it with the "
  10987. "I<^> character or it may match any part of the real symbol I<name@version> "
  10988. "string. For example:"
  10989. msgstr ""
  10990. #. type: Plain text
  10991. #: dpkg-gensymbols.man:1
  10992. #, no-wrap
  10993. msgid ""
  10994. "libdummy.so.1 libdummy1 #MINVER#\n"
  10995. " (regex)\"^mystack_.*@Base$\" 1.0\n"
  10996. " (regex|optional)\"private\" 1.0\n"
  10997. msgstr ""
  10998. #. type: Plain text
  10999. #: dpkg-gensymbols.man:1
  11000. msgid ""
  11001. "Symbols like \"mystack_new@Base\", \"mystack_push@Base\", "
  11002. "\"mystack_pop@Base\" etc. will be matched by the first pattern while "
  11003. "e.g. \"ng_mystack_new@Base\" won't. The second pattern will match all "
  11004. "symbols having the string \"private\" in their names and matches will "
  11005. "inherit I<optional> tag from the pattern."
  11006. msgstr ""
  11007. #. type: Plain text
  11008. #: dpkg-gensymbols.man:1
  11009. msgid ""
  11010. "Basic patterns listed above can be combined where it makes sense. In that "
  11011. "case, they are processed in the order in which the tags are specified. For "
  11012. "example, both"
  11013. msgstr ""
  11014. #. type: Plain text
  11015. #: dpkg-gensymbols.man:1
  11016. #, no-wrap
  11017. msgid ""
  11018. " (c++|regex)\"^NSA::ClassA::Private::privmethod\\ed\\e(int\\e)@Base\" 1.0\n"
  11019. " (regex|c++)N3NSA6ClassA7Private11privmethod\\edEi@Base 1.0\n"
  11020. msgstr ""
  11021. #. type: Plain text
  11022. #: dpkg-gensymbols.man:1
  11023. msgid ""
  11024. "will match symbols \"_ZN3NSA6ClassA7Private11privmethod1Ei@Base\" and "
  11025. "\"_ZN3NSA6ClassA7Private11privmethod2Ei@Base\". When matching the first "
  11026. "pattern, the raw symbol is first demangled as C++ symbol, then the demangled "
  11027. "name is matched against the regular expression. On the other hand, when "
  11028. "matching the second pattern, regular expression is matched against the raw "
  11029. "symbol name, then the symbol is tested if it is C++ one by attempting to "
  11030. "demangle it. A failure of any basic pattern will result in the failure of "
  11031. "the whole pattern. Therefore, for example, "
  11032. "\"__N3NSA6ClassA7Private11privmethod\\edEi@Base\" will not match either of "
  11033. "the patterns because it is not a valid C++ symbol."
  11034. msgstr ""
  11035. #. type: Plain text
  11036. #: dpkg-gensymbols.man:1
  11037. msgid ""
  11038. "In general, all patterns are divided into two groups: aliases (basic I<c++> "
  11039. "and I<symver>) and generic patterns (I<regex>, all combinations of multiple "
  11040. "basic patterns). Matching of basic alias-based patterns is fast (O(1)) "
  11041. "while generic patterns are O(N) (N - generic pattern count) for each "
  11042. "symbol. Therefore, it is recommended not to overuse generic patterns."
  11043. msgstr ""
  11044. #. type: Plain text
  11045. #: dpkg-gensymbols.man:1
  11046. msgid ""
  11047. "When multiple patterns match the same real symbol, aliases (first I<c++>, "
  11048. "then I<symver>) are preferred over generic patterns. Generic patterns are "
  11049. "matched in the order they are found in the symbol file template until the "
  11050. "first success. Please note, however, that manual reordering of template "
  11051. "file entries is not recommended because B<dpkg-gensymbols> generates diffs "
  11052. "based on the alphanumerical order of their names."
  11053. msgstr ""
  11054. #. type: SS
  11055. #: dpkg-gensymbols.man:1
  11056. #, no-wrap
  11057. msgid "Using includes"
  11058. msgstr ""
  11059. #. type: Plain text
  11060. #: dpkg-gensymbols.man:1
  11061. msgid ""
  11062. "When the set of exported symbols differ between architectures, it may become "
  11063. "inefficient to use a single symbol file. In those cases, an include "
  11064. "directive may prove to be useful in a couple of ways:"
  11065. msgstr ""
  11066. #. type: Plain text
  11067. #: dpkg-gensymbols.man:1
  11068. msgid ""
  11069. "You can factorize the common part in some external file and include that "
  11070. "file in your I<package>.symbols.I<arch> file by using an include directive "
  11071. "like this:"
  11072. msgstr ""
  11073. #. type: Plain text
  11074. #: dpkg-gensymbols.man:1
  11075. msgid "#include \"I<packages>.symbols.common\""
  11076. msgstr ""
  11077. #. type: Plain text
  11078. #: dpkg-gensymbols.man:1
  11079. msgid "The include directive may also be tagged like any symbol:"
  11080. msgstr ""
  11081. #. type: Plain text
  11082. #: dpkg-gensymbols.man:1
  11083. msgid "(tag|...|tagN)#include \"file-to-include\""
  11084. msgstr ""
  11085. #. type: Plain text
  11086. #: dpkg-gensymbols.man:1
  11087. msgid ""
  11088. "As a result, all symbols included from I<file-to-include> will be considered "
  11089. "to be tagged with I<tag> ... I<tagN> by default. You can use this feature to "
  11090. "create a common I<package>.symbols file which includes architecture specific "
  11091. "symbol files:"
  11092. msgstr ""
  11093. #. type: Plain text
  11094. #: dpkg-gensymbols.man:1
  11095. #, no-wrap
  11096. msgid ""
  11097. " common_symbol1@Base 1.0\n"
  11098. " (arch=amd64 ia64 alpha)#include \"package.symbols.64bit\"\n"
  11099. " (arch=!amd64 !ia64 !alpha)#include \"package.symbols.32bit\"\n"
  11100. " common_symbol2@Base 1.0\n"
  11101. msgstr ""
  11102. #. type: Plain text
  11103. #: dpkg-gensymbols.man:1
  11104. msgid ""
  11105. "The symbols files are read line by line, and include directives are "
  11106. "processed as soon as they are encountered. This means that the content of "
  11107. "the included file can override any content that appeared before the include "
  11108. "directive and that any content after the directive can override anything "
  11109. "contained in the included file. Any symbol (or even another #include "
  11110. "directive) in the included file can specify additional tags or override "
  11111. "values of the inherited tags in its tag specification. However, there is no "
  11112. "way for the symbol to remove any of the inherited tags."
  11113. msgstr ""
  11114. #. type: Plain text
  11115. #: dpkg-gensymbols.man:1
  11116. msgid ""
  11117. "An included file can repeat the header line containing the SONAME of the "
  11118. "library. In that case, it overrides any header line previously read. "
  11119. "However, in general it's best to avoid duplicating header lines. One way to "
  11120. "do it is the following:"
  11121. msgstr ""
  11122. #. type: Plain text
  11123. #: dpkg-gensymbols.man:1
  11124. #, no-wrap
  11125. msgid ""
  11126. "#include \"libsomething1.symbols.common\"\n"
  11127. " arch_specific_symbol@Base 1.0\n"
  11128. msgstr ""
  11129. #. type: SS
  11130. #: dpkg-gensymbols.man:1
  11131. #, no-wrap
  11132. msgid "Good library management"
  11133. msgstr ""
  11134. #. type: Plain text
  11135. #: dpkg-gensymbols.man:1
  11136. msgid "A well-maintained library has the following features:"
  11137. msgstr ""
  11138. #. type: Plain text
  11139. #: dpkg-gensymbols.man:1
  11140. msgid ""
  11141. "its API is stable (public symbols are never dropped, only new public symbols "
  11142. "are added) and changes in incompatible ways only when the SONAME changes;"
  11143. msgstr ""
  11144. #. type: Plain text
  11145. #: dpkg-gensymbols.man:1
  11146. msgid ""
  11147. "ideally, it uses symbol versioning to achieve ABI stability despite internal "
  11148. "changes and API extension;"
  11149. msgstr ""
  11150. #. type: Plain text
  11151. #: dpkg-gensymbols.man:1
  11152. msgid ""
  11153. "it doesn't export private symbols (such symbols can be tagged optional as "
  11154. "workaround)."
  11155. msgstr ""
  11156. #. type: Plain text
  11157. #: dpkg-gensymbols.man:1
  11158. msgid ""
  11159. "While maintaining the symbols file, it's easy to notice appearance and "
  11160. "disappearance of symbols. But it's more difficult to catch incompatible API "
  11161. "and ABI change. Thus the maintainer should read thoroughly the upstream "
  11162. "changelog looking for cases where the rules of good library management have "
  11163. "been broken. If potential problems are discovered, the upstream author "
  11164. "should be notified as an upstream fix is always better than a Debian "
  11165. "specific work-around."
  11166. msgstr ""
  11167. #. type: Plain text
  11168. #: dpkg-gensymbols.man:1
  11169. msgid "Scan I<package-build-dir> instead of debian/tmp."
  11170. msgstr ""
  11171. #. type: Plain text
  11172. #: dpkg-gensymbols.man:1
  11173. msgid ""
  11174. "Define the package name. Required if more than one binary package is listed "
  11175. "in debian/control (or if there's no debian/control file)."
  11176. msgstr ""
  11177. #. type: Plain text
  11178. #: dpkg-gensymbols.man:1
  11179. msgid ""
  11180. "Define the package version. Defaults to the version extracted from "
  11181. "debian/changelog. Required if called outside of a source package tree."
  11182. msgstr ""
  11183. #. type: TP
  11184. #: dpkg-gensymbols.man:1
  11185. #, no-wrap
  11186. msgid "B<-e>I<library-file>"
  11187. msgstr ""
  11188. #. type: Plain text
  11189. #: dpkg-gensymbols.man:1
  11190. msgid ""
  11191. "Only analyze libraries explicitly listed instead of finding all public "
  11192. "libraries. You can use shell patterns used for pathname expansions (see the "
  11193. "B<File::Glob>(3perl) manual page for details) in I<library-file> to match "
  11194. "multiple libraries with a single argument (otherwise you need multiple "
  11195. "B<-e>)."
  11196. msgstr ""
  11197. #. type: TP
  11198. #: dpkg-gensymbols.man:1
  11199. #, no-wrap
  11200. msgid "B<-I>I<filename>"
  11201. msgstr ""
  11202. #. type: Plain text
  11203. #: dpkg-gensymbols.man:1
  11204. msgid ""
  11205. "Use I<filename> as reference file to generate the symbols file that is "
  11206. "integrated in the package itself."
  11207. msgstr ""
  11208. #. type: Plain text
  11209. #: dpkg-gensymbols.man:1
  11210. msgid ""
  11211. "Print the generated symbols file to standard output or to I<filename> if "
  11212. "specified, rather than to B<debian/tmp/DEBIAN/symbols> (or "
  11213. "I<package-build-dir>B</DEBIAN/symbols> if B<-P> was used). If I<filename> is "
  11214. "pre-existing, its contents are used as basis for the generated symbols "
  11215. "file. You can use this feature to update a symbols file so that it matches "
  11216. "a newer upstream version of your library."
  11217. msgstr ""
  11218. #. type: TP
  11219. #: dpkg-gensymbols.man:1
  11220. #, no-wrap
  11221. msgid "B<-t>"
  11222. msgstr ""
  11223. #. type: Plain text
  11224. #: dpkg-gensymbols.man:1
  11225. msgid ""
  11226. "Write the symbol file in template mode rather than the format compatible "
  11227. "with B<deb-symbols>(5). The main difference is that in the template mode "
  11228. "symbol names and tags are written in their original form contrary to the "
  11229. "post-processed symbol names with tags stripped in the compatibility mode. "
  11230. "Moreover, some symbols might be omitted when writing a standard "
  11231. "B<deb-symbols>(5) file (according to the tag processing rules) while all "
  11232. "symbols are always written to the symbol file template."
  11233. msgstr ""
  11234. #. type: TP
  11235. #: dpkg-gensymbols.man:1
  11236. #, no-wrap
  11237. msgid "B<-c>I<[0-4]>"
  11238. msgstr ""
  11239. #. type: Plain text
  11240. #: dpkg-gensymbols.man:1
  11241. msgid ""
  11242. "Define the checks to do when comparing the generated symbols file with the "
  11243. "template file used as starting point. By default the level is 1. Increasing "
  11244. "levels do more checks and include all checks of lower levels. Level 0 never "
  11245. "fails. Level 1 fails if some symbols have disappeared. Level 2 fails if some "
  11246. "new symbols have been introduced. Level 3 fails if some libraries have "
  11247. "disappeared. Level 4 fails if some libraries have been introduced."
  11248. msgstr ""
  11249. #. type: Plain text
  11250. #: dpkg-gensymbols.man:1
  11251. msgid ""
  11252. "This value can be overridden by the environment variable "
  11253. "B<DPKG_GENSYMBOLS_CHECK_LEVEL>."
  11254. msgstr ""
  11255. #. type: Plain text
  11256. #: dpkg-gensymbols.man:1
  11257. msgid ""
  11258. "Keep quiet and never generate a diff between generated symbols file and the "
  11259. "template file used as starting point or show any warnings about new/lost "
  11260. "libraries or new/lost symbols. This option only disables informational "
  11261. "output but not the checks themselves (see B<-c> option)."
  11262. msgstr ""
  11263. #. type: TP
  11264. #: dpkg-gensymbols.man:1
  11265. #, no-wrap
  11266. msgid "B<-a>I<arch>"
  11267. msgstr ""
  11268. #. type: Plain text
  11269. #: dpkg-gensymbols.man:1
  11270. msgid ""
  11271. "Assume I<arch> as host architecture when processing symbol files. Use this "
  11272. "option to generate a symbol file or diff for any architecture provided its "
  11273. "binaries are already available."
  11274. msgstr ""
  11275. #. type: TP
  11276. #: dpkg-gensymbols.man:1
  11277. #, no-wrap
  11278. msgid "B<-d>"
  11279. msgstr ""
  11280. #. type: Plain text
  11281. #: dpkg-gensymbols.man:1
  11282. msgid ""
  11283. "Enable debug mode. Numerous messages are displayed to explain what "
  11284. "B<dpkg-gensymbols> does."
  11285. msgstr ""
  11286. #. type: TP
  11287. #: dpkg-gensymbols.man:1
  11288. #, no-wrap
  11289. msgid "B<-V>"
  11290. msgstr ""
  11291. #. type: Plain text
  11292. #: dpkg-gensymbols.man:1
  11293. msgid ""
  11294. "Enable verbose mode. The generated symbols file contains deprecated symbols "
  11295. "as comments. Furthermore in template mode, pattern symbols are followed by "
  11296. "comments listing real symbols that have matched the pattern."
  11297. msgstr ""
  11298. #. type: TP
  11299. #: dpkg-gensymbols.man:1
  11300. #, no-wrap
  11301. msgid "B<DPKG_GENSYMBOLS_CHECK_LEVEL>"
  11302. msgstr ""
  11303. #. type: Plain text
  11304. #: dpkg-gensymbols.man:1
  11305. msgid ""
  11306. "Overrides the command check level, even if the B<-c> command-line argument "
  11307. "was given (note that this goes against the common convention of command-line "
  11308. "arguments having precedence over environment variables)."
  11309. msgstr ""
  11310. #. type: Plain text
  11311. #: dpkg-gensymbols.man:1
  11312. msgid "B<https://people.redhat.com/drepper/symbol-versioning>"
  11313. msgstr ""
  11314. #. type: Plain text
  11315. #: dpkg-gensymbols.man:1
  11316. msgid "B<https://people.redhat.com/drepper/goodpractice.pdf>"
  11317. msgstr ""
  11318. #. type: Plain text
  11319. #: dpkg-gensymbols.man:1
  11320. msgid "B<https://people.redhat.com/drepper/dsohowto.pdf>"
  11321. msgstr ""
  11322. #. type: Plain text
  11323. #: dpkg-gensymbols.man:1
  11324. msgid "B<deb-symbols>(5), B<dpkg-shlibdeps>(1)."
  11325. msgstr ""
  11326. #. type: TH
  11327. #: dpkg-maintscript-helper.man:1
  11328. #, no-wrap
  11329. msgid "dpkg-maintscript-helper"
  11330. msgstr ""
  11331. #. type: Plain text
  11332. #: dpkg-maintscript-helper.man:1
  11333. msgid ""
  11334. "dpkg-maintscript-helper - works around known dpkg limitations in maintainer "
  11335. "scripts"
  11336. msgstr ""
  11337. #. type: Plain text
  11338. #: dpkg-maintscript-helper.man:1
  11339. msgid ""
  11340. "B<dpkg-maintscript-helper> I<command> [I<parameter>...] B<--> "
  11341. "I<maint-script-parameter>..."
  11342. msgstr ""
  11343. #. type: SH
  11344. #: dpkg-maintscript-helper.man:1
  11345. #, no-wrap
  11346. msgid "COMMANDS AND PARAMETERS"
  11347. msgstr ""
  11348. #. type: Plain text
  11349. #: dpkg-maintscript-helper.man:1
  11350. msgid "B<supports> I<command>"
  11351. msgstr ""
  11352. #. type: Plain text
  11353. #: dpkg-maintscript-helper.man:1
  11354. msgid "B<rm_conffile> I<conffile> [I<prior-version> [I<package>]]"
  11355. msgstr ""
  11356. #. type: Plain text
  11357. #: dpkg-maintscript-helper.man:1
  11358. msgid ""
  11359. "B<mv_conffile> I<old-conffile> I<new-conffile> [I<prior-version> "
  11360. "[I<package>]]"
  11361. msgstr ""
  11362. #. type: Plain text
  11363. #: dpkg-maintscript-helper.man:1
  11364. msgid "B<symlink_to_dir> I<pathname> I<old-target> [I<prior-version> [I<package>]]"
  11365. msgstr ""
  11366. #. type: Plain text
  11367. #: dpkg-maintscript-helper.man:1
  11368. msgid "B<dir_to_symlink> I<pathname> I<new-target> [I<prior-version> [I<package>]]"
  11369. msgstr ""
  11370. #. type: Plain text
  11371. #: dpkg-maintscript-helper.man:1
  11372. msgid ""
  11373. "This program is designed to be run within maintainer scripts to achieve some "
  11374. "tasks that B<dpkg> can't (yet) handle natively either because of design "
  11375. "decisions or due to current limitations."
  11376. msgstr ""
  11377. #. type: Plain text
  11378. #: dpkg-maintscript-helper.man:1
  11379. msgid ""
  11380. "Many of those tasks require coordinated actions from several maintainer "
  11381. "scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>). To avoid mistakes "
  11382. "the same call simply needs to be put in all scripts and the program will "
  11383. "automatically adapt its behaviour based on the environment variable "
  11384. "B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you "
  11385. "have to forward after a double hyphen."
  11386. msgstr ""
  11387. #. type: SH
  11388. #: dpkg-maintscript-helper.man:1
  11389. #, no-wrap
  11390. msgid "COMMON PARAMETERS"
  11391. msgstr ""
  11392. #. type: TP
  11393. #: dpkg-maintscript-helper.man:1
  11394. #, no-wrap
  11395. msgid "I<prior-version>"
  11396. msgstr ""
  11397. #. type: Plain text
  11398. #: dpkg-maintscript-helper.man:1
  11399. msgid ""
  11400. "Defines the latest version of the package whose upgrade should trigger the "
  11401. "operation. It is important to calculate I<prior-version> correctly so that "
  11402. "the operations are correctly performed even if the user rebuilt the package "
  11403. "with a local version. If I<prior-version> is empty or omitted, then the "
  11404. "operation is tried on every upgrade (note: it's safer to give the version "
  11405. "and have the operation tried only once)."
  11406. msgstr ""
  11407. #. type: Plain text
  11408. #: dpkg-maintscript-helper.man:1
  11409. msgid ""
  11410. "If the conffile has not been shipped for several versions, and you are now "
  11411. "modifying the maintainer scripts to clean up the obsolete file, "
  11412. "I<prior-version> should be based on the version of the package that you are "
  11413. "now preparing, not the first version of the package that lacked the "
  11414. "conffile. This applies to all other actions in the same way."
  11415. msgstr ""
  11416. #. type: Plain text
  11417. #: dpkg-maintscript-helper.man:1
  11418. msgid ""
  11419. "For example, for a conffile removed in version B<2.0-1> of a package, "
  11420. "I<prior-version> should be set to B<2.0-1~>. This will cause the conffile to "
  11421. "be removed even if the user rebuilt the previous version B<1.0-1> as "
  11422. "B<1.0-1local1>. Or a package switching a path from a symlink (shipped in "
  11423. "version B<1.0-1>) to a directory (shipped in version B<2.0-1>), but only "
  11424. "performing the actual switch in the maintainer scripts in version B<3.0-1>, "
  11425. "should set I<prior-version> to B<3.0-1~>."
  11426. msgstr ""
  11427. #. type: TP
  11428. #: dpkg-maintscript-helper.man:1
  11429. #, no-wrap
  11430. msgid "I<package>"
  11431. msgstr ""
  11432. #. type: Plain text
  11433. #: dpkg-maintscript-helper.man:1
  11434. msgid ""
  11435. "The package name. When the package is “Multi-Arch: same” this parameter must "
  11436. "include the architecture qualifier, otherwise it should B<not> usually "
  11437. "include the architecture qualifier (as it would disallow cross-grades, or "
  11438. "switching from being architecture specific to architecture B<all> or vice "
  11439. "versa). If the parameter is empty or omitted, the "
  11440. "B<DPKG_MAINTSCRIPT_PACKAGE> and B<DPKG_MAINTSCRIPT_ARCH> environment "
  11441. "variables (as set by B<dpkg>) will be used to generate an arch-qualified "
  11442. "package name."
  11443. msgstr ""
  11444. #. type: TP
  11445. #: dpkg-maintscript-helper.man:1
  11446. #, no-wrap
  11447. msgid "B<-->"
  11448. msgstr ""
  11449. #. type: Plain text
  11450. #: dpkg-maintscript-helper.man:1
  11451. msgid ""
  11452. "All the parameters of the maintainer scripts have to be forwarded to the "
  11453. "program after B<-->."
  11454. msgstr ""
  11455. #. type: SH
  11456. #: dpkg-maintscript-helper.man:1
  11457. #, no-wrap
  11458. msgid "CONFFILE RELATED TASKS"
  11459. msgstr ""
  11460. #. type: Plain text
  11461. #: dpkg-maintscript-helper.man:1
  11462. msgid ""
  11463. "When upgrading a package, B<dpkg> will not automatically remove a conffile "
  11464. "(a configuration file for which B<dpkg> should preserve user changes) if it "
  11465. "is not present in the newer version. There are two principal reasons for "
  11466. "this; the first is that the conffile could've been dropped by accident and "
  11467. "the next version could restore it, users wouldn't want their changes thrown "
  11468. "away. The second is to allow packages to transition files from a "
  11469. "dpkg-maintained conffile to a file maintained by the package's maintainer "
  11470. "scripts, usually with a tool like debconf or ucf."
  11471. msgstr ""
  11472. #. type: Plain text
  11473. #: dpkg-maintscript-helper.man:1
  11474. msgid ""
  11475. "This means that if a package is intended to rename or remove a conffile, it "
  11476. "must explicitly do so and B<dpkg-maintscript-helper> can be used to "
  11477. "implement graceful deletion and moving of conffiles within maintainer "
  11478. "scripts."
  11479. msgstr ""
  11480. #. type: SS
  11481. #: dpkg-maintscript-helper.man:1
  11482. #, no-wrap
  11483. msgid "Removing a conffile"
  11484. msgstr ""
  11485. #. type: Plain text
  11486. #: dpkg-maintscript-helper.man:1
  11487. msgid ""
  11488. "If a conffile is completely removed, it should be removed from disk, unless "
  11489. "the user has modified it. If there are local modifications, they should be "
  11490. "preserved. If the package upgrades aborts, the newly obsolete conffile "
  11491. "should not disappear."
  11492. msgstr ""
  11493. #. type: Plain text
  11494. #: dpkg-maintscript-helper.man:1
  11495. msgid ""
  11496. "All of this is implemented by putting the following shell snippet in the "
  11497. "B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
  11498. msgstr ""
  11499. #. type: Plain text
  11500. #: dpkg-maintscript-helper.man:1
  11501. #, no-wrap
  11502. msgid ""
  11503. " dpkg-maintscript-helper rm_conffile \\e\n"
  11504. " I<conffile> I<prior-version> I<package> -- \"$@\"\n"
  11505. msgstr ""
  11506. #. type: Plain text
  11507. #: dpkg-maintscript-helper.man:1
  11508. msgid "I<conffile> is the filename of the conffile to remove."
  11509. msgstr ""
  11510. #. type: Plain text
  11511. #: dpkg-maintscript-helper.man:1
  11512. msgid ""
  11513. "Current implementation: in the B<preinst>, it checks if the conffile was "
  11514. "modified and renames it either to I<conffile>B<.dpkg-remove> (if not "
  11515. "modified) or to I<conffile>B<.dpkg-backup> (if modified). In the "
  11516. "B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept "
  11517. "for reference as it contains user modifications but the former will be "
  11518. "removed. If the package upgrade aborts, the B<postrm> reinstalls the "
  11519. "original conffile. During purge, the B<postrm> will also delete the "
  11520. "B<.dpkg-bak> file kept up to now."
  11521. msgstr ""
  11522. #. type: SS
  11523. #: dpkg-maintscript-helper.man:1
  11524. #, no-wrap
  11525. msgid "Renaming a conffile"
  11526. msgstr ""
  11527. #. type: Plain text
  11528. #: dpkg-maintscript-helper.man:1
  11529. msgid ""
  11530. "If a conffile is moved from one location to another, you need to make sure "
  11531. "you move across any changes the user has made. This may seem a simple change "
  11532. "to the B<preinst> script at first, however that will result in the user "
  11533. "being prompted by B<dpkg> to approve the conffile edits even though they are "
  11534. "not responsible of them."
  11535. msgstr ""
  11536. #. type: Plain text
  11537. #: dpkg-maintscript-helper.man:1 dpkg-maintscript-helper.man:1
  11538. msgid ""
  11539. "Graceful renaming can be implemented by putting the following shell snippet "
  11540. "in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
  11541. msgstr ""
  11542. #. type: Plain text
  11543. #: dpkg-maintscript-helper.man:1
  11544. #, no-wrap
  11545. msgid ""
  11546. " dpkg-maintscript-helper mv_conffile \\e\n"
  11547. " I<old-conffile> I<new-conffile> I<prior-version> I<package> -- "
  11548. "\"$@\"\n"
  11549. msgstr ""
  11550. #. type: Plain text
  11551. #: dpkg-maintscript-helper.man:1
  11552. msgid ""
  11553. "I<old-conffile> and I<new-conffile> are the old and new name of the conffile "
  11554. "to rename."
  11555. msgstr ""
  11556. #. type: Plain text
  11557. #: dpkg-maintscript-helper.man:1
  11558. msgid ""
  11559. "Current implementation: the B<preinst> checks if the conffile has been "
  11560. "modified, if yes it's left on place otherwise it's renamed to "
  11561. "I<old-conffile>B<.dpkg-remove>. On configuration, the B<postinst> removes "
  11562. "I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to "
  11563. "I<new-conffile> if I<old-conffile> is still available. On "
  11564. "abort-upgrade/abort-install, the B<postrm> renames "
  11565. "I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required."
  11566. msgstr ""
  11567. #. type: SH
  11568. #: dpkg-maintscript-helper.man:1
  11569. #, no-wrap
  11570. msgid "SYMLINK AND DIRECTORY SWITCHES"
  11571. msgstr ""
  11572. #. type: Plain text
  11573. #: dpkg-maintscript-helper.man:1
  11574. msgid ""
  11575. "When upgrading a package, B<dpkg> will not automatically switch a symlink to "
  11576. "a directory or vice-versa. Downgrades are not supported and the path will be "
  11577. "left as is."
  11578. msgstr ""
  11579. #. type: SS
  11580. #: dpkg-maintscript-helper.man:1
  11581. #, no-wrap
  11582. msgid "Switching a symlink to directory"
  11583. msgstr ""
  11584. #. type: Plain text
  11585. #: dpkg-maintscript-helper.man:1
  11586. msgid ""
  11587. "If a symlink is switched to a real directory, you need to make sure before "
  11588. "unpacking that the symlink is removed. This may seem a simple change to the "
  11589. "B<preinst> script at first, however that will result in some problems in "
  11590. "case of admin local customization of the symlink or when downgrading the "
  11591. "package."
  11592. msgstr ""
  11593. #. type: Plain text
  11594. #: dpkg-maintscript-helper.man:1
  11595. #, no-wrap
  11596. msgid ""
  11597. " dpkg-maintscript-helper symlink_to_dir \\e\n"
  11598. " I<pathname> I<old-target> I<prior-version> I<package> -- \"$@\"\n"
  11599. msgstr ""
  11600. #. type: Plain text
  11601. #: dpkg-maintscript-helper.man:1
  11602. msgid ""
  11603. "I<pathname> is the absolute name of the old symlink (the path will be a "
  11604. "directory at the end of the installation) and I<old-target> is the target "
  11605. "name of the former symlink at I<pathname>. It can either be absolute or "
  11606. "relative to the directory containing I<pathname>."
  11607. msgstr ""
  11608. #. type: Plain text
  11609. #: dpkg-maintscript-helper.man:1
  11610. msgid ""
  11611. "Current implementation: the B<preinst> checks if the symlink exists and "
  11612. "points to I<old-target>, if not then it's left in place, otherwise it's "
  11613. "renamed to I<pathname>B<.dpkg-backup>. On configuration, the B<postinst> "
  11614. "removes I<pathname>B<.dpkg-backup> if I<pathname>B<.dpkg-backup> is still a "
  11615. "symlink. On abort-upgrade/abort-install, the B<postrm> renames "
  11616. "I<pathname>B<.dpkg-backup> back to I<pathname> if required."
  11617. msgstr ""
  11618. #. type: SS
  11619. #: dpkg-maintscript-helper.man:1
  11620. #, no-wrap
  11621. msgid "Switching a directory to symlink"
  11622. msgstr ""
  11623. #. type: Plain text
  11624. #: dpkg-maintscript-helper.man:1
  11625. msgid ""
  11626. "If a real directory is switched to a symlink, you need to make sure before "
  11627. "unpacking that the directory is removed. This may seem a simple change to "
  11628. "the B<preinst> script at first, however that will result in some problems in "
  11629. "case the directory contains conffiles, pathnames owned by other packages, "
  11630. "locally created pathnames, or when downgrading the package."
  11631. msgstr ""
  11632. #. type: Plain text
  11633. #: dpkg-maintscript-helper.man:1
  11634. msgid ""
  11635. "Graceful switching can be implemented by putting the following shell snippet "
  11636. "in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
  11637. msgstr ""
  11638. #. type: Plain text
  11639. #: dpkg-maintscript-helper.man:1
  11640. #, no-wrap
  11641. msgid ""
  11642. " dpkg-maintscript-helper dir_to_symlink \\e\n"
  11643. " I<pathname> I<new-target> I<prior-version> I<package> -- \"$@\"\n"
  11644. msgstr ""
  11645. #. type: Plain text
  11646. #: dpkg-maintscript-helper.man:1
  11647. msgid ""
  11648. "I<pathname> is the absolute name of the old directory (the path will be a "
  11649. "symlink at the end of the installation) and I<new-target> is the target of "
  11650. "the new symlink at I<pathname>. It can either be absolute or relative to the "
  11651. "directory containing I<pathname>."
  11652. msgstr ""
  11653. #. type: Plain text
  11654. #: dpkg-maintscript-helper.man:1
  11655. msgid ""
  11656. "Current implementation: the B<preinst> checks if the directory exists, does "
  11657. "not contain conffiles, pathnames owned by other packages, or locally created "
  11658. "pathnames, if not then it's left in place, otherwise it's renamed to "
  11659. "I<pathname>B<.dpkg-backup>, and an empty staging directory named I<pathname> "
  11660. "is created, marked with a file so that dpkg can track it. On configuration, "
  11661. "the B<postinst> finishes the switch if I<pathname>B<.dpkg-backup> is still a "
  11662. "directory and I<pathname> is the staging directory; it removes the staging "
  11663. "directory mark file, moves the newly created files inside the staging "
  11664. "directory to the symlink target I<new-target>/, replaces the now empty "
  11665. "staging directory I<pathname> with a symlink to I<new-target>, and removes "
  11666. "I<pathname>B<.dpkg-backup>. On abort-upgrade/abort-install, the B<postrm> "
  11667. "renames I<pathname>B<.dpkg-backup> back to I<pathname> if required."
  11668. msgstr ""
  11669. #. type: SH
  11670. #: dpkg-maintscript-helper.man:1
  11671. #, no-wrap
  11672. msgid "INTEGRATION IN PACKAGES"
  11673. msgstr ""
  11674. #. type: Plain text
  11675. #: dpkg-maintscript-helper.man:1
  11676. msgid ""
  11677. "When using a packaging helper, please check if it has native "
  11678. "B<dpkg-maintscript-helper> integration, which might make your life "
  11679. "easier. See for example B<dh_installdeb>(1)."
  11680. msgstr ""
  11681. #. type: Plain text
  11682. #: dpkg-maintscript-helper.man:1
  11683. msgid ""
  11684. "Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it "
  11685. "unconditionally requires a pre-dependency to ensure that the required "
  11686. "version of B<dpkg> has been unpacked before. The required version depends on "
  11687. "the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2, for "
  11688. "B<symlink_to_dir> and B<dir_to_symlink> it is 1.17.14:"
  11689. msgstr ""
  11690. #. type: Plain text
  11691. #: dpkg-maintscript-helper.man:1
  11692. #, no-wrap
  11693. msgid " B<Pre-Depends:> dpkg (E<gt>= 1.17.14)\n"
  11694. msgstr ""
  11695. #. type: Plain text
  11696. #: dpkg-maintscript-helper.man:1
  11697. msgid ""
  11698. "But in many cases the operation done by the program is not critical for the "
  11699. "package, and instead of using a pre-dependency we can call the program only "
  11700. "if we know that the required command is supported by the currently installed "
  11701. "B<dpkg>:"
  11702. msgstr ""
  11703. #. type: Plain text
  11704. #: dpkg-maintscript-helper.man:1
  11705. #, no-wrap
  11706. msgid ""
  11707. " if dpkg-maintscript-helper supports I<command>; then\n"
  11708. " dpkg-maintscript-helper I<command> ...\n"
  11709. " fi\n"
  11710. msgstr ""
  11711. #. type: Plain text
  11712. #: dpkg-maintscript-helper.man:1
  11713. msgid ""
  11714. "The command B<supports> will return 0 on success, 1 otherwise. The "
  11715. "B<supports> command will check if the environment variables as set by dpkg "
  11716. "and required by the script are present, and will consider it a failure in "
  11717. "case the environment is not sufficient."
  11718. msgstr ""
  11719. #. type: Plain text
  11720. #: dpkg-maintscript-helper.man:1
  11721. msgid "B<dh_installdeb>(1)."
  11722. msgstr ""
  11723. #. type: TH
  11724. #: dpkg-mergechangelogs.man:1
  11725. #, no-wrap
  11726. msgid "dpkg-mergechangelogs"
  11727. msgstr ""
  11728. #. type: Plain text
  11729. #: dpkg-mergechangelogs.man:1
  11730. msgid "dpkg-mergechangelogs - 3-way merge of debian/changelog files"
  11731. msgstr ""
  11732. #. type: Plain text
  11733. #: dpkg-mergechangelogs.man:1
  11734. msgid "B<dpkg-mergechangelogs> [I<option>...] I<old> I<new-a> I<new-b> [I<out>]"
  11735. msgstr ""
  11736. #. type: Plain text
  11737. #: dpkg-mergechangelogs.man:1
  11738. msgid ""
  11739. "This program will use the 3 provided versions of the Debian changelog to "
  11740. "generate a merged changelog file. The resulting changelog is stored in the "
  11741. "file I<out> or output to the standard output if that parameter is not given."
  11742. msgstr ""
  11743. #. type: Plain text
  11744. #: dpkg-mergechangelogs.man:1
  11745. msgid ""
  11746. "Each entry is identified by its version number and they are assumed to be "
  11747. "not conflicting, they are simply merged in the right order (by decreasing "
  11748. "version number). When B<--merge-prereleases> is used, the part of the "
  11749. "version number after the last tilde is dropped so that 1.0-1~exp1 and "
  11750. "1.0-1~exp5 are considered to be the same entry. When the same version is "
  11751. "available in both I<new-a> and I<new-b>, a standard line-based 3-way merge "
  11752. "is attempted (provided that the module Algorithm::Merge is available — it's "
  11753. "part of the package libalgorithm-merge-perl — otherwise you get a global "
  11754. "conflict on the content of the entry)."
  11755. msgstr ""
  11756. #. type: TP
  11757. #: dpkg-mergechangelogs.man:1
  11758. #, no-wrap
  11759. msgid "B<-m>, B<--merge-prereleases>"
  11760. msgstr ""
  11761. #. type: Plain text
  11762. #: dpkg-mergechangelogs.man:1
  11763. msgid ""
  11764. "Drop the part after the last tilde in the version number when doing version "
  11765. "comparison to identify if two entries are supposed to be the same or not."
  11766. msgstr ""
  11767. #. type: Plain text
  11768. #: dpkg-mergechangelogs.man:1
  11769. msgid ""
  11770. "This is useful when you keep using the same changelog entry but you increase "
  11771. "its version number regularly. For instance, you might have 2.3-1~exp1, "
  11772. "2.3-1~exp2, ... until the official release 2.3-1 and they are all the same "
  11773. "changelog entry that has evolved over time."
  11774. msgstr ""
  11775. #. type: SH
  11776. #: dpkg-mergechangelogs.man:1
  11777. #, no-wrap
  11778. msgid "LIMITATIONS"
  11779. msgstr ""
  11780. #. type: Plain text
  11781. #: dpkg-mergechangelogs.man:1
  11782. msgid ""
  11783. "Anything that is not parsed by Dpkg::Changelog is lost during the merge. "
  11784. "This might include stuff like vim modelines, comments which were not "
  11785. "supposed to be there, etc."
  11786. msgstr ""
  11787. #. type: SH
  11788. #: dpkg-mergechangelogs.man:1
  11789. #, no-wrap
  11790. msgid "INTEGRATION WITH GIT"
  11791. msgstr ""
  11792. #. type: Plain text
  11793. #: dpkg-mergechangelogs.man:1
  11794. msgid ""
  11795. "If you want to use this program to merge Debian changelog files in a git "
  11796. "repository, you have first to register a new merge driver in B<.git/config> "
  11797. "or B<~/.gitconfig>:"
  11798. msgstr ""
  11799. #. type: Plain text
  11800. #: dpkg-mergechangelogs.man:1
  11801. #, no-wrap
  11802. msgid ""
  11803. " [merge \"dpkg-mergechangelogs\"]\n"
  11804. " name = debian/changelog merge driver\n"
  11805. " driver = dpkg-mergechangelogs -m %O %A %B %A\n"
  11806. msgstr ""
  11807. #. type: Plain text
  11808. #: dpkg-mergechangelogs.man:1
  11809. msgid ""
  11810. "Then you have to setup the merge attribute for the debian/changelog file "
  11811. "either in B<.gitattributes> in the repository itself, or in "
  11812. "B<.git/info/attributes>:"
  11813. msgstr ""
  11814. #. type: Plain text
  11815. #: dpkg-mergechangelogs.man:1
  11816. #, no-wrap
  11817. msgid " debian/changelog merge=dpkg-mergechangelogs\n"
  11818. msgstr ""
  11819. #. type: TH
  11820. #: dpkg-name.man:1
  11821. #, no-wrap
  11822. msgid "dpkg-name"
  11823. msgstr ""
  11824. #. type: Plain text
  11825. #: dpkg-name.man:1
  11826. msgid "dpkg-name - rename Debian packages to full package names"
  11827. msgstr ""
  11828. #. type: Plain text
  11829. #: dpkg-name.man:1
  11830. msgid "B<dpkg-name> [I<option>...] [B<-->] I<file>..."
  11831. msgstr ""
  11832. #. type: Plain text
  11833. #: dpkg-name.man:1
  11834. msgid ""
  11835. "This manual page documents the B<dpkg-name> program which provides an easy "
  11836. "way to rename B<Debian> packages into their full package names. A full "
  11837. "package name consists of "
  11838. "I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified "
  11839. "in the control file of the package. The I<version> part of the filename "
  11840. "consists of the upstream version information optionally followed by a hyphen "
  11841. "and the revision information. The I<package-type> part comes from that field "
  11842. "if present or fallbacks to B<deb>."
  11843. msgstr ""
  11844. #. type: TP
  11845. #: dpkg-name.man:1
  11846. #, no-wrap
  11847. msgid "B<-a>, B<--no-architecture>"
  11848. msgstr ""
  11849. #. type: Plain text
  11850. #: dpkg-name.man:1
  11851. msgid "The destination filename will not have the architecture information."
  11852. msgstr ""
  11853. #. type: TP
  11854. #: dpkg-name.man:1
  11855. #, no-wrap
  11856. msgid "B<-k>, B<--symlink>"
  11857. msgstr ""
  11858. #. type: Plain text
  11859. #: dpkg-name.man:1
  11860. msgid "Create a symlink, instead of moving."
  11861. msgstr ""
  11862. #. type: TP
  11863. #: dpkg-name.man:1
  11864. #, no-wrap
  11865. msgid "B<-o>, B<--overwrite>"
  11866. msgstr ""
  11867. #. type: Plain text
  11868. #: dpkg-name.man:1
  11869. msgid ""
  11870. "Existing files will be overwritten if they have the same name as the "
  11871. "destination filename."
  11872. msgstr ""
  11873. #. type: TP
  11874. #: dpkg-name.man:1
  11875. #, no-wrap
  11876. msgid "B<-s>, B<--subdir> [I<dir>]"
  11877. msgstr ""
  11878. #. type: Plain text
  11879. #: dpkg-name.man:1
  11880. msgid ""
  11881. "Files will be moved into a subdirectory. If the directory given as argument "
  11882. "exists the files will be moved into that directory otherwise the name of the "
  11883. "target directory is extracted from the section field in the control part of "
  11884. "the package. The target directory will be "
  11885. "«unstable/binary-I<architecture>/I<section>». If the section is not found "
  11886. "in the control, then B<no-section> is assumed, and in this case, as well as "
  11887. "for sections B<non-free> and B<contrib> the target directory is "
  11888. "«I<section>/binary-I<architecture>». The section field is not required so a "
  11889. "lot of packages will find their way to the B<no-section> area. Use this "
  11890. "option with care, it's messy."
  11891. msgstr ""
  11892. #. type: TP
  11893. #: dpkg-name.man:1
  11894. #, no-wrap
  11895. msgid "B<-c>, B<--create-dir>"
  11896. msgstr ""
  11897. #. type: Plain text
  11898. #: dpkg-name.man:1
  11899. msgid ""
  11900. "This option can used together with the B<-s> option. If a target directory "
  11901. "isn't found it will be created automatically. B<Use this option with care.>"
  11902. msgstr ""
  11903. #. type: TP
  11904. #: dpkg-name.man:1
  11905. #, no-wrap
  11906. msgid "B<-v>, B<--version>"
  11907. msgstr ""
  11908. #. type: Plain text
  11909. #: dpkg-name.man:1
  11910. msgid ""
  11911. "Some packages don't follow the name structure "
  11912. "I<package>B<_>I<version>B<_>I<architecture>B<.deb>. Packages renamed by "
  11913. "B<dpkg-name> will follow this structure. Generally this will have no impact "
  11914. "on how packages are installed by B<dselect>(1)/B<dpkg>(1), but other "
  11915. "installation tools might depend on this naming structure."
  11916. msgstr ""
  11917. #. type: TP
  11918. #: dpkg-name.man:1
  11919. #, no-wrap
  11920. msgid "B<dpkg-name bar-foo.deb>"
  11921. msgstr ""
  11922. #. type: Plain text
  11923. #: dpkg-name.man:1
  11924. msgid ""
  11925. "The file B<bar-foo.deb> will be renamed to bar-foo_1.0-2_i386.deb or "
  11926. "something similar (depending on whatever information is in the control part "
  11927. "of B<bar-foo.deb>)."
  11928. msgstr ""
  11929. #. type: TP
  11930. #: dpkg-name.man:1
  11931. #, no-wrap
  11932. msgid "B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>"
  11933. msgstr ""
  11934. #. type: Plain text
  11935. #: dpkg-name.man:1
  11936. msgid ""
  11937. "All files with the extension B<deb> in the directory /root/debian and its "
  11938. "subdirectory's will be renamed by B<dpkg-name> if required into names with "
  11939. "no architecture information."
  11940. msgstr ""
  11941. #. type: TP
  11942. #: dpkg-name.man:1
  11943. #, no-wrap
  11944. msgid "B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>"
  11945. msgstr ""
  11946. #. type: Plain text
  11947. #: dpkg-name.man:1
  11948. msgid ""
  11949. "B<Don't do this.> Your archive will be messed up completely because a lot of "
  11950. "packages don't come with section information. B<Don't do this.>"
  11951. msgstr ""
  11952. #. type: TP
  11953. #: dpkg-name.man:1
  11954. #, no-wrap
  11955. msgid "B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>"
  11956. msgstr ""
  11957. #. type: Plain text
  11958. #: dpkg-name.man:1
  11959. msgid "This can be used when building new packages."
  11960. msgstr ""
  11961. #. type: Plain text
  11962. #: dpkg-name.man:1
  11963. msgid ""
  11964. "B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dpkg-deb>(1), B<find>(1), "
  11965. "B<xargs>(1)."
  11966. msgstr ""
  11967. #. type: TH
  11968. #: dpkg-parsechangelog.man:1
  11969. #, no-wrap
  11970. msgid "dpkg-parsechangelog"
  11971. msgstr ""
  11972. #. type: Plain text
  11973. #: dpkg-parsechangelog.man:1
  11974. msgid "dpkg-parsechangelog - parse Debian changelog files"
  11975. msgstr ""
  11976. #. type: Plain text
  11977. #: dpkg-parsechangelog.man:1
  11978. msgid "B<dpkg-parsechangelog> [I<option>...]"
  11979. msgstr ""
  11980. #. type: Plain text
  11981. #: dpkg-parsechangelog.man:1
  11982. msgid ""
  11983. "B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian "
  11984. "source tree and outputs the information in it to standard output in a "
  11985. "machine-readable form."
  11986. msgstr ""
  11987. #. type: TP
  11988. #: dpkg-parsechangelog.man:1
  11989. #, no-wrap
  11990. msgid "B<-l>, B<--file> I<changelog-file>"
  11991. msgstr ""
  11992. #. type: Plain text
  11993. #: dpkg-parsechangelog.man:1
  11994. msgid ""
  11995. "Specifies the changelog file to read information from. A ‘-’ can be used to "
  11996. "specify reading from standard input. The default is B<debian/changelog>."
  11997. msgstr ""
  11998. #. type: TP
  11999. #: dpkg-parsechangelog.man:1
  12000. #, no-wrap
  12001. msgid "B<-F> I<changelog-format>"
  12002. msgstr ""
  12003. #. type: Plain text
  12004. #: dpkg-parsechangelog.man:1
  12005. msgid ""
  12006. "Specifies the format of the changelog. By default the format is read from a "
  12007. "special line near the bottom of the changelog or failing that defaults to "
  12008. "the B<debian> standard format. See also B<CHANGELOG FORMATS>."
  12009. msgstr ""
  12010. #. type: TP
  12011. #: dpkg-parsechangelog.man:1
  12012. #, no-wrap
  12013. msgid "B<-L> I<libdir>"
  12014. msgstr ""
  12015. #. type: Plain text
  12016. #: dpkg-parsechangelog.man:1
  12017. msgid ""
  12018. "Obsolete option without effect (since dpkg 1.18.8). Setting the perl "
  12019. "environment variables B<PERL5LIB> or B<PERLLIB> has a similar effect when "
  12020. "looking for the parser perl modules."
  12021. msgstr ""
  12022. #. type: TP
  12023. #: dpkg-parsechangelog.man:1
  12024. #, no-wrap
  12025. msgid "B<-S>, B<--show-field> I<field>"
  12026. msgstr ""
  12027. #. type: Plain text
  12028. #: dpkg-parsechangelog.man:1
  12029. msgid ""
  12030. "Specifies the name of the field to show (since dpkg 1.17.0). The field name "
  12031. "is not printed, only its value."
  12032. msgstr ""
  12033. #. type: SS
  12034. #: dpkg-parsechangelog.man:1
  12035. #, no-wrap
  12036. msgid "Parser Options"
  12037. msgstr ""
  12038. #. type: Plain text
  12039. #: dpkg-parsechangelog.man:1
  12040. msgid ""
  12041. "The following options can be used to influence the output of the changelog "
  12042. "parser, e.g. the range of entries or the format of the output."
  12043. msgstr ""
  12044. #. type: TP
  12045. #: dpkg-parsechangelog.man:1
  12046. #, no-wrap
  12047. msgid "B<--format>I< output-format>"
  12048. msgstr ""
  12049. #. type: Plain text
  12050. #: dpkg-parsechangelog.man:1
  12051. msgid ""
  12052. "Set the output format. Currently supported values are B<dpkg> and "
  12053. "B<rfc822>. B<dpkg> is the classic output format (from before this option "
  12054. "existed) and the default. It consists of one paragraph in Debian control "
  12055. "format (see B<deb-control>(5)). If more than one entry is requested, then "
  12056. "most fields are taken from the most recent entry, except otherwise stated:"
  12057. msgstr ""
  12058. #. type: TP
  12059. #: dpkg-parsechangelog.man:1
  12060. #, no-wrap
  12061. msgid "B<Source:>I< pkg-name>"
  12062. msgstr ""
  12063. #. type: TP
  12064. #: dpkg-parsechangelog.man:1
  12065. #, no-wrap
  12066. msgid "B<Version:>I< version>"
  12067. msgstr ""
  12068. #. type: TP
  12069. #: dpkg-parsechangelog.man:1
  12070. #, no-wrap
  12071. msgid "B<Distribution:>I< target-distribution>"
  12072. msgstr ""
  12073. #. type: TP
  12074. #: dpkg-parsechangelog.man:1
  12075. #, no-wrap
  12076. msgid "B<Urgency:>I< urgency>"
  12077. msgstr ""
  12078. #. type: Plain text
  12079. #: dpkg-parsechangelog.man:1
  12080. msgid ""
  12081. "The highest urgency of all included entries is used, followed by the "
  12082. "concatenated (space-separated) comments from all the versions requested."
  12083. msgstr ""
  12084. #. type: TP
  12085. #: dpkg-parsechangelog.man:1
  12086. #, no-wrap
  12087. msgid "B<Maintainer:>I< author>"
  12088. msgstr ""
  12089. #. type: TP
  12090. #: dpkg-parsechangelog.man:1
  12091. #, no-wrap
  12092. msgid "B<Date:>I< date>"
  12093. msgstr ""
  12094. #. type: Plain text
  12095. #: dpkg-parsechangelog.man:1
  12096. msgid ""
  12097. "The date of the entry as a string, as it appears in the changelog. With a "
  12098. "B<strptime>(3) format \"B<%a, %d %b %Y %T %z>\", but where the day of the "
  12099. "week might not actually correspond to the real day obtained from the rest of "
  12100. "the date string. If you need a more accurate representation of the date, "
  12101. "use the B<Timestamp> field, but take into account it might not be possible "
  12102. "to map it back to the exact value in this field."
  12103. msgstr ""
  12104. #. type: TP
  12105. #: dpkg-parsechangelog.man:1
  12106. #, no-wrap
  12107. msgid "B<Timestamp:>I< timestamp>"
  12108. msgstr ""
  12109. #. type: Plain text
  12110. #: dpkg-parsechangelog.man:1
  12111. msgid ""
  12112. "The date of the entry as a timestamp in seconds since the epoch (since dpkg "
  12113. "1.18.8)."
  12114. msgstr ""
  12115. #. type: TP
  12116. #: dpkg-parsechangelog.man:1
  12117. #, no-wrap
  12118. msgid "B<Closes:>I< bug-number>"
  12119. msgstr ""
  12120. #. type: Plain text
  12121. #: dpkg-parsechangelog.man:1
  12122. msgid "The Closes fields of all included entries are merged."
  12123. msgstr ""
  12124. #. type: TP
  12125. #: dpkg-parsechangelog.man:1
  12126. #, no-wrap
  12127. msgid "B<Changes:>I< changelog-entries>"
  12128. msgstr ""
  12129. #. type: Plain text
  12130. #: dpkg-parsechangelog.man:1
  12131. msgid ""
  12132. "The text of all changelog entries is concatenated. To make this field a "
  12133. "valid Debian control format multiline field empty lines are replaced with a "
  12134. "single full stop and all lines is intended by one space character. The exact "
  12135. "content depends on the changelog format."
  12136. msgstr ""
  12137. #. type: Plain text
  12138. #: dpkg-parsechangelog.man:1
  12139. msgid ""
  12140. "The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> "
  12141. "fields are mandatory."
  12142. msgstr ""
  12143. #. type: Plain text
  12144. #: dpkg-parsechangelog.man:1
  12145. msgid "There might be additional user-defined fields present."
  12146. msgstr ""
  12147. #. type: Plain text
  12148. #: dpkg-parsechangelog.man:1
  12149. msgid ""
  12150. "The B<rfc822> format uses the same fields but outputs a separate paragraph "
  12151. "for each changelog entry so that all metadata for each entry is preserved."
  12152. msgstr ""
  12153. #. type: TP
  12154. #: dpkg-parsechangelog.man:1 update-alternatives.man:1
  12155. #, no-wrap
  12156. msgid "B<--all>"
  12157. msgstr ""
  12158. #. type: Plain text
  12159. #: dpkg-parsechangelog.man:1
  12160. msgid "Include all changes. Note: other options have no effect when this is in use."
  12161. msgstr ""
  12162. #. type: TP
  12163. #: dpkg-parsechangelog.man:1
  12164. #, no-wrap
  12165. msgid "B<-s>, B<--since> I<version>"
  12166. msgstr ""
  12167. #. type: TQ
  12168. #: dpkg-parsechangelog.man:1
  12169. #, no-wrap
  12170. msgid "B<-v> I<version>"
  12171. msgstr ""
  12172. #. type: Plain text
  12173. #: dpkg-parsechangelog.man:1
  12174. msgid "Include all changes later than I<version>."
  12175. msgstr ""
  12176. #. type: TP
  12177. #: dpkg-parsechangelog.man:1
  12178. #, no-wrap
  12179. msgid "B<-u>, B<--until> I<version>"
  12180. msgstr ""
  12181. #. type: Plain text
  12182. #: dpkg-parsechangelog.man:1
  12183. msgid "Include all changes earlier than I<version>."
  12184. msgstr ""
  12185. #. type: TP
  12186. #: dpkg-parsechangelog.man:1
  12187. #, no-wrap
  12188. msgid "B<-f>, B<--from> I<version>"
  12189. msgstr ""
  12190. #. type: Plain text
  12191. #: dpkg-parsechangelog.man:1
  12192. msgid "Include all changes equal or later than I<version>."
  12193. msgstr ""
  12194. #. type: TP
  12195. #: dpkg-parsechangelog.man:1
  12196. #, no-wrap
  12197. msgid "B<-t>, B<--to> I<version>"
  12198. msgstr ""
  12199. #. type: Plain text
  12200. #: dpkg-parsechangelog.man:1
  12201. msgid "Include all changes up to or equal than I<version>."
  12202. msgstr ""
  12203. #. type: TP
  12204. #: dpkg-parsechangelog.man:1
  12205. #, no-wrap
  12206. msgid "B<-c>, B<--count> I<number>"
  12207. msgstr ""
  12208. #. type: TQ
  12209. #: dpkg-parsechangelog.man:1
  12210. #, no-wrap
  12211. msgid "B<-n> I<number>"
  12212. msgstr ""
  12213. #. type: Plain text
  12214. #: dpkg-parsechangelog.man:1
  12215. msgid ""
  12216. "Include I<number> entries from the top (or the tail if I<number> is lower "
  12217. "than 0)."
  12218. msgstr ""
  12219. #. type: TP
  12220. #: dpkg-parsechangelog.man:1
  12221. #, no-wrap
  12222. msgid "B<-o>, B<--offset> I<number>"
  12223. msgstr ""
  12224. #. type: Plain text
  12225. #: dpkg-parsechangelog.man:1
  12226. msgid ""
  12227. "Change the starting point for B<--count>, counted from the top (or the tail "
  12228. "if I<number> is lower than 0)."
  12229. msgstr ""
  12230. #. type: SH
  12231. #: dpkg-parsechangelog.man:1
  12232. #, no-wrap
  12233. msgid "CHANGELOG FORMATS"
  12234. msgstr ""
  12235. #. type: Plain text
  12236. #: dpkg-parsechangelog.man:1
  12237. msgid ""
  12238. "It is possible to use a different format to the standard one, by providing a "
  12239. "parser for that alternative format."
  12240. msgstr ""
  12241. #. type: Plain text
  12242. #: dpkg-parsechangelog.man:1
  12243. msgid ""
  12244. "In order to have B<dpkg-parsechangelog> run the new parser, a line must be "
  12245. "included within the last 40 lines of the changelog file, matching the Perl "
  12246. "regular expression: “B<\\eschangelog-format:\\es+([0-9a-z]+)\\eW>”. The "
  12247. "part in parentheses should be the name of the format. For example:"
  12248. msgstr ""
  12249. #. type: Plain text
  12250. #: dpkg-parsechangelog.man:1
  12251. #, no-wrap
  12252. msgid " @@@ changelog-format: I<otherformat> @@@\n"
  12253. msgstr ""
  12254. #. type: Plain text
  12255. #: dpkg-parsechangelog.man:1
  12256. msgid "Changelog format names are non-empty strings of alphanumerics."
  12257. msgstr ""
  12258. #. type: Plain text
  12259. #: dpkg-parsechangelog.man:1
  12260. msgid ""
  12261. "If such a line exists then B<dpkg-parsechangelog> will look for the parser "
  12262. "as a B<Dpkg::Changelog::>I<Otherformat> perl module; it is an error for it "
  12263. "not being present. The parser name in the perl module will be automatically "
  12264. "capitalized. The default changelog format is B<debian>, and a parser for it "
  12265. "is provided by default."
  12266. msgstr ""
  12267. #. type: Plain text
  12268. #: dpkg-parsechangelog.man:1
  12269. msgid ""
  12270. "The parser should be derived from the Dpkg::Changelog class and implement "
  12271. "the required documented interface."
  12272. msgstr ""
  12273. #. type: Plain text
  12274. #: dpkg-parsechangelog.man:1
  12275. msgid ""
  12276. "If the changelog format which is being parsed always or almost always leaves "
  12277. "a blank line between individual change notes, these blank lines should be "
  12278. "stripped out, so as to make the resulting output compact."
  12279. msgstr ""
  12280. #. type: Plain text
  12281. #: dpkg-parsechangelog.man:1
  12282. msgid ""
  12283. "If the changelog format does not contain date or package name information "
  12284. "this information should be omitted from the output. The parser should not "
  12285. "attempt to synthesize it or find it from other sources."
  12286. msgstr ""
  12287. #. type: Plain text
  12288. #: dpkg-parsechangelog.man:1
  12289. msgid ""
  12290. "If the changelog does not have the expected format the parser should error "
  12291. "out, rather than trying to muddle through and possibly generating incorrect "
  12292. "output."
  12293. msgstr ""
  12294. #. type: Plain text
  12295. #: dpkg-parsechangelog.man:1
  12296. msgid "A changelog parser may not interact with the user at all."
  12297. msgstr ""
  12298. #. type: Plain text
  12299. #: dpkg-parsechangelog.man:1
  12300. msgid ""
  12301. "All B<Parser Options> except for B<-v> are only supported since dpkg "
  12302. "1.14.16."
  12303. msgstr ""
  12304. #. type: Plain text
  12305. #: dpkg-parsechangelog.man:1
  12306. msgid ""
  12307. "Short option parsing with non-bundled values available only since dpkg "
  12308. "1.18.0."
  12309. msgstr ""
  12310. #. type: TP
  12311. #: dpkg-parsechangelog.man:1
  12312. #, no-wrap
  12313. msgid "B<debian/changelog>"
  12314. msgstr ""
  12315. #. type: Plain text
  12316. #: dpkg-parsechangelog.man:1
  12317. msgid ""
  12318. "The changelog file, used to obtain version-dependent information about the "
  12319. "source package, such as the urgency and distribution of an upload, the "
  12320. "changes made since a particular release, and the source version number "
  12321. "itself."
  12322. msgstr ""
  12323. #. type: Plain text
  12324. #: dpkg-parsechangelog.man:1
  12325. msgid "B<deb-changelog>(5)."
  12326. msgstr ""
  12327. #. type: TH
  12328. #: dpkg-query.man:1
  12329. #, no-wrap
  12330. msgid "dpkg-query"
  12331. msgstr ""
  12332. #. type: Plain text
  12333. #: dpkg-query.man:1
  12334. msgid "dpkg-query - a tool to query the dpkg database"
  12335. msgstr ""
  12336. #. type: Plain text
  12337. #: dpkg-query.man:1
  12338. msgid "B<dpkg-query> [I<option>...] I<command>"
  12339. msgstr ""
  12340. #. type: Plain text
  12341. #: dpkg-query.man:1
  12342. msgid ""
  12343. "B<dpkg-query> is a tool to show information about packages listed in the "
  12344. "B<dpkg> database."
  12345. msgstr ""
  12346. #. type: TP
  12347. #: dpkg-query.man:1
  12348. #, no-wrap
  12349. msgid "B<-l>, B<--list> [I<package-name-pattern>...]"
  12350. msgstr ""
  12351. #. type: Plain text
  12352. #: dpkg-query.man:1
  12353. msgid ""
  12354. "List packages matching given pattern. If no I<package-name-pattern> is "
  12355. "given, list all packages in I<%ADMINDIR%/status>, excluding the ones marked "
  12356. "as not-installed (i.e. those which have been previously purged). Normal "
  12357. "shell wildcard characters are allowed in I<package-name-pattern>. Please "
  12358. "note you will probably have to quote I<package-name-pattern> to prevent the "
  12359. "shell from performing filename expansion. For example this will list all "
  12360. "package names starting with ``libc6'':"
  12361. msgstr ""
  12362. #. type: Plain text
  12363. #: dpkg-query.man:1
  12364. #, no-wrap
  12365. msgid " B<dpkg-query -l 'libc6*'>\n"
  12366. msgstr ""
  12367. #. type: Plain text
  12368. #: dpkg-query.man:1
  12369. msgid ""
  12370. "The first three columns of the output show the desired action, the package "
  12371. "status, and errors, in that order."
  12372. msgstr ""
  12373. #. type: Plain text
  12374. #: dpkg-query.man:1
  12375. msgid "Desired action:"
  12376. msgstr ""
  12377. #. type: Plain text
  12378. #: dpkg-query.man:1
  12379. #, no-wrap
  12380. msgid ""
  12381. " u = Unknown\n"
  12382. " i = Install\n"
  12383. " h = Hold\n"
  12384. " r = Remove\n"
  12385. " p = Purge\n"
  12386. msgstr ""
  12387. #. type: Plain text
  12388. #: dpkg-query.man:1
  12389. msgid "Package status:"
  12390. msgstr ""
  12391. #. type: Plain text
  12392. #: dpkg-query.man:1
  12393. #, no-wrap
  12394. msgid ""
  12395. " n = Not-installed\n"
  12396. " c = Config-files\n"
  12397. " H = Half-installed\n"
  12398. " U = Unpacked\n"
  12399. " F = Half-configured\n"
  12400. " W = Triggers-awaiting\n"
  12401. " t = Triggers-pending\n"
  12402. " i = Installed\n"
  12403. msgstr ""
  12404. #. type: Plain text
  12405. #: dpkg-query.man:1
  12406. msgid "Error flags:"
  12407. msgstr ""
  12408. #. type: Plain text
  12409. #: dpkg-query.man:1
  12410. #, no-wrap
  12411. msgid ""
  12412. " E<lt>emptyE<gt> = (none)\n"
  12413. " R = Reinst-required\n"
  12414. msgstr ""
  12415. #. type: Plain text
  12416. #: dpkg-query.man:1
  12417. msgid ""
  12418. "An uppercase status or error letter indicates the package is likely to cause "
  12419. "severe problems. Please refer to B<dpkg>(1) for information about the above "
  12420. "states and flags."
  12421. msgstr ""
  12422. #. type: Plain text
  12423. #: dpkg-query.man:1
  12424. msgid ""
  12425. "The output format of this option is not configurable, but varies "
  12426. "automatically to fit the terminal width. It is intended for human readers, "
  12427. "and is not easily machine-readable. See B<-W> (B<--show>) and "
  12428. "B<--showformat> for a way to configure the output format."
  12429. msgstr ""
  12430. #. type: TP
  12431. #: dpkg-query.man:1
  12432. #, no-wrap
  12433. msgid "B<-W>, B<--show> [I<package-name-pattern>...]"
  12434. msgstr ""
  12435. #. type: Plain text
  12436. #: dpkg-query.man:1
  12437. msgid ""
  12438. "Just like the B<--list> option this will list all packages matching the "
  12439. "given pattern. However the output can be customized using the "
  12440. "B<--showformat> option. The default output format gives one line per "
  12441. "matching package, each line having the name (extended with the architecture "
  12442. "qualifier for B<Multi-Arch> B<same> packages) and installed version of the "
  12443. "package, separated by a tab."
  12444. msgstr ""
  12445. #. type: TP
  12446. #: dpkg-query.man:1
  12447. #, no-wrap
  12448. msgid "B<-s>, B<--status> I<package-name>..."
  12449. msgstr ""
  12450. #. type: Plain text
  12451. #: dpkg-query.man:1
  12452. msgid ""
  12453. "Report status of specified package. This just displays the entry in the "
  12454. "installed package status database. When multiple I<package-name> are listed, "
  12455. "the requested status entries are separated by an empty line, with the same "
  12456. "order as specified on the argument list."
  12457. msgstr ""
  12458. #. type: TP
  12459. #: dpkg-query.man:1
  12460. #, no-wrap
  12461. msgid "B<-L>, B<--listfiles> I<package-name>..."
  12462. msgstr ""
  12463. #. type: Plain text
  12464. #: dpkg-query.man:1
  12465. msgid ""
  12466. "List files installed to your system from I<package-name>. When multiple "
  12467. "I<package-name> are listed, the requested lists of files are separated by an "
  12468. "empty line, with the same order as specified on the argument list. However, "
  12469. "note that files created by package-specific installation-scripts are not "
  12470. "listed."
  12471. msgstr ""
  12472. #. type: TP
  12473. #: dpkg-query.man:1
  12474. #, no-wrap
  12475. msgid "B<--control-list> I<package-name>"
  12476. msgstr ""
  12477. #. type: Plain text
  12478. #: dpkg-query.man:1
  12479. msgid ""
  12480. "List control files installed to your system from I<package-name> (since dpkg "
  12481. "1.16.5). These can be used as input arguments to B<--control-show>."
  12482. msgstr ""
  12483. #. type: TP
  12484. #: dpkg-query.man:1
  12485. #, no-wrap
  12486. msgid "B<--control-show> I<package-name> I<control-file>"
  12487. msgstr ""
  12488. #. type: Plain text
  12489. #: dpkg-query.man:1
  12490. msgid ""
  12491. "Print the I<control-file> installed to your system from I<package-name> to "
  12492. "the standard output (since dpkg 1.16.5)."
  12493. msgstr ""
  12494. #. type: TP
  12495. #: dpkg-query.man:1
  12496. #, no-wrap
  12497. msgid "B<-c>, B<--control-path> I<package-name> [I<control-file>]"
  12498. msgstr ""
  12499. #. type: Plain text
  12500. #: dpkg-query.man:1
  12501. msgid ""
  12502. "List paths for control files installed to your system from I<package-name> "
  12503. "(since dpkg 1.15.4). If I<control-file> is specified then only list the "
  12504. "path for that control file if it is present."
  12505. msgstr ""
  12506. #. type: Plain text
  12507. #: dpkg-query.man:1
  12508. msgid ""
  12509. "B<Warning>: this command is deprecated as it gives direct access to the "
  12510. "internal dpkg database, please switch to use B<--control-list> and "
  12511. "B<--control-show> instead for all cases where those commands might give the "
  12512. "same end result. Although, as long as there is still at least one case where "
  12513. "this command is needed (i.e. when having to remove a damaging postrm "
  12514. "maintainer script), and while there is no good solution for that, this "
  12515. "command will not get removed."
  12516. msgstr ""
  12517. #. type: TP
  12518. #: dpkg-query.man:1
  12519. #, no-wrap
  12520. msgid "B<-S>, B<--search> I<filename-search-pattern>..."
  12521. msgstr ""
  12522. #. type: Plain text
  12523. #: dpkg-query.man:1
  12524. msgid ""
  12525. "Search for packages that own files corresponding to the given pattern. "
  12526. "Standard shell wildcard characters can be used in the pattern, where "
  12527. "asterisk (B<*>) and question mark (B<?>) will match a slash, and blackslash "
  12528. "(B<\\e>) will be used as an escape character."
  12529. msgstr ""
  12530. #. type: Plain text
  12531. #: dpkg-query.man:1
  12532. msgid ""
  12533. "If the first character in the I<filename-search-pattern> is none of "
  12534. "‘B<*[?/>’ then it will be considered a substring match and will be "
  12535. "implicitly surrounded by ‘B<*>’ (as in B<*>I<filename-search-pattern>B<*>). "
  12536. "If the subsequent string contains any of ‘B<*[?\\e>’, then it will handled "
  12537. "like a glob pattern, otherwise any trailing ‘B</>’ or ‘B</.>’ will be "
  12538. "removed and a literal path lookup will be performed."
  12539. msgstr ""
  12540. #. type: Plain text
  12541. #: dpkg-query.man:1
  12542. msgid ""
  12543. "This command will not list extra files created by maintainer scripts, nor "
  12544. "will it list alternatives."
  12545. msgstr ""
  12546. #. type: TP
  12547. #: dpkg-query.man:1
  12548. #, no-wrap
  12549. msgid "B<-p>, B<--print-avail> I<package-name>..."
  12550. msgstr ""
  12551. #. type: Plain text
  12552. #: dpkg-query.man:1
  12553. msgid ""
  12554. "Display details about I<package-name>, as found in "
  12555. "I<%ADMINDIR%/available>. When multiple I<package-name> are listed, the "
  12556. "requested I<available> entries are separated by an empty line, with the same "
  12557. "order as specified on the argument list."
  12558. msgstr ""
  12559. #. type: Plain text
  12560. #: dpkg-query.man:1
  12561. msgid ""
  12562. "Users of APT-based frontends should use B<apt-cache show> I<package-name> "
  12563. "instead as the I<available> file is only kept up-to-date when using "
  12564. "B<dselect>."
  12565. msgstr ""
  12566. #. type: Plain text
  12567. #: dpkg-query.man:1 dpkg-trigger.man:1
  12568. msgid ""
  12569. "Change the location of the B<dpkg> database. The default location is "
  12570. "I<%ADMINDIR%>."
  12571. msgstr ""
  12572. #. type: TP
  12573. #: dpkg-query.man:1
  12574. #, no-wrap
  12575. msgid "B<--load-avail>"
  12576. msgstr ""
  12577. #. type: Plain text
  12578. #: dpkg-query.man:1
  12579. msgid ""
  12580. "Also load the available file when using the B<--show> and B<--list> "
  12581. "commands, which now default to only querying the status file (since dpkg "
  12582. "1.16.2)."
  12583. msgstr ""
  12584. #. type: TP
  12585. #: dpkg-query.man:1
  12586. #, no-wrap
  12587. msgid "B<-f>, B<--showformat=>I<format>"
  12588. msgstr ""
  12589. #. type: Plain text
  12590. #: dpkg-query.man:1
  12591. msgid "In the format string, “B<\\e>” introduces escapes:"
  12592. msgstr ""
  12593. #. type: Plain text
  12594. #: dpkg-query.man:1
  12595. #, no-wrap
  12596. msgid ""
  12597. " B<\\en> newline\n"
  12598. " B<\\er> carriage return\n"
  12599. " B<\\et> tab\n"
  12600. msgstr ""
  12601. #. type: Plain text
  12602. #: dpkg-query.man:1
  12603. msgid ""
  12604. "“B<\\e>” before any other character suppresses any special meaning of the "
  12605. "following character, which is useful for “B<\\e>” and “B<$>”."
  12606. msgstr ""
  12607. #. type: Plain text
  12608. #: dpkg-query.man:1
  12609. msgid ""
  12610. "Package information can be included by inserting variable references to "
  12611. "package fields using the syntax “B<${>I<field>[B<;>I<width>]B<}>”. Fields "
  12612. "are printed right-aligned unless the width is negative in which case left "
  12613. "alignment will be used. The following I<field>s are recognized but they are "
  12614. "not necessarily available in the status file (only internal fields or fields "
  12615. "stored in the binary package end up in it):"
  12616. msgstr ""
  12617. #. type: Plain text
  12618. #: dpkg-query.man:1
  12619. #, no-wrap
  12620. msgid ""
  12621. " B<Architecture>\n"
  12622. " B<Bugs>\n"
  12623. " B<Conffiles> (internal)\n"
  12624. " B<Config-Version> (internal)\n"
  12625. " B<Conflicts>\n"
  12626. " B<Breaks>\n"
  12627. " B<Depends>\n"
  12628. " B<Description>\n"
  12629. " B<Enhances>\n"
  12630. " B<Essential>\n"
  12631. " B<Filename> (internal, front-end related)\n"
  12632. " B<Homepage>\n"
  12633. " B<Installed-Size>\n"
  12634. " B<MD5sum> (internal, front-end related)\n"
  12635. " B<MSDOS-Filename> (internal, front-end related)\n"
  12636. " B<Maintainer>\n"
  12637. " B<Origin>\n"
  12638. " B<Package>\n"
  12639. " B<Pre-Depends>\n"
  12640. " B<Priority>\n"
  12641. " B<Provides>\n"
  12642. " B<Recommends>\n"
  12643. " B<Replaces>\n"
  12644. " B<Revision> (obsolete)\n"
  12645. " B<Section>\n"
  12646. " B<Size> (internal, front-end related)\n"
  12647. " B<Source>\n"
  12648. " B<Status> (internal)\n"
  12649. " B<Suggests>\n"
  12650. " B<Tag> (usually not in .deb but in repository Packages files)\n"
  12651. " B<Triggers-Awaited> (internal)\n"
  12652. " B<Triggers-Pending> (internal)\n"
  12653. " B<Version>\n"
  12654. msgstr ""
  12655. #. type: Plain text
  12656. #: dpkg-query.man:1
  12657. msgid ""
  12658. "The following are virtual fields, generated by B<dpkg-query> from values "
  12659. "from other fields (note that these do not use valid names for fields in "
  12660. "control files):"
  12661. msgstr ""
  12662. #. type: TP
  12663. #: dpkg-query.man:1
  12664. #, no-wrap
  12665. msgid "B<binary:Package>"
  12666. msgstr ""
  12667. #. type: Plain text
  12668. #: dpkg-query.man:1
  12669. msgid ""
  12670. "It contains the binary package name with a possible architecture qualifier "
  12671. "like “libc6:amd64” (since dpkg 1.16.2). An architecture qualifier will be "
  12672. "present to make the package name unambiguous, for example if the package has "
  12673. "a B<Multi-Arch> field with a value of B<same> or the package is of a foreign "
  12674. "architecture."
  12675. msgstr ""
  12676. #. type: TP
  12677. #: dpkg-query.man:1
  12678. #, no-wrap
  12679. msgid "B<binary:Summary>"
  12680. msgstr ""
  12681. #. type: Plain text
  12682. #: dpkg-query.man:1
  12683. msgid "It contains the package short description (since dpkg 1.16.2)."
  12684. msgstr ""
  12685. #. type: TP
  12686. #: dpkg-query.man:1
  12687. #, no-wrap
  12688. msgid "B<db:Status-Abbrev>"
  12689. msgstr ""
  12690. #. type: Plain text
  12691. #: dpkg-query.man:1
  12692. msgid ""
  12693. "It contains the abbreviated package status (as three characters), such as "
  12694. "“ii ” or “iHR” (since dpkg 1.16.2). See the B<--list> command description "
  12695. "for more details."
  12696. msgstr ""
  12697. #. type: TP
  12698. #: dpkg-query.man:1
  12699. #, no-wrap
  12700. msgid "B<db:Status-Want>"
  12701. msgstr ""
  12702. #. type: Plain text
  12703. #: dpkg-query.man:1
  12704. msgid ""
  12705. "It contains the package wanted status, part of the Status field (since dpkg "
  12706. "1.17.11)."
  12707. msgstr ""
  12708. #. type: TP
  12709. #: dpkg-query.man:1
  12710. #, no-wrap
  12711. msgid "B<db:Status-Status>"
  12712. msgstr ""
  12713. #. type: Plain text
  12714. #: dpkg-query.man:1
  12715. msgid ""
  12716. "It contains the package status word, part of the Status field (since dpkg "
  12717. "1.17.11)."
  12718. msgstr ""
  12719. #. type: TP
  12720. #: dpkg-query.man:1
  12721. #, no-wrap
  12722. msgid "B<db:Status-Eflag>"
  12723. msgstr ""
  12724. #. type: Plain text
  12725. #: dpkg-query.man:1
  12726. msgid ""
  12727. "It contains the package status error flag, part of the Status field (since "
  12728. "dpkg 1.17.11)."
  12729. msgstr ""
  12730. #. type: TP
  12731. #: dpkg-query.man:1
  12732. #, no-wrap
  12733. msgid "B<source:Package>"
  12734. msgstr ""
  12735. #. type: Plain text
  12736. #: dpkg-query.man:1
  12737. msgid ""
  12738. "It contains the source package name for this binary package (since dpkg "
  12739. "1.16.2)."
  12740. msgstr ""
  12741. #. type: Plain text
  12742. #: dpkg-query.man:1
  12743. msgid ""
  12744. "It contains the source package version for this binary package (since dpkg "
  12745. "1.16.2)"
  12746. msgstr ""
  12747. #. type: Plain text
  12748. #: dpkg-query.man:1
  12749. msgid ""
  12750. "It contains the source package upstream version for this binary package "
  12751. "(since dpkg 1.18.16)"
  12752. msgstr ""
  12753. #. type: Plain text
  12754. #: dpkg-query.man:1
  12755. msgid ""
  12756. "The default format string is “B<${binary:Package}\\et${Version}\\en>”. "
  12757. "Actually, all other fields found in the status file (i.e. user defined "
  12758. "fields) can be requested, too. They will be printed as-is, though, no "
  12759. "conversion nor error checking is done on them. To get the name of the "
  12760. "B<dpkg> maintainer and the installed version, you could run:"
  12761. msgstr ""
  12762. #. type: Plain text
  12763. #: dpkg-query.man:1
  12764. #, no-wrap
  12765. msgid ""
  12766. " B<dpkg-query -W -f='${binary:Package} ${Version}\\et${Maintainer}\\en' "
  12767. "dpkg>\n"
  12768. msgstr ""
  12769. #. type: Plain text
  12770. #: dpkg-query.man:1
  12771. msgid "The requested query was successfully performed."
  12772. msgstr ""
  12773. #. type: Plain text
  12774. #: dpkg-query.man:1
  12775. msgid ""
  12776. "The requested query failed either fully or partially, due to no file or "
  12777. "package being found (except for B<--control-path>, B<--control-list> and "
  12778. "B<--control-show> were such errors are fatal)."
  12779. msgstr ""
  12780. #. type: Plain text
  12781. #: dpkg-query.man:1
  12782. msgid ""
  12783. "This setting influences the output of the B<--list> option by changing the "
  12784. "width of its output."
  12785. msgstr ""
  12786. #. type: TH
  12787. #: dpkg-scanpackages.man:1
  12788. #, no-wrap
  12789. msgid "dpkg-scanpackages"
  12790. msgstr ""
  12791. #. type: Plain text
  12792. #: dpkg-scanpackages.man:1
  12793. msgid "dpkg-scanpackages - create Packages index files"
  12794. msgstr ""
  12795. #. type: Plain text
  12796. #: dpkg-scanpackages.man:1
  12797. msgid ""
  12798. "B<dpkg-scanpackages> [I<option>...] I<binary-path> [I<override-file> "
  12799. "[I<path-prefix>]] B<E<gt>> I<Packages>"
  12800. msgstr ""
  12801. #. type: Plain text
  12802. #: dpkg-scanpackages.man:1
  12803. msgid ""
  12804. "B<dpkg-scanpackages> sorts through a tree of Debian binary packages and "
  12805. "creates a Packages file, used by B<apt>(8), B<dselect>(1), etc, to tell the "
  12806. "user what packages are available for installation. These Packages files are "
  12807. "the same as those found on Debian archive sites and CD-ROMs. You might use "
  12808. "B<dpkg-scanpackages> yourself if making a directory of local packages to "
  12809. "install on a cluster of machines."
  12810. msgstr ""
  12811. #. type: Plain text
  12812. #: dpkg-scanpackages.man:1
  12813. msgid ""
  12814. "B<Note:> If you want to access the generated Packages file with B<apt> you "
  12815. "will probably need to compress the file with B<xz>(1) (generating a "
  12816. "Packages.xz file), B<bzip2>(1) (generating a Packages.bz2 file) or "
  12817. "B<gzip>(1) (generating a Packages.gz file). apt ignores uncompressed "
  12818. "Packages files except on local access (i.e. B<file://> sources)."
  12819. msgstr ""
  12820. #. type: Plain text
  12821. #: dpkg-scanpackages.man:1
  12822. msgid ""
  12823. "I<binary-path> is the name of the tree of the binary packages to process "
  12824. "(for example, B<contrib/binary-i386>). It is best to make this relative to "
  12825. "the root of the Debian archive, because every Filename field in the new "
  12826. "Packages file will start with this string."
  12827. msgstr ""
  12828. #. type: Plain text
  12829. #: dpkg-scanpackages.man:1
  12830. msgid ""
  12831. "I<override-file> is the name of a file to read which contains information "
  12832. "about how the package fits into the distribution (the file can be compressed "
  12833. "since dpkg 1.15.5); see B<deb-override>(5)."
  12834. msgstr ""
  12835. #. type: Plain text
  12836. #: dpkg-scanpackages.man:1
  12837. msgid "I<path-prefix> is an optional string to be prepended to the Filename fields."
  12838. msgstr ""
  12839. #. type: Plain text
  12840. #: dpkg-scanpackages.man:1
  12841. msgid ""
  12842. "If more than one version of a package is found only the newest one is "
  12843. "included in the output. If they have the same version and only differ in "
  12844. "architecture only the first one found is used."
  12845. msgstr ""
  12846. #. type: TP
  12847. #: dpkg-scanpackages.man:1
  12848. #, no-wrap
  12849. msgid "B<-t>, B<--type> I<type>"
  12850. msgstr ""
  12851. #. type: Plain text
  12852. #: dpkg-scanpackages.man:1
  12853. msgid "Scan for *.I<type> packages, instead of *.deb."
  12854. msgstr ""
  12855. #. type: IP
  12856. #: dpkg-scanpackages.man:1 dpkg-scansources.man:1
  12857. #, no-wrap
  12858. msgid "B<-e>, B<--extra-override> I<file>"
  12859. msgstr ""
  12860. #. type: Plain text
  12861. #: dpkg-scanpackages.man:1
  12862. msgid ""
  12863. "Scan I<file> to find supplementary overrides (the file can be compressed "
  12864. "since dpkg 1.15.5). See B<deb-extra-override>(5) for more information on "
  12865. "its format."
  12866. msgstr ""
  12867. #. type: TP
  12868. #: dpkg-scanpackages.man:1
  12869. #, no-wrap
  12870. msgid "B<-a>, B<--arch> I<arch>"
  12871. msgstr ""
  12872. #. type: Plain text
  12873. #: dpkg-scanpackages.man:1
  12874. msgid ""
  12875. "Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of "
  12876. "scanning for all debs."
  12877. msgstr ""
  12878. #. type: TP
  12879. #: dpkg-scanpackages.man:1
  12880. #, no-wrap
  12881. msgid "B<-h>, B<--hash> I<hash-list>"
  12882. msgstr ""
  12883. #. type: Plain text
  12884. #: dpkg-scanpackages.man:1
  12885. msgid ""
  12886. "Only generate file hashes for the comma-specified list specified (since dpkg "
  12887. "1.17.14). The default is to generate all currently supported hashes. "
  12888. "Supported values: B<md5>, B<sha1>, B<sha256>."
  12889. msgstr ""
  12890. #. type: TP
  12891. #: dpkg-scanpackages.man:1
  12892. #, no-wrap
  12893. msgid "B<-m>, B<--multiversion>"
  12894. msgstr ""
  12895. #. type: Plain text
  12896. #: dpkg-scanpackages.man:1
  12897. msgid "Include all found packages in the output."
  12898. msgstr ""
  12899. #. type: TP
  12900. #: dpkg-scanpackages.man:1
  12901. #, no-wrap
  12902. msgid "B<-M>, B<--medium> I<id-string>"
  12903. msgstr ""
  12904. #. type: Plain text
  12905. #: dpkg-scanpackages.man:1
  12906. msgid ""
  12907. "Add an B<X-Medium> field containing the value I<id-string> (since dpkg "
  12908. "1.15.5). This field is required if you want to generate B<Packages.cd> "
  12909. "files for use by the multicd access method of dselect."
  12910. msgstr ""
  12911. #. type: SH
  12912. #: dpkg-scanpackages.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
  12913. #: update-alternatives.man:1
  12914. #, no-wrap
  12915. msgid "DIAGNOSTICS"
  12916. msgstr ""
  12917. #. type: Plain text
  12918. #: dpkg-scanpackages.man:1
  12919. msgid ""
  12920. "B<dpkg-scanpackages> outputs the usual self-explanatory errors. It also "
  12921. "warns about packages that are in the wrong subdirectory, are duplicated, "
  12922. "have a Filename field in their control file, are missing from the override "
  12923. "file, or have maintainer substitutions which do not take effect."
  12924. msgstr ""
  12925. #. type: Plain text
  12926. #: dpkg-scanpackages.man:1
  12927. msgid ""
  12928. "B<dpkg>(1), B<dselect>(1), B<deb-override>(5), B<deb-extra-override>(5), "
  12929. "B<dpkg-scansources>(1)."
  12930. msgstr ""
  12931. #. type: TH
  12932. #: dpkg-scansources.man:1
  12933. #, no-wrap
  12934. msgid "dpkg-scansources"
  12935. msgstr ""
  12936. #. type: Plain text
  12937. #: dpkg-scansources.man:1
  12938. msgid "dpkg-scansources - create Sources index files"
  12939. msgstr ""
  12940. #. type: Plain text
  12941. #: dpkg-scansources.man:1
  12942. msgid ""
  12943. "B<dpkg-scansources> [I<option>...] I<binary-dir> [I<override-file> "
  12944. "[I<path-prefix>]] B<E<gt>> I<Sources>"
  12945. msgstr ""
  12946. #. type: Plain text
  12947. #: dpkg-scansources.man:1
  12948. msgid ""
  12949. "B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files. These "
  12950. "are used to create a Debian source index, which is output to stdout."
  12951. msgstr ""
  12952. #. type: Plain text
  12953. #: dpkg-scansources.man:1
  12954. msgid ""
  12955. "The I<override-file>, if given, is used to set priorities in the resulting "
  12956. "index records and to override the maintainer field given in the I<.dsc> "
  12957. "files. The file can be compressed (since dpkg 1.15.5). See "
  12958. "B<deb-override>(5) for the format of this file. Note: Since the override "
  12959. "file is indexed by binary, not source packages, there's a bit of a problem "
  12960. "here. The current implementation uses the highest priority of all the binary "
  12961. "packages produced by a I<.dsc> file for the priority of the source package, "
  12962. "and the override entry for the first binary package listed in the I<.dsc> "
  12963. "file to modify maintainer information. This might change."
  12964. msgstr ""
  12965. #. type: Plain text
  12966. #: dpkg-scansources.man:1
  12967. msgid ""
  12968. "The I<path-prefix>, if given, is prepended to the directory field in the "
  12969. "generated source index. You generally use this to make the directory fields "
  12970. "contain the path from the top of the Debian archive hierarchy."
  12971. msgstr ""
  12972. #. type: Plain text
  12973. #: dpkg-scansources.man:1
  12974. msgid ""
  12975. "B<Note:> If you want to access the generated Sources file with B<apt>(8) "
  12976. "you will probably need to compress the file with B<gzip>(1) (generating a "
  12977. "Sources.gz file). apt ignores uncompressed Sources files except on local "
  12978. "access (i.e. B<file://> sources)."
  12979. msgstr ""
  12980. #. type: IP
  12981. #: dpkg-scansources.man:1
  12982. #, no-wrap
  12983. msgid "B<-n>, B<--no-sort>"
  12984. msgstr ""
  12985. #. type: Plain text
  12986. #: dpkg-scansources.man:1
  12987. msgid ""
  12988. "Don't sort the index records. Normally they are sorted by source package "
  12989. "name."
  12990. msgstr ""
  12991. #. type: Plain text
  12992. #: dpkg-scansources.man:1
  12993. msgid ""
  12994. "Scan I<file> to find supplementary overrides (since dpkg 1.15.4; the file "
  12995. "can be compressed since dpkg 1.15.5). See B<deb-extra-override>(5) for "
  12996. "more information on its format."
  12997. msgstr ""
  12998. #. type: IP
  12999. #: dpkg-scansources.man:1
  13000. #, no-wrap
  13001. msgid "B<-s>, B<--source-override> I<file>"
  13002. msgstr ""
  13003. #. type: Plain text
  13004. #: dpkg-scansources.man:1
  13005. msgid ""
  13006. "Use I<file> as the source override file (the file can be compressed since "
  13007. "dpkg 1.15.5). The default is the name of the override file you specified "
  13008. "with I<.src> appended."
  13009. msgstr ""
  13010. #. type: Plain text
  13011. #: dpkg-scansources.man:1
  13012. msgid ""
  13013. "The source override file is in a different format from the binary override "
  13014. "file. It contains only two whitespace separated fields, the first is the "
  13015. "source package name and the second is the section. Blank lines and comment "
  13016. "lines are ignored in the normal manner. If a package appears in both files "
  13017. "the source override takes precedence for setting the section."
  13018. msgstr ""
  13019. #. type: IP
  13020. #: dpkg-scansources.man:1
  13021. #, no-wrap
  13022. msgid "B<--debug>"
  13023. msgstr ""
  13024. #. type: Plain text
  13025. #: dpkg-scansources.man:1
  13026. msgid "Turn debugging on."
  13027. msgstr ""
  13028. #. type: Plain text
  13029. #: dpkg-scansources.man:1
  13030. msgid "B<deb-override>(5), B<deb-extra-override>(5), B<dpkg-scanpackages>(1)."
  13031. msgstr ""
  13032. #. type: TH
  13033. #: dpkg-shlibdeps.man:1
  13034. #, no-wrap
  13035. msgid "dpkg-shlibdeps"
  13036. msgstr ""
  13037. #. type: Plain text
  13038. #: dpkg-shlibdeps.man:1
  13039. msgid "dpkg-shlibdeps - generate shared library substvar dependencies"
  13040. msgstr ""
  13041. #. type: Plain text
  13042. #: dpkg-shlibdeps.man:1
  13043. msgid "B<dpkg-shlibdeps> [I<option>...] [B<-e>]I<executable> [I<option>...]"
  13044. msgstr ""
  13045. #. type: Plain text
  13046. #: dpkg-shlibdeps.man:1
  13047. msgid ""
  13048. "B<dpkg-shlibdeps> calculates shared library dependencies for executables "
  13049. "named in its arguments. The dependencies are added to the substitution "
  13050. "variables file B<debian/substvars> as variable names "
  13051. "B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency "
  13052. "field name. Any other variables starting with B<shlibs:> are removed from "
  13053. "the file."
  13054. msgstr ""
  13055. #. type: Plain text
  13056. #: dpkg-shlibdeps.man:1
  13057. msgid ""
  13058. "B<dpkg-shlibdeps> has two possible sources of information to generate "
  13059. "dependency information. Either I<symbols> files or I<shlibs> files. For each "
  13060. "binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries "
  13061. "that it's linked with. Then, for each library, it looks up either the "
  13062. "I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if "
  13063. "debian/shlibs.local contains the relevant dependency). Both files are "
  13064. "supposed to be provided by the library package and should thus be available "
  13065. "as %ADMINDIR%/info/I<package>.I<symbols> or "
  13066. "%ADMINDIR%/info/I<package>.I<shlibs>. The package name is identified in two "
  13067. "steps: find the library file on the system (looking in the same directories "
  13068. "that B<ld.so> would use), then use B<dpkg -S >I<library-file> to lookup the "
  13069. "package providing the library."
  13070. msgstr ""
  13071. #. type: SS
  13072. #: dpkg-shlibdeps.man:1
  13073. #, no-wrap
  13074. msgid "Symbols files"
  13075. msgstr ""
  13076. #. type: Plain text
  13077. #: dpkg-shlibdeps.man:1
  13078. msgid ""
  13079. "Symbols files contain finer-grained dependency information by providing the "
  13080. "minimum dependency for each symbol that the library exports. The script "
  13081. "tries to find a symbols file associated to a library package in the "
  13082. "following places (first match is used):"
  13083. msgstr ""
  13084. #. type: IP
  13085. #: dpkg-shlibdeps.man:1
  13086. #, no-wrap
  13087. msgid "debian/*/DEBIAN/symbols"
  13088. msgstr ""
  13089. #. type: Plain text
  13090. #: dpkg-shlibdeps.man:1
  13091. msgid ""
  13092. "Shared library information generated by the current build process that also "
  13093. "invoked B<dpkg-shlibdeps>. They are generated by B<dpkg-gensymbols>(1). "
  13094. "They are only used if the library is found in a package's build tree. The "
  13095. "symbols file in that build tree takes precedence over symbols files from "
  13096. "other binary packages."
  13097. msgstr ""
  13098. #. type: IP
  13099. #: dpkg-shlibdeps.man:1
  13100. #, no-wrap
  13101. msgid "%PKGCONFDIR%/symbols/I<package>.symbols.I<arch>"
  13102. msgstr ""
  13103. #. type: IP
  13104. #: dpkg-shlibdeps.man:1
  13105. #, no-wrap
  13106. msgid "%PKGCONFDIR%/symbols/I<package>.symbols"
  13107. msgstr ""
  13108. #. type: Plain text
  13109. #: dpkg-shlibdeps.man:1
  13110. msgid ""
  13111. "Per-system overriding shared library dependency information. I<arch> is the "
  13112. "architecture of the current system (obtained by B<dpkg-architecture "
  13113. "-qDEB_HOST_ARCH>)."
  13114. msgstr ""
  13115. #. type: IP
  13116. #: dpkg-shlibdeps.man:1
  13117. #, no-wrap
  13118. msgid "Output from “B<dpkg-query --control-path> I<package> symbols”"
  13119. msgstr ""
  13120. #. type: Plain text
  13121. #: dpkg-shlibdeps.man:1 dpkg-shlibdeps.man:1
  13122. msgid ""
  13123. "Package-provided shared library dependency information. Unless overridden "
  13124. "by B<--admindir>, those files are located in %ADMINDIR%."
  13125. msgstr ""
  13126. #. type: Plain text
  13127. #: dpkg-shlibdeps.man:1
  13128. msgid ""
  13129. "While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers "
  13130. "the (biggest) minimal version needed for each library. At the end of the "
  13131. "process, it is able to write out the minimal dependency for every library "
  13132. "used (provided that the information of the I<symbols> files are accurate)."
  13133. msgstr ""
  13134. #. type: Plain text
  13135. #: dpkg-shlibdeps.man:1
  13136. msgid ""
  13137. "As a safe-guard measure, a symbols file can provide a "
  13138. "B<Build-Depends-Package> meta-information field and B<dpkg-shlibdeps> will "
  13139. "extract the minimal version required by the corresponding package in the "
  13140. "B<Build-Depends> field and use this version if it's higher than the minimal "
  13141. "version computed by scanning symbols."
  13142. msgstr ""
  13143. #. type: SS
  13144. #: dpkg-shlibdeps.man:1
  13145. #, no-wrap
  13146. msgid "Shlibs files"
  13147. msgstr ""
  13148. #. type: Plain text
  13149. #: dpkg-shlibdeps.man:1
  13150. msgid ""
  13151. "Shlibs files associate directly a library to a dependency (without looking "
  13152. "at the symbols). It's thus often stronger than really needed but very safe "
  13153. "and easy to handle."
  13154. msgstr ""
  13155. #. type: Plain text
  13156. #: dpkg-shlibdeps.man:1
  13157. msgid ""
  13158. "The dependencies for a library are looked up in several places. The first "
  13159. "file providing information for the library of interest is used:"
  13160. msgstr ""
  13161. #. type: IP
  13162. #: dpkg-shlibdeps.man:1
  13163. #, no-wrap
  13164. msgid "debian/shlibs.local"
  13165. msgstr ""
  13166. #. type: Plain text
  13167. #: dpkg-shlibdeps.man:1
  13168. msgid "Package-local overriding shared library dependency information."
  13169. msgstr ""
  13170. #. type: IP
  13171. #: dpkg-shlibdeps.man:1
  13172. #, no-wrap
  13173. msgid "%PKGCONFDIR%/shlibs.override"
  13174. msgstr ""
  13175. #. type: Plain text
  13176. #: dpkg-shlibdeps.man:1
  13177. msgid "Per-system overriding shared library dependency information."
  13178. msgstr ""
  13179. #. type: IP
  13180. #: dpkg-shlibdeps.man:1
  13181. #, no-wrap
  13182. msgid "debian/*/DEBIAN/shlibs"
  13183. msgstr ""
  13184. #. type: Plain text
  13185. #: dpkg-shlibdeps.man:1
  13186. msgid ""
  13187. "Shared library information generated by the current build process that also "
  13188. "invoked B<dpkg-shlibdeps>. They are only used if the library is found in a "
  13189. "package's build tree. The shlibs file in that build tree takes precedence "
  13190. "over shlibs files from other binary packages."
  13191. msgstr ""
  13192. #. type: IP
  13193. #: dpkg-shlibdeps.man:1
  13194. #, no-wrap
  13195. msgid "Output from “B<dpkg-query --control-path> I<package> shlibs”"
  13196. msgstr ""
  13197. #. type: IP
  13198. #: dpkg-shlibdeps.man:1
  13199. #, no-wrap
  13200. msgid "%PKGCONFDIR%/shlibs.default"
  13201. msgstr ""
  13202. #. type: Plain text
  13203. #: dpkg-shlibdeps.man:1
  13204. msgid "Per-system default shared library dependency information."
  13205. msgstr ""
  13206. #. type: Plain text
  13207. #: dpkg-shlibdeps.man:1
  13208. msgid ""
  13209. "The extracted dependencies are then directly used (except if they are "
  13210. "filtered out because they have been identified as duplicate, or as weaker "
  13211. "than another dependency)."
  13212. msgstr ""
  13213. #. type: Plain text
  13214. #: dpkg-shlibdeps.man:1
  13215. msgid ""
  13216. "B<dpkg-shlibdeps> interprets non-option arguments as executable names, just "
  13217. "as if they'd been supplied as B<-e>I<executable>."
  13218. msgstr ""
  13219. #. type: TP
  13220. #: dpkg-shlibdeps.man:1
  13221. #, no-wrap
  13222. msgid "B<-e>I<executable>"
  13223. msgstr ""
  13224. #. type: Plain text
  13225. #: dpkg-shlibdeps.man:1
  13226. msgid ""
  13227. "Include dependencies appropriate for the shared libraries required by "
  13228. "I<executable>. This option can be used multiple times."
  13229. msgstr ""
  13230. #. type: TP
  13231. #: dpkg-shlibdeps.man:1
  13232. #, no-wrap
  13233. msgid "B<-l>I<directory>"
  13234. msgstr ""
  13235. #. type: Plain text
  13236. #: dpkg-shlibdeps.man:1
  13237. msgid ""
  13238. "Prepend I<directory> to the list of directories to search for private shared "
  13239. "libraries (since dpkg 1.17.0). This option can be used multiple times."
  13240. msgstr ""
  13241. #. type: Plain text
  13242. #: dpkg-shlibdeps.man:1
  13243. msgid ""
  13244. "Note: Use this option instead of setting B<LD_LIBRARY_PATH>, as that "
  13245. "environment variable is used to control the run-time linker and abusing it "
  13246. "to set the shared library paths at build-time can be problematic when "
  13247. "cross-compiling for example."
  13248. msgstr ""
  13249. #. type: TP
  13250. #: dpkg-shlibdeps.man:1
  13251. #, no-wrap
  13252. msgid "B<-d>I<dependency-field>"
  13253. msgstr ""
  13254. #. type: Plain text
  13255. #: dpkg-shlibdeps.man:1
  13256. msgid ""
  13257. "Add dependencies to be added to the control file dependency field "
  13258. "I<dependency-field>. (The dependencies for this field are placed in the "
  13259. "variable B<shlibs:>I<dependency-field>.)"
  13260. msgstr ""
  13261. #. type: Plain text
  13262. #: dpkg-shlibdeps.man:1
  13263. msgid ""
  13264. "The B<-d>I<dependency-field> option takes effect for all executables after "
  13265. "the option, until the next B<-d>I<dependency-field>. The default "
  13266. "I<dependency-field> is B<Depends>."
  13267. msgstr ""
  13268. #. type: Plain text
  13269. #: dpkg-shlibdeps.man:1
  13270. msgid ""
  13271. "If the same dependency entry (or set of alternatives) appears in more than "
  13272. "one of the recognized dependency field names B<Pre-Depends>, B<Depends>, "
  13273. "B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will "
  13274. "automatically remove the dependency from all fields except the one "
  13275. "representing the most important dependencies."
  13276. msgstr ""
  13277. #. type: TP
  13278. #: dpkg-shlibdeps.man:1
  13279. #, no-wrap
  13280. msgid "B<-p>I<varname-prefix>"
  13281. msgstr ""
  13282. #. type: Plain text
  13283. #: dpkg-shlibdeps.man:1
  13284. msgid ""
  13285. "Start substitution variables with I<varname-prefix>B<:> instead of "
  13286. "B<shlibs:>. Likewise, any existing substitution variables starting with "
  13287. "I<varname-prefix>B<:> (rather than B<shlibs:>) are removed from the "
  13288. "substitution variables file."
  13289. msgstr ""
  13290. #. type: Plain text
  13291. #: dpkg-shlibdeps.man:1
  13292. msgid ""
  13293. "Print substitution variable settings to standard output (or I<filename> if "
  13294. "specified, since dpkg 1.17.2), rather than being added to the substitution "
  13295. "variables file (B<debian/substvars> by default)."
  13296. msgstr ""
  13297. #. type: TP
  13298. #: dpkg-shlibdeps.man:1
  13299. #, no-wrap
  13300. msgid "B<-t>I<type>"
  13301. msgstr ""
  13302. #. type: Plain text
  13303. #: dpkg-shlibdeps.man:1
  13304. msgid ""
  13305. "Prefer shared library dependency information tagged for the given package "
  13306. "type. If no tagged information is available, falls back to untagged "
  13307. "information. The default package type is B<deb>. Shared library dependency "
  13308. "information is tagged for a given type by prefixing it with the name of the "
  13309. "type, a colon, and whitespace."
  13310. msgstr ""
  13311. #. type: TP
  13312. #: dpkg-shlibdeps.man:1
  13313. #, no-wrap
  13314. msgid "B<-L>I<local-shlibs-file>"
  13315. msgstr ""
  13316. #. type: Plain text
  13317. #: dpkg-shlibdeps.man:1
  13318. msgid ""
  13319. "Read overriding shared library dependency information from "
  13320. "I<local-shlibs-file> instead of B<debian/shlibs.local>."
  13321. msgstr ""
  13322. #. type: Plain text
  13323. #: dpkg-shlibdeps.man:1
  13324. msgid ""
  13325. "Write substitution variables in I<substvars-file>; the default is "
  13326. "B<debian/substvars>."
  13327. msgstr ""
  13328. #. type: TP
  13329. #: dpkg-shlibdeps.man:1
  13330. #, no-wrap
  13331. msgid "B<-v>"
  13332. msgstr ""
  13333. #. type: Plain text
  13334. #: dpkg-shlibdeps.man:1
  13335. msgid ""
  13336. "Enable verbose mode (since dpkg 1.14.8). Numerous messages are displayed to "
  13337. "explain what B<dpkg-shlibdeps> does."
  13338. msgstr ""
  13339. #. type: TP
  13340. #: dpkg-shlibdeps.man:1
  13341. #, no-wrap
  13342. msgid "B<-x>I<package>"
  13343. msgstr ""
  13344. #. type: Plain text
  13345. #: dpkg-shlibdeps.man:1
  13346. msgid ""
  13347. "Exclude the package from the generated dependencies (since dpkg 1.14.8). "
  13348. "This is useful to avoid self-dependencies for packages which provide ELF "
  13349. "binaries (executables or library plugins) using a library contained in the "
  13350. "same package. This option can be used multiple times to exclude several "
  13351. "packages."
  13352. msgstr ""
  13353. #. type: TP
  13354. #: dpkg-shlibdeps.man:1
  13355. #, no-wrap
  13356. msgid "B<-S>I<package-build-dir>"
  13357. msgstr ""
  13358. #. type: Plain text
  13359. #: dpkg-shlibdeps.man:1
  13360. msgid ""
  13361. "Look into I<package-build-dir> first when trying to find a library (since "
  13362. "dpkg 1.14.15). This is useful when the source package builds multiple "
  13363. "flavors of the same library and you want to ensure that you get the "
  13364. "dependency from a given binary package. You can use this option multiple "
  13365. "times: directories will be tried in the same order before directories of "
  13366. "other binary packages."
  13367. msgstr ""
  13368. #. type: TP
  13369. #: dpkg-shlibdeps.man:1
  13370. #, no-wrap
  13371. msgid "B<-I>I<package-build-dir>"
  13372. msgstr ""
  13373. #. type: Plain text
  13374. #: dpkg-shlibdeps.man:1
  13375. msgid ""
  13376. "Ignore I<package-build-dir> when looking for shlibs, symbols, and shared "
  13377. "library files (since dpkg 1.18.5). You can use this option multiple times."
  13378. msgstr ""
  13379. #. type: TP
  13380. #: dpkg-shlibdeps.man:1
  13381. #, no-wrap
  13382. msgid "B<--ignore-missing-info>"
  13383. msgstr ""
  13384. #. type: Plain text
  13385. #: dpkg-shlibdeps.man:1
  13386. msgid ""
  13387. "Do not fail if dependency information can't be found for a shared library "
  13388. "(since dpkg 1.14.8). Usage of this option is discouraged, all libraries "
  13389. "should provide dependency information (either with shlibs files, or with "
  13390. "symbols files) even if they are not yet used by other packages."
  13391. msgstr ""
  13392. #. type: TP
  13393. #: dpkg-shlibdeps.man:1
  13394. #, no-wrap
  13395. msgid "B<--warnings=>I<value>"
  13396. msgstr ""
  13397. #. type: Plain text
  13398. #: dpkg-shlibdeps.man:1
  13399. msgid ""
  13400. "I<value> is a bit field defining the set of warnings that can be emitted by "
  13401. "B<dpkg-shlibdeps> (since dpkg 1.14.17). Bit 0 (value=1) enables the warning "
  13402. "“symbol I<sym> used by I<binary> found in none of the libraries”, bit 1 "
  13403. "(value=2) enables the warning “package could avoid a useless dependency” and "
  13404. "bit 2 (value=4) enables the warning “I<binary> should not be linked against "
  13405. "I<library>”. The default I<value> is 3: the first two warnings are active "
  13406. "by default, the last one is not. Set I<value> to 7 if you want all warnings "
  13407. "to be active."
  13408. msgstr ""
  13409. #. type: SS
  13410. #: dpkg-shlibdeps.man:1
  13411. #, no-wrap
  13412. msgid "Warnings"
  13413. msgstr ""
  13414. #. type: Plain text
  13415. #: dpkg-shlibdeps.man:1
  13416. msgid ""
  13417. "Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of "
  13418. "the generated package, it is able to emit warnings in several cases. They "
  13419. "inform you of things that can be improved in the package. In most cases, "
  13420. "those improvements concern the upstream sources directly. By order of "
  13421. "decreasing importance, here are the various warnings that you can encounter:"
  13422. msgstr ""
  13423. #. type: TP
  13424. #: dpkg-shlibdeps.man:1
  13425. #, no-wrap
  13426. msgid "B<symbol>I< sym>B< used by >I<binary>B< found in none of the libraries.>"
  13427. msgstr ""
  13428. #. type: Plain text
  13429. #: dpkg-shlibdeps.man:1
  13430. msgid ""
  13431. "The indicated symbol has not been found in the libraries linked with the "
  13432. "binary. The I<binary> is most likely a library and it needs to be linked "
  13433. "with an additional library during the build process (option B<-l>I<library> "
  13434. "of the linker)."
  13435. msgstr ""
  13436. #. type: TP
  13437. #: dpkg-shlibdeps.man:1
  13438. #, no-wrap
  13439. msgid ""
  13440. "I<binary>B< contains an unresolvable reference to symbol >I<sym>B<: it's "
  13441. "probably a plugin>"
  13442. msgstr ""
  13443. #. type: Plain text
  13444. #: dpkg-shlibdeps.man:1
  13445. msgid ""
  13446. "The indicated symbol has not been found in the libraries linked with the "
  13447. "binary. The I<binary> is most likely a plugin and the symbol is probably "
  13448. "provided by the program that loads this plugin. In theory a plugin doesn't "
  13449. "have any SONAME but this binary does have one and as such it could not be "
  13450. "clearly identified as such. However the fact that the binary is stored in a "
  13451. "non-public directory is a strong indication that's it's not a normal shared "
  13452. "library. If the binary is really a plugin, then disregard this warning. But "
  13453. "there's always the possibility that it's a real library and that programs "
  13454. "linking to it are using an RPATH so that the dynamic loader finds it. In "
  13455. "that case, the library is broken and needs to be fixed."
  13456. msgstr ""
  13457. #. type: TP
  13458. #: dpkg-shlibdeps.man:1
  13459. #, no-wrap
  13460. msgid ""
  13461. "B<package could avoid a useless dependency if >I<binary>B< was not linked "
  13462. "against >I<library>B< (it uses none of the library's symbols)>"
  13463. msgstr ""
  13464. #. type: Plain text
  13465. #: dpkg-shlibdeps.man:1
  13466. msgid ""
  13467. "None of the I<binaries> that are linked with I<library> use any of the "
  13468. "symbols provided by the library. By fixing all the binaries, you would avoid "
  13469. "the dependency associated to this library (unless the same dependency is "
  13470. "also generated by another library that is really used)."
  13471. msgstr ""
  13472. #. type: TP
  13473. #: dpkg-shlibdeps.man:1
  13474. #, no-wrap
  13475. msgid ""
  13476. "B<package could avoid a useless dependency if >I<binaries>B< were not linked "
  13477. "against >I<library>B< (they use none of the library's symbols)>"
  13478. msgstr ""
  13479. #. type: Plain text
  13480. #: dpkg-shlibdeps.man:1
  13481. msgid "Exactly the same as the above warning, but for multiple binaries."
  13482. msgstr ""
  13483. #. type: TP
  13484. #: dpkg-shlibdeps.man:1
  13485. #, no-wrap
  13486. msgid ""
  13487. "I<binary>B< should not be linked against >I<library>B< (it uses none of the "
  13488. "library's symbols)>"
  13489. msgstr ""
  13490. #. type: Plain text
  13491. #: dpkg-shlibdeps.man:1
  13492. msgid ""
  13493. "The I<binary> is linked to a library that it doesn't need. It's not a "
  13494. "problem but some small performance improvements in binary load time can be "
  13495. "obtained by not linking this library to this binary. This warning checks the "
  13496. "same information as the previous one but does it for each binary instead of "
  13497. "doing the check globally on all binaries analyzed."
  13498. msgstr ""
  13499. #. type: SS
  13500. #: dpkg-shlibdeps.man:1
  13501. #, no-wrap
  13502. msgid "Errors"
  13503. msgstr ""
  13504. #. type: Plain text
  13505. #: dpkg-shlibdeps.man:1
  13506. msgid ""
  13507. "B<dpkg-shlibdeps> will fail if it can't find a public library used by a "
  13508. "binary or if this library has no associated dependency information (either "
  13509. "shlibs file or symbols file). A public library has a SONAME and is versioned "
  13510. "(libsomething.so.I<X>). A private library (like a plugin) should not have a "
  13511. "SONAME and doesn't need to be versioned."
  13512. msgstr ""
  13513. #. type: TP
  13514. #: dpkg-shlibdeps.man:1
  13515. #, no-wrap
  13516. msgid ""
  13517. "B<couldn't find library >I<library-soname>B< needed by >I<binary>B< (its "
  13518. "RPATH is '>I<rpath>B<')>"
  13519. msgstr ""
  13520. #. type: Plain text
  13521. #: dpkg-shlibdeps.man:1
  13522. msgid ""
  13523. "The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> "
  13524. "has been unable to find the library. B<dpkg-shlibdeps> creates a list of "
  13525. "directories to check as following: directories listed in the RPATH of the "
  13526. "binary, directories added by the B<-l> option, directories listed in the "
  13527. "B<LD_LIBRARY_PATH> environment variable, cross multiarch directories "
  13528. "(ex. /lib/arm64-linux-gnu, /usr/lib/arm64-linux-gnu), standard public "
  13529. "directories (/lib, /usr/lib), directories listed in /etc/ld.so.conf, and "
  13530. "obsolete multilib directories (/lib32, /usr/lib32, /lib64, /usr/lib64). "
  13531. "Then it checks those directories in the package's build tree of the binary "
  13532. "being analyzed, in the packages' build trees indicated with the B<-S> "
  13533. "command-line option, in other packages' build trees that contains a "
  13534. "DEBIAN/shlibs or DEBIAN/symbols file and finally in the root directory. If "
  13535. "the library is not found in any of those directories, then you get this "
  13536. "error."
  13537. msgstr ""
  13538. #. type: Plain text
  13539. #: dpkg-shlibdeps.man:1
  13540. msgid ""
  13541. "If the library not found is in a private directory of the same package, then "
  13542. "you want to add the directory with B<-l>. If it's in another binary package "
  13543. "being built, you want to make sure that the shlibs/symbols file of this "
  13544. "package is already created and that B<-l> contains the appropriate directory "
  13545. "if it also is in a private directory."
  13546. msgstr ""
  13547. #. type: TP
  13548. #: dpkg-shlibdeps.man:1
  13549. #, no-wrap
  13550. msgid ""
  13551. "B<no dependency information found for >I<library-file>B< (used by "
  13552. ">I<binary>B<).>"
  13553. msgstr ""
  13554. #. type: Plain text
  13555. #: dpkg-shlibdeps.man:1
  13556. msgid ""
  13557. "The library needed by I<binary> has been found by B<dpkg-shlibdeps> in "
  13558. "I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency "
  13559. "information for that library. To find out the dependency, it has tried to "
  13560. "map the library to a Debian package with the help of B<dpkg -S "
  13561. ">I<library-file>. Then it checked the corresponding shlibs and symbols "
  13562. "files in %ADMINDIR%/info/, and in the various package's build trees "
  13563. "(debian/*/DEBIAN/)."
  13564. msgstr ""
  13565. #. type: Plain text
  13566. #: dpkg-shlibdeps.man:1
  13567. msgid ""
  13568. "This failure can be caused by a bad or missing shlibs or symbols file in the "
  13569. "package of the library. It might also happen if the library is built within "
  13570. "the same source package and if the shlibs files has not yet been created (in "
  13571. "which case you must fix debian/rules to create the shlibs before calling "
  13572. "B<dpkg-shlibdeps>). Bad RPATH can also lead to the library being found under "
  13573. "a non-canonical name (example: "
  13574. "/usr/lib/openoffice.org/../lib/libssl.so.0.9.8 instead of "
  13575. "/usr/lib/libssl.so.0.9.8) that's not associated to any package, "
  13576. "B<dpkg-shlibdeps> tries to work around this by trying to fallback on a "
  13577. "canonical name (using B<realpath>(3)) but it might not always work. It's "
  13578. "always best to clean up the RPATH of the binary to avoid problems."
  13579. msgstr ""
  13580. #. type: Plain text
  13581. #: dpkg-shlibdeps.man:1
  13582. msgid ""
  13583. "Calling B<dpkg-shlibdeps> in verbose mode (B<-v>) will provide much more "
  13584. "information about where it tried to find the dependency information. This "
  13585. "might be useful if you don't understand why it's giving you this error."
  13586. msgstr ""
  13587. #. type: Plain text
  13588. #: dpkg-shlibdeps.man:1
  13589. msgid "B<deb-shlibs>(5), B<deb-symbols>(5), B<dpkg-gensymbols>(1)."
  13590. msgstr ""
  13591. #. type: TH
  13592. #: dpkg-source.man:1
  13593. #, no-wrap
  13594. msgid "dpkg-source"
  13595. msgstr ""
  13596. #. type: Plain text
  13597. #: dpkg-source.man:1
  13598. msgid "dpkg-source - Debian source package (.dsc) manipulation tool"
  13599. msgstr ""
  13600. #. type: Plain text
  13601. #: dpkg-source.man:1
  13602. msgid "B<dpkg-source> [I<option>...] I<command>"
  13603. msgstr ""
  13604. #. type: Plain text
  13605. #: dpkg-source.man:1
  13606. msgid "B<dpkg-source> packs and unpacks Debian source archives."
  13607. msgstr ""
  13608. #. type: Plain text
  13609. #: dpkg-source.man:1
  13610. msgid ""
  13611. "None of these commands allow multiple options to be combined into one, and "
  13612. "they do not allow the value for an option to be specified in a separate "
  13613. "argument."
  13614. msgstr ""
  13615. #. type: TP
  13616. #: dpkg-source.man:1
  13617. #, no-wrap
  13618. msgid "B<-x>, B<--extract> I<filename>.dsc [I<output-directory>]"
  13619. msgstr ""
  13620. #. type: Plain text
  13621. #: dpkg-source.man:1
  13622. msgid ""
  13623. "Extract a source package (B<--extract> since dpkg 1.17.14). One non-option "
  13624. "argument must be supplied, the name of the Debian source control file "
  13625. "(B<.dsc>). An optional second non-option argument may be supplied to "
  13626. "specify the directory to extract the source package to, this must not "
  13627. "exist. If no output directory is specified, the source package is extracted "
  13628. "into a directory named I<source>-I<version> under the current working "
  13629. "directory."
  13630. msgstr ""
  13631. #. type: Plain text
  13632. #: dpkg-source.man:1
  13633. msgid ""
  13634. "B<dpkg-source> will read the names of the other file(s) making up the source "
  13635. "package from the control file; they are assumed to be in the same directory "
  13636. "as the B<.dsc>."
  13637. msgstr ""
  13638. #. type: Plain text
  13639. #: dpkg-source.man:1
  13640. msgid ""
  13641. "The files in the extracted package will have their permissions and "
  13642. "ownerships set to those which would have been expected if the files and "
  13643. "directories had simply been created - directories and executable files will "
  13644. "be 0777 and plain files will be 0666, both modified by the extractors' "
  13645. "umask; if the parent directory is setgid then the extracted directories will "
  13646. "be too, and all the files and directories will inherit its group ownership."
  13647. msgstr ""
  13648. #. type: Plain text
  13649. #: dpkg-source.man:1
  13650. msgid ""
  13651. "If the source package uses a non-standard format (currently this means all "
  13652. "formats except “1.0”), its name will be stored in B<debian/source/format> so "
  13653. "that the following builds of the source package use the same format by "
  13654. "default."
  13655. msgstr ""
  13656. #. type: TP
  13657. #: dpkg-source.man:1
  13658. #, no-wrap
  13659. msgid "B<-b>, B<--build> I<directory> [I<format-specific-parameters>]"
  13660. msgstr ""
  13661. #. type: Plain text
  13662. #: dpkg-source.man:1
  13663. msgid ""
  13664. "Build a source package (B<--build> since dpkg 1.17.14). The first "
  13665. "non-option argument is taken as the name of the directory containing the "
  13666. "debianized source tree (i.e. with a debian sub-directory and maybe changes "
  13667. "to the original files). Depending on the source package format used to "
  13668. "build the package, additional parameters might be accepted."
  13669. msgstr ""
  13670. #. type: Plain text
  13671. #: dpkg-source.man:1
  13672. msgid ""
  13673. "B<dpkg-source> will build the source package with the first format found in "
  13674. "this ordered list: the format indicated with the I<--format> command line "
  13675. "option, the format indicated in B<debian/source/format>, “1.0”. The "
  13676. "fallback to “1.0” is deprecated and will be removed at some point in the "
  13677. "future, you should always document the desired source format in "
  13678. "B<debian/source/format>. See section B<SOURCE PACKAGE FORMATS> for an "
  13679. "extensive description of the various source package formats."
  13680. msgstr ""
  13681. #. type: TP
  13682. #: dpkg-source.man:1
  13683. #, no-wrap
  13684. msgid "B<--print-format> I<directory>"
  13685. msgstr ""
  13686. #. type: Plain text
  13687. #: dpkg-source.man:1
  13688. msgid ""
  13689. "Print the source format that would be used to build the source package if "
  13690. "B<dpkg-source --build >I<directory> was called (in the same conditions and "
  13691. "with the same parameters; since dpkg 1.15.5)."
  13692. msgstr ""
  13693. #. type: TP
  13694. #: dpkg-source.man:1
  13695. #, no-wrap
  13696. msgid "B<--before-build> I<directory>"
  13697. msgstr ""
  13698. #. type: Plain text
  13699. #: dpkg-source.man:1
  13700. msgid ""
  13701. "Run the corresponding hook of the source package format (since dpkg "
  13702. "1.15.8). This hook is called before any build of the package "
  13703. "(B<dpkg-buildpackage> calls it very early even before B<debian/rules "
  13704. "clean>). This command is idempotent and can be called multiple times. Not "
  13705. "all source formats implement something in this hook, and those that do "
  13706. "usually prepare the source tree for the build for example by ensuring that "
  13707. "the Debian patches are applied."
  13708. msgstr ""
  13709. #. type: TP
  13710. #: dpkg-source.man:1
  13711. #, no-wrap
  13712. msgid "B<--after-build> I<directory>"
  13713. msgstr ""
  13714. #. type: Plain text
  13715. #: dpkg-source.man:1
  13716. msgid ""
  13717. "Run the corresponding hook of the source package format (since dpkg "
  13718. "1.15.8). This hook is called after any build of the package "
  13719. "(B<dpkg-buildpackage> calls it last). This command is idempotent and can be "
  13720. "called multiple times. Not all source formats implement something in this "
  13721. "hook, and those that do usually use it to undo what B<--before-build> has "
  13722. "done."
  13723. msgstr ""
  13724. #. type: TP
  13725. #: dpkg-source.man:1
  13726. #, no-wrap
  13727. msgid "B<--commit> [I<directory>] ..."
  13728. msgstr ""
  13729. #. type: Plain text
  13730. #: dpkg-source.man:1
  13731. msgid ""
  13732. "Record changes in the source tree unpacked in I<directory> (since dpkg "
  13733. "1.16.1). This command can take supplementary parameters depending on the "
  13734. "source format. It will error out for formats where this operation doesn't "
  13735. "mean anything."
  13736. msgstr ""
  13737. #. type: Plain text
  13738. #: dpkg-source.man:1
  13739. msgid ""
  13740. "Show the usage message and exit. The format specific build and extract "
  13741. "options can be shown by using the B<--format> option."
  13742. msgstr ""
  13743. #. type: SS
  13744. #: dpkg-source.man:1
  13745. #, no-wrap
  13746. msgid "Generic build options"
  13747. msgstr ""
  13748. #. type: Plain text
  13749. #: dpkg-source.man:1
  13750. msgid ""
  13751. "Specifies the main source control file to read information from. The default "
  13752. "is B<debian/control>. If given with relative pathname this is interpreted "
  13753. "starting at the source tree's top level directory."
  13754. msgstr ""
  13755. #. type: Plain text
  13756. #: dpkg-source.man:1
  13757. msgid ""
  13758. "Specifies the changelog file to read information from. The default is "
  13759. "B<debian/changelog>. If given with relative pathname this is interpreted "
  13760. "starting at the source tree's top level directory."
  13761. msgstr ""
  13762. #. type: TP
  13763. #: dpkg-source.man:1
  13764. #, no-wrap
  13765. msgid "B<--format=>I<value>"
  13766. msgstr ""
  13767. #. type: Plain text
  13768. #: dpkg-source.man:1
  13769. msgid ""
  13770. "Use the given format for building the source package (since dpkg 1.14.17). "
  13771. "It does override any format given in B<debian/source/format>."
  13772. msgstr ""
  13773. #. type: Plain text
  13774. #: dpkg-source.man:1
  13775. msgid ""
  13776. "Read substitution variables in I<substvars-file>; the default is to not read "
  13777. "any file. This option can be used multiple times to read substitution "
  13778. "variables from multiple files (since dpkg 1.15.6)."
  13779. msgstr ""
  13780. #. type: TP
  13781. #: dpkg-source.man:1
  13782. #, no-wrap
  13783. msgid "B<-Z>I<compression>, B<--compression>=I<compression>"
  13784. msgstr ""
  13785. #. type: Plain text
  13786. #: dpkg-source.man:1
  13787. msgid ""
  13788. "Specify the compression to use for created tarballs and diff files "
  13789. "(B<--compression> since dpkg 1.15.5). Note that this option will not cause "
  13790. "existing tarballs to be recompressed, it only affects new files. Supported "
  13791. "values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>. The default is I<xz> for "
  13792. "formats 2.0 and newer, and I<gzip> for format 1.0. I<xz> is only supported "
  13793. "since dpkg 1.15.5."
  13794. msgstr ""
  13795. #. type: TP
  13796. #: dpkg-source.man:1
  13797. #, no-wrap
  13798. msgid "B<-z>I<level>, B<--compression-level>=I<level>"
  13799. msgstr ""
  13800. #. type: Plain text
  13801. #: dpkg-source.man:1
  13802. msgid ""
  13803. "Compression level to use (B<--compression-level> since dpkg 1.15.5). As "
  13804. "with B<-Z> it only affects newly created files. Supported values are: I<1> "
  13805. "to I<9>, I<best>, and I<fast>. The default is I<9> for gzip and bzip2, I<6> "
  13806. "for xz and lzma."
  13807. msgstr ""
  13808. #. type: TP
  13809. #: dpkg-source.man:1
  13810. #, no-wrap
  13811. msgid "B<-i>[I<regex>], B<--diff-ignore>[=I<regex>]"
  13812. msgstr ""
  13813. #. type: Plain text
  13814. #: dpkg-source.man:1
  13815. msgid ""
  13816. "You may specify a perl regular expression to match files you want filtered "
  13817. "out of the list of files for the diff (B<--diff-ignore> since dpkg 1.15.6). "
  13818. "(This list is generated by a find command.) (If the source package is being "
  13819. "built as a version 3 source package using a VCS, this can be used to ignore "
  13820. "uncommitted changes on specific files. Using -i.* will ignore all of them.)"
  13821. msgstr ""
  13822. #. type: Plain text
  13823. #: dpkg-source.man:1
  13824. msgid ""
  13825. "The B<-i> option by itself enables this setting with a default regex "
  13826. "(preserving any modification to the default regex done by a previous use of "
  13827. "B<--extend-diff-ignore>) that will filter out control files and directories "
  13828. "of the most common revision control systems, backup and swap files and "
  13829. "Libtool build output directories. There can only be one active regex, of "
  13830. "multiple B<-i> options only the last one will take effect."
  13831. msgstr ""
  13832. #. type: Plain text
  13833. #: dpkg-source.man:1
  13834. msgid ""
  13835. "This is very helpful in cutting out extraneous files that get included in "
  13836. "the diff, e.g. if you maintain your source in a revision control system and "
  13837. "want to use a checkout to build a source package without including the "
  13838. "additional files and directories that it will usually contain (e.g. CVS/, "
  13839. ".cvsignore, .svn/). The default regex is already very exhaustive, but if you "
  13840. "need to replace it, please note that by default it can match any part of a "
  13841. "path, so if you want to match the begin of a filename or only full "
  13842. "filenames, you will need to provide the necessary anchors (e.g. ‘(^|/)’, "
  13843. "‘($|/)’) yourself."
  13844. msgstr ""
  13845. #. type: TP
  13846. #: dpkg-source.man:1
  13847. #, no-wrap
  13848. msgid "B<--extend-diff-ignore>=I<regex>"
  13849. msgstr ""
  13850. #. type: Plain text
  13851. #: dpkg-source.man:1
  13852. msgid ""
  13853. "The perl regular expression specified will extend the default value used by "
  13854. "B<--diff-ignore> and its current value, if set (since dpkg 1.15.6). It does "
  13855. "this by concatenating “B<|>I<regex>” to the existing value. This option is "
  13856. "convenient to use in B<debian/source/options> to exclude some auto-generated "
  13857. "files from the automatic patch generation."
  13858. msgstr ""
  13859. #. type: TP
  13860. #: dpkg-source.man:1
  13861. #, no-wrap
  13862. msgid "B<-I>[I<file-pattern>], B<--tar-ignore>[=I<file-pattern>]"
  13863. msgstr ""
  13864. #. type: Plain text
  13865. #: dpkg-source.man:1
  13866. msgid ""
  13867. "If this option is specified, the pattern will be passed to B<tar>(1)'s "
  13868. "B<--exclude> option when it is called to generate a .orig.tar or .tar file "
  13869. "(B<--tar-ignore> since dpkg 1.15.6). For example, B<-I>CVS will make tar "
  13870. "skip over CVS directories when generating a .tar.gz file. The option may be "
  13871. "repeated multiple times to list multiple patterns to exclude."
  13872. msgstr ""
  13873. #. type: Plain text
  13874. #: dpkg-source.man:1
  13875. msgid ""
  13876. "B<-I> by itself adds default B<--exclude> options that will filter out "
  13877. "control files and directories of the most common revision control systems, "
  13878. "backup and swap files and Libtool build output directories."
  13879. msgstr ""
  13880. #. type: Plain text
  13881. #: dpkg-source.man:1
  13882. msgid ""
  13883. "B<Note:> While they have similar purposes, B<-i> and B<-I> have very "
  13884. "different syntax and semantics. B<-i> can only be specified once and takes a "
  13885. "perl compatible regular expression which is matched against the full "
  13886. "relative path of each file. B<-I> can specified multiple times and takes a "
  13887. "filename pattern with shell wildcards. The pattern is applied to the full "
  13888. "relative path but also to each part of the path individually. The exact "
  13889. "semantic of tar's B<--exclude> option is somewhat complicated, see "
  13890. "https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full "
  13891. "documentation."
  13892. msgstr ""
  13893. #. type: Plain text
  13894. #: dpkg-source.man:1
  13895. msgid ""
  13896. "The default regex and patterns for both options can be seen in the output of "
  13897. "the B<--help> command."
  13898. msgstr ""
  13899. #. type: SS
  13900. #: dpkg-source.man:1
  13901. #, no-wrap
  13902. msgid "Generic extract options"
  13903. msgstr ""
  13904. #. type: TP
  13905. #: dpkg-source.man:1
  13906. #, no-wrap
  13907. msgid "B<--no-copy>"
  13908. msgstr ""
  13909. #. type: Plain text
  13910. #: dpkg-source.man:1
  13911. msgid ""
  13912. "Do not copy original tarballs near the extracted source package (since dpkg "
  13913. "1.14.17)."
  13914. msgstr ""
  13915. #. type: TP
  13916. #: dpkg-source.man:1
  13917. #, no-wrap
  13918. msgid "B<--no-check>"
  13919. msgstr ""
  13920. #. type: Plain text
  13921. #: dpkg-source.man:1
  13922. msgid "Do not check signatures and checksums before unpacking (since dpkg 1.14.17)."
  13923. msgstr ""
  13924. #. type: TP
  13925. #: dpkg-source.man:1
  13926. #, no-wrap
  13927. msgid "B<--no-overwrite-dir>"
  13928. msgstr ""
  13929. #. type: Plain text
  13930. #: dpkg-source.man:1
  13931. msgid ""
  13932. "Do not overwrite the extraction directory if it already exists (since dpkg "
  13933. "1.18.8)."
  13934. msgstr ""
  13935. #. type: TP
  13936. #: dpkg-source.man:1
  13937. #, no-wrap
  13938. msgid "B<--require-valid-signature>"
  13939. msgstr ""
  13940. #. type: Plain text
  13941. #: dpkg-source.man:1
  13942. msgid ""
  13943. "Refuse to unpack the source package if it doesn't contain an OpenPGP "
  13944. "signature that can be verified (since dpkg 1.15.0) either with the user's "
  13945. "I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of "
  13946. "the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg> and "
  13947. "I</usr/share/keyrings/debian-maintainers.gpg>)."
  13948. msgstr ""
  13949. #. type: TP
  13950. #: dpkg-source.man:1
  13951. #, no-wrap
  13952. msgid "B<--require-strong-checksums>"
  13953. msgstr ""
  13954. #. type: Plain text
  13955. #: dpkg-source.man:1
  13956. msgid ""
  13957. "Refuse to unpack the source package if it does not contain any strong "
  13958. "checksums (since dpkg 1.18.7). Currently the only known checksum considered "
  13959. "strong is B<SHA-256>."
  13960. msgstr ""
  13961. #. type: TP
  13962. #: dpkg-source.man:1
  13963. #, no-wrap
  13964. msgid "B<--ignore-bad-version>"
  13965. msgstr ""
  13966. #. type: Plain text
  13967. #: dpkg-source.man:1
  13968. msgid ""
  13969. "Turns the bad source package version check into a non-fatal warning (since "
  13970. "dpkg 1.17.7). This option should only be necessary when extracting ancient "
  13971. "source packages with broken versions, just for backwards compatibility."
  13972. msgstr ""
  13973. #. type: SH
  13974. #: dpkg-source.man:1
  13975. #, no-wrap
  13976. msgid "SOURCE PACKAGE FORMATS"
  13977. msgstr ""
  13978. #. type: Plain text
  13979. #: dpkg-source.man:1
  13980. msgid ""
  13981. "If you don't know what source format to use, you should probably pick either "
  13982. "“3.0 (quilt)” or “3.0 (native)”. See "
  13983. "https://wiki.debian.org/Projects/DebSrc3.0 for information on the deployment "
  13984. "of those formats within Debian."
  13985. msgstr ""
  13986. #. type: SS
  13987. #: dpkg-source.man:1
  13988. #, no-wrap
  13989. msgid "Format: 1.0"
  13990. msgstr ""
  13991. #. type: Plain text
  13992. #: dpkg-source.man:1
  13993. msgid ""
  13994. "A source package in this format consists either of a B<.orig.tar.gz> "
  13995. "associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package "
  13996. "is said to be I<native>). Optionally the original tarball might be "
  13997. "accompanied by a detached upstream signature B<.orig.tar.gz.asc>, extraction "
  13998. "supported since dpkg 1.18.5."
  13999. msgstr ""
  14000. #. type: Plain text
  14001. #: dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1
  14002. msgid "B<Extracting>"
  14003. msgstr ""
  14004. #. type: Plain text
  14005. #: dpkg-source.man:1
  14006. msgid ""
  14007. "Extracting a native package is a simple extraction of the single tarball in "
  14008. "the target directory. Extracting a non-native package is done by first "
  14009. "unpacking the B<.orig.tar.gz> and then applying the patch contained in the "
  14010. "B<.diff.gz> file. The timestamp of all patched files is reset to the "
  14011. "extraction time of the source package (this avoids timestamp skews leading "
  14012. "to problems when autogenerated files are patched). The diff can create new "
  14013. "files (the whole debian directory is created that way) but can't remove "
  14014. "files (empty files will be left over)."
  14015. msgstr ""
  14016. #. type: Plain text
  14017. #: dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1
  14018. msgid "B<Building>"
  14019. msgstr ""
  14020. #. type: Plain text
  14021. #: dpkg-source.man:1
  14022. msgid ""
  14023. "Building a native package is just creating a single tarball with the source "
  14024. "directory. Building a non-native package involves extracting the original "
  14025. "tarball in a separate “.orig” directory and regenerating the B<.diff.gz> by "
  14026. "comparing the source package I<directory> with the .orig directory."
  14027. msgstr ""
  14028. #. type: Plain text
  14029. #: dpkg-source.man:1
  14030. msgid "B<Build options (with --build):>"
  14031. msgstr ""
  14032. #. type: Plain text
  14033. #: dpkg-source.man:1
  14034. msgid ""
  14035. "If a second non-option argument is supplied it should be the name of the "
  14036. "original source directory or tarfile or the empty string if the package is a "
  14037. "Debian-specific one and so has no debianisation diffs. If no second argument "
  14038. "is supplied then B<dpkg-source> will look for the original source tarfile "
  14039. "I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source "
  14040. "directory I<directory>B<.orig> depending on the B<-sX> arguments."
  14041. msgstr ""
  14042. #. type: Plain text
  14043. #: dpkg-source.man:1
  14044. msgid ""
  14045. "B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing "
  14046. "tarfiles or directories. If this is desired then B<-sA>, B<-sP>, B<-sK>, "
  14047. "B<-sU> and B<-sR> should be used instead."
  14048. msgstr ""
  14049. #. type: Plain text
  14050. #: dpkg-source.man:1
  14051. msgid ""
  14052. "Specifies to expect the original source as a tarfile, by default "
  14053. "I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>. It will leave "
  14054. "this original source in place as a tarfile, or copy it to the current "
  14055. "directory if it isn't already there. The tarball will be unpacked into "
  14056. "I<directory>B<.orig> for the generation of the diff."
  14057. msgstr ""
  14058. #. type: TP
  14059. #: dpkg-source.man:1 dpkg-source.man:1
  14060. #, no-wrap
  14061. msgid "B<-sp>"
  14062. msgstr ""
  14063. #. type: Plain text
  14064. #: dpkg-source.man:1
  14065. msgid "Like B<-sk> but will remove the directory again afterwards."
  14066. msgstr ""
  14067. #. type: Plain text
  14068. #: dpkg-source.man:1
  14069. msgid ""
  14070. "Specifies that the original source is expected as a directory, by default "
  14071. "I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a "
  14072. "new original source archive from it."
  14073. msgstr ""
  14074. #. type: Plain text
  14075. #: dpkg-source.man:1
  14076. msgid "Like B<-su> but will remove that directory after it has been used."
  14077. msgstr ""
  14078. #. type: Plain text
  14079. #: dpkg-source.man:1
  14080. msgid ""
  14081. "Specifies that the original source is available both as a directory and as a "
  14082. "tarfile. B<dpkg-source> will use the directory to create the diff, but the "
  14083. "tarfile to create the B<.dsc>. This option must be used with care - if the "
  14084. "directory and tarfile do not match a bad source archive will be generated."
  14085. msgstr ""
  14086. #. type: Plain text
  14087. #: dpkg-source.man:1
  14088. msgid ""
  14089. "Specifies to not look for any original source, and to not generate a diff. "
  14090. "The second argument, if supplied, must be the empty string. This is used for "
  14091. "Debian-specific packages which do not have a separate upstream source and "
  14092. "therefore have no debianisation diffs."
  14093. msgstr ""
  14094. #. type: TP
  14095. #: dpkg-source.man:1
  14096. #, no-wrap
  14097. msgid "B<-sa> or B<-sA>"
  14098. msgstr ""
  14099. #. type: Plain text
  14100. #: dpkg-source.man:1
  14101. msgid ""
  14102. "Specifies to look for the original source archive as a tarfile or as a "
  14103. "directory - the second argument, if any, may be either, or the empty string "
  14104. "(this is equivalent to using B<-sn>). If a tarfile is found it will unpack "
  14105. "it to create the diff and remove it afterwards (this is equivalent to "
  14106. "B<-sp>); if a directory is found it will pack it to create the original "
  14107. "source and remove it afterwards (this is equivalent to B<-sr>); if neither "
  14108. "is found it will assume that the package has no debianisation diffs, only a "
  14109. "straightforward source archive (this is equivalent to B<-sn>). If both are "
  14110. "found then B<dpkg-source> will ignore the directory, overwriting it, if "
  14111. "B<-sA> was specified (this is equivalent to B<-sP>) or raise an error if "
  14112. "B<-sa> was specified. B<-sA> is the default."
  14113. msgstr ""
  14114. #. type: TP
  14115. #: dpkg-source.man:1 dpkg-source.man:1
  14116. #, no-wrap
  14117. msgid "B<--abort-on-upstream-changes>"
  14118. msgstr ""
  14119. #. type: Plain text
  14120. #: dpkg-source.man:1
  14121. msgid ""
  14122. "The process fails if the generated diff contains changes to files outside of "
  14123. "the debian sub-directory (since dpkg 1.15.8). This option is not allowed in "
  14124. "B<debian/source/options> but can be used in B<debian/source/local-options>."
  14125. msgstr ""
  14126. #. type: Plain text
  14127. #: dpkg-source.man:1
  14128. msgid "B<Extract options (with --extract):>"
  14129. msgstr ""
  14130. #. type: Plain text
  14131. #: dpkg-source.man:1
  14132. msgid "In all cases any existing original source tree will be removed."
  14133. msgstr ""
  14134. #. type: Plain text
  14135. #: dpkg-source.man:1
  14136. msgid ""
  14137. "Used when extracting then the original source (if any) will be left as a "
  14138. "tarfile. If it is not already located in the current directory or if an "
  14139. "existing but different file is there it will be copied there. (B<This is "
  14140. "the default>)."
  14141. msgstr ""
  14142. #. type: Plain text
  14143. #: dpkg-source.man:1
  14144. msgid "Unpacks the original source tree."
  14145. msgstr ""
  14146. #. type: Plain text
  14147. #: dpkg-source.man:1
  14148. msgid ""
  14149. "Ensures that the original source is neither copied to the current directory "
  14150. "nor unpacked. Any original source tree that was in the current directory is "
  14151. "still removed."
  14152. msgstr ""
  14153. #. type: Plain text
  14154. #: dpkg-source.man:1
  14155. msgid ""
  14156. "All the B<-s>I<X> options are mutually exclusive. If you specify more than "
  14157. "one only the last one will be used."
  14158. msgstr ""
  14159. #. type: TP
  14160. #: dpkg-source.man:1 dpkg-source.man:1
  14161. #, no-wrap
  14162. msgid "B<--skip-debianization>"
  14163. msgstr ""
  14164. #. type: Plain text
  14165. #: dpkg-source.man:1
  14166. msgid ""
  14167. "Skips application of the debian diff on top of the upstream sources (since "
  14168. "dpkg 1.15.1)."
  14169. msgstr ""
  14170. #. type: SS
  14171. #: dpkg-source.man:1
  14172. #, no-wrap
  14173. msgid "Format: 2.0"
  14174. msgstr ""
  14175. #. type: Plain text
  14176. #: dpkg-source.man:1
  14177. msgid ""
  14178. "Extraction supported since dpkg 1.13.9, building supported since dpkg "
  14179. "1.14.8. Also known as wig&pen. This format is not recommended for "
  14180. "wide-spread usage, the format “3.0 (quilt)” replaces it. Wig&pen was the "
  14181. "first specification of a new-generation source package format."
  14182. msgstr ""
  14183. #. type: Plain text
  14184. #: dpkg-source.man:1
  14185. msgid ""
  14186. "The behaviour of this format is the same as the “3.0 (quilt)” format except "
  14187. "that it doesn't use an explicit list of patches. All files in "
  14188. "B<debian/patches/> matching the perl regular expression B<[\\ew-]+> must be "
  14189. "valid patches: they are applied at extraction time."
  14190. msgstr ""
  14191. #. type: Plain text
  14192. #: dpkg-source.man:1
  14193. msgid ""
  14194. "When building a new source package, any change to the upstream source is "
  14195. "stored in a patch named B<zz_debian-diff-auto>."
  14196. msgstr ""
  14197. #. type: SS
  14198. #: dpkg-source.man:1
  14199. #, no-wrap
  14200. msgid "Format: 3.0 (native)"
  14201. msgstr ""
  14202. #. type: Plain text
  14203. #: dpkg-source.man:1
  14204. msgid ""
  14205. "Supported since dpkg 1.14.17. This format is an extension of the native "
  14206. "package format as defined in the 1.0 format. It supports all compression "
  14207. "methods and will ignore by default any VCS specific files and directories as "
  14208. "well as many temporary files (see default value associated to B<-I> option "
  14209. "in the B<--help> output)."
  14210. msgstr ""
  14211. #. type: SS
  14212. #: dpkg-source.man:1
  14213. #, no-wrap
  14214. msgid "Format: 3.0 (quilt)"
  14215. msgstr ""
  14216. #. type: Plain text
  14217. #: dpkg-source.man:1
  14218. msgid ""
  14219. "Supported since dpkg 1.14.17. A source package in this format contains at "
  14220. "least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, "
  14221. "B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>). It "
  14222. "can also contain additional original tarballs "
  14223. "(B<.orig->I<component>B<.tar.>I<ext>). I<component> can only contain "
  14224. "alphanumeric characters and hyphens (‘-’). Optionally each original tarball "
  14225. "can be accompanied by a detached upstream signature "
  14226. "(B<.orig.tar.>I<ext>B<.asc> and B<.orig->I<component>B<.tar.>I<ext>B<.asc>), "
  14227. "extraction supported since dpkg 1.17.20, building supported since dpkg "
  14228. "1.18.5."
  14229. msgstr ""
  14230. #. type: Plain text
  14231. #: dpkg-source.man:1
  14232. msgid ""
  14233. "The main original tarball is extracted first, then all additional original "
  14234. "tarballs are extracted in subdirectories named after the I<component> part "
  14235. "of their filename (any pre-existing directory is replaced). The debian "
  14236. "tarball is extracted on top of the source directory after prior removal of "
  14237. "any pre-existing B<debian> directory. Note that the debian tarball must "
  14238. "contain a B<debian> sub-directory but it can also contain binary files "
  14239. "outside of that directory (see B<--include-binaries> option)."
  14240. msgstr ""
  14241. #. type: Plain text
  14242. #: dpkg-source.man:1
  14243. msgid ""
  14244. "All patches listed in B<debian/patches/debian.series> or "
  14245. "B<debian/patches/series> are then applied. If the former file is used and "
  14246. "the latter one doesn't exist (or is a symlink), then the latter is replaced "
  14247. "with a symlink to the former. This is meant to simplify usage of B<quilt> to "
  14248. "manage the set of patches. Note however that while B<dpkg-source> parses "
  14249. "correctly series files with explicit options used for patch application "
  14250. "(stored on each line after the patch filename and one or more spaces), it "
  14251. "does ignore those options and always expect patches that can be applied with "
  14252. "the B<-p1> option of B<patch>. It will thus emit a warning when it "
  14253. "encounters such options, and the build is likely to fail."
  14254. msgstr ""
  14255. #. type: Plain text
  14256. #: dpkg-source.man:1
  14257. msgid ""
  14258. "The timestamp of all patched files is reset to the extraction time of the "
  14259. "source package (this avoids timestamp skews leading to problems when "
  14260. "autogenerated files are patched)."
  14261. msgstr ""
  14262. #. type: Plain text
  14263. #: dpkg-source.man:1
  14264. msgid ""
  14265. "Contrary to B<quilt>'s default behaviour, patches are expected to apply "
  14266. "without any fuzz. When that is not the case, you should refresh such patches "
  14267. "with B<quilt>, or B<dpkg-source> will error out while trying to apply them."
  14268. msgstr ""
  14269. #. type: Plain text
  14270. #: dpkg-source.man:1
  14271. msgid "Similarly to B<quilt>'s default behaviour, the patches can remove files too."
  14272. msgstr ""
  14273. #. type: Plain text
  14274. #: dpkg-source.man:1
  14275. msgid ""
  14276. "The file B<.pc/applied-patches> is created if some patches have been applied "
  14277. "during the extraction."
  14278. msgstr ""
  14279. #. type: Plain text
  14280. #: dpkg-source.man:1
  14281. msgid ""
  14282. "All original tarballs found in the current directory are extracted in a "
  14283. "temporary directory by following the same logic as for the unpack, the "
  14284. "debian directory is copied over in the temporary directory, and all patches "
  14285. "except the automatic patch (B<debian-changes->I<version> or "
  14286. "B<debian-changes>, depending on B<--single-debian-patch>) are applied. The "
  14287. "temporary directory is compared to the source package directory. When the "
  14288. "diff is non-empty, the build fails unless B<--single-debian-patch> or "
  14289. "B<--auto-commit> has been used, in which case the diff is stored in the "
  14290. "automatic patch. If the automatic patch is created/deleted, it's "
  14291. "added/removed from the series file and from the B<quilt> metadata."
  14292. msgstr ""
  14293. #. type: Plain text
  14294. #: dpkg-source.man:1
  14295. msgid ""
  14296. "Any change on a binary file is not representable in a diff and will thus "
  14297. "lead to a failure unless the maintainer deliberately decided to include that "
  14298. "modified binary file in the debian tarball (by listing it in "
  14299. "B<debian/source/include-binaries>). The build will also fail if it finds "
  14300. "binary files in the debian sub-directory unless they have been whitelisted "
  14301. "through B<debian/source/include-binaries>."
  14302. msgstr ""
  14303. #. type: Plain text
  14304. #: dpkg-source.man:1
  14305. msgid ""
  14306. "The updated debian directory and the list of modified binaries is then used "
  14307. "to generate the debian tarball."
  14308. msgstr ""
  14309. #. type: Plain text
  14310. #: dpkg-source.man:1
  14311. msgid ""
  14312. "The automatically generated diff doesn't include changes on VCS specific "
  14313. "files as well as many temporary files (see default value associated to B<-i> "
  14314. "option in the B<--help> output). In particular, the B<.pc> directory used by "
  14315. "B<quilt> is ignored during generation of the automatic patch."
  14316. msgstr ""
  14317. #. type: Plain text
  14318. #: dpkg-source.man:1
  14319. msgid ""
  14320. "Note: B<dpkg-source> B<--before-build> (and B<--build>) will ensure that all "
  14321. "patches listed in the series file are applied so that a package build always "
  14322. "has all patches applied. It does this by finding unapplied patches (they are "
  14323. "listed in the B<series> file but not in B<.pc/applied-patches>), and if the "
  14324. "first patch in that set can be applied without errors, it will apply them "
  14325. "all. The option B<--no-preparation> can be used to disable this behavior."
  14326. msgstr ""
  14327. #. type: Plain text
  14328. #: dpkg-source.man:1
  14329. msgid "B<Recording changes>"
  14330. msgstr ""
  14331. #. type: TP
  14332. #: dpkg-source.man:1
  14333. #, no-wrap
  14334. msgid "B<--commit> [I<directory>] [I<patch-name>] [I<patch-file>]"
  14335. msgstr ""
  14336. #. type: Plain text
  14337. #: dpkg-source.man:1
  14338. msgid ""
  14339. "Generates a patch corresponding to the local changes that are not managed by "
  14340. "the B<quilt> patch system and integrates it in the patch system under the "
  14341. "name I<patch-name>. If the name is missing, it will be asked "
  14342. "interactively. If I<patch-file> is given, it is used as the patch "
  14343. "corresponding to the local changes to integrate. Once integrated, an editor "
  14344. "is launched so that you can edit the meta-information in the patch header."
  14345. msgstr ""
  14346. #. type: Plain text
  14347. #: dpkg-source.man:1
  14348. msgid ""
  14349. "Passing I<patch-file> is mainly useful after a build failure that "
  14350. "pre-generated this file, and on this ground the given file is removed after "
  14351. "integration. Note also that the changes contained in the patch file must "
  14352. "already be applied on the tree and that the files modified by the patch must "
  14353. "not have supplementary unrecorded changes."
  14354. msgstr ""
  14355. #. type: Plain text
  14356. #: dpkg-source.man:1
  14357. msgid ""
  14358. "If the patch generation detects modified binary files, they will be "
  14359. "automatically added to B<debian/source/include-binaries> so that they end up "
  14360. "in the debian tarball (exactly like B<dpkg-source --include-binaries "
  14361. "--build> would do)."
  14362. msgstr ""
  14363. #. type: Plain text
  14364. #: dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1
  14365. msgid "B<Build options>"
  14366. msgstr ""
  14367. #. type: TP
  14368. #: dpkg-source.man:1
  14369. #, no-wrap
  14370. msgid "B<--allow-version-of-quilt-db=>I<version>"
  14371. msgstr ""
  14372. #. type: Plain text
  14373. #: dpkg-source.man:1
  14374. msgid ""
  14375. "Allow B<dpkg-source> to build the source package if the version of the "
  14376. "B<quilt> metadata is the one specified, even if B<dpkg-source> doesn't know "
  14377. "about it (since dpkg 1.15.5.4). Effectively this says that the given "
  14378. "version of the B<quilt> metadata is compatible with the version 2 that "
  14379. "B<dpkg-source> currently supports. The version of the B<quilt> metadata is "
  14380. "stored in B<.pc/.version>."
  14381. msgstr ""
  14382. #. type: TP
  14383. #: dpkg-source.man:1
  14384. #, no-wrap
  14385. msgid "B<--include-removal>"
  14386. msgstr ""
  14387. #. type: Plain text
  14388. #: dpkg-source.man:1
  14389. msgid ""
  14390. "Do not ignore removed files and include them in the automatically generated "
  14391. "patch."
  14392. msgstr ""
  14393. #. type: TP
  14394. #: dpkg-source.man:1
  14395. #, no-wrap
  14396. msgid "B<--include-timestamp>"
  14397. msgstr ""
  14398. #. type: Plain text
  14399. #: dpkg-source.man:1
  14400. msgid "Include timestamp in the automatically generated patch."
  14401. msgstr ""
  14402. #. type: TP
  14403. #: dpkg-source.man:1
  14404. #, no-wrap
  14405. msgid "B<--include-binaries>"
  14406. msgstr ""
  14407. #. type: Plain text
  14408. #: dpkg-source.man:1
  14409. msgid ""
  14410. "Add all modified binaries in the debian tarball. Also add them to "
  14411. "B<debian/source/include-binaries>: they will be added by default in "
  14412. "subsequent builds and this option is thus no more needed."
  14413. msgstr ""
  14414. #. type: TP
  14415. #: dpkg-source.man:1
  14416. #, no-wrap
  14417. msgid "B<--no-preparation>"
  14418. msgstr ""
  14419. #. type: Plain text
  14420. #: dpkg-source.man:1
  14421. msgid ""
  14422. "Do not try to prepare the build tree by applying patches which are "
  14423. "apparently unapplied (since dpkg 1.14.18)."
  14424. msgstr ""
  14425. #. type: TP
  14426. #: dpkg-source.man:1
  14427. #, no-wrap
  14428. msgid "B<--single-debian-patch>"
  14429. msgstr ""
  14430. #. type: Plain text
  14431. #: dpkg-source.man:1
  14432. msgid ""
  14433. "Use B<debian/patches/debian-changes> instead of "
  14434. "B<debian/patches/debian-changes->I<version> for the name of the automatic "
  14435. "patch generated during build (since dpkg 1.15.5.4). This option is "
  14436. "particularly useful when the package is maintained in a VCS and a patch set "
  14437. "can't reliably be generated. Instead the current diff with upstream should "
  14438. "be stored in a single patch. The option would be put in "
  14439. "B<debian/source/local-options> and would be accompanied by a "
  14440. "B<debian/source/local-patch-header> file explaining how the Debian changes "
  14441. "can be best reviewed, for example in the VCS that is used."
  14442. msgstr ""
  14443. #. type: TP
  14444. #: dpkg-source.man:1
  14445. #, no-wrap
  14446. msgid "B<--create-empty-orig>"
  14447. msgstr ""
  14448. #. type: Plain text
  14449. #: dpkg-source.man:1
  14450. msgid ""
  14451. "Automatically create the main original tarball as empty if it's missing and "
  14452. "if there are supplementary original tarballs (since dpkg 1.15.6). This "
  14453. "option is meant to be used when the source package is just a bundle of "
  14454. "multiple upstream software and where there's no “main” software."
  14455. msgstr ""
  14456. #. type: TP
  14457. #: dpkg-source.man:1
  14458. #, no-wrap
  14459. msgid "B<--no-unapply-patches, --unapply-patches>"
  14460. msgstr ""
  14461. #. type: Plain text
  14462. #: dpkg-source.man:1
  14463. msgid ""
  14464. "By default, B<dpkg-source> will automatically unapply the patches in the "
  14465. "B<--after-build> hook if it did apply them during B<--before-build> "
  14466. "(B<--unapply-patches> since dpkg 1.15.8, B<--no-unapply-patches> since dpkg "
  14467. "1.16.5). Those options allow you to forcefully disable or enable the patch "
  14468. "unapplication process. Those options are only allowed in "
  14469. "B<debian/source/local-options> so that all generated source packages have "
  14470. "the same behavior by default."
  14471. msgstr ""
  14472. #. type: Plain text
  14473. #: dpkg-source.man:1
  14474. msgid ""
  14475. "The process fails if an automatic patch has been generated (since dpkg "
  14476. "1.15.8). This option can be used to ensure that all changes were properly "
  14477. "recorded in separate B<quilt> patches prior to the source package "
  14478. "build. This option is not allowed in B<debian/source/options> but can be "
  14479. "used in B<debian/source/local-options>."
  14480. msgstr ""
  14481. #. type: TP
  14482. #: dpkg-source.man:1
  14483. #, no-wrap
  14484. msgid "B<--auto-commit>"
  14485. msgstr ""
  14486. #. type: Plain text
  14487. #: dpkg-source.man:1
  14488. msgid ""
  14489. "The process doesn't fail if an automatic patch has been generated, instead "
  14490. "it's immediately recorded in the B<quilt> series."
  14491. msgstr ""
  14492. #. type: Plain text
  14493. #: dpkg-source.man:1
  14494. msgid "B<Extract options>"
  14495. msgstr ""
  14496. #. type: Plain text
  14497. #: dpkg-source.man:1
  14498. msgid ""
  14499. "Skips extraction of the debian tarball on top of the upstream sources (since "
  14500. "dpkg 1.15.1)."
  14501. msgstr ""
  14502. #. type: TP
  14503. #: dpkg-source.man:1
  14504. #, no-wrap
  14505. msgid "B<--skip-patches>"
  14506. msgstr ""
  14507. #. type: Plain text
  14508. #: dpkg-source.man:1
  14509. msgid "Do not apply patches at the end of the extraction (since dpkg 1.14.18)."
  14510. msgstr ""
  14511. #. type: SS
  14512. #: dpkg-source.man:1
  14513. #, no-wrap
  14514. msgid "Format: 3.0 (custom)"
  14515. msgstr ""
  14516. #. type: Plain text
  14517. #: dpkg-source.man:1
  14518. msgid ""
  14519. "Supported since dpkg 1.14.17. This format is special. It doesn't represent "
  14520. "a real source package format but can be used to create source packages with "
  14521. "arbitrary files."
  14522. msgstr ""
  14523. #. type: Plain text
  14524. #: dpkg-source.man:1
  14525. msgid ""
  14526. "All non-option arguments are taken as files to integrate in the generated "
  14527. "source package. They must exist and are preferably in the current "
  14528. "directory. At least one file must be given."
  14529. msgstr ""
  14530. #. type: TP
  14531. #: dpkg-source.man:1
  14532. #, no-wrap
  14533. msgid "B<--target-format=>I<value>"
  14534. msgstr ""
  14535. #. type: Plain text
  14536. #: dpkg-source.man:1
  14537. msgid ""
  14538. "B<Required>. Defines the real format of the generated source package. The "
  14539. "generated .dsc file will contain this value in its B<Format> field and not "
  14540. "“3.0 (custom)”."
  14541. msgstr ""
  14542. #. type: SS
  14543. #: dpkg-source.man:1
  14544. #, no-wrap
  14545. msgid "Format: 3.0 (git)"
  14546. msgstr ""
  14547. #. type: Plain text
  14548. #: dpkg-source.man:1
  14549. msgid "Supported since dpkg 1.14.17. This format is experimental."
  14550. msgstr ""
  14551. #. type: Plain text
  14552. #: dpkg-source.man:1
  14553. msgid ""
  14554. "A source package in this format consists of a single bundle of a git "
  14555. "repository B<.git> to hold the source of a package. There may also be a "
  14556. "B<.gitshallow> file listing revisions for a shallow git clone."
  14557. msgstr ""
  14558. #. type: Plain text
  14559. #: dpkg-source.man:1
  14560. msgid ""
  14561. "The bundle is cloned as a git repository to the target directory. If there "
  14562. "is a gitshallow file, it is installed as I<.git/shallow> inside the cloned "
  14563. "git repository."
  14564. msgstr ""
  14565. #. type: Plain text
  14566. #: dpkg-source.man:1
  14567. msgid ""
  14568. "Note that by default the new repository will have the same branch checked "
  14569. "out that was checked out in the original source. (Typically “master”, but "
  14570. "it could be anything.) Any other branches will be available under "
  14571. "I<remotes/origin/>."
  14572. msgstr ""
  14573. #. type: Plain text
  14574. #: dpkg-source.man:1 dpkg-source.man:1
  14575. msgid ""
  14576. "Before going any further, some checks are done to ensure that we don't have "
  14577. "any non-ignored uncommitted changes."
  14578. msgstr ""
  14579. #. type: Plain text
  14580. #: dpkg-source.man:1
  14581. msgid ""
  14582. "B<git-bundle>(1) is used to generate a bundle of the git repository. By "
  14583. "default, all branches and tags in the repository are included in the bundle."
  14584. msgstr ""
  14585. #. type: TP
  14586. #: dpkg-source.man:1
  14587. #, no-wrap
  14588. msgid "B<--git-ref=>I<ref>"
  14589. msgstr ""
  14590. #. type: Plain text
  14591. #: dpkg-source.man:1
  14592. msgid ""
  14593. "Allows specifying a git ref to include in the git bundle. Use disables the "
  14594. "default behavior of including all branches and tags. May be specified "
  14595. "multiple times. The I<ref> can be the name of a branch or tag to include. It "
  14596. "may also be any parameter that can be passed to B<git-rev-list>(1). For "
  14597. "example, to include only the master branch, use B<--git-ref=>master. To "
  14598. "include all tags and branches, except for the private branch, use "
  14599. "B<--git-ref=>--all B<--git-ref=>^private"
  14600. msgstr ""
  14601. #. type: TP
  14602. #: dpkg-source.man:1
  14603. #, no-wrap
  14604. msgid "B<--git-depth=>I<number>"
  14605. msgstr ""
  14606. #. type: Plain text
  14607. #: dpkg-source.man:1
  14608. msgid ""
  14609. "Creates a shallow clone with a history truncated to the specified number of "
  14610. "revisions."
  14611. msgstr ""
  14612. #. type: SS
  14613. #: dpkg-source.man:1
  14614. #, no-wrap
  14615. msgid "Format: 3.0 (bzr)"
  14616. msgstr ""
  14617. #. type: Plain text
  14618. #: dpkg-source.man:1
  14619. msgid ""
  14620. "Supported since dpkg 1.14.17. This format is experimental. It generates a "
  14621. "single tarball containing the bzr repository."
  14622. msgstr ""
  14623. #. type: Plain text
  14624. #: dpkg-source.man:1
  14625. msgid "The tarball is unpacked and then bzr is used to checkout the current branch."
  14626. msgstr ""
  14627. #. type: Plain text
  14628. #: dpkg-source.man:1
  14629. msgid ""
  14630. "Then the VCS specific part of the source directory is copied over to a "
  14631. "temporary directory. Before this temporary directory is packed in a tarball, "
  14632. "various cleanup are done to save space."
  14633. msgstr ""
  14634. #. type: SS
  14635. #: dpkg-source.man:1
  14636. #, no-wrap
  14637. msgid "no source format specified in debian/source/format"
  14638. msgstr ""
  14639. #. type: Plain text
  14640. #: dpkg-source.man:1
  14641. msgid ""
  14642. "The file B<debian/source/format> should always exist and indicate the "
  14643. "desired source format. For backwards compatibility, format “1.0” is assumed "
  14644. "when the file doesn't exist but you should not rely on this: at some point "
  14645. "in the future B<dpkg-source> will be modified to fail when that file doesn't "
  14646. "exist."
  14647. msgstr ""
  14648. #. type: Plain text
  14649. #: dpkg-source.man:1
  14650. msgid ""
  14651. "The rationale is that format “1.0” is no longer the recommended format, you "
  14652. "should usually pick one of the newer formats (“3.0 (quilt)”, “3.0 (native)”) "
  14653. "but B<dpkg-source> will not do this automatically for you. If you want to "
  14654. "continue using the old format, you should be explicit about it and put “1.0” "
  14655. "in B<debian/source/format>."
  14656. msgstr ""
  14657. #. type: SS
  14658. #: dpkg-source.man:1
  14659. #, no-wrap
  14660. msgid "the diff modifies the following upstream files"
  14661. msgstr ""
  14662. #. type: Plain text
  14663. #: dpkg-source.man:1
  14664. msgid ""
  14665. "When using source format “1.0” it is usually a bad idea to modify upstream "
  14666. "files directly as the changes end up hidden and mostly undocumented in the "
  14667. ".diff.gz file. Instead you should store your changes as patches in the "
  14668. "debian directory and apply them at build-time. To avoid this complexity you "
  14669. "can also use the format “3.0 (quilt)” that offers this natively."
  14670. msgstr ""
  14671. #. type: SS
  14672. #: dpkg-source.man:1
  14673. #, no-wrap
  14674. msgid "cannot represent change to I<file>"
  14675. msgstr ""
  14676. #. type: Plain text
  14677. #: dpkg-source.man:1
  14678. msgid ""
  14679. "Changes to upstream sources are usually stored with patch files, but not all "
  14680. "changes can be represented with patches: they can only alter the content of "
  14681. "plain text files. If you try replacing a file with something of a different "
  14682. "type (for example replacing a plain file with a symlink or a directory), you "
  14683. "will get this error message."
  14684. msgstr ""
  14685. #. type: SS
  14686. #: dpkg-source.man:1
  14687. #, no-wrap
  14688. msgid "newly created empty file I<file> will not be represented in diff"
  14689. msgstr ""
  14690. #. type: Plain text
  14691. #: dpkg-source.man:1
  14692. msgid ""
  14693. "Empty files can't be created with patch files. Thus this change is not "
  14694. "recorded in the source package and you are warned about it."
  14695. msgstr ""
  14696. #. type: SS
  14697. #: dpkg-source.man:1
  14698. #, no-wrap
  14699. msgid "executable mode I<perms> of I<file> will not be represented in diff"
  14700. msgstr ""
  14701. #. type: Plain text
  14702. #: dpkg-source.man:1
  14703. msgid ""
  14704. "Patch files do not record permissions of files and thus executable "
  14705. "permissions are not stored in the source package. This warning reminds you "
  14706. "of that fact."
  14707. msgstr ""
  14708. #. type: SS
  14709. #: dpkg-source.man:1
  14710. #, no-wrap
  14711. msgid "special mode I<perms> of I<file> will not be represented in diff"
  14712. msgstr ""
  14713. #. type: Plain text
  14714. #: dpkg-source.man:1
  14715. msgid ""
  14716. "Patch files do not record permissions of files and thus modified permissions "
  14717. "are not stored in the source package. This warning reminds you of that fact."
  14718. msgstr ""
  14719. #. type: Plain text
  14720. #: dpkg-source.man:1
  14721. msgid ""
  14722. "If set, it will be used as the timestamp (as seconds since the epoch) to "
  14723. "clamp the mtime in the B<tar>(5) file entries."
  14724. msgstr ""
  14725. #. type: TP
  14726. #: dpkg-source.man:1
  14727. #, no-wrap
  14728. msgid "B<VISUAL>"
  14729. msgstr ""
  14730. #. type: TQ
  14731. #: dpkg-source.man:1
  14732. #, no-wrap
  14733. msgid "B<EDITOR>"
  14734. msgstr ""
  14735. #. type: Plain text
  14736. #: dpkg-source.man:1
  14737. msgid "Used by the “2.0” and “3.0 (quilt)” source format modules."
  14738. msgstr ""
  14739. #. type: TP
  14740. #: dpkg-source.man:1
  14741. #, no-wrap
  14742. msgid "B<GIT_DIR>"
  14743. msgstr ""
  14744. #. type: TQ
  14745. #: dpkg-source.man:1
  14746. #, no-wrap
  14747. msgid "B<GIT_INDEX_FILE>"
  14748. msgstr ""
  14749. #. type: TQ
  14750. #: dpkg-source.man:1
  14751. #, no-wrap
  14752. msgid "B<GIT_OBJECT_DIRECTORY>"
  14753. msgstr ""
  14754. #. type: TQ
  14755. #: dpkg-source.man:1
  14756. #, no-wrap
  14757. msgid "B<GIT_ALTERNATE_OBJECT_DIRECTORIES>"
  14758. msgstr ""
  14759. #. type: TQ
  14760. #: dpkg-source.man:1
  14761. #, no-wrap
  14762. msgid "B<GIT_WORK_TREE>"
  14763. msgstr ""
  14764. #. type: Plain text
  14765. #: dpkg-source.man:1
  14766. msgid "Used by the “3.0 (git)” source format modules."
  14767. msgstr ""
  14768. #. type: SS
  14769. #: dpkg-source.man:1
  14770. #, no-wrap
  14771. msgid "debian/source/format"
  14772. msgstr ""
  14773. #. type: Plain text
  14774. #: dpkg-source.man:1
  14775. msgid ""
  14776. "This file contains on a single line the format that should be used to build "
  14777. "the source package (possible formats are described above). No leading or "
  14778. "trailing spaces are allowed."
  14779. msgstr ""
  14780. #. type: SS
  14781. #: dpkg-source.man:1
  14782. #, no-wrap
  14783. msgid "debian/source/include-binaries"
  14784. msgstr ""
  14785. #. type: Plain text
  14786. #: dpkg-source.man:1
  14787. msgid ""
  14788. "This file contains a list of binary files (one per line) that should be "
  14789. "included in the debian tarball. Leading and trailing spaces are stripped. "
  14790. "Lines starting with ‘B<#>’ are comments and are skipped. Empty lines are "
  14791. "ignored."
  14792. msgstr ""
  14793. #. type: SS
  14794. #: dpkg-source.man:1
  14795. #, no-wrap
  14796. msgid "debian/source/options"
  14797. msgstr ""
  14798. #. type: Plain text
  14799. #: dpkg-source.man:1
  14800. msgid ""
  14801. "This file contains a list of long options that should be automatically "
  14802. "prepended to the set of command line options of a B<dpkg-source --build> or "
  14803. "B<dpkg-source --print-format> call. Options like B<--compression> and "
  14804. "B<--compression-level> are well suited for this file."
  14805. msgstr ""
  14806. #. type: Plain text
  14807. #: dpkg-source.man:1
  14808. msgid ""
  14809. "Each option should be put on a separate line. Empty lines and lines starting "
  14810. "with ‘B<#>’ are ignored. The leading ‘B<-->’ should be stripped and short "
  14811. "options are not allowed. Optional spaces are allowed around the ‘B<=>’ "
  14812. "symbol and optional quotes are allowed around the value. Here's an example "
  14813. "of such a file:"
  14814. msgstr ""
  14815. #. type: Plain text
  14816. #: dpkg-source.man:1
  14817. #, no-wrap
  14818. msgid ""
  14819. " # let dpkg-source create a debian.tar.bz2 with maximal compression\n"
  14820. " compression = \"bzip2\"\n"
  14821. " compression-level = 9\n"
  14822. " # use debian/patches/debian-changes as automatic patch\n"
  14823. " single-debian-patch\n"
  14824. " # ignore changes on config.{sub,guess}\n"
  14825. " extend-diff-ignore = \"(^|/)(config.sub|config.guess)$\"\n"
  14826. msgstr ""
  14827. #. type: Plain text
  14828. #: dpkg-source.man:1
  14829. msgid ""
  14830. "Note: B<format> options are not accepted in this file, you should use "
  14831. "B<debian/source/format> instead."
  14832. msgstr ""
  14833. #. type: SS
  14834. #: dpkg-source.man:1
  14835. #, no-wrap
  14836. msgid "debian/source/local-options"
  14837. msgstr ""
  14838. #. type: Plain text
  14839. #: dpkg-source.man:1
  14840. msgid ""
  14841. "Exactly like B<debian/source/options> except that the file is not included "
  14842. "in the generated source package. It can be useful to store a preference tied "
  14843. "to the maintainer or to the VCS repository where the source package is "
  14844. "maintained."
  14845. msgstr ""
  14846. #. type: SS
  14847. #: dpkg-source.man:1
  14848. #, no-wrap
  14849. msgid "debian/source/local-patch-header R<and> debian/source/patch-header"
  14850. msgstr ""
  14851. #. type: Plain text
  14852. #: dpkg-source.man:1
  14853. msgid ""
  14854. "Free form text that is put on top of the automatic patch generated in "
  14855. "formats “2.0” or “3.0 (quilt)”. B<local-patch-header> is not included in the "
  14856. "generated source package while B<patch-header> is."
  14857. msgstr ""
  14858. #. type: SS
  14859. #: dpkg-source.man:1
  14860. #, no-wrap
  14861. msgid "debian/patches/series"
  14862. msgstr ""
  14863. #. type: Plain text
  14864. #: dpkg-source.man:1
  14865. msgid ""
  14866. "This file lists all patches that have to be applied (in the given order) on "
  14867. "top of the upstream source package. Leading and trailing spaces are "
  14868. "stripped. Lines starting with ‘B<#>’ are comments and are skipped. Empty "
  14869. "lines are ignored. Remaining lines start with a patch filename (relative to "
  14870. "the B<debian/patches/> directory) up to the first space character or the end "
  14871. "of line. Optional B<quilt> options can follow up to the end of line or the "
  14872. "first ‘B<#>’ preceded by one or more spaces (which marks the start of a "
  14873. "comment up to the end of line)."
  14874. msgstr ""
  14875. #. type: Plain text
  14876. #: dpkg-source.man:1
  14877. msgid ""
  14878. "The point at which field overriding occurs compared to certain standard "
  14879. "output field settings is rather confused."
  14880. msgstr ""
  14881. #. type: Plain text
  14882. #: dpkg-source.man:1
  14883. msgid "B<deb-src-control>(5), B<deb-changelog>(5), B<dsc>(5)."
  14884. msgstr ""
  14885. #. type: TH
  14886. #: dpkg-split.man:1
  14887. #, no-wrap
  14888. msgid "dpkg-split"
  14889. msgstr ""
  14890. #. type: Plain text
  14891. #: dpkg-split.man:1
  14892. msgid "dpkg-split - Debian package archive split/join tool"
  14893. msgstr ""
  14894. #. type: Plain text
  14895. #: dpkg-split.man:1
  14896. msgid "B<dpkg-split> [I<option>...] I<command>"
  14897. msgstr ""
  14898. #. type: Plain text
  14899. #: dpkg-split.man:1
  14900. msgid ""
  14901. "B<dpkg-split> splits Debian binary package files into smaller parts and "
  14902. "reassembles them again, to support the storage of large package files on "
  14903. "small media such as floppy disks."
  14904. msgstr ""
  14905. #. type: Plain text
  14906. #: dpkg-split.man:1
  14907. msgid ""
  14908. "It can be operated manually using the B<--split>, B<--join> and B<--info> "
  14909. "options."
  14910. msgstr ""
  14911. #. type: Plain text
  14912. #: dpkg-split.man:1
  14913. msgid ""
  14914. "It also has an automatic mode, invoked using the B<--auto> option, where it "
  14915. "maintains a queue of parts seen but not yet reassembled and reassembles a "
  14916. "package file when it has seen all of its parts. The B<--listq> and "
  14917. "B<--discard> options allow the management of the queue."
  14918. msgstr ""
  14919. #. type: Plain text
  14920. #: dpkg-split.man:1
  14921. msgid ""
  14922. "All splitting, joining and queueing operations produce informative messages "
  14923. "on standard output; these may safely be ignored."
  14924. msgstr ""
  14925. #. type: TP
  14926. #: dpkg-split.man:1
  14927. #, no-wrap
  14928. msgid "B<-s>, B<--split> I<complete-archive> [I<prefix>]"
  14929. msgstr ""
  14930. #. type: Plain text
  14931. #: dpkg-split.man:1
  14932. msgid "Splits a single Debian binary package into several parts."
  14933. msgstr ""
  14934. #. type: Plain text
  14935. #: dpkg-split.man:1
  14936. msgid ""
  14937. "The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part "
  14938. "number, starting at 1, and I<M> is the total number of parts (both in "
  14939. "decimal)."
  14940. msgstr ""
  14941. #. type: Plain text
  14942. #: dpkg-split.man:1
  14943. msgid ""
  14944. "If no I<prefix> is supplied then the I<complete-archive> filename is taken, "
  14945. "including directory, with any trailing B<.deb> removed."
  14946. msgstr ""
  14947. #. type: TP
  14948. #: dpkg-split.man:1
  14949. #, no-wrap
  14950. msgid "B<-j>, B<--join> I<part>..."
  14951. msgstr ""
  14952. #. type: Plain text
  14953. #: dpkg-split.man:1
  14954. msgid ""
  14955. "Joins the parts of a package file together, reassembling the original file "
  14956. "as it was before it was split."
  14957. msgstr ""
  14958. #. type: Plain text
  14959. #: dpkg-split.man:1
  14960. msgid ""
  14961. "The part files given as arguments must be all the parts of exactly the same "
  14962. "original binary file. Each part must occur exactly once in the argument "
  14963. "list, though the parts to not need to be listed in order."
  14964. msgstr ""
  14965. #. type: Plain text
  14966. #: dpkg-split.man:1
  14967. msgid ""
  14968. "The parts must of course all have been generated with the same part size "
  14969. "specified at split time, which means that they must usually have been "
  14970. "generated by the same invocation of B<dpkg-split --split>."
  14971. msgstr ""
  14972. #. type: Plain text
  14973. #: dpkg-split.man:1
  14974. msgid "The parts' filenames are not significant for the reassembly process."
  14975. msgstr ""
  14976. #. type: Plain text
  14977. #: dpkg-split.man:1
  14978. msgid ""
  14979. "By default the output file is called "
  14980. "I<package>B<_>I<version>B<_>I<arch>B<.deb>."
  14981. msgstr ""
  14982. #. type: TP
  14983. #: dpkg-split.man:1
  14984. #, no-wrap
  14985. msgid "B<-I>, B<--info> I<part>..."
  14986. msgstr ""
  14987. #. type: Plain text
  14988. #: dpkg-split.man:1
  14989. msgid ""
  14990. "Prints information, in a human-readable format, about the part file(s) "
  14991. "specified. Arguments which are not binary package parts produce a message "
  14992. "saying so instead (but still on standard output)."
  14993. msgstr ""
  14994. #. type: TP
  14995. #: dpkg-split.man:1
  14996. #, no-wrap
  14997. msgid "B<-a>, B<--auto -o> I<complete-output part>"
  14998. msgstr ""
  14999. #. type: Plain text
  15000. #: dpkg-split.man:1
  15001. msgid "Automatically queue parts and reassemble a package if possible."
  15002. msgstr ""
  15003. #. type: Plain text
  15004. #: dpkg-split.man:1
  15005. msgid ""
  15006. "The I<part> specified is examined, and compared with other parts of the same "
  15007. "package (if any) in the queue of packages file parts."
  15008. msgstr ""
  15009. #. type: Plain text
  15010. #: dpkg-split.man:1
  15011. msgid ""
  15012. "If all parts of the package file of which I<part> is a part are available "
  15013. "then the package is reassembled and written to I<complete-output> (which "
  15014. "should not usually already exist, though this is not an error)."
  15015. msgstr ""
  15016. #. type: Plain text
  15017. #: dpkg-split.man:1
  15018. msgid ""
  15019. "If not then the I<part> is copied into the queue and I<complete-output> is "
  15020. "not created."
  15021. msgstr ""
  15022. #. type: Plain text
  15023. #: dpkg-split.man:1
  15024. msgid ""
  15025. "If I<part> is not a split binary package part then B<dpkg-split> will exit "
  15026. "with status B<1>; if some other trouble occurs then it will exit with status "
  15027. "B<2>."
  15028. msgstr ""
  15029. #. type: Plain text
  15030. #: dpkg-split.man:1
  15031. msgid ""
  15032. "The B<--output> or B<-o> option must be supplied when using B<--auto>. (If "
  15033. "this were not mandatory the calling program would not know what output file "
  15034. "to expect.)"
  15035. msgstr ""
  15036. #. type: TP
  15037. #: dpkg-split.man:1
  15038. #, no-wrap
  15039. msgid "B<-l>, B<--listq>"
  15040. msgstr ""
  15041. #. type: Plain text
  15042. #: dpkg-split.man:1
  15043. msgid "Lists the contents of the queue of packages to be reassembled."
  15044. msgstr ""
  15045. #. type: Plain text
  15046. #: dpkg-split.man:1
  15047. msgid ""
  15048. "For each package file of which parts are in the queue the output gives the "
  15049. "name of the package, the parts in the queue, and the total number of bytes "
  15050. "stored in the queue."
  15051. msgstr ""
  15052. #. type: TP
  15053. #: dpkg-split.man:1
  15054. #, no-wrap
  15055. msgid "B<-d>, B<--discard> [I<package>...]"
  15056. msgstr ""
  15057. #. type: Plain text
  15058. #: dpkg-split.man:1
  15059. msgid ""
  15060. "This discards parts from the queue of those waiting for the remaining parts "
  15061. "of their packages."
  15062. msgstr ""
  15063. #. type: Plain text
  15064. #: dpkg-split.man:1
  15065. msgid ""
  15066. "If no I<package> is specified then the queue is cleared completely; if any "
  15067. "are specified then only parts of the relevant package(s) are deleted."
  15068. msgstr ""
  15069. #. type: TP
  15070. #: dpkg-split.man:1
  15071. #, no-wrap
  15072. msgid "B<--depotdir>I< directory>"
  15073. msgstr ""
  15074. #. type: Plain text
  15075. #: dpkg-split.man:1
  15076. msgid ""
  15077. "Specifies an alternative directory for the queue of parts awaiting automatic "
  15078. "reassembly. The default is B<%ADMINDIR%>."
  15079. msgstr ""
  15080. #. type: TP
  15081. #: dpkg-split.man:1
  15082. #, no-wrap
  15083. msgid "B<-S>, B<--partsize> I<kibibytes>"
  15084. msgstr ""
  15085. #. type: Plain text
  15086. #: dpkg-split.man:1
  15087. msgid ""
  15088. "Specifies the maximum part size when splitting, in kibibytes (1024 "
  15089. "bytes). The default is 450 KiB."
  15090. msgstr ""
  15091. #. type: TP
  15092. #: dpkg-split.man:1
  15093. #, no-wrap
  15094. msgid "B<-o>, B<--output> I<complete-output>"
  15095. msgstr ""
  15096. #. type: Plain text
  15097. #: dpkg-split.man:1
  15098. msgid "Specifies the output file name for a reassembly."
  15099. msgstr ""
  15100. #. type: Plain text
  15101. #: dpkg-split.man:1
  15102. msgid ""
  15103. "This overrides the default for a manual reassembly (B<--join>) and is "
  15104. "mandatory for an automatic queue-or-reassemble (B<--auto>)."
  15105. msgstr ""
  15106. #. type: TP
  15107. #: dpkg-split.man:1
  15108. #, no-wrap
  15109. msgid "B<-Q>, B<--npquiet>"
  15110. msgstr ""
  15111. #. type: Plain text
  15112. #: dpkg-split.man:1
  15113. msgid ""
  15114. "When doing automatic queue-or-reassembly B<dpkg-split> usually prints a "
  15115. "message if it is given a I<part> that is not a binary package part. This "
  15116. "option suppresses this message, to allow programs such as B<dpkg> to cope "
  15117. "with both split and unsplit packages without producing spurious messages."
  15118. msgstr ""
  15119. #. type: TP
  15120. #: dpkg-split.man:1
  15121. #, no-wrap
  15122. msgid "B<--msdos>"
  15123. msgstr ""
  15124. #. type: Plain text
  15125. #: dpkg-split.man:1
  15126. msgid "Forces the output filenames generated by B<--split> to be msdos-compatible."
  15127. msgstr ""
  15128. #. type: Plain text
  15129. #: dpkg-split.man:1
  15130. msgid ""
  15131. "This mangles the prefix - either the default derived from the input filename "
  15132. "or the one supplied as an argument: alphanumerics are lowercased, plus signs "
  15133. "are replaced by B<x>'s and all other characters are discarded."
  15134. msgstr ""
  15135. #. type: Plain text
  15136. #: dpkg-split.man:1
  15137. msgid ""
  15138. "The result is then truncated as much as is necessary, and filenames of the "
  15139. "form I<prefixN>B<of>I<M>B<.deb> are generated."
  15140. msgstr ""
  15141. #. type: Plain text
  15142. #: dpkg-split.man:1
  15143. msgid ""
  15144. "The requested split, merge, or other command succeeded. B<--info> commands "
  15145. "count as successful even if the files are not binary package parts."
  15146. msgstr ""
  15147. #. type: Plain text
  15148. #: dpkg-split.man:1
  15149. msgid ""
  15150. "Only occurs with B<--auto> and indicates that the I<part> file was not a "
  15151. "binary package part."
  15152. msgstr ""
  15153. #. type: Plain text
  15154. #: dpkg-split.man:1
  15155. msgid ""
  15156. "Fatal or unrecoverable error due to invalid command-line usage, a file that "
  15157. "looked like a package part file but was corrupted, or interactions with the "
  15158. "system, such as accesses to the database, memory allocations, etc."
  15159. msgstr ""
  15160. #. type: Plain text
  15161. #: dpkg-split.man:1
  15162. msgid ""
  15163. "If set, it will be used as the timestamp (as seconds since the epoch) in the "
  15164. "B<deb-split>(5)'s B<ar>(5) container."
  15165. msgstr ""
  15166. #. type: TP
  15167. #: dpkg-split.man:1
  15168. #, no-wrap
  15169. msgid "I<%ADMINDIR%/parts>"
  15170. msgstr ""
  15171. #. type: Plain text
  15172. #: dpkg-split.man:1
  15173. msgid "The default queue directory for part files awaiting automatic reassembly."
  15174. msgstr ""
  15175. #. type: Plain text
  15176. #: dpkg-split.man:1
  15177. msgid ""
  15178. "The filenames used in this directory are in a format internal to "
  15179. "B<dpkg-split> and are unlikely to be useful to other programs, and in any "
  15180. "case the filename format should not be relied upon."
  15181. msgstr ""
  15182. #. type: Plain text
  15183. #: dpkg-split.man:1
  15184. msgid ""
  15185. "Full details of the packages in the queue are impossible to get without "
  15186. "digging into the queue directory yourself."
  15187. msgstr ""
  15188. #. type: Plain text
  15189. #: dpkg-split.man:1
  15190. msgid ""
  15191. "There is no easy way to test whether a file that may be a binary package "
  15192. "part is one."
  15193. msgstr ""
  15194. #. type: Plain text
  15195. #: dpkg-split.man:1
  15196. msgid "B<deb>(5), B<deb-control>(5), B<dpkg-deb>(1), B<dpkg>(1)."
  15197. msgstr ""
  15198. #. type: TH
  15199. #: dpkg-statoverride.man:1
  15200. #, no-wrap
  15201. msgid "dpkg-statoverride"
  15202. msgstr ""
  15203. #. type: Plain text
  15204. #: dpkg-statoverride.man:1
  15205. msgid "dpkg-statoverride - override ownership and mode of files"
  15206. msgstr ""
  15207. #. type: Plain text
  15208. #: dpkg-statoverride.man:1
  15209. msgid "B<dpkg-statoverride> [I<option>...] I<command>"
  15210. msgstr ""
  15211. #. type: Plain text
  15212. #: dpkg-statoverride.man:1
  15213. msgid ""
  15214. "“B<stat overrides>” are a way to tell B<dpkg>(1) to use a different owner "
  15215. "or mode for a path when a package is installed (this applies to any "
  15216. "filesystem object that B<dpkg> handles, including directories, devices, "
  15217. "etc.). This can be used to force programs that are normally setuid to be "
  15218. "install without a setuid flag, or only executable by a certain group."
  15219. msgstr ""
  15220. #. type: Plain text
  15221. #: dpkg-statoverride.man:1
  15222. msgid ""
  15223. "B<dpkg-statoverride> is a utility to manage the list of stat overrides. It "
  15224. "has three basic functions: adding, removing and listing overrides."
  15225. msgstr ""
  15226. #. type: TP
  15227. #: dpkg-statoverride.man:1
  15228. #, no-wrap
  15229. msgid "B<--add>I< user group mode path>"
  15230. msgstr ""
  15231. #. type: Plain text
  15232. #: dpkg-statoverride.man:1
  15233. msgid ""
  15234. "Add an override for I<path>. I<path> does not need to exist when this "
  15235. "command is used; the override will be stored and used later. Users and "
  15236. "groups can be specified by their name (for example B<root> or B<nobody>), or "
  15237. "by their number by prepending the number with a ‘B<#>’ (for example B<#0> or "
  15238. "B<#65534>). The I<mode> needs to be specified in octal."
  15239. msgstr ""
  15240. #. type: Plain text
  15241. #: dpkg-statoverride.man:1
  15242. msgid ""
  15243. "If B<--update> is specified and I<path> exists, it is immediately set to the "
  15244. "new owner and mode."
  15245. msgstr ""
  15246. #. type: TP
  15247. #: dpkg-statoverride.man:1
  15248. #, no-wrap
  15249. msgid "B<--remove>I< path>"
  15250. msgstr ""
  15251. #. type: Plain text
  15252. #: dpkg-statoverride.man:1
  15253. msgid ""
  15254. "Remove an override for I<path>, the status of I<path> is left unchanged by "
  15255. "this command."
  15256. msgstr ""
  15257. #. type: TP
  15258. #: dpkg-statoverride.man:1
  15259. #, no-wrap
  15260. msgid "B<--list> [I<glob-pattern>]"
  15261. msgstr ""
  15262. #. type: Plain text
  15263. #: dpkg-statoverride.man:1
  15264. msgid ""
  15265. "List all overrides. If a glob pattern is specified restrict the output to "
  15266. "overrides which match the glob."
  15267. msgstr ""
  15268. #. type: Plain text
  15269. #: dpkg-statoverride.man:1
  15270. msgid ""
  15271. "Change the I<directory> of the B<dpkg> database where the statoverride file "
  15272. "is also stored. Defaults to I<%ADMINDIR%>."
  15273. msgstr ""
  15274. #. type: TP
  15275. #: dpkg-statoverride.man:1 update-alternatives.man:1
  15276. #, no-wrap
  15277. msgid "B<--force>"
  15278. msgstr ""
  15279. #. type: Plain text
  15280. #: dpkg-statoverride.man:1
  15281. msgid ""
  15282. "Force an action, even if a sanity check would otherwise prohibit it. This "
  15283. "is necessary to override an existing override."
  15284. msgstr ""
  15285. #. type: TP
  15286. #: dpkg-statoverride.man:1
  15287. #, no-wrap
  15288. msgid "B<--update>"
  15289. msgstr ""
  15290. #. type: Plain text
  15291. #: dpkg-statoverride.man:1
  15292. msgid ""
  15293. "Immediately try to change the I<path> to the new owner and mode if it "
  15294. "exists."
  15295. msgstr ""
  15296. #. type: Plain text
  15297. #: dpkg-statoverride.man:1
  15298. msgid "Be less verbose about what we do."
  15299. msgstr ""
  15300. #. type: Plain text
  15301. #: dpkg-statoverride.man:1
  15302. msgid "For B<--list>, if there are no overrides or none match the supplied glob."
  15303. msgstr ""
  15304. #. type: TP
  15305. #: dpkg-statoverride.man:1
  15306. #, no-wrap
  15307. msgid "I<%ADMINDIR%/statoverride>"
  15308. msgstr ""
  15309. #. type: Plain text
  15310. #: dpkg-statoverride.man:1
  15311. msgid ""
  15312. "File which contains the current list of stat overrides of the system. It is "
  15313. "located in the B<dpkg> administration directory, along with other files "
  15314. "important to B<dpkg>, such as I<status> or I<available>."
  15315. msgstr ""
  15316. #. type: Plain text
  15317. #: dpkg-statoverride.man:1
  15318. msgid ""
  15319. "Note: B<dpkg-statoverride> preserves the old copy of this file, with "
  15320. "extension “-old”, before replacing it with the new one."
  15321. msgstr ""
  15322. #. type: TH
  15323. #: dpkg-trigger.man:1
  15324. #, no-wrap
  15325. msgid "dpkg-trigger"
  15326. msgstr ""
  15327. #. type: Plain text
  15328. #: dpkg-trigger.man:1
  15329. msgid "dpkg-trigger - a package trigger utility"
  15330. msgstr ""
  15331. #. type: Plain text
  15332. #: dpkg-trigger.man:1
  15333. msgid "B<dpkg-trigger> [I<option>...] I<trigger-name>"
  15334. msgstr ""
  15335. #. type: Plain text
  15336. #: dpkg-trigger.man:1
  15337. msgid "B<dpkg-trigger> [I<option>...] I<command>"
  15338. msgstr ""
  15339. #. type: Plain text
  15340. #: dpkg-trigger.man:1
  15341. msgid ""
  15342. "B<dpkg-trigger> is a tool to explicitly activate triggers and check for its "
  15343. "support on the running B<dpkg>."
  15344. msgstr ""
  15345. #. type: Plain text
  15346. #: dpkg-trigger.man:1
  15347. msgid ""
  15348. "This can be used by maintainer scripts in complex and conditional situations "
  15349. "where the file triggers, or the declarative B<activate> triggers control "
  15350. "file directive, are insufficiently rich. It can also be used for testing and "
  15351. "by system administrators (but note that the triggers won't actually be run "
  15352. "by B<dpkg-trigger>)."
  15353. msgstr ""
  15354. #. type: Plain text
  15355. #: dpkg-trigger.man:1
  15356. msgid "Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>."
  15357. msgstr ""
  15358. #. type: TP
  15359. #: dpkg-trigger.man:1
  15360. #, no-wrap
  15361. msgid "B<--check-supported>"
  15362. msgstr ""
  15363. #. type: Plain text
  15364. #: dpkg-trigger.man:1
  15365. msgid ""
  15366. "Check if the running B<dpkg> supports triggers (usually called from a "
  15367. "postinst). Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> "
  15368. "with an error message to stderr if not. Normally, however, it is better just "
  15369. "to activate the desired trigger with B<dpkg-trigger>."
  15370. msgstr ""
  15371. #. type: TP
  15372. #: dpkg-trigger.man:1
  15373. #, no-wrap
  15374. msgid "B<--by-package=>I<package>"
  15375. msgstr ""
  15376. #. type: Plain text
  15377. #: dpkg-trigger.man:1
  15378. msgid ""
  15379. "Override trigger awaiter (normally set by B<dpkg> through the "
  15380. "B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, "
  15381. "naming the package to which the script belongs, and this will be used by "
  15382. "default)."
  15383. msgstr ""
  15384. #. type: TP
  15385. #: dpkg-trigger.man:1
  15386. #, no-wrap
  15387. msgid "B<--no-await>"
  15388. msgstr ""
  15389. #. type: Plain text
  15390. #: dpkg-trigger.man:1
  15391. msgid ""
  15392. "This option arranges that the calling package T (if any) need not await the "
  15393. "processing of this trigger; the interested package(s) I, will not be added "
  15394. "to T's trigger processing awaited list and T's status is unchanged. T may "
  15395. "be considered installed even though I may not yet have processed the "
  15396. "trigger."
  15397. msgstr ""
  15398. #. type: TP
  15399. #: dpkg-trigger.man:1
  15400. #, no-wrap
  15401. msgid "B<--await>"
  15402. msgstr ""
  15403. #. type: Plain text
  15404. #: dpkg-trigger.man:1
  15405. msgid ""
  15406. "This option does the inverse of B<--no-await> (since dpkg 1.17.21). It is "
  15407. "currently the default behavior."
  15408. msgstr ""
  15409. #. type: TP
  15410. #: dpkg-trigger.man:1
  15411. #, no-wrap
  15412. msgid "B<--no-act>"
  15413. msgstr ""
  15414. #. type: Plain text
  15415. #: dpkg-trigger.man:1
  15416. msgid "Just test, do not actually change anything."
  15417. msgstr ""
  15418. #. FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev.
  15419. #. type: Plain text
  15420. #: dpkg-trigger.man:1
  15421. msgid "B<dpkg>(1), B<deb-triggers>(5), B</usr/share/doc/dpkg-dev/triggers.txt.gz>."
  15422. msgstr ""
  15423. #. type: TH
  15424. #: dpkg-vendor.man:1
  15425. #, no-wrap
  15426. msgid "dpkg-vendor"
  15427. msgstr ""
  15428. #. type: Plain text
  15429. #: dpkg-vendor.man:1
  15430. msgid "dpkg-vendor - queries information about distribution vendors"
  15431. msgstr ""
  15432. #. type: Plain text
  15433. #: dpkg-vendor.man:1
  15434. msgid "B<dpkg-vendor> [I<option>...] I<command>"
  15435. msgstr ""
  15436. #. type: Plain text
  15437. #: dpkg-vendor.man:1
  15438. msgid ""
  15439. "B<dpkg-vendor> is a tool to query information about vendors listed in "
  15440. "B<%PKGCONFDIR%/origins>. B<%PKGCONFDIR%/origins/default> contains "
  15441. "information about the current vendor."
  15442. msgstr ""
  15443. #. type: TP
  15444. #: dpkg-vendor.man:1
  15445. #, no-wrap
  15446. msgid "B<--is>I< vendor>"
  15447. msgstr ""
  15448. #. type: Plain text
  15449. #: dpkg-vendor.man:1
  15450. msgid ""
  15451. "Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with "
  15452. "B<1>."
  15453. msgstr ""
  15454. #. type: TP
  15455. #: dpkg-vendor.man:1
  15456. #, no-wrap
  15457. msgid "B<--derives-from>I< vendor>"
  15458. msgstr ""
  15459. #. type: Plain text
  15460. #: dpkg-vendor.man:1
  15461. msgid ""
  15462. "Exits with B<0> if the current vendor distribution is a derivative of "
  15463. "I<vendor>, otherwise exits with B<1>. It uses the B<Parent> field to browse "
  15464. "all ancestors of the current vendor."
  15465. msgstr ""
  15466. #. type: TP
  15467. #: dpkg-vendor.man:1
  15468. #, no-wrap
  15469. msgid "B<--query>I< field>"
  15470. msgstr ""
  15471. #. type: Plain text
  15472. #: dpkg-vendor.man:1
  15473. msgid ""
  15474. "Print on standard output the value of the vendor-specific I<field> for the "
  15475. "current vendor."
  15476. msgstr ""
  15477. #. type: TP
  15478. #: dpkg-vendor.man:1
  15479. #, no-wrap
  15480. msgid "B<--vendor>I< vendor>"
  15481. msgstr ""
  15482. #. type: Plain text
  15483. #: dpkg-vendor.man:1
  15484. msgid ""
  15485. "Assumes the current vendor is I<vendor> instead of discovering it with the "
  15486. "B<DEB_VENDOR> environment variable or B<%PKGCONFDIR%/origins/default>."
  15487. msgstr ""
  15488. #. type: Plain text
  15489. #: dpkg-vendor.man:1
  15490. msgid ""
  15491. "This setting defines the current vendor. If not set, it will discover the "
  15492. "current vendor by reading B<%PKGCONFDIR%/origins/default>."
  15493. msgstr ""
  15494. #. type: Plain text
  15495. #: dpkg-vendor.man:1
  15496. msgid "B<deb-origin>(5)."
  15497. msgstr ""
  15498. #. type: TH
  15499. #: dselect.man:1
  15500. #, no-wrap
  15501. msgid "dselect"
  15502. msgstr ""
  15503. #. type: Plain text
  15504. #: dselect.man:1
  15505. msgid "dselect - Debian package management frontend"
  15506. msgstr ""
  15507. #. type: Plain text
  15508. #: dselect.man:1
  15509. msgid "B<dselect> [I<option>...] [I<command>...]"
  15510. msgstr ""
  15511. #. type: Plain text
  15512. #: dselect.man:1
  15513. #, no-wrap
  15514. msgid ""
  15515. "B<dselect>\n"
  15516. "is one of the primary user interfaces for managing packages on a Debian\n"
  15517. "system. At the B<dselect> main menu, the system administrator can:\n"
  15518. " - Update the list of available package versions,\n"
  15519. " - View the status of installed and available packages,\n"
  15520. " - Alter package selections and manage dependencies,\n"
  15521. " - Install new packages or upgrade to newer versions.\n"
  15522. msgstr ""
  15523. #. type: Plain text
  15524. #: dselect.man:1
  15525. msgid ""
  15526. "B<dselect> operates as a front-end to B<dpkg>(1), the low-level Debian "
  15527. "package handling tool. It features a full-screen package selections manager "
  15528. "with package depends and conflicts resolver. When run with administrator "
  15529. "privileges, packages can be installed, upgraded and removed. Various access "
  15530. "methods can be configured to retrieve available package version information "
  15531. "and installable packages from package repositories. Depending on the used "
  15532. "access method, these repositories can be public archive servers on the "
  15533. "internet, local archive servers or cdroms. The recommended access method is "
  15534. "I<apt>, which is provided by the package B<apt>."
  15535. msgstr ""
  15536. #. type: Plain text
  15537. #: dselect.man:1
  15538. msgid ""
  15539. "Normally B<dselect> is invoked without parameters. An interactive menu is "
  15540. "presented, offering the user a list of commands. If a command is given as "
  15541. "argument, then that command is started immediately. Several command line "
  15542. "parameters are still available to modify the running behaviour of B<dselect> "
  15543. "or show additional information about the program."
  15544. msgstr ""
  15545. #. type: Plain text
  15546. #: dselect.man:1
  15547. msgid ""
  15548. "All options can be specified both on the command line and in the B<dselect> "
  15549. "configuration file I<%PKGCONFDIR%/dselect.cfg> or the files on the "
  15550. "configuration directory I<%PKGCONFDIR%/dselect.cfg.d/>. Each line in the "
  15551. "configuration file is either an option (exactly the same as the command line "
  15552. "option but without leading hyphens) or a comment (if it starts with a "
  15553. "‘B<#>’)."
  15554. msgstr ""
  15555. #. type: Plain text
  15556. #: dselect.man:1
  15557. msgid ""
  15558. "Changes the directory where the dpkg ‘I<status>’, ‘I<available>’ and similar "
  15559. "files are located. This defaults to I<%ADMINDIR%> and normally there "
  15560. "shouldn't be any need to change it."
  15561. msgstr ""
  15562. #. type: TP
  15563. #: dselect.man:1
  15564. #, no-wrap
  15565. msgid "B<-D>I<file>, B<--debug> I<file>"
  15566. msgstr ""
  15567. #. type: Plain text
  15568. #: dselect.man:1
  15569. msgid "Turn on debugging. Debugging information is sent to I<file>."
  15570. msgstr ""
  15571. #. type: TP
  15572. #: dselect.man:1
  15573. #, no-wrap
  15574. msgid "B<--expert>"
  15575. msgstr ""
  15576. #. type: Plain text
  15577. #: dselect.man:1
  15578. msgid "Turns on expert mode, i.e. doesn't display possibly annoying help messages."
  15579. msgstr ""
  15580. #. type: TP
  15581. #: dselect.man:1
  15582. #, no-wrap
  15583. msgid ""
  15584. "B<--colour>|B<--color> "
  15585. "I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]"
  15586. msgstr ""
  15587. #. type: Plain text
  15588. #: dselect.man:1
  15589. msgid ""
  15590. "Configures screen colors. This works only if your display supports colors. "
  15591. "This option may be used multiple times (and is best used in "
  15592. "I<dselect.cfg>). Each use changes the color (and optionally, other "
  15593. "attributes) of one part of the screen. The parts of the screen (from top to "
  15594. "bottom) are:"
  15595. msgstr ""
  15596. #. type: TP
  15597. #: dselect.man:1
  15598. #, no-wrap
  15599. msgid "B<title>"
  15600. msgstr ""
  15601. #. type: Plain text
  15602. #: dselect.man:1
  15603. msgid "The screen title."
  15604. msgstr ""
  15605. #. type: TP
  15606. #: dselect.man:1
  15607. #, no-wrap
  15608. msgid "B<listhead>"
  15609. msgstr ""
  15610. #. type: Plain text
  15611. #: dselect.man:1
  15612. msgid "The header line above the list of packages."
  15613. msgstr ""
  15614. #. type: TP
  15615. #: dselect.man:1
  15616. #, no-wrap
  15617. msgid "B<list>"
  15618. msgstr ""
  15619. #. type: Plain text
  15620. #: dselect.man:1
  15621. msgid "The scrolling list of packages (and also some help text)."
  15622. msgstr ""
  15623. #. type: TP
  15624. #: dselect.man:1
  15625. #, no-wrap
  15626. msgid "B<listsel>"
  15627. msgstr ""
  15628. #. type: Plain text
  15629. #: dselect.man:1
  15630. msgid "The selected item in the list."
  15631. msgstr ""
  15632. #. type: TP
  15633. #: dselect.man:1
  15634. #, no-wrap
  15635. msgid "B<pkgstate>"
  15636. msgstr ""
  15637. #. type: Plain text
  15638. #: dselect.man:1
  15639. msgid ""
  15640. "In the list of packages, the text indicating the current state of each "
  15641. "package."
  15642. msgstr ""
  15643. #. type: TP
  15644. #: dselect.man:1
  15645. #, no-wrap
  15646. msgid "B<pkgstatesel>"
  15647. msgstr ""
  15648. #. type: Plain text
  15649. #: dselect.man:1
  15650. msgid ""
  15651. "In the list of packages, the text indicating the current state of the "
  15652. "currently selected package."
  15653. msgstr ""
  15654. #. type: TP
  15655. #: dselect.man:1
  15656. #, no-wrap
  15657. msgid "B<infohead>"
  15658. msgstr ""
  15659. #. type: Plain text
  15660. #: dselect.man:1
  15661. msgid "The header line that displays the state of the currently selected package."
  15662. msgstr ""
  15663. #. type: TP
  15664. #: dselect.man:1
  15665. #, no-wrap
  15666. msgid "B<infodesc>"
  15667. msgstr ""
  15668. #. type: Plain text
  15669. #: dselect.man:1
  15670. msgid "The package's short description."
  15671. msgstr ""
  15672. #. type: TP
  15673. #: dselect.man:1
  15674. #, no-wrap
  15675. msgid "B<info>"
  15676. msgstr ""
  15677. #. type: Plain text
  15678. #: dselect.man:1
  15679. msgid "Used to display package info such as the package's description."
  15680. msgstr ""
  15681. #. type: TP
  15682. #: dselect.man:1
  15683. #, no-wrap
  15684. msgid "B<infofoot>"
  15685. msgstr ""
  15686. #. type: Plain text
  15687. #: dselect.man:1
  15688. msgid "The last line of the screen when selecting packages."
  15689. msgstr ""
  15690. #. type: TP
  15691. #: dselect.man:1
  15692. #, no-wrap
  15693. msgid "B<query>"
  15694. msgstr ""
  15695. #. type: Plain text
  15696. #: dselect.man:1
  15697. msgid "Used to display query lines"
  15698. msgstr ""
  15699. #. type: TP
  15700. #: dselect.man:1
  15701. #, no-wrap
  15702. msgid "B<helpscreen>"
  15703. msgstr ""
  15704. #. type: Plain text
  15705. #: dselect.man:1
  15706. msgid "Color of help screens."
  15707. msgstr ""
  15708. #. type: Plain text
  15709. #: dselect.man:1
  15710. msgid ""
  15711. "After the part of the screen comes a colon and the color specification. You "
  15712. "can specify either the foreground color, the background color, or both, "
  15713. "overriding the compiled-in colors. Use standard curses color names."
  15714. msgstr ""
  15715. #. type: Plain text
  15716. #: dselect.man:1
  15717. msgid ""
  15718. "Optionally, after the color specification is another colon, and an attribute "
  15719. "specification. This is a list of one or more attributes, separated by plus "
  15720. "(‘+’) characters. Available attributes include (not all of these will work "
  15721. "on all terminals): B<normal>, B<standout>, B<underline>, B<reverse>, "
  15722. "B<blink>, B<bright>, B<dim>, B<bold>"
  15723. msgstr ""
  15724. #. type: Plain text
  15725. #: dselect.man:1
  15726. msgid "Print a brief help text and exit successfully."
  15727. msgstr ""
  15728. #. type: Plain text
  15729. #: dselect.man:1
  15730. msgid "Print version information and exit successfully."
  15731. msgstr ""
  15732. #. type: Plain text
  15733. #: dselect.man:1
  15734. msgid ""
  15735. "When B<dselect> is started it can perform the following commands, either "
  15736. "directly if it was specified on the command line or by prompting the user "
  15737. "with a menu of available commands if running interactively:"
  15738. msgstr ""
  15739. #. type: SS
  15740. #: dselect.man:1
  15741. #, no-wrap
  15742. msgid "access"
  15743. msgstr ""
  15744. #. type: Plain text
  15745. #: dselect.man:1
  15746. msgid "Choose and configure an access method to access package repositories."
  15747. msgstr ""
  15748. #. type: Plain text
  15749. #: dselect.man:1
  15750. msgid ""
  15751. "By default, B<dselect> provides several methods such as I<cdrom>, "
  15752. "I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount>, "
  15753. "I<floppy> or I<ftp>, but other packages may provide additional methods, "
  15754. "eg. the I<apt> access method provided by the B<apt> package."
  15755. msgstr ""
  15756. #. type: Plain text
  15757. #: dselect.man:1
  15758. msgid "The use of the I<apt> access method is strongly recommended."
  15759. msgstr ""
  15760. #. type: SS
  15761. #: dselect.man:1
  15762. #, no-wrap
  15763. msgid "update"
  15764. msgstr ""
  15765. #. type: Plain text
  15766. #: dselect.man:1
  15767. msgid "Refresh the available packages database."
  15768. msgstr ""
  15769. #. type: Plain text
  15770. #: dselect.man:1
  15771. msgid ""
  15772. "Retrieves a list of available package versions from the package repository, "
  15773. "configured for the current access method, and update the dpkg database. The "
  15774. "package lists are commonly provided by the repository as files named "
  15775. "I<Packages> or I<Packages.gz>. These files can be generated by repository "
  15776. "maintainers, using the program B<dpkg-scanpackages>(1)."
  15777. msgstr ""
  15778. #. type: Plain text
  15779. #: dselect.man:1
  15780. msgid ""
  15781. "Details of the update command depend on the access method's implementation. "
  15782. "Normally the process is straightforward and requires no user interaction."
  15783. msgstr ""
  15784. #. type: SS
  15785. #: dselect.man:1
  15786. #, no-wrap
  15787. msgid "select"
  15788. msgstr ""
  15789. #. type: Plain text
  15790. #: dselect.man:1
  15791. msgid "View or manage package selections and dependencies."
  15792. msgstr ""
  15793. #. type: Plain text
  15794. #: dselect.man:1
  15795. msgid ""
  15796. "This is the main function of B<dselect>. In the select screen, the user can "
  15797. "review a list of all available and installed packages. When run with "
  15798. "administrator privileges, it is also possible to interactively change "
  15799. "packages selection state. B<dselect> tracks the implications of these "
  15800. "changes to other depending or conflicting packages."
  15801. msgstr ""
  15802. #. type: Plain text
  15803. #: dselect.man:1
  15804. msgid ""
  15805. "When a conflict or failed depends is detected, a dependency resolution "
  15806. "subscreen is prompted to the user. In this screen, a list of conflicting or "
  15807. "depending packages is shown, and for each package listed, the reason for its "
  15808. "listing is shown. The user may apply the suggestions proposed by B<dselect>, "
  15809. "override them, or back out all the changes, including the ones that created "
  15810. "the unresolved depends or conflicts."
  15811. msgstr ""
  15812. #. type: Plain text
  15813. #: dselect.man:1
  15814. msgid ""
  15815. "The use of the interactive package selections management screen is explained "
  15816. "in more detail below."
  15817. msgstr ""
  15818. #. type: SS
  15819. #: dselect.man:1
  15820. #, no-wrap
  15821. msgid "install"
  15822. msgstr ""
  15823. #. type: Plain text
  15824. #: dselect.man:1
  15825. msgid "Installs selected packages."
  15826. msgstr ""
  15827. #. type: Plain text
  15828. #: dselect.man:1
  15829. msgid ""
  15830. "The configured access method will fetch installable or upgradable packages "
  15831. "from the relevant repositories and install these using B<dpkg>. Depending "
  15832. "on the implementation of the access method, all packages can be prefetched "
  15833. "before installation, or fetched when needed. Some access methods may also "
  15834. "remove packages that were marked for removal."
  15835. msgstr ""
  15836. #. type: Plain text
  15837. #: dselect.man:1
  15838. msgid ""
  15839. "If an error occurred during install, it is usually advisable to run install "
  15840. "again. In most cases, the problems will disappear or be solved. If problems "
  15841. "persist or the installation performed was incorrect, please investigate into "
  15842. "the causes and circumstances, and file a bug in the Debian bug tracking "
  15843. "system. Instructions on how to do this can be found at "
  15844. "https://bugs.debian.org/ or by reading the documentation for B<bug>(1) or "
  15845. "B<reportbug>(1), if these are installed."
  15846. msgstr ""
  15847. #. type: Plain text
  15848. #: dselect.man:1
  15849. msgid ""
  15850. "Details of the install command depend on the access method's "
  15851. "implementation. The user's attention and input may be required during "
  15852. "installation, configuration or removal of packages. This depends on the "
  15853. "maintainer scripts in the package. Some packages make use of the "
  15854. "B<debconf>(1) library, allowing for more flexible or even automated "
  15855. "installation setups."
  15856. msgstr ""
  15857. #. type: SS
  15858. #: dselect.man:1
  15859. #, no-wrap
  15860. msgid "config"
  15861. msgstr ""
  15862. #. type: Plain text
  15863. #: dselect.man:1
  15864. msgid "Configures any previously installed, but not fully configured packages."
  15865. msgstr ""
  15866. #. type: SS
  15867. #: dselect.man:1
  15868. #, no-wrap
  15869. msgid "remove"
  15870. msgstr ""
  15871. #. type: Plain text
  15872. #: dselect.man:1
  15873. msgid "Removes or purges installed packages, that are marked for removal."
  15874. msgstr ""
  15875. #. type: SS
  15876. #: dselect.man:1
  15877. #, no-wrap
  15878. msgid "quit"
  15879. msgstr ""
  15880. #. type: Plain text
  15881. #: dselect.man:1
  15882. msgid "Quit B<dselect>."
  15883. msgstr ""
  15884. #. type: Plain text
  15885. #: dselect.man:1
  15886. msgid "Exits the program with zero (successful) errorcode."
  15887. msgstr ""
  15888. #. type: SH
  15889. #: dselect.man:1
  15890. #, no-wrap
  15891. msgid "PACKAGE SELECTIONS MANAGEMENT"
  15892. msgstr ""
  15893. #. type: SS
  15894. #: dselect.man:1
  15895. #, no-wrap
  15896. msgid "Introduction"
  15897. msgstr ""
  15898. #. type: Plain text
  15899. #: dselect.man:1
  15900. msgid ""
  15901. "B<dselect> directly exposes the administrator to some of the complexities "
  15902. "involved with managing large sets of packages with many "
  15903. "interdependencies. For a user who is unfamiliar with the concepts and the "
  15904. "ways of the Debian package management system, it can be quite "
  15905. "overwhelming. Although B<dselect> is aimed at easing package management and "
  15906. "administration, it is only instrumental in doing so and cannot be assumed to "
  15907. "be a sufficient substitute for administrator skill and understanding. The "
  15908. "user is required to be familiar with the concepts underlying the Debian "
  15909. "packaging system. In case of doubt, consult the B<dpkg>(1) manpage and the "
  15910. "distribution policy."
  15911. msgstr ""
  15912. #. type: Plain text
  15913. #: dselect.man:1
  15914. msgid ""
  15915. "Unless B<dselect> is run in expert or immediate mode, a help screen is first "
  15916. "displayed when choosing this command from the menu. The user is I<strongly> "
  15917. "advised to study all of the information presented in the online help "
  15918. "screens, when one pops up. The online help screens can at any time be "
  15919. "invoked with the ‘B<?>’ key."
  15920. msgstr ""
  15921. #. type: SS
  15922. #: dselect.man:1
  15923. #, no-wrap
  15924. msgid "Screen layout"
  15925. msgstr ""
  15926. #. type: Plain text
  15927. #: dselect.man:1
  15928. msgid ""
  15929. "The select screen is by default split in a top and a bottom half. The top "
  15930. "half shows a list of packages. A cursor bar can select an individual "
  15931. "package, or a group of packages, if applicable, by selecting the group "
  15932. "header. The bottom half of the screen shows some details about the package "
  15933. "currently selected in the top half of the screen. The type of detail that "
  15934. "is displayed can be varied."
  15935. msgstr ""
  15936. #. type: Plain text
  15937. #: dselect.man:1
  15938. msgid ""
  15939. "Pressing the ‘B<I>’ key toggles a full-screen display of the packages list, "
  15940. "an enlarged view of the package details, or the equally split screen."
  15941. msgstr ""
  15942. #. type: SS
  15943. #: dselect.man:1
  15944. #, no-wrap
  15945. msgid "Package details view"
  15946. msgstr ""
  15947. #. type: Plain text
  15948. #: dselect.man:1
  15949. #, no-wrap
  15950. msgid ""
  15951. "The package details view by default shows the extended package description\n"
  15952. "for the package that is currently selected in the packages status list.\n"
  15953. "The type of detail can be toggled by pressing the ‘B<i>’ key.\n"
  15954. "This alternates between:\n"
  15955. " - the extended description\n"
  15956. " - the control information for the installed version\n"
  15957. " - the control information for the available version\n"
  15958. msgstr ""
  15959. #. type: Plain text
  15960. #: dselect.man:1
  15961. msgid ""
  15962. "In a dependency resolution screen, there is also the possibility of viewing "
  15963. "the specific unresolved depends or conflicts related to the package and "
  15964. "causing it to be listed."
  15965. msgstr ""
  15966. #. type: SS
  15967. #: dselect.man:1
  15968. #, no-wrap
  15969. msgid "Packages status list"
  15970. msgstr ""
  15971. #. type: Plain text
  15972. #: dselect.man:1
  15973. msgid ""
  15974. "The main select screen displays a list of all packages known to the Debian "
  15975. "package management system. This includes packages installed on the system "
  15976. "and packages known from the available packages database."
  15977. msgstr ""
  15978. #. type: Plain text
  15979. #: dselect.man:1
  15980. msgid ""
  15981. "For every package, the list shows the package's status, priority, section, "
  15982. "installed and available architecture, installed and available versions, the "
  15983. "package name and its short description, all in one line. By pressing the "
  15984. "‘B<A>’ key, the display of the installed and available architecture can be "
  15985. "toggled between on an off. By pressing the ‘B<V>’ key, the display of the "
  15986. "installed and available version can be toggled between on an off. By "
  15987. "pressing the ‘B<v>’ key, the package status display is toggled between "
  15988. "verbose and shorthand. Shorthand display is the default."
  15989. msgstr ""
  15990. #. type: Plain text
  15991. #: dselect.man:1
  15992. msgid ""
  15993. "The shorthand status indication consists of four parts: an error flag, which "
  15994. "should normally be clear, the current status, the last selection state and "
  15995. "the current selection state. The first two relate to the actual state of "
  15996. "the package, the second pair are about the selections set by the user."
  15997. msgstr ""
  15998. #. type: Plain text
  15999. #: dselect.man:1
  16000. #, no-wrap
  16001. msgid ""
  16002. "These are the meanings of the shorthand package status indicator codes:\n"
  16003. " Error flag:\n"
  16004. " I<empty> no error\n"
  16005. " B<R> serious error, needs reinstallation;\n"
  16006. " Installed state:\n"
  16007. " I<empty> not installed;\n"
  16008. " B<*> fully installed and configured;\n"
  16009. " B<-> not installed but some config files may remain;\n"
  16010. " B<U> unpacked but not yet configured;\n"
  16011. " B<C> half-configured (an error happened);\n"
  16012. " B<I> half-installed (an error happened).\n"
  16013. " Current and requested selections:\n"
  16014. " B<*> marked for installation or upgrade;\n"
  16015. " B<-> marked for removal, configuration files remain;\n"
  16016. " B<=> on hold: package will not be processed at all;\n"
  16017. " B<_> marked for purge, also remove configuration;\n"
  16018. " B<n> package is new and has yet to be marked.\n"
  16019. msgstr ""
  16020. #. type: SS
  16021. #: dselect.man:1
  16022. #, no-wrap
  16023. msgid "Cursor and screen movement"
  16024. msgstr ""
  16025. #. type: Plain text
  16026. #: dselect.man:1
  16027. msgid ""
  16028. "The package selection list and the dependency conflict resolution screens "
  16029. "can be navigated using motion commands mapped to the following keys:"
  16030. msgstr ""
  16031. #. type: Plain text
  16032. #: dselect.man:1
  16033. #, no-wrap
  16034. msgid ""
  16035. " B<p, Up, k> move cursor bar up\n"
  16036. " B<n, Down, j> move cursor bar down\n"
  16037. " B<P, Pgup, Backspace> scroll list 1 page up\n"
  16038. " B<N, Pgdn, Space> scroll list 1 page down\n"
  16039. " B<^p> scroll list 1 line up\n"
  16040. " B<^n> scroll list 1 line down\n"
  16041. " B<t, Home> jump to top of list\n"
  16042. " B<e, End> jump to end of list\n"
  16043. " B<u> scroll info 1 page up\n"
  16044. " B<d> scroll info 1 page down\n"
  16045. " B<^u> scroll info 1 line up\n"
  16046. " B<^d> scroll info 1 line down\n"
  16047. " B<B, Left-arrow> pan display 1/3 screen left\n"
  16048. " B<F, Right-arrow> pan display 1/3 screen right\n"
  16049. " B<^b> pan display 1 character left\n"
  16050. " B<^f> pan display 1 character right\n"
  16051. msgstr ""
  16052. #. type: SS
  16053. #: dselect.man:1
  16054. #, no-wrap
  16055. msgid "Searching and sorting"
  16056. msgstr ""
  16057. #. type: Plain text
  16058. #: dselect.man:1
  16059. msgid ""
  16060. "The list of packages can be searched by package name. This is done by "
  16061. "pressing ‘B</>’, and typing a simple search string. The string is "
  16062. "interpreted as a B<regex>(7) regular expression. If you add ‘B</d>’ to the "
  16063. "search expression, dselect will also search in descriptions. If you add "
  16064. "‘B</i>’ the search will be case insensitive. You may combine these two "
  16065. "suffixes like this: ‘B</id>’. Repeated searching is accomplished by "
  16066. "repeatedly pressing the ‘B<n>’ or ‘B<\\e>’ keys, until the wanted package is "
  16067. "found. If the search reaches the bottom of the list, it wraps to the top "
  16068. "and continues searching from there."
  16069. msgstr ""
  16070. #. type: Plain text
  16071. #: dselect.man:1
  16072. #, no-wrap
  16073. msgid ""
  16074. "The list sort order can be varied by pressing\n"
  16075. "the ‘B<o>’ and ‘B<O>’ keys repeatedly.\n"
  16076. "The following nine sort orderings can be selected:\n"
  16077. " alphabet available status\n"
  16078. " priority+section available+priority status+priority\n"
  16079. " section+priority available+section status+section\n"
  16080. msgstr ""
  16081. #. type: Plain text
  16082. #: dselect.man:1
  16083. msgid ""
  16084. "Where not listed above explicitly, alphabetic order is used as the final "
  16085. "subordering sort key."
  16086. msgstr ""
  16087. #. type: SS
  16088. #: dselect.man:1
  16089. #, no-wrap
  16090. msgid "Altering selections"
  16091. msgstr ""
  16092. #. type: Plain text
  16093. #: dselect.man:1
  16094. #, no-wrap
  16095. msgid ""
  16096. "The requested selection state of individual packages may be\n"
  16097. "altered with the following commands:\n"
  16098. " B<+, Insert> install or upgrade\n"
  16099. " B<=, H> hold in present state and version\n"
  16100. " B<:, G> unhold: upgrade or leave uninstalled\n"
  16101. " B<-, Delete> remove, but leave configuration\n"
  16102. " B<_> remove & purge configuration\n"
  16103. msgstr ""
  16104. #. type: Plain text
  16105. #: dselect.man:1
  16106. msgid ""
  16107. "When the change request results in one or more unsatisfied depends or "
  16108. "conflicts, B<dselect> prompts the user with a dependency resolution "
  16109. "screen. This will be further explained below."
  16110. msgstr ""
  16111. #. type: Plain text
  16112. #: dselect.man:1
  16113. msgid ""
  16114. "It is also possible to apply these commands to groups of package selections, "
  16115. "by pointing the cursor bar onto a group header. The exact grouping of "
  16116. "packages is dependent on the current list ordering settings."
  16117. msgstr ""
  16118. #. type: Plain text
  16119. #: dselect.man:1
  16120. msgid ""
  16121. "Proper care should be taken when altering large groups of selections, "
  16122. "because this can instantaneously create large numbers of unresolved depends "
  16123. "or conflicts, all of which will be listed in one dependency resolution "
  16124. "screen, making them very hard to handle. In practice, only hold and unhold "
  16125. "operations are useful when applied to groups."
  16126. msgstr ""
  16127. #. type: SS
  16128. #: dselect.man:1
  16129. #, no-wrap
  16130. msgid "Resolving depends and conflicts"
  16131. msgstr ""
  16132. #. type: Plain text
  16133. #: dselect.man:1
  16134. msgid ""
  16135. "When the change request results in one or more unsatisfied depends or "
  16136. "conflicts, B<dselect> prompts the user with a dependency resolution "
  16137. "screen. First however, an informative help screen is displayed."
  16138. msgstr ""
  16139. #. type: Plain text
  16140. #: dselect.man:1
  16141. msgid ""
  16142. "The top half of this screen lists all the packages that will have unresolved "
  16143. "depends or conflicts, as a result of the requested change, and all the "
  16144. "packages whose installation can resolve any of these depends or whose "
  16145. "removal can resolve any of the conflicts. The bottom half defaults to show "
  16146. "the depends or conflicts that cause the currently selected package to be "
  16147. "listed."
  16148. msgstr ""
  16149. #. type: Plain text
  16150. #: dselect.man:1
  16151. msgid ""
  16152. "When the sublist of packages is displayed initially, B<dselect> may have "
  16153. "already set the requested selection status of some of the listed packages, "
  16154. "in order to resolve the depends or conflicts that caused the dependency "
  16155. "resolution screen to be displayed. Usually, it is best to follow up the "
  16156. "suggestions made by B<dselect>."
  16157. msgstr ""
  16158. #. type: Plain text
  16159. #: dselect.man:1
  16160. msgid ""
  16161. "The listed packages' selection state may be reverted to the original "
  16162. "settings, as they were before the unresolved depends or conflicts were "
  16163. "created, by pressing the ‘B<R>’ key. By pressing the ‘B<D>’ key, the "
  16164. "automatic suggestions are reset, but the change that caused the dependency "
  16165. "resolution screen to be prompted is kept as requested. Finally, by pressing "
  16166. "‘B<U>’, the selections are again set to the automatic suggestion values."
  16167. msgstr ""
  16168. #. type: SS
  16169. #: dselect.man:1
  16170. #, no-wrap
  16171. msgid "Establishing the requested selections"
  16172. msgstr ""
  16173. #. type: Plain text
  16174. #: dselect.man:1
  16175. msgid ""
  16176. "By pressing B<enter>, the currently displayed set of selections is "
  16177. "accepted. If B<dselect> detects no unresolved depends as a result of the "
  16178. "requested selections, the new selections will be set. However, if there are "
  16179. "any unresolved depends, B<dselect> will again prompt the user with a "
  16180. "dependency resolution screen."
  16181. msgstr ""
  16182. #. type: Plain text
  16183. #: dselect.man:1
  16184. msgid ""
  16185. "To alter a set of selections that creates unresolved depends or conflicts "
  16186. "and forcing B<dselect> to accept it, press the ‘B<Q>’ key. This sets the "
  16187. "selections as specified by the user, unconditionally. Generally, don't do "
  16188. "this unless you've read the fine print."
  16189. msgstr ""
  16190. #. type: Plain text
  16191. #: dselect.man:1
  16192. msgid ""
  16193. "The opposite effect, to back out any selections change requests and go back "
  16194. "to the previous list of selections, is attained by pressing the ‘B<X>’ or "
  16195. "B<escape> keys. By repeatedly pressing these keys, any possibly detrimental "
  16196. "changes to the requested package selections can be backed out completely to "
  16197. "the last established settings."
  16198. msgstr ""
  16199. #. type: Plain text
  16200. #: dselect.man:1
  16201. msgid ""
  16202. "If you mistakenly establish some settings and wish to revert all the "
  16203. "selections to what is currently installed on the system, press the ‘B<C>’ "
  16204. "key. This is somewhat similar to using the unhold command on all packages, "
  16205. "but provides a more obvious panic button in cases where the user pressed "
  16206. "B<enter> by accident."
  16207. msgstr ""
  16208. #. type: Plain text
  16209. #: dselect.man:1
  16210. msgid "The requested command was successfully performed."
  16211. msgstr ""
  16212. #. type: Plain text
  16213. #: dselect.man:1
  16214. msgid ""
  16215. "If set, B<dselect> will use it as the directory from which to read the user "
  16216. "specific configuration file."
  16217. msgstr ""
  16218. #. type: Plain text
  16219. #: dselect.man:1
  16220. msgid ""
  16221. "The B<dselect> package selection interface is confusing to some new users. "
  16222. "Reportedly, it even makes seasoned kernel developers cry."
  16223. msgstr ""
  16224. #. type: Plain text
  16225. #: dselect.man:1
  16226. msgid "The documentation is lacking."
  16227. msgstr ""
  16228. #. type: Plain text
  16229. #: dselect.man:1
  16230. msgid "There is no help option in the main menu."
  16231. msgstr ""
  16232. #. type: Plain text
  16233. #: dselect.man:1
  16234. msgid "The visible list of available packages cannot be reduced."
  16235. msgstr ""
  16236. #. type: Plain text
  16237. #: dselect.man:1
  16238. msgid ""
  16239. "The built in access methods can no longer stand up to current quality "
  16240. "standards. Use the access method provided by apt, it is not only not broken, "
  16241. "it is also much more flexible than the built in access methods."
  16242. msgstr ""
  16243. #. type: Plain text
  16244. #: dselect.man:1
  16245. msgid "B<dpkg>(1), B<apt-get>(8), B<sources.list>(5), B<deb>(5)."
  16246. msgstr ""
  16247. #. type: TH
  16248. #: dselect.cfg.man:1
  16249. #, no-wrap
  16250. msgid "dselect.cfg"
  16251. msgstr ""
  16252. #. type: Plain text
  16253. #: dselect.cfg.man:1
  16254. msgid "dselect.cfg - dselect configuration file"
  16255. msgstr ""
  16256. #. type: Plain text
  16257. #: dselect.cfg.man:1
  16258. msgid ""
  16259. "This file contains default options for dselect. Each line contains a single "
  16260. "option which is exactly the same as a normal command line option for dselect "
  16261. "except for the leading hyphens which are not used here. Quotes surrounding "
  16262. "option values are stripped. Comments are allowed by starting a line with a "
  16263. "hash sign (‘B<#>’)."
  16264. msgstr ""
  16265. #. type: Plain text
  16266. #: dselect.cfg.man:1
  16267. msgid "I<%PKGCONFDIR%/dselect.cfg.d/[0-9a-zA-Z_-]*>"
  16268. msgstr ""
  16269. #. type: Plain text
  16270. #: dselect.cfg.man:1
  16271. msgid "I<%PKGCONFDIR%/dselect.cfg>"
  16272. msgstr ""
  16273. #. type: Plain text
  16274. #: dselect.cfg.man:1
  16275. msgid "I<~/.dselect.cfg>"
  16276. msgstr ""
  16277. #. type: Plain text
  16278. #: dselect.cfg.man:1
  16279. msgid "B<dselect>(1)."
  16280. msgstr ""
  16281. #. type: TH
  16282. #: start-stop-daemon.man:1
  16283. #, no-wrap
  16284. msgid "start-stop-daemon"
  16285. msgstr ""
  16286. #. type: Plain text
  16287. #: start-stop-daemon.man:1
  16288. msgid "start-stop-daemon - start and stop system daemon programs"
  16289. msgstr ""
  16290. #. type: Plain text
  16291. #: start-stop-daemon.man:1
  16292. msgid "B<start-stop-daemon> [I<option>...] I<command>"
  16293. msgstr ""
  16294. #. type: Plain text
  16295. #: start-stop-daemon.man:1
  16296. msgid ""
  16297. "B<start-stop-daemon> is used to control the creation and termination of "
  16298. "system-level processes. Using one of the matching options, "
  16299. "B<start-stop-daemon> can be configured to find existing instances of a "
  16300. "running process."
  16301. msgstr ""
  16302. #. type: Plain text
  16303. #: start-stop-daemon.man:1
  16304. msgid ""
  16305. "Note: unless B<--pid> or B<--pidfile> are specified, B<start-stop-daemon> "
  16306. "behaves similar to B<killall>(1). B<start-stop-daemon> will scan the "
  16307. "process table looking for any processes which match the process name, parent "
  16308. "pid, uid, and/or gid (if specified). Any matching process will prevent "
  16309. "B<--start> from starting the daemon. All matching processes will be sent the "
  16310. "TERM signal (or the one specified via B<--signal> or B<--retry>) if "
  16311. "B<--stop> is specified. For daemons which have long-lived children which "
  16312. "need to live through a B<--stop>, you must specify a pidfile."
  16313. msgstr ""
  16314. #. type: TP
  16315. #: start-stop-daemon.man:1
  16316. #, no-wrap
  16317. msgid "B<-S>, B<--start> [B<-->] I<arguments>"
  16318. msgstr ""
  16319. #. type: Plain text
  16320. #: start-stop-daemon.man:1
  16321. msgid ""
  16322. "Check for the existence of a specified process. If such a process exists, "
  16323. "B<start-stop-daemon> does nothing, and exits with error status 1 (0 if "
  16324. "B<--oknodo> is specified). If such a process does not exist, it starts an "
  16325. "instance, using either the executable specified by B<--exec> or, if "
  16326. "specified, by B<--startas>. Any arguments given after B<--> on the command "
  16327. "line are passed unmodified to the program being started."
  16328. msgstr ""
  16329. #. type: TP
  16330. #: start-stop-daemon.man:1
  16331. #, no-wrap
  16332. msgid "B<-K>, B<--stop>"
  16333. msgstr ""
  16334. #. type: Plain text
  16335. #: start-stop-daemon.man:1
  16336. msgid ""
  16337. "Checks for the existence of a specified process. If such a process exists, "
  16338. "B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits "
  16339. "with error status 0. If such a process does not exist, B<start-stop-daemon> "
  16340. "exits with error status 1 (0 if B<--oknodo> is specified). If B<--retry> is "
  16341. "specified, then B<start-stop-daemon> will check that the process(es) have "
  16342. "terminated."
  16343. msgstr ""
  16344. #. type: TP
  16345. #: start-stop-daemon.man:1
  16346. #, no-wrap
  16347. msgid "B<-T>, B<--status>"
  16348. msgstr ""
  16349. #. type: Plain text
  16350. #: start-stop-daemon.man:1
  16351. msgid ""
  16352. "Check for the existence of a specified process, and returns an exit status "
  16353. "code, according to the LSB Init Script Actions (since version 1.16.1)."
  16354. msgstr ""
  16355. #. type: TP
  16356. #: start-stop-daemon.man:1
  16357. #, no-wrap
  16358. msgid "B<-H>, B<--help>"
  16359. msgstr ""
  16360. #. type: Plain text
  16361. #: start-stop-daemon.man:1
  16362. msgid "Show usage information and exit."
  16363. msgstr ""
  16364. #. type: TP
  16365. #: start-stop-daemon.man:1
  16366. #, no-wrap
  16367. msgid "B<-V>, B<--version>"
  16368. msgstr ""
  16369. #. type: Plain text
  16370. #: start-stop-daemon.man:1
  16371. msgid "Show the program version and exit."
  16372. msgstr ""
  16373. #. type: SS
  16374. #: start-stop-daemon.man:1
  16375. #, no-wrap
  16376. msgid "Matching options"
  16377. msgstr ""
  16378. #. type: TP
  16379. #: start-stop-daemon.man:1
  16380. #, no-wrap
  16381. msgid "B<--pid> I<pid>"
  16382. msgstr ""
  16383. #. type: Plain text
  16384. #: start-stop-daemon.man:1
  16385. msgid ""
  16386. "Check for a process with the specified I<pid> (since version 1.17.6). The "
  16387. "I<pid> must be a number greater than 0."
  16388. msgstr ""
  16389. #. type: TP
  16390. #: start-stop-daemon.man:1
  16391. #, no-wrap
  16392. msgid "B<--ppid> I<ppid>"
  16393. msgstr ""
  16394. #. type: Plain text
  16395. #: start-stop-daemon.man:1
  16396. msgid ""
  16397. "Check for a process with the specified parent pid I<ppid> (since version "
  16398. "1.17.7). The I<ppid> must be a number greater than 0."
  16399. msgstr ""
  16400. #. type: TP
  16401. #: start-stop-daemon.man:1
  16402. #, no-wrap
  16403. msgid "B<-p>, B<--pidfile> I<pid-file>"
  16404. msgstr ""
  16405. #. type: Plain text
  16406. #: start-stop-daemon.man:1
  16407. msgid ""
  16408. "Check whether a process has created the file I<pid-file>. Note: using this "
  16409. "matching option alone might cause unintended processes to be acted on, if "
  16410. "the old process terminated without being able to remove the I<pid-file>."
  16411. msgstr ""
  16412. #. type: TP
  16413. #: start-stop-daemon.man:1
  16414. #, no-wrap
  16415. msgid "B<-x>, B<--exec> I<executable>"
  16416. msgstr ""
  16417. #. type: Plain text
  16418. #: start-stop-daemon.man:1
  16419. msgid ""
  16420. "Check for processes that are instances of this I<executable>. The "
  16421. "I<executable> argument should be an absolute pathname. Note: this might not "
  16422. "work as intended with interpreted scripts, as the executable will point to "
  16423. "the interpreter. Take into account processes running from inside a chroot "
  16424. "will also be matched, so other match restrictions might be needed."
  16425. msgstr ""
  16426. #. type: TP
  16427. #: start-stop-daemon.man:1
  16428. #, no-wrap
  16429. msgid "B<-n>, B<--name> I<process-name>"
  16430. msgstr ""
  16431. #. type: Plain text
  16432. #: start-stop-daemon.man:1
  16433. msgid ""
  16434. "Check for processes with the name I<process-name>. The I<process-name> is "
  16435. "usually the process filename, but it could have been changed by the process "
  16436. "itself. Note: on most systems this information is retrieved from the process "
  16437. "comm name from the kernel, which tends to have a relatively short length "
  16438. "limit (assuming more than 15 characters is non-portable)."
  16439. msgstr ""
  16440. #. type: TP
  16441. #: start-stop-daemon.man:1
  16442. #, no-wrap
  16443. msgid "B<-u>, B<--user> I<username>|I<uid>"
  16444. msgstr ""
  16445. #. type: Plain text
  16446. #: start-stop-daemon.man:1
  16447. msgid ""
  16448. "Check for processes owned by the user specified by I<username> or "
  16449. "I<uid>. Note: using this matching option alone will cause all processes "
  16450. "matching the user to be acted on."
  16451. msgstr ""
  16452. #. type: SS
  16453. #: start-stop-daemon.man:1
  16454. #, no-wrap
  16455. msgid "Generic options"
  16456. msgstr ""
  16457. #. type: TP
  16458. #: start-stop-daemon.man:1
  16459. #, no-wrap
  16460. msgid "B<-g>, B<--group> I<group>|I<gid>"
  16461. msgstr ""
  16462. #. type: Plain text
  16463. #: start-stop-daemon.man:1
  16464. msgid "Change to I<group> or I<gid> when starting the process."
  16465. msgstr ""
  16466. #. type: TP
  16467. #: start-stop-daemon.man:1
  16468. #, no-wrap
  16469. msgid "B<-s>, B<--signal> I<signal>"
  16470. msgstr ""
  16471. #. type: Plain text
  16472. #: start-stop-daemon.man:1
  16473. msgid ""
  16474. "With B<--stop>, specifies the signal to send to processes being stopped "
  16475. "(default TERM)."
  16476. msgstr ""
  16477. #. type: TP
  16478. #: start-stop-daemon.man:1
  16479. #, no-wrap
  16480. msgid "B<-R>, B<--retry> I<timeout>|I<schedule>"
  16481. msgstr ""
  16482. #. type: Plain text
  16483. #: start-stop-daemon.man:1
  16484. msgid ""
  16485. "With B<--stop>, specifies that B<start-stop-daemon> is to check whether the "
  16486. "process(es) do finish. It will check repeatedly whether any matching "
  16487. "processes are running, until none are. If the processes do not exit it will "
  16488. "then take further action as determined by the schedule."
  16489. msgstr ""
  16490. #. type: Plain text
  16491. #: start-stop-daemon.man:1
  16492. msgid ""
  16493. "If I<timeout> is specified instead of I<schedule>, then the schedule "
  16494. "I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the "
  16495. "signal specified with B<--signal>."
  16496. msgstr ""
  16497. #. type: Plain text
  16498. #: start-stop-daemon.man:1
  16499. msgid ""
  16500. "I<schedule> is a list of at least two items separated by slashes (B</>); "
  16501. "each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means "
  16502. "to send that signal, or I<timeout>, which means to wait that many seconds "
  16503. "for processes to exit, or B<forever>, which means to repeat the rest of the "
  16504. "schedule forever if necessary."
  16505. msgstr ""
  16506. #. type: Plain text
  16507. #: start-stop-daemon.man:1
  16508. msgid ""
  16509. "If the end of the schedule is reached and B<forever> is not specified, then "
  16510. "B<start-stop-daemon> exits with error status 2. If a schedule is specified, "
  16511. "then any signal specified with B<--signal> is ignored."
  16512. msgstr ""
  16513. #. type: TP
  16514. #: start-stop-daemon.man:1
  16515. #, no-wrap
  16516. msgid "B<-a>, B<--startas> I<pathname>"
  16517. msgstr ""
  16518. #. type: Plain text
  16519. #: start-stop-daemon.man:1
  16520. msgid ""
  16521. "With B<--start>, start the process specified by I<pathname>. If not "
  16522. "specified, defaults to the argument given to B<--exec>."
  16523. msgstr ""
  16524. #. type: TP
  16525. #: start-stop-daemon.man:1
  16526. #, no-wrap
  16527. msgid "B<-t>, B<--test>"
  16528. msgstr ""
  16529. #. type: Plain text
  16530. #: start-stop-daemon.man:1
  16531. msgid ""
  16532. "Print actions that would be taken and set appropriate return value, but take "
  16533. "no action."
  16534. msgstr ""
  16535. #. type: TP
  16536. #: start-stop-daemon.man:1
  16537. #, no-wrap
  16538. msgid "B<-o>, B<--oknodo>"
  16539. msgstr ""
  16540. #. type: Plain text
  16541. #: start-stop-daemon.man:1
  16542. msgid "Return exit status 0 instead of 1 if no actions are (would be) taken."
  16543. msgstr ""
  16544. #. type: TP
  16545. #: start-stop-daemon.man:1
  16546. #, no-wrap
  16547. msgid "B<-q>, B<--quiet>"
  16548. msgstr ""
  16549. #. type: Plain text
  16550. #: start-stop-daemon.man:1
  16551. msgid "Do not print informational messages; only display error messages."
  16552. msgstr ""
  16553. #. type: TP
  16554. #: start-stop-daemon.man:1
  16555. #, no-wrap
  16556. msgid "B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]"
  16557. msgstr ""
  16558. #. type: Plain text
  16559. #: start-stop-daemon.man:1
  16560. msgid ""
  16561. "Change to this username/uid before starting the process. You can also "
  16562. "specify a group by appending a B<:>, then the group or gid in the same way "
  16563. "as you would for the B<chown>(1) command (I<user>B<:>I<group>). If a user "
  16564. "is specified without a group, the primary GID for that user is used. When "
  16565. "using this option you must realize that the primary and supplemental groups "
  16566. "are set as well, even if the B<--group> option is not specified. The "
  16567. "B<--group> option is only for groups that the user isn't normally a member "
  16568. "of (like adding per process group membership for generic users like "
  16569. "B<nobody>)."
  16570. msgstr ""
  16571. #. type: TP
  16572. #: start-stop-daemon.man:1
  16573. #, no-wrap
  16574. msgid "B<-r>, B<--chroot> I<root>"
  16575. msgstr ""
  16576. #. type: Plain text
  16577. #: start-stop-daemon.man:1
  16578. msgid ""
  16579. "Chdir and chroot to I<root> before starting the process. Please note that "
  16580. "the pidfile is also written after the chroot."
  16581. msgstr ""
  16582. #. type: TP
  16583. #: start-stop-daemon.man:1
  16584. #, no-wrap
  16585. msgid "B<-d>, B<--chdir> I<path>"
  16586. msgstr ""
  16587. #. type: Plain text
  16588. #: start-stop-daemon.man:1
  16589. msgid ""
  16590. "Chdir to I<path> before starting the process. This is done after the chroot "
  16591. "if the B<-r>|B<--chroot> option is set. When not specified, "
  16592. "B<start-stop-daemon> will chdir to the root directory before starting the "
  16593. "process."
  16594. msgstr ""
  16595. #. type: TP
  16596. #: start-stop-daemon.man:1
  16597. #, no-wrap
  16598. msgid "B<-b>, B<--background>"
  16599. msgstr ""
  16600. #. type: Plain text
  16601. #: start-stop-daemon.man:1
  16602. msgid ""
  16603. "Typically used with programs that don't detach on their own. This option "
  16604. "will force B<start-stop-daemon> to fork before starting the process, and "
  16605. "force it into the background. B<Warning: start-stop-daemon> cannot check "
  16606. "the exit status if the process fails to execute for B<any> reason. This is a "
  16607. "last resort, and is only meant for programs that either make no sense "
  16608. "forking on their own, or where it's not feasible to add the code for them to "
  16609. "do this themselves."
  16610. msgstr ""
  16611. #. type: TP
  16612. #: start-stop-daemon.man:1
  16613. #, no-wrap
  16614. msgid "B<-C>, B<--no-close>"
  16615. msgstr ""
  16616. #. type: Plain text
  16617. #: start-stop-daemon.man:1
  16618. msgid ""
  16619. "Do not close any file descriptor when forcing the daemon into the background "
  16620. "(since version 1.16.5). Used for debugging purposes to see the process "
  16621. "output, or to redirect file descriptors to log the process output. Only "
  16622. "relevant when using B<--background>."
  16623. msgstr ""
  16624. #. type: TP
  16625. #: start-stop-daemon.man:1
  16626. #, no-wrap
  16627. msgid "B<-N>, B<--nicelevel> I<int>"
  16628. msgstr ""
  16629. #. type: Plain text
  16630. #: start-stop-daemon.man:1
  16631. msgid "This alters the priority of the process before starting it."
  16632. msgstr ""
  16633. #. type: TP
  16634. #: start-stop-daemon.man:1
  16635. #, no-wrap
  16636. msgid "B<-P>, B<--procsched> I<policy>B<:>I<priority>"
  16637. msgstr ""
  16638. #. type: Plain text
  16639. #: start-stop-daemon.man:1
  16640. msgid ""
  16641. "This alters the process scheduler policy and priority of the process before "
  16642. "starting it (since version 1.15.0). The priority can be optionally "
  16643. "specified by appending a B<:> followed by the value. The default I<priority> "
  16644. "is 0. The currently supported policy values are B<other>, B<fifo> and B<rr>."
  16645. msgstr ""
  16646. #. type: TP
  16647. #: start-stop-daemon.man:1
  16648. #, no-wrap
  16649. msgid "B<-I>, B<--iosched> I<class>B<:>I<priority>"
  16650. msgstr ""
  16651. #. type: Plain text
  16652. #: start-stop-daemon.man:1
  16653. msgid ""
  16654. "This alters the IO scheduler class and priority of the process before "
  16655. "starting it (since version 1.15.0). The priority can be optionally "
  16656. "specified by appending a B<:> followed by the value. The default I<priority> "
  16657. "is 4, unless I<class> is B<idle>, then I<priority> will always be 7. The "
  16658. "currently supported values for I<class> are B<idle>, B<best-effort> and "
  16659. "B<real-time>."
  16660. msgstr ""
  16661. #. type: TP
  16662. #: start-stop-daemon.man:1
  16663. #, no-wrap
  16664. msgid "B<-k>, B<--umask> I<mask>"
  16665. msgstr ""
  16666. #. type: Plain text
  16667. #: start-stop-daemon.man:1
  16668. msgid ""
  16669. "This sets the umask of the process before starting it (since version "
  16670. "1.13.22)."
  16671. msgstr ""
  16672. #. type: TP
  16673. #: start-stop-daemon.man:1
  16674. #, no-wrap
  16675. msgid "B<-m>, B<--make-pidfile>"
  16676. msgstr ""
  16677. #. type: Plain text
  16678. #: start-stop-daemon.man:1
  16679. msgid ""
  16680. "Used when starting a program that does not create its own pid file. This "
  16681. "option will make B<start-stop-daemon> create the file referenced with "
  16682. "B<--pidfile> and place the pid into it just before executing the "
  16683. "process. Note, the file will only be removed when stopping the program if "
  16684. "B<--remove-pidfile> is used. B<Note:> This feature may not work in all "
  16685. "cases. Most notably when the program being executed forks from its main "
  16686. "process. Because of this, it is usually only useful when combined with the "
  16687. "B<--background> option."
  16688. msgstr ""
  16689. #. type: TP
  16690. #: start-stop-daemon.man:1
  16691. #, no-wrap
  16692. msgid "B<--remove-pidfile>"
  16693. msgstr ""
  16694. #. type: Plain text
  16695. #: start-stop-daemon.man:1
  16696. msgid ""
  16697. "Used when stopping a program that does not remove its own pid file (since "
  16698. "version 1.17.19). This option will make B<start-stop-daemon> remove the "
  16699. "file referenced with B<--pidfile> after terminating the process."
  16700. msgstr ""
  16701. #. type: Plain text
  16702. #: start-stop-daemon.man:1
  16703. msgid "Print verbose informational messages."
  16704. msgstr ""
  16705. #. type: Plain text
  16706. #: start-stop-daemon.man:1
  16707. msgid ""
  16708. "The requested action was performed. If B<--oknodo> was specified, it's also "
  16709. "possible that nothing had to be done. This can happen when B<--start> was "
  16710. "specified and a matching process was already running, or when B<--stop> was "
  16711. "specified and there were no matching processes."
  16712. msgstr ""
  16713. #. type: Plain text
  16714. #: start-stop-daemon.man:1
  16715. msgid "If B<--oknodo> was not specified and nothing was done."
  16716. msgstr ""
  16717. #. type: Plain text
  16718. #: start-stop-daemon.man:1
  16719. msgid ""
  16720. "If B<--stop> and B<--retry> were specified, but the end of the schedule was "
  16721. "reached and the processes were still running."
  16722. msgstr ""
  16723. #. type: TP
  16724. #: start-stop-daemon.man:1 start-stop-daemon.man:1
  16725. #, no-wrap
  16726. msgid "B<3>"
  16727. msgstr ""
  16728. #. type: Plain text
  16729. #: start-stop-daemon.man:1
  16730. msgid "Any other error."
  16731. msgstr ""
  16732. #. type: Plain text
  16733. #: start-stop-daemon.man:1
  16734. msgid "When using the B<--status> command, the following status codes are returned:"
  16735. msgstr ""
  16736. #. type: Plain text
  16737. #: start-stop-daemon.man:1
  16738. msgid "Program is running."
  16739. msgstr ""
  16740. #. type: Plain text
  16741. #: start-stop-daemon.man:1
  16742. msgid "Program is not running and the pid file exists."
  16743. msgstr ""
  16744. #. type: Plain text
  16745. #: start-stop-daemon.man:1
  16746. msgid "Program is not running."
  16747. msgstr ""
  16748. #. type: TP
  16749. #: start-stop-daemon.man:1
  16750. #, no-wrap
  16751. msgid "B<4>"
  16752. msgstr ""
  16753. #. type: Plain text
  16754. #: start-stop-daemon.man:1
  16755. msgid "Unable to determine program status."
  16756. msgstr ""
  16757. #. type: Plain text
  16758. #: start-stop-daemon.man:1
  16759. msgid ""
  16760. "Start the B<food> daemon, unless one is already running (a process named "
  16761. "food, running as user food, with pid in food.pid):"
  16762. msgstr ""
  16763. #. type: Plain text
  16764. #: start-stop-daemon.man:1
  16765. #, no-wrap
  16766. msgid ""
  16767. "start-stop-daemon --start --oknodo --user food --name food \\e\n"
  16768. "\t--pidfile /run/food.pid --startas /usr/sbin/food \\e\n"
  16769. "\t--chuid food -- --daemon\n"
  16770. msgstr ""
  16771. #. type: Plain text
  16772. #: start-stop-daemon.man:1
  16773. msgid "Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:"
  16774. msgstr ""
  16775. #. type: Plain text
  16776. #: start-stop-daemon.man:1
  16777. #, no-wrap
  16778. msgid ""
  16779. "start-stop-daemon --stop --oknodo --user food --name food \\e\n"
  16780. "\t--pidfile /run/food.pid --retry 5\n"
  16781. msgstr ""
  16782. #. type: Plain text
  16783. #: start-stop-daemon.man:1
  16784. msgid "Demonstration of a custom schedule for stopping B<food>:"
  16785. msgstr ""
  16786. #. type: Plain text
  16787. #: start-stop-daemon.man:1
  16788. #, no-wrap
  16789. msgid ""
  16790. "start-stop-daemon --stop --oknodo --user food --name food \\e\n"
  16791. "\t--pidfile /run/food.pid --retry=TERM/30/KILL/5\n"
  16792. msgstr ""
  16793. #. type: TH
  16794. #: update-alternatives.man:1
  16795. #, no-wrap
  16796. msgid "update-alternatives"
  16797. msgstr ""
  16798. #. type: Plain text
  16799. #: update-alternatives.man:1
  16800. msgid "update-alternatives - maintain symbolic links determining default commands"
  16801. msgstr ""
  16802. #. type: Plain text
  16803. #: update-alternatives.man:1
  16804. msgid "B<update-alternatives> [I<option>...] I<command>"
  16805. msgstr ""
  16806. #. type: Plain text
  16807. #: update-alternatives.man:1
  16808. msgid ""
  16809. "B<update-alternatives> creates, removes, maintains and displays information "
  16810. "about the symbolic links comprising the Debian alternatives system."
  16811. msgstr ""
  16812. #. type: Plain text
  16813. #: update-alternatives.man:1
  16814. msgid ""
  16815. "It is possible for several programs fulfilling the same or similar functions "
  16816. "to be installed on a single system at the same time. For example, many "
  16817. "systems have several text editors installed at once. This gives choice to "
  16818. "the users of a system, allowing each to use a different editor, if desired, "
  16819. "but makes it difficult for a program to make a good choice for an editor to "
  16820. "invoke if the user has not specified a particular preference."
  16821. msgstr ""
  16822. #. type: Plain text
  16823. #: update-alternatives.man:1
  16824. msgid ""
  16825. "Debian's alternatives system aims to solve this problem. A generic name in "
  16826. "the filesystem is shared by all files providing interchangeable "
  16827. "functionality. The alternatives system and the system administrator "
  16828. "together determine which actual file is referenced by this generic name. "
  16829. "For example, if the text editors B<ed>(1) and B<nvi>(1) are both installed "
  16830. "on the system, the alternatives system will cause the generic name "
  16831. "I</usr/bin/editor> to refer to I</usr/bin/nvi> by default. The system "
  16832. "administrator can override this and cause it to refer to I</usr/bin/ed> "
  16833. "instead, and the alternatives system will not alter this setting until "
  16834. "explicitly requested to do so."
  16835. msgstr ""
  16836. #. type: Plain text
  16837. #: update-alternatives.man:1
  16838. msgid ""
  16839. "The generic name is not a direct symbolic link to the selected alternative. "
  16840. "Instead, it is a symbolic link to a name in the I<alternatives> "
  16841. "I<directory>, which in turn is a symbolic link to the actual file "
  16842. "referenced. This is done so that the system administrator's changes can be "
  16843. "confined within the I<%CONFDIR%> directory: the FHS (q.v.) gives reasons why "
  16844. "this is a Good Thing."
  16845. msgstr ""
  16846. #. type: Plain text
  16847. #: update-alternatives.man:1
  16848. msgid ""
  16849. "When each package providing a file with a particular functionality is "
  16850. "installed, changed or removed, B<update-alternatives> is called to update "
  16851. "information about that file in the alternatives system. "
  16852. "B<update-alternatives> is usually called from the B<postinst> (configure) or "
  16853. "B<prerm> (remove and deconfigure) scripts in Debian packages."
  16854. msgstr ""
  16855. #. type: Plain text
  16856. #: update-alternatives.man:1
  16857. msgid ""
  16858. "It is often useful for a number of alternatives to be synchronized, so that "
  16859. "they are changed as a group; for example, when several versions of the "
  16860. "B<vi>(1) editor are installed, the man page referenced by "
  16861. "I</usr/share/man/man1/vi.1> should correspond to the executable referenced "
  16862. "by I</usr/bin/vi>. B<update-alternatives> handles this by means of "
  16863. "I<master> and I<slave> links; when the master is changed, any associated "
  16864. "slaves are changed too. A master link and its associated slaves make up a "
  16865. "I<link> I<group>."
  16866. msgstr ""
  16867. #. type: Plain text
  16868. #: update-alternatives.man:1
  16869. msgid ""
  16870. "Each link group is, at any given time, in one of two modes: automatic or "
  16871. "manual. When a group is in automatic mode, the alternatives system will "
  16872. "automatically decide, as packages are installed and removed, whether and how "
  16873. "to update the links. In manual mode, the alternatives system will retain "
  16874. "the choice of the administrator and avoid changing the links (except when "
  16875. "something is broken)."
  16876. msgstr ""
  16877. #. type: Plain text
  16878. #: update-alternatives.man:1
  16879. msgid ""
  16880. "Link groups are in automatic mode when they are first introduced to the "
  16881. "system. If the system administrator makes changes to the system's automatic "
  16882. "settings, this will be noticed the next time B<update-alternatives> is run "
  16883. "on the changed link's group, and the group will automatically be switched to "
  16884. "manual mode."
  16885. msgstr ""
  16886. #. type: Plain text
  16887. #: update-alternatives.man:1
  16888. msgid ""
  16889. "Each alternative has a I<priority> associated with it. When a link group is "
  16890. "in automatic mode, the alternatives pointed to by members of the group will "
  16891. "be those which have the highest priority."
  16892. msgstr ""
  16893. #. type: Plain text
  16894. #: update-alternatives.man:1
  16895. msgid ""
  16896. "When using the B<--config> option, B<update-alternatives> will list all of "
  16897. "the choices for the link group of which given I<name> is the master "
  16898. "alternative name. The current choice is marked with a ‘*’. You will then "
  16899. "be prompted for your choice regarding this link group. Depending on the "
  16900. "choice made, the link group might no longer be in I<auto> mode. You will "
  16901. "need to use the B<--auto> option in order to return to the automatic mode "
  16902. "(or you can rerun B<--config> and select the entry marked as automatic)."
  16903. msgstr ""
  16904. #. type: Plain text
  16905. #: update-alternatives.man:1
  16906. msgid ""
  16907. "If you want to configure non-interactively you can use the B<--set> option "
  16908. "instead (see below)."
  16909. msgstr ""
  16910. #. type: Plain text
  16911. #: update-alternatives.man:1
  16912. msgid ""
  16913. "Different packages providing the same file need to do so B<cooperatively>. "
  16914. "In other words, the usage of B<update-alternatives> is B<mandatory> for all "
  16915. "involved packages in such case. It is not possible to override some file in "
  16916. "a package that does not employ the B<update-alternatives> mechanism."
  16917. msgstr ""
  16918. #. type: SH
  16919. #: update-alternatives.man:1
  16920. #, no-wrap
  16921. msgid "TERMINOLOGY"
  16922. msgstr ""
  16923. #. type: Plain text
  16924. #: update-alternatives.man:1
  16925. msgid ""
  16926. "Since the activities of B<update-alternatives> are quite involved, some "
  16927. "specific terms will help to explain its operation."
  16928. msgstr ""
  16929. #. type: TP
  16930. #: update-alternatives.man:1
  16931. #, no-wrap
  16932. msgid "generic name (or alternative link)"
  16933. msgstr ""
  16934. #. type: Plain text
  16935. #: update-alternatives.man:1
  16936. msgid ""
  16937. "A name, like I</usr/bin/editor>, which refers, via the alternatives system, "
  16938. "to one of a number of files of similar function."
  16939. msgstr ""
  16940. #. type: TP
  16941. #: update-alternatives.man:1
  16942. #, no-wrap
  16943. msgid "alternative name"
  16944. msgstr ""
  16945. #. type: Plain text
  16946. #: update-alternatives.man:1
  16947. msgid "The name of a symbolic link in the alternatives directory."
  16948. msgstr ""
  16949. #. type: TP
  16950. #: update-alternatives.man:1
  16951. #, no-wrap
  16952. msgid "alternative (or alternative path)"
  16953. msgstr ""
  16954. #. type: Plain text
  16955. #: update-alternatives.man:1
  16956. msgid ""
  16957. "The name of a specific file in the filesystem, which may be made accessible "
  16958. "via a generic name using the alternatives system."
  16959. msgstr ""
  16960. #. type: TP
  16961. #: update-alternatives.man:1
  16962. #, no-wrap
  16963. msgid "alternatives directory"
  16964. msgstr ""
  16965. #. type: Plain text
  16966. #: update-alternatives.man:1
  16967. msgid "A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks."
  16968. msgstr ""
  16969. #. type: TP
  16970. #: update-alternatives.man:1
  16971. #, no-wrap
  16972. msgid "administrative directory"
  16973. msgstr ""
  16974. #. type: Plain text
  16975. #: update-alternatives.man:1
  16976. msgid ""
  16977. "A directory, by default I<%ADMINDIR%/alternatives>, containing "
  16978. "B<update-alternatives>' state information."
  16979. msgstr ""
  16980. #. type: TP
  16981. #: update-alternatives.man:1
  16982. #, no-wrap
  16983. msgid "link group"
  16984. msgstr ""
  16985. #. type: Plain text
  16986. #: update-alternatives.man:1
  16987. msgid "A set of related symlinks, intended to be updated as a group."
  16988. msgstr ""
  16989. #. type: TP
  16990. #: update-alternatives.man:1
  16991. #, no-wrap
  16992. msgid "master link"
  16993. msgstr ""
  16994. #. type: Plain text
  16995. #: update-alternatives.man:1
  16996. msgid ""
  16997. "The alternative link in a link group which determines how the other links in "
  16998. "the group are configured."
  16999. msgstr ""
  17000. #. type: TP
  17001. #: update-alternatives.man:1
  17002. #, no-wrap
  17003. msgid "slave link"
  17004. msgstr ""
  17005. #. type: Plain text
  17006. #: update-alternatives.man:1
  17007. msgid ""
  17008. "An alternative link in a link group which is controlled by the setting of "
  17009. "the master link."
  17010. msgstr ""
  17011. #. type: TP
  17012. #: update-alternatives.man:1
  17013. #, no-wrap
  17014. msgid "automatic mode"
  17015. msgstr ""
  17016. #. type: Plain text
  17017. #: update-alternatives.man:1
  17018. msgid ""
  17019. "When a link group is in automatic mode, the alternatives system ensures that "
  17020. "the links in the group point to the highest priority alternative appropriate "
  17021. "for the group."
  17022. msgstr ""
  17023. #. type: TP
  17024. #: update-alternatives.man:1
  17025. #, no-wrap
  17026. msgid "manual mode"
  17027. msgstr ""
  17028. #. type: Plain text
  17029. #: update-alternatives.man:1
  17030. msgid ""
  17031. "When a link group is in manual mode, the alternatives system will not make "
  17032. "any changes to the system administrator's settings."
  17033. msgstr ""
  17034. #. type: TP
  17035. #: update-alternatives.man:1
  17036. #, no-wrap
  17037. msgid "B<--install> I<link name path priority> [B<--slave> I<link name path>]..."
  17038. msgstr ""
  17039. #. type: Plain text
  17040. #: update-alternatives.man:1
  17041. msgid ""
  17042. "Add a group of alternatives to the system. I<link> is the generic name for "
  17043. "the master link, I<name> is the name of its symlink in the alternatives "
  17044. "directory, and I<path> is the alternative being introduced for the master "
  17045. "link. The arguments after B<--slave> are the generic name, symlink name in "
  17046. "the alternatives directory and the alternative path for a slave link. Zero "
  17047. "or more B<--slave> options, each followed by three arguments, may be "
  17048. "specified. Note that the master alternative must exist or the call will "
  17049. "fail. However if a slave alternative doesn't exist, the corresponding slave "
  17050. "alternative link will simply not be installed (a warning will still be "
  17051. "displayed). If some real file is installed where an alternative link has to "
  17052. "be installed, it is kept unless B<--force> is used."
  17053. msgstr ""
  17054. #. type: Plain text
  17055. #: update-alternatives.man:1
  17056. msgid ""
  17057. "If the alternative name specified exists already in the alternatives "
  17058. "system's records, the information supplied will be added as a new set of "
  17059. "alternatives for the group. Otherwise, a new group, set to automatic mode, "
  17060. "will be added with this information. If the group is in automatic mode, and "
  17061. "the newly added alternatives' priority is higher than any other installed "
  17062. "alternatives for this group, the symlinks will be updated to point to the "
  17063. "newly added alternatives."
  17064. msgstr ""
  17065. #. type: TP
  17066. #: update-alternatives.man:1
  17067. #, no-wrap
  17068. msgid "B<--set> I<name path>"
  17069. msgstr ""
  17070. #. type: Plain text
  17071. #: update-alternatives.man:1
  17072. msgid ""
  17073. "Set the program I<path> as alternative for I<name.> This is equivalent to "
  17074. "B<--config> but is non-interactive and thus scriptable."
  17075. msgstr ""
  17076. #. type: TP
  17077. #: update-alternatives.man:1
  17078. #, no-wrap
  17079. msgid "B<--remove> I<name path>"
  17080. msgstr ""
  17081. #. type: Plain text
  17082. #: update-alternatives.man:1
  17083. msgid ""
  17084. "Remove an alternative and all of its associated slave links. I<name> is a "
  17085. "name in the alternatives directory, and I<path> is an absolute filename to "
  17086. "which I<name> could be linked. If I<name> is indeed linked to I<path>, "
  17087. "I<name> will be updated to point to another appropriate alternative (and the "
  17088. "group is put back in automatic mode), or removed if there is no such "
  17089. "alternative left. Associated slave links will be updated or removed, "
  17090. "correspondingly. If the link is not currently pointing to I<path>, no links "
  17091. "are changed; only the information about the alternative is removed."
  17092. msgstr ""
  17093. #. type: TP
  17094. #: update-alternatives.man:1
  17095. #, no-wrap
  17096. msgid "B<--remove-all> I<name>"
  17097. msgstr ""
  17098. #. type: Plain text
  17099. #: update-alternatives.man:1
  17100. msgid ""
  17101. "Remove all alternatives and all of their associated slave links. I<name> is "
  17102. "a name in the alternatives directory."
  17103. msgstr ""
  17104. #. type: Plain text
  17105. #: update-alternatives.man:1
  17106. msgid ""
  17107. "Call B<--config> on all alternatives. It can be usefully combined with "
  17108. "B<--skip-auto> to review and configure all alternatives which are not "
  17109. "configured in automatic mode. Broken alternatives are also displayed. Thus "
  17110. "a simple way to fix all broken alternatives is to call B<yes '' | "
  17111. "update-alternatives --force --all>."
  17112. msgstr ""
  17113. #. type: TP
  17114. #: update-alternatives.man:1
  17115. #, no-wrap
  17116. msgid "B<--auto> I<name>"
  17117. msgstr ""
  17118. #. type: Plain text
  17119. #: update-alternatives.man:1
  17120. msgid ""
  17121. "Switch the link group behind the alternative for I<name> to automatic mode. "
  17122. "In the process, the master symlink and its slaves are updated to point to "
  17123. "the highest priority installed alternatives."
  17124. msgstr ""
  17125. #. type: TP
  17126. #: update-alternatives.man:1
  17127. #, no-wrap
  17128. msgid "B<--display> I<name>"
  17129. msgstr ""
  17130. #. type: Plain text
  17131. #: update-alternatives.man:1
  17132. msgid ""
  17133. "Display information about the link group. Information displayed includes "
  17134. "the group's mode (auto or manual), the master and slave links, which "
  17135. "alternative the master link currently points to, what other alternatives are "
  17136. "available (and their corresponding slave alternatives), and the highest "
  17137. "priority alternative currently installed."
  17138. msgstr ""
  17139. #. type: TP
  17140. #: update-alternatives.man:1
  17141. #, no-wrap
  17142. msgid "B<--get-selections>"
  17143. msgstr ""
  17144. #. type: Plain text
  17145. #: update-alternatives.man:1
  17146. msgid ""
  17147. "List all master alternative names (those controlling a link group) and "
  17148. "their status (since version 1.15.0). Each line contains up to 3 fields "
  17149. "(separated by one or more spaces). The first field is the alternative name, "
  17150. "the second one is the status (either B<auto> or B<manual>), and the last one "
  17151. "contains the current choice in the alternative (beware: it's a filename and "
  17152. "thus might contain spaces)."
  17153. msgstr ""
  17154. #. type: Plain text
  17155. #: update-alternatives.man:1
  17156. msgid ""
  17157. "Read configuration of alternatives on standard input in the format generated "
  17158. "by B<--get-selections> and reconfigure them accordingly (since version "
  17159. "1.15.0)."
  17160. msgstr ""
  17161. #. type: TP
  17162. #: update-alternatives.man:1
  17163. #, no-wrap
  17164. msgid "B<--query> I<name>"
  17165. msgstr ""
  17166. #. type: Plain text
  17167. #: update-alternatives.man:1
  17168. msgid ""
  17169. "Display information about the link group like B<--display> does, but in a "
  17170. "machine parseable way (since version 1.15.0, see section B<QUERY FORMAT> "
  17171. "below)."
  17172. msgstr ""
  17173. #. type: TP
  17174. #: update-alternatives.man:1
  17175. #, no-wrap
  17176. msgid "B<--list> I<name>"
  17177. msgstr ""
  17178. #. type: Plain text
  17179. #: update-alternatives.man:1
  17180. msgid "Display all targets of the link group."
  17181. msgstr ""
  17182. #. type: TP
  17183. #: update-alternatives.man:1
  17184. #, no-wrap
  17185. msgid "B<--config> I<name>"
  17186. msgstr ""
  17187. #. type: Plain text
  17188. #: update-alternatives.man:1
  17189. msgid ""
  17190. "Show available alternatives for a link group and allow the user to "
  17191. "interactively select which one to use. The link group is updated."
  17192. msgstr ""
  17193. #. type: TP
  17194. #: update-alternatives.man:1
  17195. #, no-wrap
  17196. msgid "B<--altdir>I< directory>"
  17197. msgstr ""
  17198. #. type: Plain text
  17199. #: update-alternatives.man:1
  17200. msgid ""
  17201. "Specifies the alternatives directory, when this is to be different from the "
  17202. "default."
  17203. msgstr ""
  17204. #. type: Plain text
  17205. #: update-alternatives.man:1
  17206. msgid ""
  17207. "Specifies the administrative directory, when this is to be different from "
  17208. "the default."
  17209. msgstr ""
  17210. #. type: TP
  17211. #: update-alternatives.man:1
  17212. #, no-wrap
  17213. msgid "B<--log>I< file>"
  17214. msgstr ""
  17215. #. type: Plain text
  17216. #: update-alternatives.man:1
  17217. msgid ""
  17218. "Specifies the log file (since version 1.15.0), when this is to be different "
  17219. "from the default (%LOGDIR%/alternatives.log)."
  17220. msgstr ""
  17221. #. type: Plain text
  17222. #: update-alternatives.man:1
  17223. msgid ""
  17224. "Allow replacing or dropping any real file that is installed where an "
  17225. "alternative link has to be installed or removed."
  17226. msgstr ""
  17227. #. type: TP
  17228. #: update-alternatives.man:1
  17229. #, no-wrap
  17230. msgid "B<--skip-auto>"
  17231. msgstr ""
  17232. #. type: Plain text
  17233. #: update-alternatives.man:1
  17234. msgid ""
  17235. "Skip configuration prompt for alternatives which are properly configured in "
  17236. "automatic mode. This option is only relevant with B<--config> or B<--all>."
  17237. msgstr ""
  17238. #. type: TP
  17239. #: update-alternatives.man:1
  17240. #, no-wrap
  17241. msgid "B<--verbose>"
  17242. msgstr ""
  17243. #. type: Plain text
  17244. #: update-alternatives.man:1
  17245. msgid "Generate more comments about what is being done."
  17246. msgstr ""
  17247. #. type: Plain text
  17248. #: update-alternatives.man:1
  17249. msgid "Don't generate any comments unless errors occur."
  17250. msgstr ""
  17251. #. type: Plain text
  17252. #: update-alternatives.man:1
  17253. msgid ""
  17254. "Problems were encountered whilst parsing the command line or performing the "
  17255. "action."
  17256. msgstr ""
  17257. #. type: Plain text
  17258. #: update-alternatives.man:1
  17259. msgid ""
  17260. "If set and the B<--admindir> option has not been specified, it will be used "
  17261. "as the base administrative directory."
  17262. msgstr ""
  17263. #. type: TP
  17264. #: update-alternatives.man:1
  17265. #, no-wrap
  17266. msgid "I<%CONFDIR%/alternatives/>"
  17267. msgstr ""
  17268. #. type: Plain text
  17269. #: update-alternatives.man:1
  17270. msgid ""
  17271. "The default alternatives directory. Can be overridden by the B<--altdir> "
  17272. "option."
  17273. msgstr ""
  17274. #. type: TP
  17275. #: update-alternatives.man:1
  17276. #, no-wrap
  17277. msgid "I<%ADMINDIR%/alternatives/>"
  17278. msgstr ""
  17279. #. type: Plain text
  17280. #: update-alternatives.man:1
  17281. msgid ""
  17282. "The default administration directory. Can be overridden by the "
  17283. "B<--admindir> option."
  17284. msgstr ""
  17285. #. type: SH
  17286. #: update-alternatives.man:1
  17287. #, no-wrap
  17288. msgid "QUERY FORMAT"
  17289. msgstr ""
  17290. #. type: Plain text
  17291. #: update-alternatives.man:1
  17292. msgid ""
  17293. "The B<--query> format is using an RFC822-like flat format. It's made of I<n> "
  17294. "+ 1 blocks where I<n> is the number of alternatives available in the queried "
  17295. "link group. The first block contains the following fields:"
  17296. msgstr ""
  17297. #. type: TP
  17298. #: update-alternatives.man:1
  17299. #, no-wrap
  17300. msgid "B<Name:>I< name>"
  17301. msgstr ""
  17302. #. type: Plain text
  17303. #: update-alternatives.man:1
  17304. msgid "The alternative name in the alternative directory."
  17305. msgstr ""
  17306. #. type: TP
  17307. #: update-alternatives.man:1
  17308. #, no-wrap
  17309. msgid "B<Link:>I< link>"
  17310. msgstr ""
  17311. #. type: Plain text
  17312. #: update-alternatives.man:1
  17313. msgid "The generic name of the alternative."
  17314. msgstr ""
  17315. #. type: TP
  17316. #: update-alternatives.man:1 update-alternatives.man:1
  17317. #, no-wrap
  17318. msgid "B<Slaves:>I< list-of-slaves>"
  17319. msgstr ""
  17320. #. type: Plain text
  17321. #: update-alternatives.man:1
  17322. msgid ""
  17323. "When this field is present, the B<next> lines hold all slave links "
  17324. "associated to the master link of the alternative. There is one slave per "
  17325. "line. Each line contains one space, the generic name of the slave "
  17326. "alternative, another space, and the path to the slave link."
  17327. msgstr ""
  17328. #. type: TP
  17329. #: update-alternatives.man:1
  17330. #, no-wrap
  17331. msgid "B<Status:>I< status>"
  17332. msgstr ""
  17333. #. type: Plain text
  17334. #: update-alternatives.man:1
  17335. msgid "The status of the alternative (B<auto> or B<manual>)."
  17336. msgstr ""
  17337. #. type: TP
  17338. #: update-alternatives.man:1
  17339. #, no-wrap
  17340. msgid "B<Best:>I< best-choice>"
  17341. msgstr ""
  17342. #. type: Plain text
  17343. #: update-alternatives.man:1
  17344. msgid ""
  17345. "The path of the best alternative for this link group. Not present if there "
  17346. "is no alternatives available."
  17347. msgstr ""
  17348. #. type: TP
  17349. #: update-alternatives.man:1
  17350. #, no-wrap
  17351. msgid "B<Value:>I< currently-selected-alternative>"
  17352. msgstr ""
  17353. #. type: Plain text
  17354. #: update-alternatives.man:1
  17355. msgid ""
  17356. "The path of the currently selected alternative. It can also take the magic "
  17357. "value B<none>. It is used if the link doesn't exist."
  17358. msgstr ""
  17359. #. type: Plain text
  17360. #: update-alternatives.man:1
  17361. msgid ""
  17362. "The other blocks describe the available alternatives in the queried link "
  17363. "group:"
  17364. msgstr ""
  17365. #. type: TP
  17366. #: update-alternatives.man:1
  17367. #, no-wrap
  17368. msgid "B<Alternative:>I< path-of-this-alternative>"
  17369. msgstr ""
  17370. #. type: Plain text
  17371. #: update-alternatives.man:1
  17372. msgid "Path to this block's alternative."
  17373. msgstr ""
  17374. #. type: TP
  17375. #: update-alternatives.man:1
  17376. #, no-wrap
  17377. msgid "B<Priority:>I< priority-value>"
  17378. msgstr ""
  17379. #. type: Plain text
  17380. #: update-alternatives.man:1
  17381. msgid "Value of the priority of this alternative."
  17382. msgstr ""
  17383. #. type: Plain text
  17384. #: update-alternatives.man:1
  17385. msgid ""
  17386. "When this field is present, the B<next> lines hold all slave alternatives "
  17387. "associated to the master link of the alternative. There is one slave per "
  17388. "line. Each line contains one space, the generic name of the slave "
  17389. "alternative, another space, and the path to the slave alternative."
  17390. msgstr ""
  17391. #. type: SS
  17392. #: update-alternatives.man:1
  17393. #, no-wrap
  17394. msgid "Example"
  17395. msgstr ""
  17396. #. type: Plain text
  17397. #: update-alternatives.man:1
  17398. #, no-wrap
  17399. msgid ""
  17400. "$ update-alternatives --query editor\n"
  17401. "Name: editor\n"
  17402. "Link: /usr/bin/editor\n"
  17403. "Slaves:\n"
  17404. " editor.1.gz /usr/share/man/man1/editor.1.gz\n"
  17405. " editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz\n"
  17406. " editor.it.1.gz /usr/share/man/it/man1/editor.1.gz\n"
  17407. " editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz\n"
  17408. " editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz\n"
  17409. "Status: auto\n"
  17410. "Best: /usr/bin/vim.basic\n"
  17411. "Value: /usr/bin/vim.basic\n"
  17412. msgstr ""
  17413. #. type: Plain text
  17414. #: update-alternatives.man:1
  17415. #, no-wrap
  17416. msgid ""
  17417. "Alternative: /bin/ed\n"
  17418. "Priority: -100\n"
  17419. "Slaves:\n"
  17420. " editor.1.gz /usr/share/man/man1/ed.1.gz\n"
  17421. msgstr ""
  17422. #. type: Plain text
  17423. #: update-alternatives.man:1
  17424. #, no-wrap
  17425. msgid ""
  17426. "Alternative: /usr/bin/vim.basic\n"
  17427. "Priority: 50\n"
  17428. "Slaves:\n"
  17429. " editor.1.gz /usr/share/man/man1/vim.1.gz\n"
  17430. " editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz\n"
  17431. " editor.it.1.gz /usr/share/man/it/man1/vim.1.gz\n"
  17432. " editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz\n"
  17433. " editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz\n"
  17434. msgstr ""
  17435. #. type: Plain text
  17436. #: update-alternatives.man:1
  17437. msgid ""
  17438. "With B<--verbose> B<update-alternatives> chatters incessantly about its "
  17439. "activities on its standard output channel. If problems occur, "
  17440. "B<update-alternatives> outputs error messages on its standard error channel "
  17441. "and returns an exit status of 2. These diagnostics should be "
  17442. "self-explanatory; if you do not find them so, please report this as a bug."
  17443. msgstr ""
  17444. #. type: Plain text
  17445. #: update-alternatives.man:1
  17446. msgid ""
  17447. "There are several packages which provide a text editor compatible with "
  17448. "B<vi>, for example B<nvi> and B<vim>. Which one is used is controlled by the "
  17449. "link group B<vi>, which includes links for the program itself and the "
  17450. "associated manpage."
  17451. msgstr ""
  17452. #. type: Plain text
  17453. #: update-alternatives.man:1
  17454. msgid ""
  17455. "To display the available packages which provide B<vi> and the current "
  17456. "setting for it, use the B<--display> action:"
  17457. msgstr ""
  17458. #. type: Plain text
  17459. #: update-alternatives.man:1
  17460. msgid "B<update-alternatives --display vi>"
  17461. msgstr ""
  17462. #. type: Plain text
  17463. #: update-alternatives.man:1
  17464. msgid ""
  17465. "To choose a particular B<vi> implementation, use this command as root and "
  17466. "then select a number from the list:"
  17467. msgstr ""
  17468. #. type: Plain text
  17469. #: update-alternatives.man:1
  17470. msgid "B<update-alternatives --config vi>"
  17471. msgstr ""
  17472. #. type: Plain text
  17473. #: update-alternatives.man:1
  17474. msgid ""
  17475. "To go back to having the B<vi> implementation chosen automatically, do this "
  17476. "as root:"
  17477. msgstr ""
  17478. #. type: Plain text
  17479. #: update-alternatives.man:1
  17480. msgid "B<update-alternatives --auto vi>"
  17481. msgstr ""
  17482. #. type: Plain text
  17483. #: update-alternatives.man:1
  17484. msgid "B<ln>(1), FHS, the Filesystem Hierarchy Standard."
  17485. msgstr ""