Search.setIndex({docnames:["basics","dependencies","deprecation","ebuild-format","filesystem","index","installed-files","keywords","languages","maintainer","motivation","other-docs","other-metadata","preface","use-flags","user-group"],envversion:{"sphinx.domains.c":1,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":1,"sphinx.domains.index":1,"sphinx.domains.javascript":1,"sphinx.domains.math":2,"sphinx.domains.python":1,"sphinx.domains.rst":1,"sphinx.domains.std":1,"sphinx.ext.todo":2,sphinx:56},filenames:["basics.rst","dependencies.rst","deprecation.rst","ebuild-format.rst","filesystem.rst","index.rst","installed-files.rst","keywords.rst","languages.rst","maintainer.rst","motivation.rst","other-docs.rst","other-metadata.rst","preface.rst","use-flags.rst","user-group.rst"],objects:{},objnames:{},objtypes:{},terms:{"08gentoo":4,"2fuse":12,"80librari":4,"80multilib":4,"83cc5bbd7bbe8bdf04dd3c3bc7f8a035":12,"9cae3a92412a007febe7ac0612d50f5f":1,"break":[3,8],"case":[0,4,5,7,12],"class":0,"default":[1,6],"final":[0,10,11],"function":[0,3,4,8],"g\u00f3rny":13,"import":[1,8,12,15],"long":[1,7,8,12],"micha\u0142":13,"new":[2,4,5,8,10,14,15],"public":1,"static":[5,12],"switch":14,"true":15,"try":[0,3,9],"var":4,"while":[0,1,3,6,12],Adding:5,FHS:5,For:[1,4,9],Its:[0,10],PMS:[1,10,11,12],Such:[6,12],The:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,15],There:[1,6,9,10],USE:[5,6],Use:3,Using:1,With:4,abi:[1,4],abil:[3,10,12],abolish:0,about:12,absolut:5,accept:[1,4,12,15],access:4,accident:8,accord:1,account:[1,3,5],acct:15,achiev:0,across:[0,10],action:0,activ:11,actual:9,add:[3,9],added:[4,6,9],adding:[1,9,15],addit:[3,4,6,10,11],addition:0,address:10,adjust:14,adopt:15,advantag:[3,14],affect:[0,3,7,12],aforement:[4,10],after:[0,1,4],afterward:14,against:[0,3,10,12],agre:9,aid:15,aim:[0,1,5,9,13,14],align:3,all:[0,1,3,5,6,7,8,9,10,11,12,13,14,15],alloc:15,allow:[3,12],along:[4,10],alreadi:[1,4,8,12],also:[0,8,10,14],alter:12,alwai:[3,4],amd64:4,amount:10,analyz:0,ani:[1,3,6,9,10,11,12,14],anoth:[1,4,12],anymor:[4,7],anywher:12,api:1,app:6,appeal:5,append:3,appli:[0,1,7,9,10,11],applic:[1,4,6,10,11,12],appropri:[4,12],approv:[1,11,15],arbitrari:15,arch:[3,7],architectur:[0,4,7],archiv:[1,6,12,14],area:0,argu:1,aris:[10,14,15],ask:[0,7],assign:[9,15],assum:[1,14],assumpt:12,attempt:[3,6,10,14],attribut:13,author:5,autom:0,autotool:6,avail:[1,10,12,14],avoid:[3,6],awar:9,backup:9,bad:[1,4,12],base:6,baselayout:15,bash:[3,6],basic:[5,11],becom:[1,5,9,13],been:[1,4,6,12,14,15],befor:[0,7,14,15],behavior:[0,1,6,12],being:[1,6,7,8,9,12],besid:11,better:[8,10],between:[4,8,12,14,15],bin:4,binari:12,bind:[5,10,13],bit:4,blurri:4,bodi:[0,5,10,13],boot:4,both:[0,3,5,6,8,13,14],boundari:4,bracket:3,breakag:[1,7],broken:4,brought:6,browser:4,bug:[3,7,9,12,15],build:[0,1,4,6,8,12,14],builtin:3,bump:[2,5,15],bundl:12,burden:9,cach:12,call:[1,8],can:[0,1,4,5,7,10,11,12,13,14,15],care:9,categori:6,caus:[1,6,7,8,12,14],cf3f5a59ac918335766632bd02438722:14,chanc:[8,9],chang:[3,5,8,11],check:[1,4,5],choic:[3,14],choos:[12,14],chosen:15,chost:4,circumst:[1,12],claim:1,clarifi:4,clean:1,clear:[5,10,13,14],close:7,code:[0,1,5,8,12],collect:10,collis:15,combin:[0,5,10,12,13],comment:9,commit:0,common:[1,3,12,13],compar:9,compat:[4,8],compil:0,complet:[6,10,12],compli:11,complianc:5,compon:0,concept:0,concis:10,condit:[3,12],conf:2,config:6,conform:[10,11],confus:[3,7,14],consent:9,consequ:6,consid:[6,12,14],consist:[0,3,8,14],construct:3,contact:0,contain:[5,9,11,14],content:[3,5],context:6,contrari:12,contribut:0,control:[1,4,6,12,14],controlled_optional_rdepend:1,convert:[3,14],copi:3,correct:[1,4,12],correctli:[0,3,4],correspond:[1,4],cost:[6,8],could:[6,9,12],council:[0,1,2,4,5,10,11,13,14],cover:12,creat:[0,4,10,11,14,15],creativ:13,cross:15,ctarget:4,cumbersom:1,current:[0,2,4,5,9,13],dai:7,data:4,debat:1,decid:[1,12],decis:[0,10],declar:12,dedic:[9,12],defer:8,defici:10,defin:[1,5,8,11,14],definit:[5,13],delai:[8,15],depclean:12,depend:[3,5,6,7,8,12,14],dependent_slot:12,deprec:[5,15],deriv:12,design:[3,5,13],desir:15,detail:11,detect:[0,1],dev:[1,4,9,12,14],develop:[0,1,3,4,5,7,9,10,13,14,15],devmanu:[10,11],did:[6,10,12],die:6,differ:[0,1,3,12],difficult:4,direct:[0,12],directli:[0,8,10],directori:[3,4],disabl:[1,12],disagre:[0,11],disciplinari:0,discourag:[6,14],discov:14,discuss:[11,14],distinguish:[9,14],distribut:[4,11],distro:15,doc:4,document:[0,5,12,13],doe:[1,6,7,9,11,12],done:11,dosym:4,doubt:[0,15],down:[0,10],download:12,downward:15,drop:[5,9],dropping_stable_keyword:7,due:[1,4,6,7],duplic:7,dure:[1,4],dynam:[1,3,4,5,15],each:[0,1,10,12],eapi:[5,11],earli:[4,8],easi:[0,12],easier:[0,14],easili:9,eblit:3,ebuild:[0,1,2,4,5,6,8,10,11,12],eclass:[1,5,12,15],edit:[3,10],editor:3,educ:0,effect:12,effort:[0,7],eight:10,either:[1,4,6,7,8,12,14],ekeyword:3,elog:1,emerg:12,enabl:[1,6,12,14],encourag:3,end:[0,8,9,14],enforc:[3,5,11,12],enough:12,ensur:[1,4,8,12],entri:[3,15],equal:1,equival:1,error:[1,3,12],especi:[1,4],establish:10,etc:[0,3,4],eutil:1,eval:3,even:[1,12,14],everi:10,exampl:[1,4,6,9,12],except:[1,4,7],execut:[0,4,12],exempt:7,exist:[1,2,8,12,14,15],expect:[0,2],experi:0,experienc:[0,1],experiment:7,explan:10,explicit:[1,12],explicitli:[1,3,6,8,9,10,12,14,15],exponenti:8,express:[12,14],extend:14,extern:[3,5],fact:1,facto:10,fail:12,fallback:6,far:[0,10,12],fatal:[4,12],favor:15,featur:[1,12],few:[3,14],file:[0,5,7,9,10,12],filesystem:[4,11],find:[6,9,10,12],first:[6,7],fit:9,fix:[0,9,15],flag:[0,5,6],flat:[10,14],flip:1,focu:0,focus:[0,10],follow:[0,4,6,7,9,11,15],foo:[1,3],forbidden:[3,9,12],form:[3,10,14],formal:10,format:[5,11,12],former:[1,10],found:[4,10],free:15,frequent:[8,9],frobnic:4,from:[1,3,4,7,9,10,12,15],fulfil:4,full:[4,6],fulli:3,further:[0,15],furthermor:[1,3,4,9,10,12],futur:[1,7,9,11,14,15],game:5,gamestat:4,gap:15,gener:[3,4,6,11,12,14],gentoo:[0,1,2,3,4,7,8,9,10,12,13,14,15],get:1,gid:15,git:[2,4],github:3,gitweb:[2,4],give:8,glep:[0,1,5,15],global:[5,12,13,14],gnu:4,goal:[5,6],goe:3,going:[6,10],good:[1,4,12,15],govern:0,gpl:12,grab:9,gracefulli:[8,12],grant:4,graph:[1,7,8],grep:[3,9],group:[4,5,9],grow:8,gtk2:[1,14],gtk3:14,gtk:14,guarante:[8,12],gui:5,guid:[11,13],guidelin:[4,11],guix:4,hack:4,had:[1,7],hand:3,handl:[8,12],hard:[3,9,10,12,14],hardcod:[4,6],harder:3,harm:[6,12],has:[1,3,4,6,8,12,14,15],have:[1,3,6,7,8,12,15],help:[0,1,3,9],helper:8,here:[6,7,10],hierarch:14,hierarchi:4,high:4,highest:11,highlight:3,his:[0,8],histor:[1,3,4,5,6,12,14,15],histori:5,hold:4,homepag:5,host:4,hour:6,how:[1,10,11],howev:[6,7,10,11,12],http:[1,2,3,4,7,8,12,14,15],huge:6,hyphen:14,idea:1,identifi:12,imit:14,immedi:[1,7],immin:15,implement:[0,1,8,11,12],impli:4,implicitli:1,impos:11,imposs:6,improv:14,inappropri:9,incident:3,includ:[0,1,3,4,6,9,12],inconsist:4,increas:[1,9],indent:3,independ:7,index:[1,3,5,7,12,14],indic:[0,1,4,10,13],individu:3,infer:[1,12],inform:[1,5,9,10,12],init:12,initramf:4,instal:[0,1,5,8,12,14],install_mask:6,instead:[1,4,8],instruct:11,intend:10,interchang:1,interest:[7,9],intern:13,introduc:[6,8,14],introduct:[5,14],invalid:12,invari:12,investig:3,involv:0,ish:3,isol:4,issu:[0,6,8,14],its:[1,4,8,10,11],itself:11,ius:12,job:12,justifi:15,keep:6,kept:7,keyword:5,kind:0,knowledg:9,known:[0,7,12],lack:10,languag:5,larg:[3,9,10],larger:4,last:[7,9],later:8,latter:[1,4,10,12,14],layout:[2,5,11],lead:15,least:[1,3,7,12],leav:[3,15],lengthen:14,less:[0,3,10,12],level:[3,4,11],lib64:4,lib:[1,4,6],libbar:1,libexec:4,libfoo:1,libfrobn:1,libpython:8,librari:[1,5],libreoffic:6,libtool:5,licens:5,life:8,like:14,likeli:0,likewis:1,limit:[0,3],line:5,liner:6,link:[1,5,6,8,12],linker:[0,4],lint:[0,3],linux:11,list:[0,2,4,6,9,10,11,12,15],liter:3,littl:[3,12],load:3,loader:[4,6],local:[6,14],locat:[3,5,6,12],log:[1,4,10,14],logic:[1,10],longer:[1,4,9],lose:[1,8],lost:9,lot:10,low:14,lowest:15,made:[4,14],mai:[1,4,6,11,14],mail:[0,7,9,11],maintain:[0,4,5,7,8,10,11,13],mainten:[3,8,9],major:[0,8,11,12,15],make:[1,3,4,5,6,8,9,10,12,14],manag:[0,1,4,5,12],mani:[1,4,6,8,9,11,12],manual:[5,14],marker:12,match:[1,8,15],mean:[1,14],meaning:5,meant:[5,7,9,13],measur:0,meet:[1,4,10,14],member:[0,9],mention:10,mere:9,messag:[1,12,14],metadata:[2,4,5,9],method:3,mgorni:13,might:6,migrat:[2,15],minim:8,minor:[0,7],mismatch:14,miss:[1,12],mistak:[0,1,12],modern:4,modifi:3,modul:8,moment:1,more:[3,6,10,11,12,14],most:3,motiv:5,mount:4,move:[3,4],mtab:4,much:[6,12],multi:3,multilib:5,multipl:[3,12,14],multislot:5,must:[1,4,5,6,7,8,9,14,15],name:[3,4,5,6],necessari:[1,6,9,14],need:[1,4,6,9,10,11,12,14,15],needless:1,neg:[6,7],neglect:7,neither:9,never:[4,6,10],nevertheless:11,newer:2,newest:1,newli:14,next:15,nix:4,no_homepag:12,non:[0,1,3,4,7,10,12],nonfunct:1,nor:[1,9],normal:[4,12],noth:12,notic:[1,6],number:[3,8,9,15],obsolet:10,obtain:14,offer:14,often:[7,9],old:[1,4,7,8,9,12],oldid:[1,7,12,14],omit:12,onc:[1,3,7,9],one:[1,4,6,7,8,9,12],ones:15,onli:[1,3,4,6,7,10,11,12],open:[1,15],oper:[5,11],oppon:1,opportun:1,opt:4,optfeatur:1,option:[5,12,14],order:[0,1,4,6,8,10,12],org:[1,2,3,4,7,8,12,14,15],organ:10,origin:[9,10,12],other:[0,1,3,4,5,6,7,8,9,10,13,14],otherwis:[1,6],out:[1,8,9,10,14],over:[0,7],overlai:12,overlap:3,overrid:[0,11],overspecifi:12,own:4,ownership:5,packag:[0,2,3,4,5,6,7,8,12,14,15],page:[3,5,10,11],paludi:1,parallel:12,part:[1,3,4,10],partial:[3,10,11],particular:[6,10],partit:4,past:[3,10],path:[0,5,6],per:14,period:0,permit:[1,3,4,9,12],person:[0,7,14],phase:[0,3,8,14],php:[1,7,12,14],pkg:6,pkgcheck:[0,1,2,3,4,7,8,12,14,15],place:[1,6,7],plain:[1,3],pleas:[9,12],plugin:6,point:[1,4,6,10],pointless:15,polici:[1,6,7,9,12,13,14],port:8,portabl:[0,1,6],portag:[1,4],posix:[3,5],possibl:[0,1,3,8,9,10],potenti:[6,12],practic:[0,6],pre:12,precis:10,predict:1,prefac:5,prefer:[1,8,14],prepar:8,preprocess:3,prerequisit:12,present:12,prevent:[1,9,15],previou:[0,1,7],primari:[10,12],primit:15,principl:3,prioriti:14,privat:1,privileg:4,proactiv:[2,5],problem:[0,1],proc:4,proceed:7,process:[3,5,7,11,13,15],profil:[4,9],program:[6,8,9],proj:4,project:[0,1,3,4,5,6,7,8,9,10,11,12,13,14],prolifer:6,prone:3,propag:1,proper:14,propon:1,propos:1,protect:12,provid:[0,6,8,10,11,12,15],pull:1,purpos:[4,5,12],push:[0,15],pypi:3,python:[5,9],python_2_end:8,python_compat:8,python_gen_cond_dep:8,python_single_target:8,python_single_usedep:8,python_target:8,python_usedep:8,qt4:14,qt5:14,qualiti:0,quality_assur:[1,7,12,14],queri:[10,12],question:[0,1,4,7,9,12],rang:[1,15],rapid:15,rather:[3,10,11,14],rational:[1,3,4,5,6,7,8,9,10,12,13,14,15],reach:8,readabl:4,readi:8,readm:1,realli:[6,10],reason:[1,4,15],reassign:9,rebuild:[1,6],recommend:[3,6,11,14,15],reconsid:1,recoveri:[4,6],reduc:[0,3,8],refer:[1,2,4,5,7,8,10,12,14,15],refin:1,refus:[0,9],regard:0,regular:[14,15],reject:10,rekeyword:5,rel:4,relat:[0,10],relev:[0,7,12],reli:[1,4],reliabl:[0,8],remain:7,rememb:12,remov:[1,5,6,8,12,14,15],render:3,repair:4,repeat:[0,3],replac:[6,10,14],repo:[2,4],repoman:[0,1,2,3,4,7,15],report:[0,1,2,3,4,6,7,8,9,12,14,15],repositori:[0,10,11,12],request:[0,1,7,15],requir:[1,4,6,8,10,11,12,15],resembl:14,reserv:[14,15],resign:9,resolv:[0,12],respond:7,respons:[1,12,14,15],restrict:[1,4,5,10,11],result:[1,15],retest:7,retir:8,reus:15,revers:[1,6,8],review:[11,15],revis:[4,5],risk:0,rite:7,role:0,root:4,rootf:4,rule:[3,7,11,12,14,15],run:[0,4],runtim:[5,8,12],same:[0,12,15],sbin:4,scale:10,scan:0,scatter:10,scope:12,score:4,script:[4,8,12],search:5,second:15,section:1,secur:6,select:15,self:4,send:9,separ:[5,12],serv:15,servic:[0,6],set:[1,3,5,10,13,14],setgid:4,setup:[0,4],share:[4,6],sharealik:13,shell:6,shorter:14,should:[0,1,2,4,6,7,8,10,11,12,14,15],side:1,silent:9,similar:12,simpl:[14,15],simplest:12,simpli:1,simplifi:15,simultan:12,sinc:[3,4,6,12,14],singl:[5,10,12],size:6,skip:12,slack:7,slot:[5,8],small:[4,5,9],smaller:6,softwar:[0,4,11],sole:9,solut:1,some:[4,7,10,12],soon:8,sooner:8,sourc:[1,2,3,4,5,6,7,8,9,10,12,13,14,15],space:[4,12],span:1,special:[4,5,12,14],specif:[0,1,5,6,10,12,13,14],specifi:[1,3,11,12],spend:6,spirit:10,split:9,src:4,src_uri:5,srv:4,stabil:5,stabl:[1,5],stale:10,standard:[3,5],start:[1,10,15],state:[4,5,12],still:[1,4,7,14],store:2,strict:5,strictli:[4,12],strip:6,strongli:6,style:[1,5],sub:5,subdirectori:4,subpag:12,subsequ:11,subset:7,subslot:5,subtli:4,success:15,suffer:9,suffici:10,suffix:4,suggest:11,summari:[1,4,14],supplement:[0,6],suppli:[5,13],support:[0,1,3,5,6,8,12,14],suppos:4,sure:[3,9],surpris:[0,3],symbol:5,symlink:4,sync:15,synchron:15,syntax:3,system:[0,5,6,11,12,15],systemd:[0,6],tab:3,take:[0,1,7,9],target:5,task:0,team:[0,3,4,5,7,9,10,13,14],technic:[4,6,9,10,11,12,14],temporarili:12,tent:1,term:8,termin:3,test:[0,3,5],text:13,than:[0,3,6,8,10,11,14],thei:[0,1,4,6,7,9,12,14],them:[0,4,6,9,10,11,14],themselv:6,therefor:[1,3,4,5,10,13],thi:[0,1,3,4,6,7,9,10,11,12,13,14,15],those:[0,3,4,8,9,12],three:[0,1],through:[8,11],tild:1,time:[0,1,7,8,10,12],timefram:1,tini:6,tip:10,titl:[1,7,12,14],todai:6,toggl:1,tool:[0,1,3,6],toolchain:[4,12],toolkit:14,top:4,tracker:12,tree:[0,2,4,5,10,11,13],trigger:[0,12],triplet:4,trivial:[0,12],turn:[10,12],two:[0,12],txt:[1,4,14,15],udev:4,uid:15,unclear:10,uncommon:[1,6],uncondition:[6,12],undefin:12,under:[1,12,13],underscor:5,understand:10,unfair:9,unit:[0,6],unless:[1,6,8,9,15],unmaintain:9,unnecessari:[3,6,7,8,14],unnecessarili:[1,14],unpredict:12,unprefix:14,unreli:1,unset:12,until:8,unus:3,unwilling:0,updat:[1,5,10,11,13,15],upgrad:[8,12],upon:11,upstream:[4,8,12],uri:3,usag:[1,5,10],use:[0,3,4,5,6,8,10,12,14,15],use_expand:14,used:[1,2,3,4,6,8,9,12,14,15],usefulness:3,user:[0,1,4,5,6,8,9,12,14],uses:[1,8,12,14],using:[0,1,3,4,6,8,12,15],usr:5,usual:[1,12],valid:14,valu:[1,3,4,5],variabl:[5,8],variant:4,variou:[0,9,10,14],verbatim:3,veri:[1,4,6,9,10,14,15],verifi:[1,12],version:[1,2,3,4,5,12,15],versioned_use_flag:14,via:[3,4,10,11,12,14,15],violat:[0,12],wai:[1,10,12,14],want:[7,14],warn:1,wast:4,web:[4,12],well:[3,5,7,10,11,12,13],were:[1,3,6,7,10,12,15],what:9,when:[0,1,2,3,4,6,9,11,12,14],whenev:[1,3,4,6,7,11,12,14],where:4,whether:[0,1,7],which:[1,3,5,7,10,12,13,14],who:[1,6,7,9,10,14],whole:8,why:9,wide:0,wider:10,widget:14,width:3,wiki:[1,7,8,10,11,12,14],wildcard:1,wish:[6,14],within:[1,4,5,7,9,14],without:[0,3,4,5],word:10,work:[0,3,4,7,12,13,14],world:4,wors:9,would:[4,10],wrap:3,writabl:4,written:[0,1,9,10],wrong:[4,12],www:12,xml:9,yet:1,you:1,your:1,zeroth:1},titles:["Basic information","Dependencies","Deprecations","Ebuild file format","File system layout","Gentoo Policy Guide","Installed files","Keywording and stabilization","Language-specific policies","Package Maintainers","Motivation and history","Other policy documents","Other metadata variables","Preface","USE flags","Users and groups"],titleterms:{"case":1,"new":[7,9],"static":[4,6],Adding:9,FHS:11,USE:[1,12,14],absolut:4,account:15,appeal:0,author:13,basic:0,bump:1,chang:[0,1],check:0,code:3,complianc:0,contain:3,defin:3,depend:1,deprec:[2,8],develop:11,document:[10,11],drop:7,dynam:12,eapi:2,ebuild:3,eclass:[3,8],enforc:0,extern:11,file:[3,4,6],flag:[1,12,14],format:3,game:4,gentoo:[5,11],glep:11,goal:0,group:15,gui:14,guid:[5,10],histor:10,histori:10,homepag:[3,12],indic:5,inform:0,instal:[4,6],introduct:13,keyword:[3,7],languag:8,layout:4,librari:[4,6],libtool:[4,6],licens:[12,13],line:3,link:4,locat:4,maintain:9,make:0,manag:11,manual:11,meaning:12,metadata:12,motiv:10,multilib:4,multislot:12,must:[3,12],name:14,oper:1,option:1,other:[11,12],ownership:4,packag:[1,9,11],path:4,polici:[0,5,8,10,11,15],posix:11,prefac:13,proactiv:1,purpos:10,python:8,refer:3,rekeyword:7,remov:[7,9],restrict:12,revis:1,runtim:1,separ:4,singl:3,slot:[1,12],small:6,special:1,specif:[8,11],src_uri:3,stabil:7,stabl:7,standard:11,state:10,strict:4,style:3,sub:1,subslot:1,support:4,symbol:4,system:4,tabl:5,target:4,test:12,todo:[4,7,14],underscor:14,usag:8,use:1,user:15,usr:4,valu:12,variabl:[3,12],version:[7,14],within:3,without:[1,9]}})