diff options
author | 2020-01-22 04:13:30 +0100 | |
---|---|---|
committer | 2020-01-22 04:13:30 +0100 | |
commit | 8e51d2fabf1968d03bc6a79fc43f0b2d35e7ec16 (patch) | |
tree | 9c3722cca5a3f62a7a579d70e5a80ed3368b7d03 | |
parent | optfeature & USE-deps (diff) | |
download | policy-guide-8e51d2fabf1968d03bc6a79fc43f0b2d35e7ec16.tar.gz policy-guide-8e51d2fabf1968d03bc6a79fc43f0b2d35e7ec16.tar.bz2 policy-guide-8e51d2fabf1968d03bc6a79fc43f0b2d35e7ec16.zip |
Update
18417ff index: Display full TOC
c674d07 other-metadata: RESTRICT="!test? ( test )"
5d3972d other-metadata: meaningful homepage policy
Signed-off-by: Michał Górny <mgorny@gentoo.org>
-rw-r--r-- | _sources/index.rst.txt | 1 | ||||
-rw-r--r-- | _sources/other-metadata.rst.txt | 58 | ||||
-rw-r--r-- | genindex.html | 22 | ||||
-rw-r--r-- | index.html | 33 | ||||
-rw-r--r-- | other-metadata.html | 61 | ||||
-rw-r--r-- | searchindex.js | 2 |
6 files changed, 170 insertions, 7 deletions
diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt index c1295a6..b3bcddc 100644 --- a/_sources/index.rst.txt +++ b/_sources/index.rst.txt @@ -10,7 +10,6 @@ in which the policy can be updated. .. toctree:: - :maxdepth: 2 :caption: Contents: :glob: diff --git a/_sources/other-metadata.rst.txt b/_sources/other-metadata.rst.txt index ca3759a..f05014b 100644 --- a/_sources/other-metadata.rst.txt +++ b/_sources/other-metadata.rst.txt @@ -36,4 +36,62 @@ manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors. +.. index:: + single: homepage; meaningful value + pair: homepage; gentoo.org + +HOMEPAGE value must be meaningful +--------------------------------- +:Source: QA +:Reference: https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035 +:Reported: known bad values are reported by pkgcheck + +The HOMEPAGE specified for the package should either be dedicated +to the package in question or make it easy to find dedicated +information. Packages must not use ``https://www.gentoo.org/`` +or a similar generic homepage. If no homepage is available, the special +value of ``https://wiki.gentoo.org/wiki/No_homepage`` must be used. + +*Rationale*: The homepage specified in ebuilds is normally used to +locate information about the upstream project, e.g. downloads, source +code repository, bug tracker, documentation. Homepages that make it +hard to locate information about a specific project have little value, +and the Gentoo homepage generally does not do a good job at linking even +major Gentoo projects. Furthermore, many of the projects did not even +have a single dedicated subpage anywhere in Gentoo web space. In all +those cases, using the explicit No_homepage marker at least makes it +easy to identify such packages. + + +.. index:: + single: restrict; test; USE=-test + single: USE flags; test; restrict + +RESTRICT=test for USE=-test +--------------------------- +:Source: QA +:Reported: by pkgcheck + +Whenever the package uses ``test`` flag to control test prerequisites +(or another flag with a similar purpose), it must explicitly restrict +tests when the flag is unset. + +*Example*:: + + IUSE="test" + RESTRICT="!test? ( test )" + +*Rationale*: contrary to common assumption, ``test`` flag is not special +and the package manager can execute tests when the flag is disabled. +The explicit restriction guarantees that tests will be skipped under +this circumstance, and they will not fail for users. + +.. Note:: + Technically there are packages that do not strictly require this + restriction since they handle missing test prerequisites gracefully + (e.g. by skipping the tests). However, we enforce the rule for all + packages since omitting the restriction by mistake is much more + common, and there is little harm in overspecifying it. + + .. _metadata invariance: https://projects.gentoo.org/pms/7/pms.html#x1-600007.1 diff --git a/genindex.html b/genindex.html index a684ff1..467cef1 100644 --- a/genindex.html +++ b/genindex.html @@ -223,6 +223,13 @@ <li><a href="filesystem.html#index-4">file system</a> </li> </ul></li> + <li> + gentoo.org + + <ul> + <li><a href="other-metadata.html#index-2">homepage</a> +</li> + </ul></li> </ul></td> <td style="width: 33%; vertical-align: top;"><ul> <li><a href="user-group.html#index-1">group</a> @@ -244,6 +251,10 @@ homepage <ul> + <li><a href="other-metadata.html#index-2">gentoo.org</a> +</li> + <li><a href="other-metadata.html#index-2">meaningful value</a> +</li> <li><a href="ebuild-format.html#index-3">src uri</a> </li> <li><a href="ebuild-format.html#index-2">variable</a> @@ -355,6 +366,15 @@ <table style="width: 100%" class="indextable genindextable"><tr> <td style="width: 33%; vertical-align: top;"><ul> <li> + restrict + + <ul> + <li><a href="other-metadata.html#index-3">test; USE=-test</a> +</li> + </ul></li> + </ul></td> + <td style="width: 33%; vertical-align: top;"><ul> + <li> revision bump <ul> @@ -429,6 +449,8 @@ </li> <li><a href="installed-files.html#index-0">small files</a> </li> + <li><a href="other-metadata.html#index-3">test; restrict</a> +</li> <li><a href="use-flags.html#index-2">underscore</a> </li> <li><a href="use-flags.html#index-0">versioned</a> @@ -143,16 +143,33 @@ in which the policy can be updated.</p> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a><ul> -<li class="toctree-l2"><a class="reference internal" href="other-docs.html#gentoo-specific-documentation">Gentoo-specific documentation</a></li> -<li class="toctree-l2"><a class="reference internal" href="other-docs.html#external-standards">External standards</a></li> +<li class="toctree-l2"><a class="reference internal" href="other-docs.html#gentoo-specific-documentation">Gentoo-specific documentation</a><ul> +<li class="toctree-l3"><a class="reference internal" href="other-docs.html#package-manager-specification">Package Manager Specification</a></li> +<li class="toctree-l3"><a class="reference internal" href="other-docs.html#gleps">GLEPs</a></li> +<li class="toctree-l3"><a class="reference internal" href="other-docs.html#developer-manual">Developer Manual</a></li> +</ul> +</li> +<li class="toctree-l2"><a class="reference internal" href="other-docs.html#external-standards">External standards</a><ul> +<li class="toctree-l3"><a class="reference internal" href="other-docs.html#posix">POSIX</a></li> +<li class="toctree-l3"><a class="reference internal" href="other-docs.html#fhs">FHS</a></li> +</ul> +</li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a><ul> <li class="toctree-l2"><a class="reference internal" href="dependencies.html#optional-runtime-dependencies">Optional runtime dependencies</a></li> <li class="toctree-l2"><a class="reference internal" href="dependencies.html#dependencies-with-no-revision">=-dependencies with no revision</a></li> -<li class="toctree-l2"><a class="reference internal" href="dependencies.html#slot-and-subslot-dependencies">Slot and subslot dependencies</a></li> +<li class="toctree-l2"><a class="reference internal" href="dependencies.html#slot-and-subslot-dependencies">Slot and subslot dependencies</a><ul> +<li class="toctree-l3"><a class="reference internal" href="dependencies.html#on-sub-slotted-packages">on (sub-)slotted packages</a></li> +<li class="toctree-l3"><a class="reference internal" href="dependencies.html#special-case-qt-packages">special case: Qt packages</a></li> +<li class="toctree-l3"><a class="reference internal" href="dependencies.html#proactive-use-of-slot-operators">proactive use of slot operators</a></li> +</ul> +</li> <li class="toctree-l2"><a class="reference internal" href="dependencies.html#revision-bumps-on-runtime-dependency-changes">Revision bumps on runtime dependency changes</a></li> -<li class="toctree-l2"><a class="reference internal" href="dependencies.html#use-dependencies">USE dependencies</a></li> +<li class="toctree-l2"><a class="reference internal" href="dependencies.html#use-dependencies">USE dependencies</a><ul> +<li class="toctree-l3"><a class="reference internal" href="dependencies.html#on-packages-without-the-flag">on packages without the flag</a></li> +</ul> +</li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a><ul> @@ -184,7 +201,11 @@ in which the policy can be updated.</p> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a><ul> -<li class="toctree-l2"><a class="reference internal" href="languages.html#python">Python</a></li> +<li class="toctree-l2"><a class="reference internal" href="languages.html#python">Python</a><ul> +<li class="toctree-l3"><a class="reference internal" href="languages.html#eclass-usage">Eclass usage</a></li> +<li class="toctree-l3"><a class="reference internal" href="languages.html#python-2-deprecation">Python 2 deprecation</a></li> +</ul> +</li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="maintainer.html">Package Maintainers</a><ul> @@ -195,6 +216,8 @@ in which the policy can be updated.</p> </li> <li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a><ul> <li class="toctree-l2"><a class="reference internal" href="other-metadata.html#dynamic-slots-multislot-flag">Dynamic slots (multislot flag)</a></li> +<li class="toctree-l2"><a class="reference internal" href="other-metadata.html#homepage-value-must-be-meaningful">HOMEPAGE value must be meaningful</a></li> +<li class="toctree-l2"><a class="reference internal" href="other-metadata.html#restrict-test-for-use-test">RESTRICT=test for USE=-test</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a><ul> diff --git a/other-metadata.html b/other-metadata.html index 4a71d7d..2df22e5 100644 --- a/other-metadata.html +++ b/other-metadata.html @@ -150,6 +150,65 @@ depend on slot, via <code class="docutils literal notranslate"><span class="pre" manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.</p> </div> +<div class="section" id="homepage-value-must-be-meaningful"> +<span id="index-2"></span><h2>HOMEPAGE value must be meaningful<a class="headerlink" href="#homepage-value-must-be-meaningful" title="Permalink to this headline">¶</a></h2> +<dl class="field-list simple"> +<dt class="field-odd">Source</dt> +<dd class="field-odd"><p>QA</p> +</dd> +<dt class="field-even">Reference</dt> +<dd class="field-even"><p><a class="reference external" href="https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035">https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035</a></p> +</dd> +<dt class="field-odd">Reported</dt> +<dd class="field-odd"><p>known bad values are reported by pkgcheck</p> +</dd> +</dl> +<p>The HOMEPAGE specified for the package should either be dedicated +to the package in question or make it easy to find dedicated +information. Packages must not use <code class="docutils literal notranslate"><span class="pre">https://www.gentoo.org/</span></code> +or a similar generic homepage. If no homepage is available, the special +value of <code class="docutils literal notranslate"><span class="pre">https://wiki.gentoo.org/wiki/No_homepage</span></code> must be used.</p> +<p><em>Rationale</em>: The homepage specified in ebuilds is normally used to +locate information about the upstream project, e.g. downloads, source +code repository, bug tracker, documentation. Homepages that make it +hard to locate information about a specific project have little value, +and the Gentoo homepage generally does not do a good job at linking even +major Gentoo projects. Furthermore, many of the projects did not even +have a single dedicated subpage anywhere in Gentoo web space. In all +those cases, using the explicit No_homepage marker at least makes it +easy to identify such packages.</p> +</div> +<div class="section" id="restrict-test-for-use-test"> +<span id="index-3"></span><h2>RESTRICT=test for USE=-test<a class="headerlink" href="#restrict-test-for-use-test" title="Permalink to this headline">¶</a></h2> +<dl class="field-list simple"> +<dt class="field-odd">Source</dt> +<dd class="field-odd"><p>QA</p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>by pkgcheck</p> +</dd> +</dl> +<p>Whenever the package uses <code class="docutils literal notranslate"><span class="pre">test</span></code> flag to control test prerequisites +(or another flag with a similar purpose), it must explicitly restrict +tests when the flag is unset.</p> +<p><em>Example</em>:</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">IUSE</span><span class="o">=</span><span class="s2">"test"</span> +<span class="n">RESTRICT</span><span class="o">=</span><span class="s2">"!test? ( test )"</span> +</pre></div> +</div> +<p><em>Rationale</em>: contrary to common assumption, <code class="docutils literal notranslate"><span class="pre">test</span></code> flag is not special +and the package manager can execute tests when the flag is disabled. +The explicit restriction guarantees that tests will be skipped under +this circumstance, and they will not fail for users.</p> +<div class="admonition note"> +<p class="admonition-title">Note</p> +<p>Technically there are packages that do not strictly require this +restriction since they handle missing test prerequisites gracefully +(e.g. by skipping the tests). However, we enforce the rule for all +packages since omitting the restriction by mistake is much more +common, and there is little harm in overspecifying it.</p> +</div> +</div> </div> @@ -207,6 +266,8 @@ invalidation or explicit errors.</p> <li class="toctree-l1"><a class="reference internal" href="maintainer.html">Package Maintainers</a></li> <li class="toctree-l1 current"><a class="current reference internal" href="#">Other metadata variables</a><ul class='nav'> <li class="toctree-l2"><a class="reference internal" href="#dynamic-slots-multislot-flag">Dynamic slots (multislot flag)</a></li> +<li class="toctree-l2"><a class="reference internal" href="#homepage-value-must-be-meaningful">HOMEPAGE value must be meaningful</a></li> +<li class="toctree-l2"><a class="reference internal" href="#restrict-test-for-use-test">RESTRICT=test for USE=-test</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li> diff --git a/searchindex.js b/searchindex.js index 051c813..9011225 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["basics","dependencies","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.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","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":3,"2fuse":11,"80librari":3,"80multilib":3,"83cc5bbd7bbe8bdf04dd3c3bc7f8a035":[],"9cae3a92412a007febe7ac0612d50f5f":1,"break":[2,7],"case":[0,3,6],"class":0,"default":[1,5],"final":[0,9,10],"function":[0,2,3,7],"g\u00f3rny":12,"import":[1,7,14],"long":[1,6,7,11],"micha\u0142":12,"new":[3,4,7,9,13,14],"public":1,"static":4,"switch":13,"true":14,"try":[0,2,8],"var":3,"while":[0,1,2,5,11],Adding:4,For:[1,3,8],Its:[0,9],PMS:[1,9,10,11],Such:[5,11],The:[0,1,2,3,4,6,7,8,9,10,11,12,13,14],There:[1,5,8,9],USE:[4,5,11],Use:2,Using:1,With:3,abi:[1,3],abil:9,abolish:0,about:[],absolut:4,accept:[1,3,11,14],access:3,accident:7,accord:1,account:[1,2,4],acct:14,achiev:0,across:[0,9],action:0,activ:10,actual:8,add:[2,8],added:[3,5,8],adding:[1,8,14],addit:[2,3,5,9,10],addition:0,address:9,adjust:13,adopt:14,advantag:[2,13],affect:[0,2,6],aforement:[3,9],after:[0,1,3],afterward:13,against:[0,2,9],agre:8,aid:14,aim:[0,1,4,8,12,13],align:2,all:[0,1,2,4,5,6,7,8,9,10,11,12,13,14],alloc:14,allow:[2,11],along:[3,9],alreadi:[1,3,7],also:[0,7,9,13],alter:11,alwai:[2,3],amd64:3,amount:9,analyz:0,ani:[1,2,5,8,9,10,11,13],anoth:[1,3],anymor:[3,6],anywher:[],api:1,app:5,appeal:4,appli:[0,1,6,8,9,10],applic:[1,3,5,9,10],appropri:3,approv:[1,10,14],arbitrari:14,arch:6,architectur:[0,3,6],archiv:[1,5,13],area:0,argu:1,aris:[9,13,14],ask:[0,6],assign:[8,14],assum:[1,13],assumpt:[],attempt:[2,5,9,13],attribut:12,author:4,autom:0,autotool:5,avail:[1,9,13],avoid:[2,5],awar:8,backup:8,bad:[1,3],base:5,baselayout:14,bash:[2,5],basic:[4,10],becom:[1,4,8,12],been:[1,3,5,11,13,14],befor:[0,6,13,14],behavior:[0,1,5,11],being:[1,5,6,7,8,11],besid:10,better:[7,9],between:[3,7,11,13,14],bin:3,bind:[4,9,12],bit:3,blurri:3,bodi:[0,4,9,12],boot:3,both:[0,2,4,5,7,12,13],boundari:3,bracket:2,breakag:[1,6],broken:3,brought:5,browser:3,bug:[2,6,8,14],build:[0,1,3,5,7,13],builtin:2,bump:[4,14],burden:8,cach:11,call:[1,7],can:[0,1,3,4,6,9,10,11,12,13,14],care:8,categori:5,caus:[1,5,6,7,11,13],cf3f5a59ac918335766632bd02438722:13,chanc:[7,8],chang:[2,4,7,10],check:[1,3,4],choic:[2,13],choos:[11,13],chosen:14,chost:3,circumst:1,claim:1,clarifi:3,clean:1,clear:[4,9,12,13],close:6,code:[0,1,4,7],collect:9,collis:14,combin:[0,4,9,12],comment:8,commit:0,common:[1,2,12],compar:8,compat:[3,7],compil:0,complet:[5,9],compli:10,complianc:4,compon:0,concept:0,concis:9,condit:2,config:5,conform:[9,10],confus:[2,6,13],consent:8,consequ:5,consid:[5,13],consist:[0,2,7,13],construct:2,contact:0,contain:[4,8,10,13],content:4,context:5,contrari:[],contribut:0,control:[1,3,5,13],controlled_optional_rdepend:1,convert:[2,13],copi:2,correct:[1,3],correctli:[0,3],correspond:[1,3],cost:[5,7],could:[5,8,11],council:[0,1,3,4,9,10,12,13],creat:[0,3,9,10,13,14],creativ:12,cross:14,ctarget:3,cumbersom:1,current:[0,3,4,8,12],dai:6,data:3,debat:1,decid:1,decis:[0,9],declar:11,dedic:8,defer:7,defici:9,defin:[1,7,10,13],definit:[4,12],delai:[7,14],depclean:11,depend:[2,4,5,6,7,11,13],dependent_slot:11,deprec:14,design:[2,4,12],desir:14,detail:10,detect:[0,1],dev:[1,3,8,13],develop:[0,1,2,3,4,6,8,9,12,13,14],devmanu:[9,10],did:[5,9],die:5,differ:[0,1,2],difficult:3,direct:[0,11],directli:[0,7,9],directori:[2,3],disabl:[1,11],disagre:[0,10],disciplinari:0,discourag:[5,13],discov:13,discuss:[10,13],distinguish:[8,13],distribut:[3,10],distro:14,doc:3,document:[0,4,12],doe:[1,5,6,8,10],done:10,dosym:3,doubt:[0,14],down:[0,9],download:[],downward:14,drop:[4,8],dropping_stable_keyword:6,due:[1,3,5,6],duplic:6,dure:[1,3],dynam:[1,2,3,4,14],each:[0,1,9,11],eapi:10,earli:[3,7],easi:0,easier:[0,13],easili:8,eblit:2,ebuild:[0,1,3,4,5,7,9,10,11],eclass:[1,4,11,14],edit:[2,9],editor:2,educ:0,effort:[0,6],eight:9,either:[1,3,5,6,7,13],elog:1,emerg:11,enabl:[1,5,11,13],encourag:2,end:[0,7,8,13],enforc:[2,4,10],ensur:[1,3,7],entri:[2,14],eprefix:[],equal:1,equival:1,error:[1,2,11],especi:[1,3],establish:9,etc:[0,3],eutil:1,eval:2,even:[1,13],everi:9,exampl:[1,3,5,8],except:[1,3,6],execut:[0,3],exempt:6,exist:[1,7,13,14],expect:0,experi:0,experienc:[0,1],experiment:6,explan:9,explicit:[1,11],explicitli:[1,2,5,7,8,9,11,13,14],exponenti:7,express:13,extend:13,extern:[2,4],fact:1,facto:9,fail:[],fallback:5,far:[0,9],fatal:[3,11],favor:14,featur:[1,11],few:[2,13],file:[0,4,6,8,9],filesystem:[3,10],find:[5,8,9],first:[5,6],fit:8,fix:[0,8,14],flag:[0,4,5],flat:[9,13],flip:1,focu:0,focus:[0,9],follow:[0,3,5,6,8,10,14],foo:[1,2],forbidden:[2,8,11],form:[2,9,13],formal:9,format:[4,10],former:[1,9],found:[3,9],free:14,frequent:[7,8],frobnic:3,from:[1,2,3,6,8,9,11,14],fulfil:3,full:[3,5],fulli:2,further:[0,14],furthermor:[1,2,3,8,9],futur:[1,6,8,10,13,14],game:4,gamestat:3,gap:14,gener:[2,3,5,10,13],gentoo:[0,1,2,3,6,7,8,9,11,12,13,14],get:1,gid:14,git:3,github:2,gitweb:3,give:7,glep:[0,1,14],global:[4,11,12,13],gnu:3,goal:[4,5],goe:2,going:[5,9],good:[1,3,14],govern:0,grab:8,gracefulli:7,grant:3,graph:[1,6,7],grep:[2,8],group:[3,4,8],grow:7,gtk2:[1,13],gtk3:13,gtk:13,guarante:7,gui:4,guid:[10,12],guidelin:[3,10],guix:3,hack:3,had:[1,6],hand:2,handl:[7,11],hard:[2,8,9,13],hardcod:[3,5],harder:2,harm:5,has:[1,3,5,7,11,13,14],have:[1,2,5,6,7,14],help:[0,1,2,8],helper:7,here:[5,6,9],hierarch:13,hierarchi:3,high:3,highest:10,highlight:2,his:[0,7],histor:[1,2,3,4,5,11,13,14],histori:4,hold:3,homepag:4,host:3,hour:5,how:[1,9,10],howev:[5,6,9,10],http:[1,2,3,6,7,11,13,14],huge:5,hyphen:13,idea:1,identifi:[],imit:13,immedi:[1,6],immin:14,implement:[0,1,7,10],impli:3,implicitli:1,impos:10,imposs:5,improv:13,inappropri:8,incident:2,includ:[0,1,2,3,5,8,11],inconsist:3,increas:[1,8],indent:2,independ:6,index:[1,2,4,6,11,13],indic:[0,1,3,9,12],individu:2,infer:[1,11],inform:[1,4,8,9],initramf:3,instal:[0,1,4,7,11,13],install_mask:5,instead:[1,3,7],instruct:10,intend:9,interchang:1,interest:[6,8],intern:12,introduc:[5,7,13],introduct:[4,13],invalid:11,invari:11,investig:2,involv:0,ish:2,isol:3,issu:[0,5,7,13],its:[1,3,7,9,10],itself:10,ius:[],job:[],justifi:14,keep:5,kept:6,keyword:4,kind:0,knowledg:8,known:[0,6],lack:9,languag:4,larg:[8,9],larger:3,last:[6,8],later:7,latter:[1,3,9,13],layout:[4,10],lead:14,least:[1,2,6],leav:[2,14],lengthen:13,less:[0,2,9],level:[2,3,10],lib64:3,lib:[1,3,5],libbar:1,libexec:3,libfoo:1,libfrobn:1,libpython:7,librari:[1,4],libreoffic:5,libtool:4,licens:4,life:7,like:13,likeli:0,likewis:1,limit:0,liner:5,link:[1,4,5,7],linker:[0,3],lint:[0,2],linux:10,list:[0,3,5,8,9,10,14],littl:2,load:2,loader:[3,5],local:[5,13],locat:[2,4,5],log:[1,3,9,13],logic:[1,9],longer:[1,3,8],lose:[1,7],lost:8,lot:9,low:13,lowest:14,made:[3,13],mai:[1,3,5,10,13],mail:[0,6,8,10],maintain:[0,3,4,6,7,9,10,12],mainten:[2,7,8],major:[0,7,10,14],make:[1,2,3,4,5,7,8,9,13],manag:[0,1,3,11],mani:[1,3,5,7,8,10],manual:13,marker:[],match:[1,7,14],mean:[1,13],meaning:[],meant:[4,6,8,12],measur:0,meet:[1,3,9,13],member:[0,8],mention:9,mere:8,messag:[1,13],metadata:[3,4,8],method:2,mgorni:12,might:5,migrat:14,minim:7,minor:[0,6],mismatch:13,miss:1,mistak:[0,1],modern:3,modul:7,moment:1,more:[2,5,9,10,13],most:2,motiv:4,mount:3,move:[2,3],mtab:3,much:5,multi:2,multilib:4,multipl:[2,11,13],multislot:4,must:[1,3,4,5,6,7,8,13,14],name:[2,3,4,5],necessari:[1,5,8,13],need:[1,3,5,8,9,10,13,14],needless:1,neg:[5,6],neglect:6,neither:8,never:[3,5,9],nevertheless:10,newest:1,newli:13,next:14,nix:3,no_homepag:[],non:[0,1,2,3,6,9,11],nonfunct:1,nor:[1,8],normal:3,notic:[1,5],number:[7,8,14],obsolet:9,obtain:13,offer:13,often:[6,8],old:[1,3,6,7,8,11],oldid:[1,6,11,13],omit:[],onc:[1,6,8],one:[1,3,5,6,7,8],ones:14,onli:[1,3,5,6,9,10],open:[1,14],oper:10,oppon:1,opportun:1,opt:3,optfeatur:1,option:[4,11,13],order:[0,1,3,5,7,9],org:[1,2,3,6,7,11,13,14],organ:9,origin:[8,9,11],other:[0,1,2,3,4,5,6,7,8,9,12,13],otherwis:[1,5],out:[1,7,8,9,13],over:[0,6],overlai:11,overlap:2,overrid:[0,10],overspecifi:[],own:3,ownership:4,packag:[0,2,3,4,5,6,7,11,13,14],page:[2,4,9,10],paludi:1,parallel:11,part:[1,2,3,9],partial:[2,9,10],particular:[5,9],partit:3,past:[2,9],path:[0,4,5],per:13,period:0,permit:[1,2,3,8,11],person:[0,6,13],phase:[0,2,7,13],php:[1,6,11,13],pkg:5,pkgcheck:[0,1,2,3,6,7,13,14],place:[1,5,6],plain:[1,2],pleas:8,plugin:5,point:[1,3,5,9],pointless:14,polici:[1,5,6,8,11,12,13],port:7,portabl:[0,1,5],portag:[1,3],posix:2,possibl:[0,1,2,7,8,9],potenti:5,practic:[0,5],pre:11,precis:9,predict:1,prefac:4,prefer:[1,7,13],prefix:[],prepar:7,prepend:[],preprocess:2,prerequisit:[],prevent:[1,8,14],previou:[0,1,6],primari:9,primit:14,principl:2,prioriti:13,privat:1,privileg:3,problem:[0,1],proc:3,proceed:6,process:[4,6,10,12,14],profil:[3,8],program:[5,7,8],proj:3,project:[0,1,2,3,4,5,6,7,8,9,10,11,12,13],prolifer:5,prone:2,propag:1,proper:13,propon:1,propos:1,provid:[0,5,7,9,10,11,14],pull:1,purpos:[3,4],push:[0,14],pypi:2,python:[4,8],python_2_end:7,python_compat:7,python_gen_cond_dep:7,python_single_target:7,python_single_usedep:7,python_target:7,python_usedep:7,qt4:13,qt5:13,qualiti:0,quality_assur:[1,6,11,13],queri:[9,11],question:[0,1,3,6,8],rang:[1,14],rapid:14,rather:[2,9,10,13],rational:[1,2,3,4,5,6,7,8,9,11,12,13,14],reach:7,readabl:3,readi:7,readm:1,realli:[5,9],reason:[1,3,14],reassign:8,rebuild:[1,5],recommend:[2,5,10,13,14],reconsid:1,recoveri:[3,5],reduc:[0,2,7],refer:[1,3,4,6,7,9,11,13,14],refin:1,refus:[0,8],regard:0,regular:[13,14],reject:9,rekeyword:4,rel:3,relat:[0,9],relev:[0,6],reli:[1,3],reliabl:[0,7],remain:6,remov:[1,4,5,7,11,13,14],render:2,repair:3,repeat:[0,2],replac:[5,9,13],repo:3,repoman:[0,1,2,3,6,14],report:[0,1,2,3,5,6,7,8,11,13,14],repositori:[0,9,10,11],request:[0,1,6,14],requir:[1,3,5,7,9,10,11,14],resembl:13,reserv:[13,14],resign:8,resolv:[0,11],respond:6,respons:[1,11,13,14],restrict:[1,3,9,10],result:[1,14],retest:6,retir:7,reus:14,revers:[1,5,7],review:[10,14],revis:[3,4],risk:0,rite:6,role:0,root:3,rootf:3,rule:[2,6,10,13,14],run:[0,3],runtim:[4,7],same:[0,11,14],sbin:3,scale:9,scan:0,scatter:9,scope:11,score:3,script:[3,7],search:4,second:14,section:1,secur:5,select:14,self:3,send:8,separ:[4,11],serv:14,servic:[0,5],set:[1,2,4,9,12,13],setgid:3,setup:[0,3],share:[3,5],sharealik:12,shell:5,shorter:13,should:[0,1,3,5,6,7,9,10,13,14],side:1,silent:8,similar:[],simpl:[13,14],simpli:1,simplifi:14,simultan:11,sinc:[2,3,5,13],singl:[2,9],size:5,skip:[],slack:6,slot:[4,7],small:[3,4,8],smaller:5,softwar:[0,3,10],sole:8,solut:1,some:[3,6,9],soon:7,sooner:7,sourc:[1,2,3,4,5,6,7,8,9,11,12,13,14],space:3,span:1,special:[3,13],specif:[0,1,4,5,9,12,13],specifi:[1,2,10],spend:5,spirit:9,split:8,src:3,src_uri:4,srv:3,stabil:4,stabl:[1,4],stale:9,standard:[2,4],start:[1,9,14],state:[3,4,11],still:[1,3,6,13],strict:4,strictli:3,strip:5,strongli:5,style:[1,4],subdirectori:3,subpag:[],subsequ:10,subset:6,subslot:4,subtli:3,success:14,suffer:8,suffici:9,suffix:3,suggest:10,summari:[1,3,13],supplement:[0,5],suppli:[4,12],support:[0,1,2,4,5,7,11,13],suppos:3,sure:8,surpris:[0,2],symbol:4,symlink:3,sync:14,synchron:14,syntax:2,system:[0,4,5,10,14],systemd:[0,5],tab:2,take:[0,1,6,8],target:4,task:0,team:[0,3,4,6,8,9,12,13],technic:[3,5,8,9,10,11,13],tent:1,term:7,termin:2,test:[0,2],text:12,than:[0,2,5,7,9,10,13],thei:[0,1,3,5,6,8,13],them:[0,3,5,8,9,10,13],themselv:5,therefor:[1,3,4,9,12],thi:[0,1,2,3,5,6,8,9,10,11,12,13,14],those:[0,2,3,7,8],three:[0,1],through:[7,10],tild:1,time:[0,1,6,7,9],timefram:1,tini:5,tip:9,titl:[1,6,11,13],todai:5,toggl:1,tool:[0,1,2,5],toolchain:[3,11],toolkit:13,top:3,tracker:[],tree:[0,3,4,9,10,12],trigger:[0,11],triplet:3,trivial:0,turn:[9,11],two:[0,11],txt:[1,3,13,14],udev:3,uid:14,unclear:9,uncommon:[1,5],uncondition:[5,11],undefin:11,under:[1,12],underscor:4,understand:9,unfair:8,unit:[0,5],unless:[1,5,7,8,14],unmaintain:8,unnecessari:[2,5,6,7,13],unnecessarili:[1,13],unpredict:11,unprefix:13,unreli:1,unset:[],until:7,unus:2,unwilling:0,updat:[1,4,9,10,12,14],upgrad:[7,11],upon:10,upstream:[3,7],uri:2,usag:[1,9],use:[0,2,3,5,7,9,11,13,14],use_expand:13,used:[1,2,3,5,7,8,11,13,14],usefulness:2,user:[0,1,3,4,5,7,8,11,13],uses:[1,7,13],using:[0,1,2,3,5,7,14],usr:4,usual:1,valid:13,valu:[1,2,3,11],variabl:[4,7],variant:3,variou:[0,8,9,13],verbatim:2,veri:[1,3,5,8,9,13,14],verifi:1,version:[1,2,3,4,11,14],versioned_use_flag:13,via:[2,3,9,10,11,13,14],violat:[0,11],wai:[1,9,13],want:[6,13],warn:1,wast:3,web:3,well:[2,4,6,9,10,11,12],were:[1,2,5,6,9,11,14],what:8,when:[0,1,2,3,5,8,10,11,13],whenev:[1,2,3,5,6,10,13],where:3,whether:[0,1,6],which:[1,2,4,6,9,11,12,13],who:[1,5,6,8,9,13],whole:7,why:8,wide:0,wider:9,widget:13,width:2,wiki:[1,6,7,9,10,11,13],wildcard:1,wish:[5,13],within:[1,3,4,6,8,13],without:[0,2,3,4],word:9,work:[0,2,3,6,12,13],world:3,wors:8,would:[3,9],writabl:3,written:[0,1,8,9],wrong:3,xml:8,yet:1,you:1,your:1,zeroth:1},titles:["Basic information","Dependencies","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":[6,8],"static":[3,5],Adding:8,FHS:10,USE:[1,13],absolut:3,account:14,appeal:0,author:12,basic:0,bump:1,chang:[0,1],check:0,code:2,complianc:0,contain:2,depend:1,deprec:7,develop:10,document:[9,10],drop:6,dynam:11,ebuild:2,eclass:[2,7],enforc:0,extern:10,file:[2,3,5],flag:[1,11,13],format:2,game:3,gentoo:[4,10],glep:10,goal:0,group:14,gui:13,guid:[4,9],histor:9,histori:9,homepag:2,indic:4,inform:0,instal:[3,5],introduct:12,keyword:6,languag:7,layout:3,librari:[3,5],libtool:[3,5],licens:12,link:3,locat:3,maintain:8,make:0,manag:10,manual:10,meaning:[],metadata:11,motiv:9,multilib:3,multislot:11,must:2,name:13,oper:1,option:1,other:[10,11],ownership:3,packag:[1,8,10],path:3,polici:[0,4,7,9,10,14],posix:10,prefac:12,proactiv:1,purpos:9,python:7,refer:2,rekeyword:6,remov:[6,8],restrict:[],revis:1,runtim:1,separ:3,slot:[1,11],small:5,special:1,specif:[7,10],src_uri:2,stabil:6,stabl:6,standard:10,state:9,strict:3,style:2,sub:1,subslot:1,support:3,symbol:3,system:3,tabl:4,target:3,test:[],todo:[3,6,13],underscor:13,usag:7,use:1,user:14,usr:3,valu:[],variabl:[2,11],version:[6,13],within:2,without:[1,8]}})
\ No newline at end of file +Search.setIndex({docnames:["basics","dependencies","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.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","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":3,"2fuse":11,"80librari":3,"80multilib":3,"83cc5bbd7bbe8bdf04dd3c3bc7f8a035":11,"9cae3a92412a007febe7ac0612d50f5f":1,"break":[2,7],"case":[0,3,4,6,11],"class":0,"default":[1,5],"final":[0,9,10],"function":[0,2,3,7],"g\u00f3rny":12,"import":[1,7,14],"long":[1,6,7,11],"micha\u0142":12,"new":[3,4,7,9,13,14],"public":1,"static":4,"switch":13,"true":14,"try":[0,2,8],"var":3,"while":[0,1,2,5,11],Adding:4,FHS:4,For:[1,3,8],Its:[0,9],PMS:[1,9,10,11],Such:[5,11],The:[0,1,2,3,4,6,7,8,9,10,11,12,13,14],There:[1,5,8,9],USE:[4,5],Use:2,Using:1,With:3,_build:[],abi:[1,3],abil:9,abolish:0,about:11,absolut:4,accept:[1,3,11,14],access:3,accident:7,accord:1,account:[1,2,4],acct:14,achiev:0,across:[0,9],action:0,activ:10,actual:8,add:[2,8],added:[3,5,8],adding:[1,8,14],addit:[2,3,5,9,10],addition:0,address:9,adjust:13,adopt:14,advantag:[2,13],affect:[0,2,6],aforement:[3,9],after:[0,1,3],afterward:13,against:[0,2,9],agre:8,aid:14,aim:[0,1,4,8,12,13],align:2,all:[0,1,2,4,5,6,7,8,9,10,11,12,13,14],alloc:14,allow:[2,11],along:[3,9],alreadi:[1,3,7],also:[0,7,9,13],alter:11,alwai:[2,3],amd64:3,amount:9,analyz:0,ani:[1,2,5,8,9,10,11,13],anongit:[],anoth:[1,3,11],anymor:[3,6],anywher:11,api:1,app:5,appeal:4,appli:[0,1,6,8,9,10],applic:[1,3,5,9,10],appropri:3,approv:[1,10,14],arbitrari:14,arch:6,architectur:[0,3,6],archiv:[1,5,11,13],area:0,argu:1,argument:[],aris:[9,13,14],ask:[0,6],assign:[8,14],assum:[1,13],assumpt:11,attach:[],attempt:[2,5,9,13],attribut:12,author:4,autom:0,autotool:5,avail:[1,9,11,13],avoid:[2,5],awar:8,backup:8,bad:[1,3,11],base:5,baselayout:14,bash:[2,5],basic:[4,10],becom:[1,4,8,12],been:[1,3,5,11,13,14],befor:[0,6,13,14],behavior:[0,1,5,11],being:[1,5,6,7,8,11],besid:10,best:[],better:[7,9],between:[3,7,11,13,14],bin:3,bind:[4,9,12],bit:3,blurri:3,bodi:[0,4,9,12],boot:3,both:[0,2,4,5,7,12,13],boundari:3,bracket:2,breakag:[1,6],broken:3,brought:5,browser:3,bug:[2,6,8,11,14],bugzilla:[],build:[0,1,3,5,7,13],built:[],builtin:2,bump:[4,14],burden:8,cach:11,call:[1,7],can:[0,1,3,4,6,9,10,11,12,13,14],care:8,categori:5,caus:[1,5,6,7,11,13],cf3f5a59ac918335766632bd02438722:13,chanc:[7,8],chang:[2,4,7,10],chapter:[],charact:[],check:[1,3,4],checkout:[],choic:[2,13],choos:[11,13],chosen:14,chost:3,circumst:[1,11],claim:1,clarifi:3,clean:1,clear:[4,9,12,13],clone:[],close:6,code:[0,1,4,7,11],collect:9,collis:14,combin:[0,4,9,12],command:[],comment:8,commit:0,common:[1,2,11,12],compar:8,compat:[3,7],compil:0,complet:[5,9],compli:10,complianc:4,compon:0,concept:0,concis:9,condit:2,config:5,conform:[9,10],confus:[2,6,13],consent:8,consequ:5,consid:[5,13],consist:[0,2,7,13],construct:2,contact:0,contain:[4,8,10,13],content:4,context:5,contrari:11,contribut:0,control:[1,3,5,11,13],controlled_optional_rdepend:1,convert:[2,13],copi:2,correct:[1,3],correctli:[0,3],correspond:[1,3],cost:[5,7],could:[5,8,11],council:[0,1,3,4,9,10,12,13],creat:[0,3,9,10,13,14],creativ:12,cross:14,ctarget:3,cumbersom:1,current:[0,3,4,8,12],dai:6,data:3,debat:1,decid:1,decis:[0,9],declar:11,dedic:[8,11],defer:7,defici:9,defin:[1,7,10,13],definit:[4,12],delai:[7,14],depclean:11,depend:[2,4,5,6,7,11,13],dependent_slot:11,deprec:[4,14],design:[2,4,12],desir:14,detail:10,detect:[0,1],dev:[1,3,8,11,13],develop:[0,1,2,3,4,6,8,9,12,13,14],devmanu:[9,10],did:[5,9,11],die:5,differ:[0,1,2],difficult:3,direct:[0,11],directli:[0,7,9],directori:[2,3],disabl:[1,11],disagre:[0,10],disciplinari:0,discourag:[5,13],discov:13,discuss:[10,13],distinguish:[8,13],distribut:[3,10],distro:14,doc:3,document:[0,4,11,12],doe:[1,5,6,8,10,11],done:10,dosym:3,doubt:[0,14],down:[0,9],download:11,downward:14,drop:[4,8],dropping_stable_keyword:6,due:[1,3,5,6],duplic:6,dure:[1,3],dynam:[1,2,3,4,14],each:[0,1,9,11],eapi:10,earli:[3,7],easi:[0,11],easier:[0,13],easili:8,eblit:2,ebuild:[0,1,3,4,5,7,9,10,11],eclass:[1,4,11,14],edit:[2,9],editor:2,educ:0,effort:[0,6],eight:9,either:[1,3,5,6,7,11,13],elog:1,emerg:11,empti:[],enabl:[1,5,11,13],encourag:2,end:[0,7,8,13],enforc:[2,4,10,11],ensur:[1,3,7],entri:[2,14],eprefix:[],equal:1,equival:1,error:[1,2,11],especi:[1,3],establish:9,etc:[0,3],eutil:1,eval:2,even:[1,11,13],everi:9,exampl:[1,3,5,8,11],except:[1,3,6],execut:[0,3,11],exempt:6,exist:[1,7,13,14],expect:0,experi:0,experienc:[0,1],experiment:6,explan:9,explicit:[1,11],explicitli:[1,2,5,7,8,9,11,13,14],exponenti:7,express:13,extend:13,extern:[2,4],fact:1,facto:9,fail:11,fallback:5,far:[0,9],fatal:[3,11],favor:14,featur:[1,11],few:[2,13],file:[0,4,6,8,9],filesystem:[3,10],find:[5,8,9,11],first:[5,6],fit:8,fix:[0,8,14],flag:[0,4,5],flat:[9,13],flip:1,focu:0,focus:[0,9],follow:[0,3,5,6,8,10,14],foo:[1,2],forbidden:[2,8,11],fork:[],form:[2,9,13],formal:9,format:[4,10],former:[1,9],found:[3,9],free:14,frequent:[7,8],frobnic:3,from:[1,2,3,6,8,9,11,14],fulfil:3,full:[3,5],fulli:2,further:[0,14],furthermor:[1,2,3,8,9,11],futur:[1,6,8,10,13,14],game:4,gamestat:3,gap:14,gener:[2,3,5,10,11,13],gentoo:[0,1,2,3,6,7,8,9,11,12,13,14],get:1,gid:14,git:3,github:2,gitweb:3,give:7,glep:[0,1,4,14],global:[4,11,12,13],gnu:3,goal:[4,5],goe:2,going:[5,9],good:[1,3,11,14],govern:0,grab:8,gracefulli:[7,11],grant:3,graph:[1,6,7],grep:[2,8],group:[3,4,8],grow:7,gtk2:[1,13],gtk3:13,gtk:13,guarante:[7,11],gui:4,guid:[10,12],guidelin:[3,10],guix:3,hack:3,had:[1,6],hand:2,handl:[7,11],hard:[2,8,9,11,13],hardcod:[3,5],harder:2,harm:[5,11],has:[1,3,5,7,11,13,14],have:[1,2,5,6,7,11,14],help:[0,1,2,8],helper:7,here:[5,6,9],hierarch:13,hierarchi:3,high:3,highest:10,highlight:2,his:[0,7],histor:[1,2,3,4,5,11,13,14],histori:4,hold:3,homepag:4,host:3,hour:5,how:[1,9,10],howev:[5,6,9,10,11],html:[],http:[1,2,3,6,7,11,13,14],huge:5,hyphen:13,idea:1,identifi:11,imit:13,immedi:[1,6],immin:14,implement:[0,1,7,10],impli:3,implicitli:1,impos:10,imposs:5,improv:13,inappropri:8,incident:2,includ:[0,1,2,3,5,8,11],inconsist:3,increas:[1,8],indent:2,independ:6,index:[1,2,4,6,11,13],indic:[0,1,3,9,12],individu:2,infer:[1,11],inform:[1,4,8,9,11],initramf:3,instal:[0,1,4,7,11,13],install_mask:5,instead:[1,3,7],instruct:10,intend:9,interchang:1,interest:[6,8],intern:12,introduc:[5,7,13],introduct:[4,13],invalid:11,invari:11,investig:2,involv:0,ish:2,isol:3,issu:[0,5,7,13],its:[1,3,7,9,10],itself:10,ius:11,job:11,justifi:14,keep:5,kept:6,keyword:4,kind:0,knowledg:8,known:[0,6,11],lack:9,languag:4,larg:[8,9],larger:3,last:[6,8],later:7,latexpdf:[],latter:[1,3,9,13],layout:[4,10],lead:14,least:[1,2,6,11],leav:[2,14],lengthen:13,less:[0,2,9],level:[2,3,10],lib64:3,lib:[1,3,5],libbar:1,libexec:3,libfoo:1,libfrobn:1,libpython:7,librari:[1,4],libreoffic:5,libtool:4,licens:4,life:7,like:13,likeli:0,likewis:1,limit:0,line:[],liner:5,link:[1,4,5,7,11],linker:[0,3],lint:[0,2],linux:10,list:[0,3,5,8,9,10,14],littl:[2,11],load:2,loader:[3,5],local:[5,13],locat:[2,4,5,11],log:[1,3,9,13],logic:[1,9],longer:[1,3,8],lose:[1,7],lost:8,lot:9,low:13,lowest:14,made:[3,13],mai:[1,3,5,10,13],mail:[0,6,8,10],maintain:[0,3,4,6,7,9,10,12],mainten:[2,7,8],major:[0,7,10,11,14],make:[1,2,3,4,5,7,8,9,11,13],manag:[0,1,3,4,11],mani:[1,3,5,7,8,10,11],manual:[4,13],marker:11,match:[1,7,14],mean:[1,13],meaning:4,meant:[4,6,8,12],measur:0,meet:[1,3,9,13],member:[0,8],mention:9,mere:8,messag:[1,11,13],metadata:[3,4,8],method:2,mgorni:12,might:5,migrat:14,minim:7,minor:[0,6],mismatch:13,miss:[1,11],mistak:[0,1,11],modern:3,modul:7,moment:1,more:[2,5,9,10,11,13],most:2,motiv:4,mount:3,move:[2,3],mtab:3,much:[5,11],multi:2,multilib:4,multipl:[2,11,13],multislot:4,must:[1,3,4,5,6,7,8,13,14],name:[2,3,4,5],necessari:[1,5,8,13],need:[1,3,5,8,9,10,13,14],needless:1,neg:[5,6],neglect:6,neither:8,never:[3,5,9],nevertheless:10,newest:1,newli:13,next:14,nix:3,no_homepag:11,non:[0,1,2,3,6,9,11],nonfunct:1,nor:[1,8],normal:[3,11],notabl:[],notic:[1,5],number:[7,8,14],obsolet:9,obtain:13,offer:13,often:[6,8],old:[1,3,6,7,8,11],oldid:[1,6,11,13],omit:11,onc:[1,6,8],one:[1,3,5,6,7,8],ones:14,onli:[1,3,5,6,9,10],open:[1,14],oper:[4,10],oppon:1,opportun:1,opt:3,optfeatur:1,option:[4,11,13],order:[0,1,3,5,7,9],org:[1,2,3,6,7,11,13,14],organ:9,origin:[8,9,11],other:[0,1,2,3,4,5,6,7,8,9,12,13],otherwis:[1,5],out:[1,7,8,9,13],output:[],over:[0,6],overlai:11,overlap:2,overrid:[0,10],overspecifi:11,own:3,ownership:4,packag:[0,2,3,4,5,6,7,11,13,14],page:[2,4,9,10],paludi:1,paragraph:[],parallel:11,part:[1,2,3,9],partial:[2,9,10],particular:[5,9],partit:3,past:[2,9],patch:[],path:[0,4,5],per:13,period:0,permit:[1,2,3,8,11],person:[0,6,13],phase:[0,2,7,13],php:[1,6,11,13],pkg:5,pkgcheck:[0,1,2,3,6,7,11,13,14],place:[1,5,6],plain:[1,2],pleas:8,plugin:5,point:[1,3,5,9],pointless:14,polici:[1,5,6,8,11,12,13],port:7,portabl:[0,1,5],portag:[1,3],posix:[2,4],possibl:[0,1,2,7,8,9],potenti:5,practic:[0,5],pre:11,precis:9,predict:1,prefac:4,prefer:[1,7,13],prefix:[],prepar:7,prepend:[],preprocess:2,prerequisit:11,prevent:[1,8,14],previou:[0,1,6],primari:9,primit:14,principl:2,prioriti:13,privat:1,privileg:3,proactiv:4,problem:[0,1],proc:3,proceed:6,process:[4,6,10,12,14],profil:[3,8],program:[5,7,8],proj:3,project:[0,1,2,3,4,5,6,7,8,9,10,11,12,13],prolifer:5,prone:2,propag:1,proper:13,propon:1,propos:1,provid:[0,5,7,9,10,11,14],publish:[],pull:1,purpos:[3,4,11],push:[0,14],pypi:2,python:[4,8],python_2_end:7,python_compat:7,python_gen_cond_dep:7,python_single_target:7,python_single_usedep:7,python_target:7,python_usedep:7,qt4:13,qt5:13,qualiti:0,quality_assur:[1,6,11,13],queri:[9,11],question:[0,1,3,6,8,11],rang:[1,14],rapid:14,rather:[2,9,10,13],rational:[1,2,3,4,5,6,7,8,9,11,12,13,14],reach:7,readabl:3,readi:7,readm:1,realli:[5,9],reason:[1,3,14],reassign:8,rebuild:[1,5],recommend:[2,5,10,13,14],reconsid:1,recoveri:[3,5],reduc:[0,2,7],refer:[1,3,4,6,7,9,11,13,14],refin:1,refus:[0,8],regard:0,regular:[13,14],reject:9,rekeyword:4,rel:3,relat:[0,9],relev:[0,6],reli:[1,3],reliabl:[0,7],remain:6,remov:[1,4,5,7,11,13,14],render:2,repair:3,repeat:[0,2],replac:[5,9,13],repo:3,repoman:[0,1,2,3,6,14],report:[0,1,2,3,5,6,7,8,11,13,14],repositori:[0,9,10,11],request:[0,1,6,14],requir:[1,3,5,7,9,10,11,14],resembl:13,reserv:[13,14],resign:8,resolv:[0,11],respect:[],respond:6,respons:[1,11,13,14],restrict:[1,3,4,9,10],result:[1,14],retest:6,retir:7,reus:14,revers:[1,5,7],review:[10,14],revis:[3,4],risk:0,rite:6,role:0,root:3,rootf:3,rule:[2,6,10,11,13,14],run:[0,3],runtim:[4,7],same:[0,11,14],sbin:3,scale:9,scan:0,scatter:9,scope:11,score:3,script:[3,7],search:4,second:14,section:1,secur:5,select:14,self:3,send:8,sentenc:[],separ:[4,11],serv:14,servic:[0,5],set:[1,2,4,9,12,13],setgid:3,setup:[0,3],share:[3,5],sharealik:12,shell:5,shorter:13,should:[0,1,3,5,6,7,9,10,11,13,14],side:1,silent:8,similar:11,simpl:[13,14],simpli:1,simplifi:14,simultan:11,sinc:[2,3,5,11,13],singl:[2,9,11],site:[],size:5,skip:11,slack:6,slot:[4,7],small:[3,4,8],smaller:5,softwar:[0,3,10],sole:8,solut:1,some:[3,6,9],soon:7,sooner:7,sourc:[1,2,3,4,5,6,7,8,9,11,12,13,14],space:[3,11],span:1,special:[3,4,11,13],specif:[0,1,4,5,9,11,12,13],specifi:[1,2,10,11],spend:5,sphinx:[],spirit:9,split:8,src:3,src_uri:4,srv:3,ssh:[],stabil:4,stabl:[1,4],stale:9,standard:[2,4],start:[1,9,14],state:[3,4,11],still:[1,3,6,13],stop:[],strict:4,strictli:[3,11],strip:5,strongli:5,style:[1,4],sub:4,subdirectori:3,submit:[],subpag:11,subsequ:10,subset:6,subslot:4,subtli:3,success:14,suffer:8,suffici:9,suffix:3,suggest:10,summari:[1,3,13],supplement:[0,5],suppli:[4,12],support:[0,1,2,4,5,7,11,13],suppos:3,sure:8,surpris:[0,2],symbol:4,symlink:3,sync:14,synchron:14,syntax:2,system:[0,4,5,10,14],systemd:[0,5],tab:2,take:[0,1,6,8],target:4,task:0,team:[0,3,4,6,8,9,12,13],technic:[3,5,8,9,10,11,13],tent:1,term:7,termin:2,test:[0,2,4],text:12,than:[0,2,5,7,9,10,13],thei:[0,1,3,5,6,8,11,13],them:[0,3,5,8,9,10,13],themselv:5,therefor:[1,3,4,9,12],thi:[0,1,2,3,5,6,8,9,10,11,12,13,14],those:[0,2,3,7,8,11],three:[0,1],through:[7,10],tild:1,time:[0,1,6,7,9],timefram:1,tini:5,tip:9,titl:[1,6,11,13],todai:5,toggl:1,tool:[0,1,2,5],toolchain:[3,11],toolkit:13,top:3,topic:[],tox:[],tracker:11,tree:[0,3,4,9,10,12],trigger:[0,11],triplet:3,trivial:0,turn:[9,11],two:[0,11],txt:[1,3,13,14],udev:3,uid:14,unclear:9,uncommon:[1,5],uncondition:[5,11],undefin:11,under:[1,11,12],underscor:4,understand:9,unfair:8,unit:[0,5],unless:[1,5,7,8,14],unmaintain:8,unnecessari:[2,5,6,7,13],unnecessarili:[1,13],unpredict:11,unprefix:13,unreli:1,unset:11,until:7,unus:2,unwilling:0,updat:[1,4,9,10,12,14],upgrad:[7,11],upon:10,upstream:[3,7,11],uri:2,usag:[1,4,9],use:[0,2,3,4,5,7,9,11,13,14],use_expand:13,used:[1,2,3,5,7,8,11,13,14],usefulness:2,user:[0,1,3,4,5,7,8,11,13],uses:[1,7,11,13],using:[0,1,2,3,5,7,11,14],usr:4,usual:1,valid:13,valu:[1,2,3,4],variabl:[4,7],variant:3,variou:[0,8,9,13],verbatim:2,veri:[1,3,5,8,9,13,14],verifi:1,version:[1,2,3,4,11,14],versioned_use_flag:13,via:[2,3,9,10,11,13,14],violat:[0,11],virtualenv:[],wai:[1,9,13],want:[6,13],warn:1,wast:3,web:[3,11],well:[2,4,6,9,10,11,12],were:[1,2,5,6,9,11,14],what:8,when:[0,1,2,3,5,8,10,11,13],whenev:[1,2,3,5,6,10,11,13],where:3,whether:[0,1,6],which:[1,2,4,6,9,11,12,13],who:[1,5,6,8,9,13],whole:7,why:8,wide:0,wider:9,widget:13,width:2,wiki:[1,6,7,9,10,11,13],wildcard:1,wish:[5,13],within:[1,3,4,6,8,13],without:[0,2,3,4],word:9,work:[0,2,3,6,12,13],world:3,wors:8,would:[3,9],wrap:[],writabl:3,written:[0,1,8,9],wrong:3,www:11,xml:8,yet:1,you:1,your:1,zeroth:1},titles:["Basic information","Dependencies","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":[6,8],"static":[3,5],Adding:8,FHS:10,USE:[1,11,13],absolut:3,account:14,appeal:0,author:12,basic:0,build:[],bump:1,chang:[0,1],check:0,code:2,complianc:0,contain:2,contribut:[],depend:1,deprec:7,develop:10,document:[9,10],drop:6,dynam:11,ebuild:2,eclass:[2,7],edit:[],enforc:0,extern:10,file:[2,3,5],flag:[1,11,13],format:2,game:3,gentoo:[4,10],get:[],glep:10,goal:0,group:14,gui:13,guid:[4,9],histor:9,histori:9,homepag:[2,11],indic:4,inform:0,instal:[3,5],introduct:12,keyword:6,languag:7,layout:3,librari:[3,5],libtool:[3,5],licens:12,link:3,locat:3,maintain:8,make:0,manag:10,manual:10,meaning:11,metadata:11,motiv:9,multilib:3,multislot:11,must:[2,11],name:13,oper:1,option:1,other:[10,11],ownership:3,packag:[1,8,10],path:3,polici:[0,4,7,9,10,14],posix:10,prefac:12,proactiv:1,publish:[],purpos:9,python:7,refer:2,rekeyword:6,remov:[6,8],restrict:11,revis:1,runtim:1,send:[],separ:3,slot:[1,11],small:5,sourc:[],special:1,specif:[7,10],src_uri:2,stabil:6,stabl:6,standard:10,state:9,strict:3,style:2,sub:1,subslot:1,support:3,symbol:3,system:3,tabl:4,target:3,test:11,thi:[],todo:[3,6,13],underscor:13,updat:[],usag:7,use:1,user:14,usr:3,valu:11,variabl:[2,11],version:[6,13],within:2,without:[1,8]}})
\ No newline at end of file |