summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2020-01-19 11:52:41 +0100
committerMichał Górny <mgorny@gentoo.org>2020-01-19 11:52:41 +0100
commita78e47e2d90aa050944b16b1fc1a3e62f83cef5f (patch)
tree8a4d50ed7bbbf056598961d3ba2fc2b63d3fbd09
parentUpload first built version (diff)
downloadpolicy-guide-a78e47e2d90aa050944b16b1fc1a3e62f83cef5f.tar.gz
policy-guide-a78e47e2d90aa050944b16b1fc1a3e62f83cef5f.tar.bz2
policy-guide-a78e47e2d90aa050944b16b1fc1a3e62f83cef5f.zip
Update wrt maintainers, keywording and new theme
Signed-off-by: Michał Górny <mgorny@gentoo.org>
-rw-r--r--.buildinfo2
-rw-r--r--_sources/keywords.rst.txt45
-rw-r--r--_sources/maintainer.rst.txt73
-rw-r--r--_static/tyrian-sphinx-theme.css857
-rw-r--r--basics.html260
-rw-r--r--dependencies.html260
-rw-r--r--ebuild-format.html260
-rw-r--r--filesystem.html260
-rw-r--r--genindex.html270
-rw-r--r--index.html284
-rw-r--r--installed-files.html260
-rw-r--r--keywords.html311
-rw-r--r--languages.html260
-rw-r--r--maintainer.html329
-rw-r--r--motivation.html260
-rw-r--r--objects.invbin495 -> 515 bytes
-rw-r--r--other-docs.html260
-rw-r--r--other-metadata.html260
-rw-r--r--preface.html260
-rw-r--r--search.html234
-rw-r--r--searchindex.js2
-rw-r--r--use-flags.html260
-rw-r--r--user-group.html252
23 files changed, 4464 insertions, 1055 deletions
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``::
+
+ <!-- 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).
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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Basic information &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Other policy documents" href="other-docs.html" />
- <link rel="prev" title="Motivation and history" href="motivation.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Motivation and history" href="motivation.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/basics.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="basic-information">
<h1>Basic information<a class="headerlink" href="#basic-information" title="Permalink to this headline">¶</a></h1>
<div class="section" id="goals-of-policy-making">
@@ -104,27 +185,50 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="motivation.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Motivation and history
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="other-docs.html" class="pull-right" style="color:#767676;">
+
+ Other policy documents
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Basic information</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Basic information</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#goals-of-policy-making">Goals of policy making</a></li>
<li class="toctree-l2"><a class="reference internal" href="#policy-compliance-checking">Policy compliance checking</a></li>
<li class="toctree-l2"><a class="reference internal" href="#policy-enforcement">Policy enforcement</a></li>
@@ -143,51 +247,77 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="motivation.html" title="previous chapter">Motivation and history</a></li>
- <li>Next: <a href="other-docs.html" title="next chapter">Other policy documents</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/basics.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/dependencies.html b/dependencies.html
index 40201d3..95040d3 100644
--- a/dependencies.html
+++ b/dependencies.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Dependencies &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Ebuild file format" href="ebuild-format.html" />
- <link rel="prev" title="Other policy documents" href="other-docs.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Other policy documents" href="other-docs.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/dependencies.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="dependencies">
<h1>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this headline">¶</a></h1>
<span class="target" id="index-0"></span><div class="section" id="optional-runtime-dependencies">
@@ -176,29 +257,52 @@ if the package installed by the user still links to libfoo.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="other-docs.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Other policy documents
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="ebuild-format.html" class="pull-right" style="color:#767676;">
+
+ Ebuild file format
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Dependencies</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Dependencies</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#optional-runtime-dependencies">Optional runtime dependencies</a></li>
<li class="toctree-l2"><a class="reference internal" href="#slot-and-subslot-dependencies">Slot and subslot dependencies</a></li>
<li class="toctree-l2"><a class="reference internal" href="#revision-bumps-on-runtime-dependency-changes">Revision bumps on runtime dependency changes</a></li>
@@ -214,51 +318,77 @@ if the package installed by the user still links to libfoo.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="other-docs.html" title="previous chapter">Other policy documents</a></li>
- <li>Next: <a href="ebuild-format.html" title="next chapter">Ebuild file format</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/dependencies.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Ebuild file format &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="File system layout" href="filesystem.html" />
- <link rel="prev" title="Dependencies" href="dependencies.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Dependencies" href="dependencies.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/ebuild-format.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="ebuild-file-format">
<h1>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Permalink to this headline">¶</a></h1>
<div class="section" id="coding-style">
@@ -124,30 +205,53 @@ index.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="dependencies.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Dependencies
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="filesystem.html" class="pull-right" style="color:#767676;">
+
+ File system layout
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li>
<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Ebuild file format</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Ebuild file format</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#coding-style">Coding style</a></li>
<li class="toctree-l2"><a class="reference internal" href="#code-must-be-contained-within-ebuild-and-eclasses">Code must be contained within ebuild and eclasses</a></li>
<li class="toctree-l2"><a class="reference internal" href="#homepage-must-not-contain-variables">HOMEPAGE must not contain variables</a></li>
@@ -163,51 +267,77 @@ index.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="dependencies.html" title="previous chapter">Dependencies</a></li>
- <li>Next: <a href="filesystem.html" title="next chapter">File system layout</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/ebuild-format.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/filesystem.html b/filesystem.html
index f5e33f8..733458b 100644
--- a/filesystem.html
+++ b/filesystem.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>File system layout &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Installed files" href="installed-files.html" />
- <link rel="prev" title="Ebuild file format" href="ebuild-format.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Ebuild file format" href="ebuild-format.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/filesystem.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="file-system-layout">
<h1>File system layout<a class="headerlink" href="#file-system-layout" title="Permalink to this headline">¶</a></h1>
<div class="section" id="installation-paths">
@@ -208,31 +289,54 @@ fulfill that purpose.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="ebuild-format.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Ebuild file format
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="installed-files.html" class="pull-right" style="color:#767676;">
+
+ Installed files
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li>
<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li>
<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">File system layout</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">File system layout</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#installation-paths">Installation paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="#support-for-separate-usr">Support for separate /usr</a></li>
<li class="toctree-l2"><a class="reference internal" href="#strict-multilib-layout">Strict multilib layout</a></li>
@@ -248,51 +352,77 @@ fulfill that purpose.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="ebuild-format.html" title="previous chapter">Ebuild file format</a></li>
- <li>Next: <a href="installed-files.html" title="next chapter">Installed files</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/filesystem.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/genindex.html b/genindex.html
index f1dcab6..4b8b28b 100644
--- a/genindex.html
+++ b/genindex.html
@@ -1,36 +1,117 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Index &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/language_data.js"></script>
<link rel="index" title="Index" href="#" />
- <link rel="search" title="Search" href="search.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="search" title="Search" href="search.html" />
</head><body>
-
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="https://gitweb.gentoo.org/proj/policy-guide.git/">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li class="active">
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
+
+
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
- <div class="body" role="main">
-
+
<h1 id="index">Index</h1>
@@ -44,6 +125,7 @@
| <a href="#I"><strong>I</strong></a>
| <a href="#K"><strong>K</strong></a>
| <a href="#L"><strong>L</strong></a>
+ | <a href="#M"><strong>M</strong></a>
| <a href="#P"><strong>P</strong></a>
| <a href="#Q"><strong>Q</strong></a>
| <a href="#R"><strong>R</strong></a>
@@ -192,7 +274,11 @@
keywords
<ul>
- <li><a href="keywords.html#index-0">removing stable</a>
+ <li><a href="keywords.html#index-0">rekeywording</a>
+</li>
+ <li><a href="keywords.html#index-2">removing stable</a>
+</li>
+ <li><a href="keywords.html#index-1">stabilizing new versions</a>
</li>
</ul></li>
</ul></td>
@@ -213,6 +299,23 @@
</ul></td>
</tr></table>
+<h2 id="M">M</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%; vertical-align: top;"><ul>
+ <li>
+ maintainer
+
+ <ul>
+ <li><a href="maintainer.html#index-0">adding</a>
+</li>
+ <li><a href="maintainer.html#index-1">new packages without</a>
+</li>
+ <li><a href="maintainer.html#index-2">removing</a>
+</li>
+ </ul></li>
+ </ul></td>
+</tr></table>
+
<h2 id="P">P</h2>
<table style="width: 100%" class="indextable genindextable"><tr>
<td style="width: 33%; vertical-align: top;"><ul>
@@ -295,6 +398,8 @@
<h2 id="U">U</h2>
<table style="width: 100%" class="indextable genindextable"><tr>
<td style="width: 33%; vertical-align: top;"><ul>
+ <li><a href="maintainer.html#index-3">up for grabs</a>
+</li>
<li>
USE flags
@@ -325,79 +430,88 @@
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
-
-
-
+
+
+
+
+
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
-<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
-<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li>
-<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li>
-<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li>
-<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
-<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
-<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
-<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
-<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li>
-<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
-</ul>
+ </div>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/index.html b/index.html
index 1229b1a..1ae837a 100644
--- a/index.html
+++ b/index.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Gentoo Policy Guide &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -14,23 +21,97 @@
<script type="text/javascript" src="_static/language_data.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
- <link rel="next" title="Preface" href="preface.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="next" title="Preface" href="preface.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li class="active">
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/index.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
- <div class="body" role="main">
-
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
+
+
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="gentoo-policy-guide">
<h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Permalink to this headline">¶</a></h1>
<p>Gentoo Policy Guide aims to become a definitive clear source of all
@@ -94,6 +175,8 @@ in which the policy can be updated.</p>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="keywords.html#rekeywording-on-dropped-keywords">Rekeywording on dropped keywords</a></li>
+<li class="toctree-l2"><a class="reference internal" href="keywords.html#stabilizing-new-versions">Stabilizing new versions</a></li>
<li class="toctree-l2"><a class="reference internal" href="keywords.html#removing-stable-keywords">Removing stable keywords</a></li>
</ul>
</li>
@@ -101,6 +184,12 @@ in which the policy can be updated.</p>
<li class="toctree-l2"><a class="reference internal" href="languages.html#python">Python</a></li>
</ul>
</li>
+<li class="toctree-l1"><a class="reference internal" href="maintainer.html">Package Maintainers</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="maintainer.html#adding-new-maintainers">Adding new maintainers</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maintainer.html#new-packages-without-a-maintainer">New packages without a maintainer</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maintainer.html#removing-package-maintainers">Removing package maintainers</a></li>
+</ul>
+</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>
</ul>
@@ -127,24 +216,40 @@ in which the policy can be updated.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="#">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="preface.html" class="pull-right" style="color:#767676;">
+
+ Preface
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul>
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -155,55 +260,108 @@ in which the policy can be updated.</p>
<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
+<li class="toctree-l1"><a class="reference internal" href="maintainer.html">Package Maintainers</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="#">Documentation overview</a><ul>
- <li>Next: <a href="preface.html" title="next chapter">Preface</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <div id="custom_toc">
+ <h2 style="margin-top:20px!important;">Contents</h2>
+ <div class="collapse" id="collapseExample" style="margin-top:10px;">
+ </div>
+ </div>
+ <script type="text/javascript">
+ $("#custom_toc").prependTo(".toctree-wrapper");
+ $("#custom_toc").css("display", "inline-block");
+ $('#collapseExample').on('show.bs.collapse', function () {
+ $("#show_contents").html("hide");
+ })
+ $('#collapseExample').on('hide.bs.collapse', function () {
+ $("#show_contents").html("show");
+ })
+
+ $("#collapseExample").collapse('show');
+ $(".caption").next().detach().appendTo('#collapseExample');
+ $(".caption").hide();
+
+ </script>
+
+
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+
+
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/index.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Installed files &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Keywording and stabilization" href="keywords.html" />
- <link rel="prev" title="File system layout" href="filesystem.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="File system layout" href="filesystem.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/installed-files.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="installed-files">
<h1>Installed files<a class="headerlink" href="#installed-files" title="Permalink to this headline">¶</a></h1>
<div class="section" id="installation-of-small-files">
@@ -121,24 +202,47 @@ unnecessary and potentially harmful.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="filesystem.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ File system layout
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="keywords.html" class="pull-right" style="color:#767676;">
+
+ Keywording and stabilization
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -146,7 +250,7 @@ unnecessary and potentially harmful.</p>
<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li>
<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li>
<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Installed files</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Installed files</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#installation-of-small-files">Installation of small files</a></li>
<li class="toctree-l2"><a class="reference internal" href="#installation-of-static-libraries">Installation of static libraries</a></li>
<li class="toctree-l2"><a class="reference internal" href="#installation-of-libtool-la-files">Installation of libtool (.la) files</a></li>
@@ -159,51 +263,77 @@ unnecessary and potentially harmful.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="filesystem.html" title="previous chapter">File system layout</a></li>
- <li>Next: <a href="keywords.html" title="next chapter">Keywording and stabilization</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/installed-files.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/keywords.html b/keywords.html
index 5052f26..e83ce12 100644
--- a/keywords.html
+++ b/keywords.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Keywording and stabilization &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,27 +22,147 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Language-specific policies" href="languages.html" />
- <link rel="prev" title="Installed files" href="installed-files.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Installed files" href="installed-files.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/keywords.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
- <div class="body" role="main">
-
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
+
+
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="keywording-and-stabilization">
<h1>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="rekeywording-on-dropped-keywords">
+<span id="index-0"></span><h2>Rekeywording on dropped keywords<a class="headerlink" href="#rekeywording-on-dropped-keywords" 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 and repoman</p>
+</dd>
+</dl>
+<p>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.</p>
+<p><em>Rationale</em>: 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.</p>
+</div>
+<div class="section" id="stabilizing-new-versions">
+<span id="index-1"></span><h2>Stabilizing new versions<a class="headerlink" href="#stabilizing-new-versions" 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 requesting a stabilization of a new version of the package,
+the developer must CC <em>all</em> 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.</p>
+<p>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.</p>
+<p><em>Rationale</em>: 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.</p>
+</div>
<div class="section" id="removing-stable-keywords">
-<span id="index-0"></span><h2>Removing stable keywords<a class="headerlink" href="#removing-stable-keywords" title="Permalink to this headline">¶</a></h2>
+<span id="index-2"></span><h2>Removing stable keywords<a class="headerlink" href="#removing-stable-keywords" 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>
@@ -58,24 +185,47 @@ of last rite mails.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="installed-files.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Installed files
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="languages.html" class="pull-right" style="color:#767676;">
+
+ Language-specific policies
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -84,61 +234,90 @@ of last rite mails.</p>
<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li>
<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li>
<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Keywording and stabilization</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Keywording and stabilization</a><ul class='nav'>
+<li class="toctree-l2"><a class="reference internal" href="#rekeywording-on-dropped-keywords">Rekeywording on dropped keywords</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#stabilizing-new-versions">Stabilizing new versions</a></li>
<li class="toctree-l2"><a class="reference internal" href="#removing-stable-keywords">Removing stable keywords</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
+<li class="toctree-l1"><a class="reference internal" href="maintainer.html">Package Maintainers</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="installed-files.html" title="previous chapter">Installed files</a></li>
- <li>Next: <a href="languages.html" title="next chapter">Language-specific policies</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/keywords.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/languages.html b/languages.html
index c9503e9..48b6b0f 100644
--- a/languages.html
+++ b/languages.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Language-specific policies &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Other metadata variables" href="other-metadata.html" />
- <link rel="prev" title="Keywording and stabilization" href="keywords.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Keywording and stabilization" href="keywords.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/languages.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="language-specific-policies">
<h1>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Permalink to this headline">¶</a></h1>
<div class="section" id="python">
@@ -101,24 +182,47 @@ will cause major upgrade issues.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="keywords.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Keywording and stabilization
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="other-metadata.html" class="pull-right" style="color:#767676;">
+
+ Other metadata variables
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -128,7 +232,7 @@ will cause major upgrade issues.</p>
<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li>
<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Language-specific policies</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Language-specific policies</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#python">Python</a></li>
</ul>
</li>
@@ -137,51 +241,77 @@ will cause major upgrade issues.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="keywords.html" title="previous chapter">Keywording and stabilization</a></li>
- <li>Next: <a href="other-metadata.html" title="next chapter">Other metadata variables</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/languages.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/maintainer.html b/maintainer.html
new file mode 100644
index 0000000..f930f0d
--- /dev/null
+++ b/maintainer.html
@@ -0,0 +1,329 @@
+
+<!doctype html>
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Package Maintainers &#8212; Gentoo Policy Guide documentation</title>
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
+ <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <script type="text/javascript" src="_static/language_data.js"></script>
+ <link rel="index" title="Index" href="genindex.html" />
+ <link rel="search" title="Search" href="search.html" />
+ <link rel="next" title="Other metadata variables" href="other-metadata.html" />
+ <link rel="prev" title="Language-specific policies" href="languages.html" />
+ </head><body>
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/maintainer.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
+
+
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
+ <div class="section" id="package-maintainers">
+<h1>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="adding-new-maintainers">
+<span id="index-0"></span><h2>Adding new maintainers<a class="headerlink" href="#adding-new-maintainers" 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>no</p>
+</dd>
+</dl>
+<p>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.</p>
+<p><em>Rationale</em>: 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.</p>
+<p>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.</p>
+</div>
+<div class="section" id="new-packages-without-a-maintainer">
+<span id="index-1"></span><h2>New packages without a maintainer<a class="headerlink" href="#new-packages-without-a-maintainer" 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>no</p>
+</dd>
+</dl>
+<p>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.</p>
+<p><em>Rationale</em>: 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.</p>
+<span class="target" id="index-2"></span></div>
+<div class="section" id="removing-package-maintainers">
+<span id="index-3"></span><h2>Removing package maintainers<a class="headerlink" href="#removing-package-maintainers" 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>no</p>
+</dd>
+</dl>
+<p>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 <code class="docutils literal notranslate"><span class="pre">metadata.xml</span></code>:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>&lt;!-- maintainer-needed --&gt;
+</pre></div>
+</div>
+<p>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.</p>
+<p><em>Rationale</em>: 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).</p>
+</div>
+</div>
+
+
+
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="languages.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Language-specific policies
+
+ </a>
+
+ </div>
+
+ <div class="col-sm-6">
+
+ <a href="other-metadata.html" class="pull-right" style="color:#767676;">
+
+ Other metadata variables
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+
+ </div>
+
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
+
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
+<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
+<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
+<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li>
+<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li>
+<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li>
+<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li>
+<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
+<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
+<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Package Maintainers</a><ul class='nav'>
+<li class="toctree-l2"><a class="reference internal" href="#adding-new-maintainers">Adding new maintainers</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#new-packages-without-a-maintainer">New packages without a maintainer</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#removing-package-maintainers">Removing package maintainers</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
+<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li>
+<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
+</ul>
+
+
+ </nav>
+ </div>
+</div>
+ </div>
+
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+
+
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+
+
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
+
+
+
+
+
+
+
+ </body>
+</html>
+
diff --git a/motivation.html b/motivation.html
index 21aaa91..de6abd7 100644
--- a/motivation.html
+++ b/motivation.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Motivation and history &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Basic information" href="basics.html" />
- <link rel="prev" title="Preface" href="preface.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Preface" href="preface.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/motivation.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="motivation-and-history">
<h1>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Permalink to this headline">¶</a></h1>
<div class="section" id="historical-state-of-policy-documentation">
@@ -80,26 +161,49 @@ devmanual) should conform to policies stated here.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="preface.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Preface
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="basics.html" class="pull-right" style="color:#767676;">
+
+ Basic information
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Motivation and history</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Motivation and history</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#historical-state-of-policy-documentation">Historical state of policy documentation</a></li>
<li class="toctree-l2"><a class="reference internal" href="#purpose-of-the-policy-guide">Purpose of the Policy Guide</a></li>
</ul>
@@ -117,51 +221,77 @@ devmanual) should conform to policies stated here.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="preface.html" title="previous chapter">Preface</a></li>
- <li>Next: <a href="basics.html" title="next chapter">Basic information</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/motivation.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/objects.inv b/objects.inv
index 31d1ef4..b0f3f34 100644
--- a/objects.inv
+++ b/objects.inv
Binary files 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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Other policy documents &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Dependencies" href="dependencies.html" />
- <link rel="prev" title="Basic information" href="basics.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Basic information" href="basics.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/other-docs.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="other-policy-documents">
<h1>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Permalink to this headline">¶</a></h1>
<div class="section" id="gentoo-specific-documentation">
@@ -84,28 +165,51 @@ disagree, Gentoo policies should be followed.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="basics.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Basic information
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="dependencies.html" class="pull-right" style="color:#767676;">
+
+ Dependencies
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Other policy documents</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Other policy documents</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#gentoo-specific-documentation">Gentoo-specific documentation</a></li>
<li class="toctree-l2"><a class="reference internal" href="#external-standards">External standards</a></li>
</ul>
@@ -121,51 +225,77 @@ disagree, Gentoo policies should be followed.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="basics.html" title="previous chapter">Basic information</a></li>
- <li>Next: <a href="dependencies.html" title="next chapter">Dependencies</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/other-docs.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Other metadata variables &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="USE flags" href="use-flags.html" />
- <link rel="prev" title="Language-specific policies" href="languages.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Language-specific policies" href="languages.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/other-metadata.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="other-metadata-variables">
<h1>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this headline">¶</a></h1>
<span class="target" id="index-0"></span><div class="section" id="dynamic-slots-multislot-flag">
@@ -72,24 +153,47 @@ invalidation or explicit errors.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="languages.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Language-specific policies
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="use-flags.html" class="pull-right" style="color:#767676;">
+
+ USE flags
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -100,7 +204,7 @@ invalidation or explicit errors.</p>
<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Other metadata variables</a><ul>
+<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>
</ul>
</li>
@@ -108,51 +212,77 @@ invalidation or explicit errors.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="languages.html" title="previous chapter">Language-specific policies</a></li>
- <li>Next: <a href="use-flags.html" title="next chapter">USE flags</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/other-metadata.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/preface.html b/preface.html
index c780ca3..c5f509f 100644
--- a/preface.html
+++ b/preface.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Preface &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Motivation and history" href="motivation.html" />
- <link rel="prev" title="Gentoo Policy Guide" href="index.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Gentoo Policy Guide" href="index.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/preface.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="preface">
<h1>Preface<a class="headerlink" href="#preface" title="Permalink to this headline">¶</a></h1>
<div class="section" id="introduction">
@@ -60,25 +141,48 @@ in which the policy can be updated.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="index.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Gentoo Policy Guide
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="motivation.html" class="pull-right" style="color:#767676;">
+
+ Motivation and history
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Preface</a><ul>
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Preface</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#introduction">Introduction</a></li>
<li class="toctree-l2"><a class="reference internal" href="#authors">Authors</a></li>
<li class="toctree-l2"><a class="reference internal" href="#license">License</a></li>
@@ -98,51 +202,77 @@ in which the policy can be updated.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="index.html" title="previous chapter">Gentoo Policy Guide</a></li>
- <li>Next: <a href="motivation.html" title="next chapter">Motivation and history</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/preface.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
diff --git a/search.html b/search.html
index 3062d84..05708c2 100644
--- a/search.html
+++ b/search.html
@@ -1,12 +1,19 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Search &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
@@ -17,24 +24,98 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="#" />
<script type="text/javascript" src="searchindex.js" defer></script>
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
</head><body>
-
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="https://gitweb.gentoo.org/proj/policy-guide.git/">Source</a></li>
+ <li class="active">
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="#" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
+
+
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
- <div class="body" role="main">
-
+
<h1 id="search-documentation">Search</h1>
<div id="fallback" class="admonition warning">
<script type="text/javascript">$('#fallback').hide();</script>
@@ -59,69 +140,88 @@
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
-
-
-
+
+
+
+
+
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
-<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
-<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li>
-<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li>
-<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li>
-<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li>
-<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
-<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
-<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
-<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li>
-<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
-</ul>
+ </div>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- </ul></li>
-</ul>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
+ </div>
</div>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>USE flags &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -15,23 +22,97 @@
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Users and groups" href="user-group.html" />
- <link rel="prev" title="Other metadata variables" href="other-metadata.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="Other metadata variables" href="other-metadata.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/use-flags.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="use-flags">
<h1>USE flags<a class="headerlink" href="#use-flags" title="Permalink to this headline">¶</a></h1>
<div class="section" id="versioned-use-flags">
@@ -121,24 +202,47 @@ or underscores depending on developer’s personal preference.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="other-metadata.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ Other metadata variables
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="user-group.html" class="pull-right" style="color:#767676;">
+
+ Users and groups
+
+ <i class="fa fa-angle-double-right" aria-hidden="true"></i>
+ </a>
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -150,7 +254,7 @@ or underscores depending on developer’s personal preference.</p>
<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li>
<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">USE flags</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">USE flags</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#versioned-use-flags">Versioned USE flags</a></li>
<li class="toctree-l2"><a class="reference internal" href="#use-gui-flag">USE=gui flag</a></li>
<li class="toctree-l2"><a class="reference internal" href="#underscores-in-use-flag-names">Underscores in USE flag names</a></li>
@@ -159,51 +263,77 @@ or underscores depending on developer’s personal preference.</p>
<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="other-metadata.html" title="previous chapter">Other metadata variables</a></li>
- <li>Next: <a href="user-group.html" title="next chapter">Users and groups</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/use-flags.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+
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 @@
-<!DOCTYPE html>
+<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <meta charset="utf-8" />
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
<title>Users and groups &#8212; Gentoo Policy Guide documentation</title>
- <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+ <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+
+ <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon">
+ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen">
+ <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen">
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
@@ -14,23 +21,97 @@
<script type="text/javascript" src="_static/language_data.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
- <link rel="prev" title="USE flags" href="use-flags.html" />
-
- <link rel="stylesheet" href="_static/custom.css" type="text/css" />
-
-
- <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
-
+ <link rel="prev" title="USE flags" href="use-flags.html" />
</head><body>
-
+ <header>
+ <div class="site-title">
+ <div class="container">
+ <div class="row">
+ <div class="site-title-buttons">
+ <div class="btn-group btn-group-sm">
+ <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a>
+ <div class="btn-group btn-group-sm">
+ <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#">
+ <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span>
+ </a>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li>
+ <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li>
+ <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li>
+ <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li>
+ <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li>
+ <li class="divider"></li>
+ <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li>
+ <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li>
+ <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li>
+ <li class="divider"></li>
+ <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="logo">
+ <a href="index.html" title="Back to the homepage" class="site-logo"></a>
+ <span class="site-label"> Policy Guide </span>
+ </div>
+ </div>
+ </div>
+ </div>
+ <nav class="tyrian-navbar" role="navigation">
+ <div class="container">
+ <div class="row">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ </div>
+ <div class="collapse navbar-collapse navbar-main-collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="index.html">Home</a></li>
+ <li class=""><a href="_sources/user-group.rst.txt">Source</a></li>
+ <li>
+ <a href="search.html">Search</a></li>
+ <li>
+ <a href="genindex.html">Index</a></li>
+
+
+
+ </ul>
+
+ <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '')
+ { alert('Please enter one or more search terms first.');
+ return false; } return true;">
+
+ <div class="input-group" style="margin-top:2px;">
+ <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span>
+ <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value="">
+ </div>
+ <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button>
+ </form>
+
+ </div>
+ </div>
+ </div>
+ </nav>
+ </header>
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
-
- <div class="body" role="main">
-
+ <div class="container">
+ <div class="row">
+
+
+
+ <div class="col-md-9 col-sm-12 col-xs-12" role="main">
+
+
+
+
+
+
<div class="section" id="users-and-groups">
<h1>Users and groups<a class="headerlink" href="#users-and-groups" title="Permalink to this headline">¶</a></h1>
<span class="target" id="index-0"></span><div class="section" id="user-and-group-account-policy">
@@ -83,24 +164,40 @@ been reserved for true system users and groups.</p>
</div>
- </div>
-
- </div>
- </div>
- <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
- <div class="sphinxsidebarwrapper">
-<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1>
-
-
-
+
+
+
+ <div class="row" style="margin-top:50px;">
+ <div class="col-sm-6">
+
+ <a href="use-flags.html" style="color:#767676;">
+ <i class="fa fa-angle-double-left" aria-hidden="true"></i>
+
+ USE flags
+
+ </a>
+
+ </div>
+ <div class="col-sm-6">
+
+ </div>
+ </div>
+
+
+
+ </div>
+
+ <div class="col-md-3 hidden-sm hidden-xs" role="main">
+<div class="" role="navigation" aria-label="main navigation">
+ <div class="">
-<h3>Navigation</h3>
-<p class="caption"><span class="caption-text">Contents:</span></p>
-<ul class="current">
+ <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400">
+ <p class="hidden"><span class="hidden-text">Contents:</span></p>
+<ul class='current nav'>
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li>
<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li>
@@ -113,56 +210,83 @@ been reserved for true system users and groups.</p>
<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li>
<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li>
<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Users and groups</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Users and groups</a><ul class='nav'>
<li class="toctree-l2"><a class="reference internal" href="#user-and-group-account-policy">User and group account policy</a></li>
</ul>
</li>
</ul>
-<div class="relations">
-<h3>Related Topics</h3>
-<ul>
- <li><a href="index.html">Documentation overview</a><ul>
- <li>Previous: <a href="use-flags.html" title="previous chapter">USE flags</a></li>
- </ul></li>
-</ul>
-</div>
-<div id="searchbox" style="display: none" role="search">
- <h3 id="searchlabel">Quick search</h3>
- <div class="searchformwrapper">
- <form class="search" action="search.html" method="get">
- <input type="text" name="q" aria-labelledby="searchlabel" />
- <input type="submit" value="Go" />
- </form>
+
+ </nav>
</div>
</div>
-<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-xs-12 col-md-offset-2 col-md-7">
+ <h3 class="footerhead">Gentoo Policy Guide </h3>
+ <div class="row">
+ <div class="col-xs-12 col-md-4">
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> &amp; <a href="#">Tyrian Theme 0.0.1</a></span>
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ <div class="col-xs-12 col-md-4">
+ </div>
+ </div>
+ </div>
+ <div class="col-xs-12 col-md-3">
+ <h3 class="footerhead">Questions or comments?</h3>
+ Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>.
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-xs-2 col-sm-3 col-md-2">
+ <ul class="footerlinks three-icons">
+ <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li>
+ <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li>
+ <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li>
+ </ul>
+ </div>
+ <div class="col-xs-10 col-sm-9 col-md-10">
+ <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br>
+ <small>
+ Gentoo is a trademark of the Gentoo Foundation, Inc.
+ The contents of this document, unless otherwise expressly stated, are licensed under the
+ <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license.
+ The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply.
+ </small>
+ </div>
+ </div>
+ </div>
+ </footer>
+ <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script>
+ <script type="text/javascript">
+ $('body').scrollspy({
+ target: '.bs-docs-sidebar',
+ offset: 40
+ });
+ </script>
+ <script type="text/javascript">
+ $('#indices-and-tables').hide()
+ </script>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="footer">
- &copy;2020, Gentoo Authors.
-
- |
- Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a>
- &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
-
- |
- <a href="_sources/user-group.rst.txt"
- rel="nofollow">Page source</a>
- </div>
-
+
+
</body>
-</html> \ No newline at end of file
+</html>
+