From a78e47e2d90aa050944b16b1fc1a3e62f83cef5f Mon Sep 17 00:00:00 2001 From: Michał Górny Date: Sun, 19 Jan 2020 11:52:41 +0100 Subject: Update wrt maintainers, keywording and new theme MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Michał Górny --- .buildinfo | 2 +- _sources/keywords.rst.txt | 45 +++ _sources/maintainer.rst.txt | 73 ++++ _static/tyrian-sphinx-theme.css | 857 ++++++++++++++++++++++++++++++++++++++++ basics.html | 260 +++++++++--- dependencies.html | 260 +++++++++--- ebuild-format.html | 260 +++++++++--- filesystem.html | 260 +++++++++--- genindex.html | 270 +++++++++---- index.html | 284 ++++++++++--- installed-files.html | 260 +++++++++--- keywords.html | 311 +++++++++++---- languages.html | 260 +++++++++--- maintainer.html | 329 +++++++++++++++ motivation.html | 260 +++++++++--- objects.inv | Bin 495 -> 515 bytes other-docs.html | 260 +++++++++--- other-metadata.html | 260 +++++++++--- preface.html | 260 +++++++++--- search.html | 234 +++++++---- searchindex.js | 2 +- use-flags.html | 260 +++++++++--- user-group.html | 252 +++++++++--- 23 files changed, 4464 insertions(+), 1055 deletions(-) create mode 100644 _sources/maintainer.rst.txt create mode 100644 _static/tyrian-sphinx-theme.css create mode 100644 maintainer.html diff --git a/.buildinfo b/.buildinfo index 35c77fd..f39f055 100644 --- a/.buildinfo +++ b/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: ce60be0b53d5203a8ff4274fb9b02171 +config: 9c01bbccf1639ca20e8f26ac6cc426f0 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/_sources/keywords.rst.txt b/_sources/keywords.rst.txt index 5dcbc77..272dca4 100644 --- a/_sources/keywords.rst.txt +++ b/_sources/keywords.rst.txt @@ -1,6 +1,51 @@ Keywording and stabilization ============================ +.. index:: keywords; rekeywording + +Rekeywording on dropped keywords +-------------------------------- +:Source: QA +:Reported: by pkgcheck and repoman + +The developer removing keywords from a package (e.g. due to new +dependencies) must file a rekeywording bug asking for the package being +retested. This rule can be exempted if the package is known not to work +(anymore) on the arch in question. + +*Rationale*: rekeywording on minor architectures often takes a long +time. If a developer neglects to request it immediately, it negatively +affects other developers who in the future either want to stabilize +a new version or to remove an old version. + + +.. index:: keywords; stabilizing new versions + +Stabilizing new versions +------------------------ +:Source: QA +:Reported: by pkgcheck + +Whenever requesting a stabilization of a new version of the package, +the developer must CC *all* arches that had at least one previous stable +version of the package in question, and that still have ~arch keywords +in the stabilized version. This applies to experimental architectures +as well. + +The stabilization request can be closed and old stable version removed +once all non-experimental architectures have processed the stabilization +request. However, the remaining arch teams should be kept CC-ed in case +they wanted to process the bug. + +*Rationale*: there were some cases of developers requesting +stabilization only of a subset of architectures they were personally +interested in. This meant some other developer had to independently +request stabilization on remaining architectures which only meant +a duplication of effort and unnecessary confusion over which version +is stable and whether arch teams are slacking or stabilization was not +requested on remaining architectures in the first place. + + .. index:: keywords; removing stable Removing stable keywords diff --git a/_sources/maintainer.rst.txt b/_sources/maintainer.rst.txt new file mode 100644 index 0000000..07dd3b1 --- /dev/null +++ b/_sources/maintainer.rst.txt @@ -0,0 +1,73 @@ +Package Maintainers +=================== + +.. index:: maintainer; adding + +Adding new maintainers +---------------------- +:Source: QA +:Reported: no + +Developers must not add other developers as package maintainers, unless +the developers in question consent to that. Developers must not add +projects that they are not members of as package maintainers, unless +one of the project members explicitly agrees to that or the project +policy explicitly permits it. + +*Rationale*: this policy aims to prevent package maintainers being added +as backup maintainers without their consent or knowledge. What's worse, +once the original maintainer resigns the packages frequently drop +to backup maintainers who are neither interested in maintaining them, +nor often aware why they are listed as maintainers. + +For example, developers used to frequently add Python team as a backup +maintainer to various packages not fitting the project's profile. This +includes various end-user programs written in Python. Many of those +packages ended up being maintained solely by Python, and distinguishing +them from packages actually within project's profile was hard. + + +.. index:: maintainer; new packages without + +New packages without a maintainer +--------------------------------- +:Source: QA +:Reported: no + +It is explicitly forbidden to add new packages without a dedicated +maintainer. This does not apply if the package in question is not +technically a new one but merely split out of unmaintained package. + +*Rationale*: Gentoo is currently suffering from a very large number +of packages without a maintainer. There is a small group of developers +trying to fix them as necessary. It is unfair and inappropriate +to increase their maintenance burden by adding new packages and refusing +to take care of them. + + +.. index:: maintainer; removing +.. index:: up for grabs + +Removing package maintainers +---------------------------- +:Source: QA +:Reported: no + +When removing maintainers from a package, the developer must reassign +all bugs filed for it. Furthermore, when removing the last maintainer +for a package, the developer must add the following comment +to ``metadata.xml``:: + + + +Furthermore, the developer must send an 'up for grabs' mail +to gentoo-dev mailing list, containing the list of packages with +no maintainer. If possible, please include any information that could +be helpful to future maintainers. + +*Rationale*: reassigning bugs is necessary to make sure that old bugs +are not lost assigned to developers who are no longer interested +in them. The maintainer-needed comment is meant to make it possible +to easily grep for unmaintained packages. The 'up for grabs' mails aim +to increase the chances of packages finding a new maintainers (compared +to them silently becoming maintainer-needed). diff --git a/_static/tyrian-sphinx-theme.css b/_static/tyrian-sphinx-theme.css new file mode 100644 index 0000000..9db8ecd --- /dev/null +++ b/_static/tyrian-sphinx-theme.css @@ -0,0 +1,857 @@ +@import url("basic.css"); + +/* -- page layout ----------------------------------------------------------- */ + +body { + font-family: Georgia, serif; + font-size: 17px; + background-color: #fff; + color: #000; + margin: 0; + padding: 0; +} + + +div.document { + width: 940px; + margin: 30px auto 0 auto; +} + +div.documentwrapper { + float: left; + width: 100%; +} + +div.bodywrapper { + margin: 0 0 0 220px; +} + +div.sphinxsidebar { + width: 220px; + font-size: 14px; + line-height: 1.5; +} + +hr { + border: 1px solid #B1B4B6; +} + +div.body { + background-color: #fff; + color: #3E4349; + padding: 0 30px 0 30px; +} + +div.body > .section { + text-align: left; +} + +div.footer { + width: 940px; + margin: 20px auto 30px auto; + font-size: 14px; + color: #888; + text-align: right; +} + +div.footer a { + color: #888; +} + +p.caption { + font-family: inherit; + font-size: inherit; +} + + +div.relations { + display: none; +} + + +div.sphinxsidebar a { + color: #444; + text-decoration: none; + border-bottom: 1px solid #999; +} + +div.sphinxsidebar a:hover { + border-bottom: 1px solid #999; +} + +div.sphinxsidebarwrapper { + padding: 18px 10px; +} + +div.sphinxsidebarwrapper p.logo { + padding: 0; + margin: -10px 0 0 0px; + text-align: center; +} + +div.sphinxsidebarwrapper h1.logo { + margin-top: -10px; + text-align: center; + margin-bottom: 5px; + text-align: left; +} + +div.sphinxsidebarwrapper h1.logo-name { + margin-top: 0px; +} + +div.sphinxsidebarwrapper p.blurb { + margin-top: 0; + font-style: normal; +} + +div.sphinxsidebar h3, +div.sphinxsidebar h4 { + font-family: Georgia, serif; + color: #444; + font-size: 24px; + font-weight: normal; + margin: 0 0 5px 0; + padding: 0; +} + +div.sphinxsidebar h4 { + font-size: 20px; +} + +div.sphinxsidebar h3 a { + color: #444; +} + +div.sphinxsidebar p.logo a, +div.sphinxsidebar h3 a, +div.sphinxsidebar p.logo a:hover, +div.sphinxsidebar h3 a:hover { + border: none; +} + +div.sphinxsidebar p { + color: #555; + margin: 10px 0; +} + +div.sphinxsidebar ul { + margin: 10px 0; + padding: 0; + color: #000; +} + +div.sphinxsidebar ul li.toctree-l1 > a { + font-size: 120%; +} + +div.sphinxsidebar ul li.toctree-l2 > a { + font-size: 110%; +} + +div.sphinxsidebar input { + border: 1px solid #CCC; + font-family: Georgia, serif; + font-size: 1em; +} + +div.sphinxsidebar hr { + border: none; + height: 1px; + color: #AAA; + background: #AAA; + + text-align: left; + margin-left: 0; + width: 50%; +} + +/* -- body styles ----------------------------------------------------------- */ + +a { + color: #004B6B; + text-decoration: underline; +} + +a:hover { + color: #6D4100; + text-decoration: underline; +} + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: Georgia, serif; + font-weight: normal; + margin: 30px 0px 10px 0px; + padding: 0; +} + +div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; } +div.body h2 { font-size: 180%; } +div.body h3 { font-size: 150%; } +div.body h4 { font-size: 130%; } +div.body h5 { font-size: 100%; } +div.body h6 { font-size: 100%; } + +a.headerlink { + color: #DDD; + padding: 0 4px; + text-decoration: none; +} + +a.headerlink:hover { + color: #444; + background: #EAEAEA; +} + +div.body p, div.body dd, div.body li { + line-height: 1.4em; +} + +div.admonition { + margin: 20px 0px; + padding: 10px 30px; + background-color: #EEE; + border: 1px solid #CCC; +} + +div.admonition tt.xref, div.admonition code.xref, div.admonition a tt { + background-color: #FBFBFB; + border-bottom: 1px solid #fafafa; +} + +div.admonition p.admonition-title { + font-family: Georgia, serif; + font-weight: normal; + font-size: 24px; + margin: 0 0 10px 0; + padding: 0; + line-height: 1; +} + +div.admonition p.last { + margin-bottom: 0; +} + +div.highlight { + background-color: #fff; +} + +dt:target, .highlight { + background: #FAF3E8; +} + +div.warning { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.danger { + background-color: #FCC; + border: 1px solid #FAA; + -moz-box-shadow: 2px 2px 4px #D52C2C; + -webkit-box-shadow: 2px 2px 4px #D52C2C; + box-shadow: 2px 2px 4px #D52C2C; +} + +div.error { + background-color: #FCC; + border: 1px solid #FAA; + -moz-box-shadow: 2px 2px 4px #D52C2C; + -webkit-box-shadow: 2px 2px 4px #D52C2C; + box-shadow: 2px 2px 4px #D52C2C; +} + +div.caution { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.attention { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.important { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.note { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.tip { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.hint { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.seealso { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.topic { + background-color: #EEE; +} + +p.admonition-title { + display: inline; +} + +p.admonition-title:after { + content: ":"; +} + +pre, tt, code { + font-family: 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace; + font-size: 0.9em; +} + +.hll { + background-color: #FFC; + margin: 0 -12px; + padding: 0 12px; + display: block; +} + +img.screenshot { +} + +tt.descname, tt.descclassname, code.descname, code.descclassname { + font-size: 0.95em; +} + +tt.descname, code.descname { + padding-right: 0.08em; +} + +img.screenshot { + -moz-box-shadow: 2px 2px 4px #EEE; + -webkit-box-shadow: 2px 2px 4px #EEE; + box-shadow: 2px 2px 4px #EEE; +} + +table.docutils { + border: 1px solid #888; + -moz-box-shadow: 2px 2px 4px #EEE; + -webkit-box-shadow: 2px 2px 4px #EEE; + box-shadow: 2px 2px 4px #EEE; +} + +table.docutils td, table.docutils th { + border: 1px solid #888; + padding: 0.25em 0.7em; +} + +table.field-list, table.footnote { + border: none; + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} + +table.footnote { + margin: 15px 0; + width: 100%; + border: 1px solid #EEE; + background: #FDFDFD; + font-size: 0.9em; +} + +table.footnote + table.footnote { + margin-top: -15px; + border-top: none; +} + +table.field-list th { + padding: 0 0.8em 0 0; +} + +table.field-list td { + padding: 0; +} + +table.field-list p { + margin-bottom: 0.8em; +} + +/* Cloned from + * https://github.com/sphinx-doc/sphinx/commit/ef60dbfce09286b20b7385333d63a60321784e68 + */ +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +table.footnote td.label { + width: .1px; + padding: 0.3em 0 0.3em 0.5em; +} + +table.footnote td { + padding: 0.3em 0.5em; +} + +dl { + margin: 0; + padding: 0; +} + +dl dd { + margin-left: 30px; +} + +blockquote { + margin: 0 0 0 30px; + padding: 0; +} + +ul, ol { + /* Matches the 30px from the narrow-screen "li > ul" selector below */ + margin: 10px 0 10px 30px; + padding: 0; +} + +pre { + background: #EEE; + padding: 7px 30px; + margin: 15px 0px; + line-height: 1.3em; +} + +div.viewcode-block:target { + background: #ffd; +} + +dl pre, blockquote pre, li pre { + margin-left: 0; + padding-left: 30px; +} + +tt, code { + background-color: #ecf0f3; + color: #222; + /* padding: 1px 2px; */ +} + +tt.xref, code.xref, a tt { + background-color: #FBFBFB; + border-bottom: 1px solid #fff; +} + +a.reference { + text-decoration: none; + border-bottom: none; +} + +/* Don't put an underline on images */ +a.image-reference, a.image-reference:hover { + border-bottom: none; +} + +a.reference:hover { + border-bottom: none; +} + +a.footnote-reference { + text-decoration: none; + font-size: 0.7em; + vertical-align: top; + border-bottom: 1px dotted #004B6B; +} + +a.footnote-reference:hover { + border-bottom: 1px solid #6D4100; +} + +a:hover tt, a:hover code { + background: #EEE; +} + + +@media screen and (max-width: 870px) { + + div.sphinxsidebar { + display: none; + } + + div.document { + width: 100%; + + } + + div.documentwrapper { + margin-left: 0; + margin-top: 0; + margin-right: 0; + margin-bottom: 0; + } + + div.bodywrapper { + margin-top: 0; + margin-right: 0; + margin-bottom: 0; + margin-left: 0; + } + + ul { + margin-left: 0; + } + + li > ul { + /* Matches the 30px from the "ul, ol" selector above */ + margin-left: 30px; + } + + .document { + width: auto; + } + + .footer { + width: auto; + } + + .bodywrapper { + margin: 0; + } + + .footer { + width: auto; + } + + .github { + display: none; + } + + + +} + + + +@media screen and (max-width: 875px) { + + body { + margin: 0; + } + + div.documentwrapper { + float: none; + background: #fff; + } + + div.sphinxsidebar { + display: block; + float: none; + width: 102.5%; + margin: 50px -30px -20px -30px; + padding: 10px 20px; + background: #333; + color: #FFF; + } + + div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p, + div.sphinxsidebar h3 a { + color: #fff; + } + + div.sphinxsidebar a { + color: #AAA; + } + + div.sphinxsidebar p.logo { + display: none; + } + + div.document { + width: 100%; + margin: 0; + } + + div.footer { + display: none; + } + + div.bodywrapper { + margin: 0; + } + + div.body { + min-height: 0; + padding: 0; + } + + .rtd_doc_footer { + display: none; + } + + .document { + width: auto; + } + + .footer { + width: auto; + } + + .footer { + width: auto; + } + + .github { + display: none; + } +} + + +/* misc. */ + +.revsys-inline { + display: none!important; +} + +/* Make nested-list/multi-paragraph items look better in Releases changelog + * pages. Without this, docutils' magical list fuckery causes inconsistent + * formatting between different release sub-lists. + */ +div#changelog > div.section > ul > li > p:only-child { + margin-bottom: 0; +} + +/* Hide fugly table cell borders in ..bibliography:: directive output */ +table.docutils.citation, table.docutils.citation td, table.docutils.citation th { + border: none; + /* Below needed in some edge cases; if not applied, bottom shadows appear */ + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} + + +/* relbar */ + +.related { + line-height: 30px; + width: 100%; + font-size: 0.9rem; +} + +.related.top { + border-bottom: 1px solid #EEE; + margin-bottom: 20px; +} + +.related.bottom { + border-top: 1px solid #EEE; +} + +.related ul { + padding: 0; + margin: 0; + list-style: none; +} + +.related li { + display: inline; +} + +nav#rellinks { + float: right; +} + +nav#rellinks li+li:before { + content: "|"; +} + +nav#breadcrumbs li+li:before { + content: "\00BB"; +} + +/* Hide certain items when printing */ +@media print { + div.related { + display: none; + } +} + + +.bs-docs-sidebar { + padding-left: 20px; + margin-top: 20px; + margin-bottom: 20px; +} + + +.bs-docs-sidebar .nav>li>a { + color: #767676; + border-left: 2px solid transparent; + padding: 4px 20px; + font-size: 13px; + font-weight: 400; +} + +.bs-docs-sidebar .nav .nav>li>a { + padding-top: 1px; + padding-bottom: 1px; + padding-left: 30px; + font-size: 12px; +} + +.bs-docs-sidebar .nav>.current>a, +.bs-docs-sidebar .nav>.active>a, +.bs-docs-sidebar .nav>li>a:hover, +.bs-docs-sidebar .nav>li>a:focus { + color: #54487A; + text-decoration: none; + background-color: transparent; + border-left-color: #54487A; +} + +.bs-docs-sidebar .nav>.current>a, +.bs-docs-sidebar .nav>.current:hover>a, +.bs-docs-sidebar .nav>.current:focus>a, +.bs-docs-sidebar .nav>.active>a, +.bs-docs-sidebar .nav>.active:hover>a, +.bs-docs-sidebar .nav>.active:focus>a { + font-weight: 700; +} + +.bs-docs-sidebar .nav .nav>.active>a, +.bs-docs-sidebar .nav .nav>.active:hover>a, +.bs-docs-sidebar .nav .nav>.active:focus>a { + font-weight: 500; +} + +.bs-docs-sidebar .nav ul.nav { + display: none; +} + +.bs-docs-sidebar .nav>.current>ul.nav, +.bs-docs-sidebar .nav>.active>ul.nav { + display: block; +} + +.bs-docs-sidebar > .caption { + display: none!important; +} + + +#collapseExample > p { + display: none!important; +} + + +.bs-docs-sidebar.affix { + top: 10px!important; +} + +h2 { + margin-top: 40px!important; + padding-bottom: 5px; + border-bottom: 1px solid #eee; +} + +.collapsed > li > ul { + display:block!important; +} + +body { + min-height: 100vh; + position: relative; + margin: 0; + padding-bottom: 215px; +} + +footer { + position: absolute; + margin-top: 40px; + bottom: 0; + width: 100%; +} + +.site-welcome { + font-size:2.5em; + text-align:center; + margin-bottom:1em +} + +@media (max-width: 870px) { + .simple > li { + margin-left: 30px; + } +} + +@media (min-width: 351px) { + .site-logo { + height: 63px; + width: 191px; + background: url(https://assets.gentoo.org/tyrian/site-logo.png); + background: url(https://assets.gentoo.org/tyrian/site-logo.svg), + linear-gradient(transparent, transparent); + } +} + +@media (max-width: 350px) { + .site-logo { + margin-top: 7px; + height: 49px!important; + width: 49px!important; + background: url(https://www.gentoo.org/assets/img/logo/gentoo-signet.svg); + background: url(https://www.gentoo.org/assets/img/logo/gentoo-signet.svg), + linear-gradient(transparent, transparent); + } +} + + +@media (min-width: 351px) { + .site-label{ + vertical-align: 2.75em!important; + margin-left: 15px; + } +} + +@media (max-width: 350px) { + .site-label{ + vertical-align: 2em!important; + margin-left: 5px; + } +} + + +.gentoo_svg_logo { + content:url("https://assets.gentoo.org/tyrian/site-logo.svg"); +} + +.gentoo_logo { + content:url("https://assets.gentoo.org/tyrian/site-logo.svg"); +} + +h1 + div > h2 { + margin-top: 15px !important; +} + +h1 + span + div > span + h2 { + margin-top: 15px !important; +} + +#custom_toc { + width:auto;margin-bottom:30px;padding:5px;display: none; +} + +@media (max-width: 870px) { + #collapseExample { + padding-left:20px; + } +} \ No newline at end of file diff --git a/basics.html b/basics.html index 45f77bb..93cf1cc 100644 --- a/basics.html +++ b/basics.html @@ -1,12 +1,19 @@ - + - + + + Basic information — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
+
+
+
+
+
+ Get Gentoo! +
+ + + + +
+
+
+ +
+
+
+ +
-
-
-
- -
- +
+
+ + + +
+ + + + + +

Basic information

@@ -104,27 +185,50 @@ be appealed to the -
-

Gentoo Policy Guide

- - - + + + +
+
+ + + + + Motivation and history + + + +
+
+ + + + Other policy documents + + + + +
+
+ + + +
+ + +
+
+
+
+
+
+
+

Gentoo Policy Guide

+
+
+ Powered by
Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
+
+
+
+
+
+
+
+

Questions or comments?

+ Please feel free to contact us. +
+
+
+
+
    +
    • +
    • +
    • +
+
+
+ © 2001–2020 Gentoo Foundation, Inc.
+ + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
+
+
+
+ + + -
-
-
-
-
- ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
- + + - \ No newline at end of file + + diff --git a/dependencies.html b/dependencies.html index 40201d3..95040d3 100644 --- a/dependencies.html +++ b/dependencies.html @@ -1,12 +1,19 @@ - + - + + + Dependencies — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
+
+
+
+
+
+ Get Gentoo! +
+ + + + +
+
+
+ +
+
+
+ +
-
-
-
- -
- +
+
+ + + +
+ + + + + +

Dependencies

@@ -176,29 +257,52 @@ if the package installed by the user still links to libfoo.

-
- -
-
- +
+
+
+
+
+
+

Gentoo Policy Guide

+
+
+ Powered by
Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
+
+
+
+
+
+
+
+

Questions or comments?

+ Please feel free to contact us. +
+
+
+
+
    +
    • +
    • +
    • +
+
+
+ © 2001–2020 Gentoo Foundation, Inc.
+ + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
+
+
+
+ + + -
-
-
-
-
- ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
- + + - \ No newline at end of file + + diff --git a/ebuild-format.html b/ebuild-format.html index 8ecd823..e84ed58 100644 --- a/ebuild-format.html +++ b/ebuild-format.html @@ -1,12 +1,19 @@ - + - + + + Ebuild file format — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
+
+
+
+
+
+ Get Gentoo! +
+ + + + +
+
+
+ +
+
+
+ +
-
-
-
- -
- +
+
+ + + +
+ + + + + +

Ebuild file format

@@ -124,30 +205,53 @@ index.

-
- -
-
- +
+
+
+
+
+
+

Gentoo Policy Guide

+
+
+ Powered by
Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
+
+
+
+
+
+
+
+

Questions or comments?

+ Please feel free to contact us. +
+
+
+
+
    +
    • +
    • +
    • +
+
+
+ © 2001–2020 Gentoo Foundation, Inc.
+ + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
+
+
+
+ + + -
-
-
-
-
- ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
- + + - \ No newline at end of file + + diff --git a/filesystem.html b/filesystem.html index f5e33f8..733458b 100644 --- a/filesystem.html +++ b/filesystem.html @@ -1,12 +1,19 @@ - + - + + + File system layout — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
+
+
+
+
+
+ Get Gentoo! +
+ + + + +
+
+
+ +
+
+
+ +
-
-
-
- -
- +
+
+ + + +
+ + + + + +

File system layout

@@ -208,31 +289,54 @@ fulfill that purpose.

-
- -
-
- +
+
+
+
+
+
+

Gentoo Policy Guide

+
+
+ Powered by
Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
+
+
+
+
+
+
+
+

Questions or comments?

+ Please feel free to contact us. +
+
+
+
+
    +
    • +
    • +
    • +
+
+
+ © 2001–2020 Gentoo Foundation, Inc.
+ + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
+
+
+
+ + + -
-
-
-
-
- ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
- + + - \ No newline at end of file + + diff --git a/genindex.html b/genindex.html index f1dcab6..4b8b28b 100644 --- a/genindex.html +++ b/genindex.html @@ -1,36 +1,117 @@ - + - + + + Index — Gentoo Policy Guide documentation - + + + + + + - - - - - - - + - - -
-
-
- +
+
+
+
+
+
+ Get Gentoo! +
+ + + + +
+
+
+ +
+
+
+ +
+ + +
+
+ + + +
+ + + + -
- +

Index

@@ -44,6 +125,7 @@ | I | K | L + | M | P | Q | R @@ -192,7 +274,11 @@ keywords @@ -213,6 +299,23 @@ +

M

+ + +
+

P

    @@ -295,6 +398,8 @@

    U

  • Keywording and stabilization
    • @@ -101,6 +184,12 @@ in which the policy can be updated.

  • Python
    • +
  • Package Maintainers +
  • Other metadata variables @@ -127,24 +216,40 @@ in which the policy can be updated.

    - - - - - +
    + +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + +
    +

    Contents

    +
    +
    +
    + + + + + + + - - -
    - -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + + - \ No newline at end of file + + diff --git a/installed-files.html b/installed-files.html index cd19af2..e68a53c 100644 --- a/installed-files.html +++ b/installed-files.html @@ -1,12 +1,19 @@ - + - + + + Installed files — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Installed files

    @@ -121,24 +202,47 @@ unnecessary and potentially harmful.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/keywords.html b/keywords.html index 5052f26..e83ce12 100644 --- a/keywords.html +++ b/keywords.html @@ -1,12 +1,19 @@ - + - + + + Keywording and stabilization — Gentoo Policy Guide documentation - + + + + + + @@ -15,27 +22,147 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    + + +
    +
    + + + +
    + + + + + +

    Keywording and stabilization

    +
    +

    Rekeywording on dropped keywords

    +
    +
    Source
    +

    QA

    +
    +
    Reported
    +

    by pkgcheck and repoman

    +
    +
    +

    The developer removing keywords from a package (e.g. due to new +dependencies) must file a rekeywording bug asking for the package being +retested. This rule can be exempted if the package is known not to work +(anymore) on the arch in question.

    +

    Rationale: rekeywording on minor architectures often takes a long +time. If a developer neglects to request it immediately, it negatively +affects other developers who in the future either want to stabilize +a new version or to remove an old version.

    +
    +
    +

    Stabilizing new versions

    +
    +
    Source
    +

    QA

    +
    +
    Reported
    +

    by pkgcheck

    +
    +
    +

    Whenever requesting a stabilization of a new version of the package, +the developer must CC all arches that had at least one previous stable +version of the package in question, and that still have ~arch keywords +in the stabilized version. This applies to experimental architectures +as well.

    +

    The stabilization request can be closed and old stable version removed +once all non-experimental architectures have processed the stabilization +request. However, the remaining arch teams should be kept CC-ed in case +they wanted to process the bug.

    +

    Rationale: there were some cases of developers requesting +stabilization only of a subset of architectures they were personally +interested in. This meant some other developer had to independently +request stabilization on remaining architectures which only meant +a duplication of effort and unnecessary confusion over which version +is stable and whether arch teams are slacking or stabilization was not +requested on remaining architectures in the first place.

    +
    -

    Removing stable keywords

    +

    Removing stable keywords

    Source

    QA

    @@ -58,24 +185,47 @@ of last rite mails.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    - -
    - -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/languages.html b/languages.html index c9503e9..48b6b0f 100644 --- a/languages.html +++ b/languages.html @@ -1,12 +1,19 @@ - + - + + + Language-specific policies — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Language-specific policies

    @@ -101,24 +182,47 @@ will cause major upgrade issues.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/maintainer.html b/maintainer.html new file mode 100644 index 0000000..f930f0d --- /dev/null +++ b/maintainer.html @@ -0,0 +1,329 @@ + + + + + + + + + Package Maintainers — Gentoo Policy Guide documentation + + + + + + + + + + + + + + + + + +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    + + +
    +
    + + + +
    + + + + + + +
    +

    Package Maintainers

    +
    +

    Adding new maintainers

    +
    +
    Source
    +

    QA

    +
    +
    Reported
    +

    no

    +
    +
    +

    Developers must not add other developers as package maintainers, unless +the developers in question consent to that. Developers must not add +projects that they are not members of as package maintainers, unless +one of the project members explicitly agrees to that or the project +policy explicitly permits it.

    +

    Rationale: this policy aims to prevent package maintainers being added +as backup maintainers without their consent or knowledge. What’s worse, +once the original maintainer resigns the packages frequently drop +to backup maintainers who are neither interested in maintaining them, +nor often aware why they are listed as maintainers.

    +

    For example, developers used to frequently add Python team as a backup +maintainer to various packages not fitting the project’s profile. This +includes various end-user programs written in Python. Many of those +packages ended up being maintained solely by Python, and distinguishing +them from packages actually within project’s profile was hard.

    +
    +
    +

    New packages without a maintainer

    +
    +
    Source
    +

    QA

    +
    +
    Reported
    +

    no

    +
    +
    +

    It is explicitly forbidden to add new packages without a dedicated +maintainer. This does not apply if the package in question is not +technically a new one but merely split out of unmaintained package.

    +

    Rationale: Gentoo is currently suffering from a very large number +of packages without a maintainer. There is a small group of developers +trying to fix them as necessary. It is unfair and inappropriate +to increase their maintenance burden by adding new packages and refusing +to take care of them.

    +
    +
    +

    Removing package maintainers

    +
    +
    Source
    +

    QA

    +
    +
    Reported
    +

    no

    +
    +
    +

    When removing maintainers from a package, the developer must reassign +all bugs filed for it. Furthermore, when removing the last maintainer +for a package, the developer must add the following comment +to metadata.xml:

    +
    <!-- maintainer-needed -->
+
    +
    +

    Furthermore, the developer must send an ‘up for grabs’ mail +to gentoo-dev mailing list, containing the list of packages with +no maintainer. If possible, please include any information that could +be helpful to future maintainers.

    +

    Rationale: reassigning bugs is necessary to make sure that old bugs +are not lost assigned to developers who are no longer interested +in them. The maintainer-needed comment is meant to make it possible +to easily grep for unmaintained packages. The ‘up for grabs’ mails aim +to increase the chances of packages finding a new maintainers (compared +to them silently becoming maintainer-needed).

    +
    +
    + + + + + + +
    +
    + + + + + Language-specific policies + + + +
    + +
    + + + + Other metadata variables + + + + +
    +
    + + + + +
    + + + + +
    +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + + + + + + + + + + + + + + + + diff --git a/motivation.html b/motivation.html index 21aaa91..de6abd7 100644 --- a/motivation.html +++ b/motivation.html @@ -1,12 +1,19 @@ - + - + + + Motivation and history — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Motivation and history

    @@ -80,26 +161,49 @@ devmanual) should conform to policies stated here.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/objects.inv b/objects.inv index 31d1ef4..b0f3f34 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/other-docs.html b/other-docs.html index 532f33f..2cc4581 100644 --- a/other-docs.html +++ b/other-docs.html @@ -1,12 +1,19 @@ - + - + + + Other policy documents — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Other policy documents

    @@ -84,28 +165,51 @@ disagree, Gentoo policies should be followed.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/other-metadata.html b/other-metadata.html index 911a78c..e86abab 100644 --- a/other-metadata.html +++ b/other-metadata.html @@ -1,12 +1,19 @@ - + - + + + Other metadata variables — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Other metadata variables

    @@ -72,24 +153,47 @@ invalidation or explicit errors.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/preface.html b/preface.html index c780ca3..c5f509f 100644 --- a/preface.html +++ b/preface.html @@ -1,12 +1,19 @@ - + - + + + Preface — Gentoo Policy Guide documentation - + + + + + + @@ -15,23 +22,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Preface

    @@ -60,25 +141,48 @@ in which the policy can be updated.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/search.html b/search.html index 3062d84..05708c2 100644 --- a/search.html +++ b/search.html @@ -1,12 +1,19 @@ - + - + + + Search — Gentoo Policy Guide documentation - + + + + + + @@ -17,24 +24,98 @@ - - - - - - - - -
    -
    -
    - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    + + +
    +
    + + + +
    + + + + -
    - +

    Search

    @@ -59,69 +140,88 @@
    -
    - -
    -
    - +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

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

    USE flags

    @@ -121,24 +202,47 @@ or underscores depending on developer’s personal preference.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + diff --git a/user-group.html b/user-group.html index 040a3c1..700ef2e 100644 --- a/user-group.html +++ b/user-group.html @@ -1,12 +1,19 @@ - + - + + + Users and groups — Gentoo Policy Guide documentation - + + + + + + @@ -14,23 +21,97 @@ - - - - - - - + - +
    +
    +
    +
    +
    +
    + Get Gentoo! +
    + + + + +
    +
    +
    + +
    +
    +
    + +
    -
    -
    -
    - -
    - +
    +
    + + + +
    + + + + + +

    Users and groups

    @@ -83,24 +164,40 @@ been reserved for true system users and groups.

    -
    - -
    -
    - +
    +
    +
    +
    +
    +
    +

    Gentoo Policy Guide

    +
    +
    + Powered by
    Sphinx 2.3.1 & Tyrian Theme 0.0.1 +
    +
    +
    +
    +
    +
    +
    +
    +

    Questions or comments?

    + Please feel free to contact us. +
    +
    +
    +
    +
      +
      • +
      • +
      • +
    +
    +
    + © 2001–2020 Gentoo Foundation, Inc.
    + + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + CC-BY-SA-3.0 license. + The Gentoo Name and Logo Usage Guidelines apply. + +
    +
    +
    +
    + + + -
    -
    -
    -
    -
    - ©2020, Gentoo Authors. - - | - Powered by Sphinx 2.3.1 - & Alabaster 0.7.12 - - | - Page source -
    - + + - \ No newline at end of file + + -- cgit v1.2.3-65-gdbad