diff options
| -rw-r--r-- | _static/basic.css | 22 | ||||
| -rw-r--r-- | _static/documentation_options.js | 3 | ||||
| -rw-r--r-- | _static/searchtools.js | 26 | ||||
| -rw-r--r-- | _static/sphinx_highlight.js | 16 | ||||
| -rw-r--r-- | basics.html | 42 | ||||
| -rw-r--r-- | combined.html | 206 | ||||
| -rw-r--r-- | dependencies.html | 54 | ||||
| -rw-r--r-- | deprecation.html | 38 | ||||
| -rw-r--r-- | ebuild-format.html | 48 | ||||
| -rw-r--r-- | editing.html | 46 | ||||
| -rw-r--r-- | filesystem.html | 46 | ||||
| -rw-r--r-- | genindex.html | 30 | ||||
| -rw-r--r-- | index.html | 36 | ||||
| -rw-r--r-- | installed-files.html | 44 | ||||
| -rw-r--r-- | keywords.html | 40 | ||||
| -rw-r--r-- | languages.html | 42 | ||||
| -rw-r--r-- | maintainer.html | 42 | ||||
| -rw-r--r-- | motivation.html | 38 | ||||
| -rw-r--r-- | other-docs.html | 48 | ||||
| -rw-r--r-- | other-metadata.html | 44 | ||||
| -rw-r--r-- | preface.html | 40 | ||||
| -rw-r--r-- | search.html | 30 | ||||
| -rw-r--r-- | searchindex.js | 2 | ||||
| -rw-r--r-- | std-policy-index.html | 30 | ||||
| -rw-r--r-- | use-flags.html | 40 | ||||
| -rw-r--r-- | user-group.html | 38 |
26 files changed, 544 insertions, 547 deletions
diff --git a/_static/basic.css b/_static/basic.css index 7577acb..30fee9d 100644 --- a/_static/basic.css +++ b/_static/basic.css @@ -237,6 +237,10 @@ a.headerlink { visibility: hidden; } +a:visited { + color: #551A8B; +} + h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, @@ -670,6 +674,16 @@ dd { margin-left: 30px; } +.sig dd { + margin-top: 0px; + margin-bottom: 0px; +} + +.sig dl { + margin-top: 0px; + margin-bottom: 0px; +} + dl > dd:last-child, dl > dd:last-child > :last-child { margin-bottom: 0; @@ -738,6 +752,14 @@ abbr, acronym { cursor: help; } +.translated { + background-color: rgba(207, 255, 207, 0.2) +} + +.untranslated { + background-color: rgba(255, 207, 207, 0.2) +} + /* -- code displays --------------------------------------------------------- */ pre { diff --git a/_static/documentation_options.js b/_static/documentation_options.js index b57ae3b..7e4c114 100644 --- a/_static/documentation_options.js +++ b/_static/documentation_options.js @@ -1,5 +1,4 @@ -var DOCUMENTATION_OPTIONS = { - URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), +const DOCUMENTATION_OPTIONS = { VERSION: '', LANGUAGE: 'en', COLLAPSE_INDEX: false, diff --git a/_static/searchtools.js b/_static/searchtools.js index 97d56a7..7918c3f 100644 --- a/_static/searchtools.js +++ b/_static/searchtools.js @@ -57,12 +57,12 @@ const _removeChildren = (element) => { const _escapeRegExp = (string) => string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string -const _displayItem = (item, searchTerms) => { +const _displayItem = (item, searchTerms, highlightTerms) => { const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; - const docUrlRoot = DOCUMENTATION_OPTIONS.URL_ROOT; const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; + const contentRoot = document.documentElement.dataset.content_root; const [docName, title, anchor, descr, score, _filename] = item; @@ -75,20 +75,24 @@ const _displayItem = (item, searchTerms) => { if (dirname.match(/\/index\/$/)) dirname = dirname.substring(0, dirname.length - 6); else if (dirname === "index/") dirname = ""; - requestUrl = docUrlRoot + dirname; + requestUrl = contentRoot + dirname; linkUrl = requestUrl; } else { // normal html builders - requestUrl = docUrlRoot + docName + docFileSuffix; + requestUrl = contentRoot + docName + docFileSuffix; linkUrl = docName + docLinkSuffix; } let linkEl = listItem.appendChild(document.createElement("a")); linkEl.href = linkUrl + anchor; linkEl.dataset.score = score; linkEl.innerHTML = title; - if (descr) + if (descr) { listItem.appendChild(document.createElement("span")).innerHTML = " (" + descr + ")"; + // highlight search terms in the description + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + } else if (showSearchSummary) fetch(requestUrl) .then((responseData) => responseData.text()) @@ -97,6 +101,9 @@ const _displayItem = (item, searchTerms) => { listItem.appendChild( Search.makeSearchSummary(data, searchTerms) ); + // highlight search terms in the summary + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); }); Search.output.appendChild(listItem); }; @@ -115,14 +122,15 @@ const _finishSearch = (resultCount) => { const _displayNextItem = ( results, resultCount, - searchTerms + searchTerms, + highlightTerms, ) => { // results left, load the summary and display it // this is intended to be dynamic (don't sub resultsCount) if (results.length) { - _displayItem(results.pop(), searchTerms); + _displayItem(results.pop(), searchTerms, highlightTerms); setTimeout( - () => _displayNextItem(results, resultCount, searchTerms), + () => _displayNextItem(results, resultCount, searchTerms, highlightTerms), 5 ); } @@ -360,7 +368,7 @@ const Search = { // console.info("search results:", Search.lastresults); // print the results - _displayNextItem(results, results.length, searchTerms); + _displayNextItem(results, results.length, searchTerms, highlightTerms); }, /** diff --git a/_static/sphinx_highlight.js b/_static/sphinx_highlight.js index aae669d..8a96c69 100644 --- a/_static/sphinx_highlight.js +++ b/_static/sphinx_highlight.js @@ -29,14 +29,19 @@ const _highlight = (node, addItems, text, className) => { } span.appendChild(document.createTextNode(val.substr(pos, text.length))); + const rest = document.createTextNode(val.substr(pos + text.length)); parent.insertBefore( span, parent.insertBefore( - document.createTextNode(val.substr(pos + text.length)), + rest, node.nextSibling ) ); node.nodeValue = val.substr(0, pos); + /* There may be more occurrences of search term in this node. So call this + * function recursively on the remaining fragment. + */ + _highlight(rest, addItems, text, className); if (isInSVG) { const rect = document.createElementNS( @@ -140,5 +145,10 @@ const SphinxHighlight = { }, }; -_ready(SphinxHighlight.highlightSearchWords); -_ready(SphinxHighlight.initEscapeListener); +_ready(() => { + /* Do not call highlightSearchWords() when we are on the search page. + * It will highlight words from the *previous* search query. + */ + if (typeof Search === "undefined") SphinxHighlight.highlightSearchWords(); + SphinxHighlight.initEscapeListener(); +}); diff --git a/basics.html b/basics.html index c3959f6..83e16b0 100644 --- a/basics.html +++ b/basics.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Basic information — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="basic-information"> -<h1>Basic information<a class="headerlink" href="#basic-information" title="Permalink to this heading">¶</a></h1> +<h1>Basic information<a class="headerlink" href="#basic-information" title="Link to this heading">¶</a></h1> <section id="goals-of-policy-making"> -<h2>Goals of policy making<a class="headerlink" href="#goals-of-policy-making" title="Permalink to this heading">¶</a></h2> +<h2>Goals of policy making<a class="headerlink" href="#goals-of-policy-making" title="Link to this heading">¶</a></h2> <p>The Gentoo policies focus on three aims:</p> <ol class="arabic simple"> <li><p><em>Portability</em>. By following the policies, it should be possible @@ -154,7 +155,7 @@ his goals and reduce the likeliness of surprising behavior.</p></li> </ol> </section> <section id="policy-compliance-checking"> -<h2>Policy compliance checking<a class="headerlink" href="#policy-compliance-checking" title="Permalink to this heading">¶</a></h2> +<h2>Policy compliance checking<a class="headerlink" href="#policy-compliance-checking" title="Link to this heading">¶</a></h2> <p>Currently, there are two kinds of tools involved in detecting policy violations:</p> <ol class="arabic simple"> @@ -177,7 +178,7 @@ supplements the direct use of linting tools by developers with reliable tree-wide scans.</p> </section> <section id="policy-enforcement"> -<h2>Policy enforcement<a class="headerlink" href="#policy-enforcement" title="Permalink to this heading">¶</a></h2> +<h2>Policy enforcement<a class="headerlink" href="#policy-enforcement" title="Link to this heading">¶</a></h2> <p>The Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a> is tasked with enforcement of the tree policies. Its role is governed by <a class="reference external" href="https://www.gentoo.org/glep/glep-0048.html">GLEP 48</a>. It focuses on documenting the policies, resolving doubts regarding them and educating @@ -190,7 +191,7 @@ refuses to resolve policy violations.</p> team can issue disciplinary measures against the developer in question.</p> </section> <section id="policy-making-changes-and-appeals"> -<h2>Policy making, changes and appeals<a class="headerlink" href="#policy-making-changes-and-appeals" title="Permalink to this heading">¶</a></h2> +<h2>Policy making, changes and appeals<a class="headerlink" href="#policy-making-changes-and-appeals" title="Link to this heading">¶</a></h2> <p>The majority of policies are written down and maintained by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a>. Other Gentoo projects also create policies that affect their specific areas of contributions (e.g. <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Systemd">systemd project</a> created @@ -285,7 +286,7 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -299,16 +300,13 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/combined.html b/combined.html index 4412881..adabc6d 100644 --- a/combined.html +++ b/combined.html @@ -5,20 +5,21 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>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="stylesheet" type="text/css" href="_static/pygments.css" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/custom.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"> <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> + <script src="_static/documentation_options.js"></script> <script src="_static/doctools.js"></script> <script src="_static/sphinx_highlight.js"></script> <link rel="index" title="Index" href="genindex.html" /> @@ -110,7 +111,7 @@ <section id="gentoo-policy-guide"> -<h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Permalink to this heading">¶</a></h1> +<h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Link to this heading">¶</a></h1> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. It combines both policies that are global by design (i.e. set by the QA @@ -120,9 +121,9 @@ indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> <div class="toctree-wrapper compound"> <span id="document-preface"></span><section id="preface"> -<h2>Preface<a class="headerlink" href="#preface" title="Permalink to this heading">¶</a></h2> +<h2>Preface<a class="headerlink" href="#preface" title="Link to this heading">¶</a></h2> <section id="introduction"> -<h3>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h3> +<h3>Introduction<a class="headerlink" href="#introduction" title="Link to this heading">¶</a></h3> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. It combines both policies that are global by design (i.e. set by the QA @@ -132,7 +133,7 @@ indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> </section> <section id="authors"> -<h3>Authors<a class="headerlink" href="#authors" title="Permalink to this heading">¶</a></h3> +<h3>Authors<a class="headerlink" href="#authors" title="Link to this heading">¶</a></h3> <p>This document is maintained by the Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA project</a>.</p> <p>The current text authors are:</p> <ul class="simple"> @@ -141,15 +142,15 @@ in which the policy can be updated.</p> </ul> </section> <section id="license"> -<h3>License<a class="headerlink" href="#license" title="Permalink to this heading">¶</a></h3> +<h3>License<a class="headerlink" href="#license" title="Link to this heading">¶</a></h3> <p>This work is licensed under the <a class="reference external" href="https://creativecommons.org/licenses/by-sa/4.0/.">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</p> </section> </section> <span id="document-motivation"></span><section id="motivation-and-history"> -<h2>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Permalink to this heading">¶</a></h2> +<h2>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Link to this heading">¶</a></h2> <section id="historical-state-of-policy-documentation"> -<h3>Historical state of policy documentation<a class="headerlink" href="#historical-state-of-policy-documentation" title="Permalink to this heading">¶</a></h3> +<h3>Historical state of policy documentation<a class="headerlink" href="#historical-state-of-policy-documentation" title="Link to this heading">¶</a></h3> <p>At the time, Gentoo was lacking a clear and focused document listing all development-related policies in a concise and clear way.</p> <p><a class="reference external" href="https://projects.gentoo.org/pms/latest/pms.html">PMS</a> provided a technical specification for the ebuild files but did @@ -176,7 +177,7 @@ established less or more formally in the past but were never really written down.</p> </section> <section id="purpose-of-the-policy-guide"> -<h3>Purpose of the Policy Guide<a class="headerlink" href="#purpose-of-the-policy-guide" title="Permalink to this heading">¶</a></h3> +<h3>Purpose of the Policy Guide<a class="headerlink" href="#purpose-of-the-policy-guide" title="Link to this heading">¶</a></h3> <p>The Policy Guide was created in order to address aforementioned documentation deficiencies. Its primary purpose is to collect all applicable policies from various sources and combine them into a single @@ -193,9 +194,9 @@ devmanual) should conform to policies stated here.</p> </section> </section> <span id="document-basics"></span><section id="basic-information"> -<h2>Basic information<a class="headerlink" href="#basic-information" title="Permalink to this heading">¶</a></h2> +<h2>Basic information<a class="headerlink" href="#basic-information" title="Link to this heading">¶</a></h2> <section id="goals-of-policy-making"> -<h3>Goals of policy making<a class="headerlink" href="#goals-of-policy-making" title="Permalink to this heading">¶</a></h3> +<h3>Goals of policy making<a class="headerlink" href="#goals-of-policy-making" title="Link to this heading">¶</a></h3> <p>The Gentoo policies focus on three aims:</p> <ol class="arabic simple"> <li><p><em>Portability</em>. By following the policies, it should be possible @@ -214,7 +215,7 @@ his goals and reduce the likeliness of surprising behavior.</p></li> </ol> </section> <section id="policy-compliance-checking"> -<h3>Policy compliance checking<a class="headerlink" href="#policy-compliance-checking" title="Permalink to this heading">¶</a></h3> +<h3>Policy compliance checking<a class="headerlink" href="#policy-compliance-checking" title="Link to this heading">¶</a></h3> <p>Currently, there are two kinds of tools involved in detecting policy violations:</p> <ol class="arabic simple"> @@ -237,7 +238,7 @@ supplements the direct use of linting tools by developers with reliable tree-wide scans.</p> </section> <section id="policy-enforcement"> -<h3>Policy enforcement<a class="headerlink" href="#policy-enforcement" title="Permalink to this heading">¶</a></h3> +<h3>Policy enforcement<a class="headerlink" href="#policy-enforcement" title="Link to this heading">¶</a></h3> <p>The Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a> is tasked with enforcement of the tree policies. Its role is governed by <a class="reference external" href="https://www.gentoo.org/glep/glep-0048.html">GLEP 48</a>. It focuses on documenting the policies, resolving doubts regarding them and educating @@ -250,7 +251,7 @@ refuses to resolve policy violations.</p> team can issue disciplinary measures against the developer in question.</p> </section> <section id="policy-making-changes-and-appeals"> -<h3>Policy making, changes and appeals<a class="headerlink" href="#policy-making-changes-and-appeals" title="Permalink to this heading">¶</a></h3> +<h3>Policy making, changes and appeals<a class="headerlink" href="#policy-making-changes-and-appeals" title="Link to this heading">¶</a></h3> <p>The majority of policies are written down and maintained by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a>. Other Gentoo projects also create policies that affect their specific areas of contributions (e.g. <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Systemd">systemd project</a> created @@ -263,11 +264,11 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w </section> </section> <span id="document-other-docs"></span><section id="other-policy-documents"> -<h2>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Permalink to this heading">¶</a></h2> +<h2>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Link to this heading">¶</a></h2> <section id="gentoo-specific-documentation"> -<h3>Gentoo-specific documentation<a class="headerlink" href="#gentoo-specific-documentation" title="Permalink to this heading">¶</a></h3> +<h3>Gentoo-specific documentation<a class="headerlink" href="#gentoo-specific-documentation" title="Link to this heading">¶</a></h3> <section id="package-manager-specification"> -<h4>Package Manager Specification<a class="headerlink" href="#package-manager-specification" title="Permalink to this heading">¶</a></h4> +<h4>Package Manager Specification<a class="headerlink" href="#package-manager-specification" title="Link to this heading">¶</a></h4> <p><a class="reference external" href="https://projects.gentoo.org/pms/latest/pms.html">PMS</a> provides the specification of ebuild format, as well as general guidelines for implementing package managers. All ebuilds in the Gentoo repository are required to conform to the PMS. Tree policies may @@ -277,7 +278,7 @@ in subsequent EAPIs that are approved by the Council. The project’s wiki page discusses how PMS can be changed via <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Package_Manager_Specification/Future_EAPI_process">future EAPI process</a>.</p> </section> <section id="gleps"> -<h4>GLEPs<a class="headerlink" href="#gleps" title="Permalink to this heading">¶</a></h4> +<h4>GLEPs<a class="headerlink" href="#gleps" title="Link to this heading">¶</a></h4> <p><a class="reference external" href="https://www.gentoo.org/glep/">GLEPs</a> provide the highest level policies applicable to Gentoo. Final or active GLEPs apply to all developers. Tree policies may impose additional restrictions on GLEPs but may not override them.</p> @@ -286,7 +287,7 @@ In general, all GLEP updates go through mailing list review and need to be approved by the Council.</p> </section> <section id="developer-manual"> -<h4>Developer Manual<a class="headerlink" href="#developer-manual" title="Permalink to this heading">¶</a></h4> +<h4>Developer Manual<a class="headerlink" href="#developer-manual" title="Link to this heading">¶</a></h4> <p><a class="reference external" href="https://devmanual.gentoo.org/">Devmanual</a> is the basic guide for ebuild developers. Besides policies, it contains many general recommendations and detailed instructions. Developer Manual does not specify policies itself, and needs to comply @@ -296,16 +297,16 @@ recommended that all changes are reviewed by the <a class="reference external" h </section> </section> <section id="external-standards"> -<h3>External standards<a class="headerlink" href="#external-standards" title="Permalink to this heading">¶</a></h3> +<h3>External standards<a class="headerlink" href="#external-standards" title="Link to this heading">¶</a></h3> <section id="posix"> -<h4>POSIX<a class="headerlink" href="#posix" title="Permalink to this heading">¶</a></h4> +<h4>POSIX<a class="headerlink" href="#posix" title="Link to this heading">¶</a></h4> <p><a class="reference external" href="http://get.posixcertified.ieee.org/">POSIX</a> is the basic standard for operating systems. However, its rules apply to the software packaged in Gentoo rather than the distribution itself. Nevertheless, when no more specific policy applies, following POSIX is recommended.</p> </section> <section id="fhs"> -<h4>FHS<a class="headerlink" href="#fhs" title="Permalink to this heading">¶</a></h4> +<h4>FHS<a class="headerlink" href="#fhs" title="Link to this heading">¶</a></h4> <p><a class="reference external" href="https://refspecs.linuxfoundation.org/fhs.shtml">FHS</a> specifies the suggested filesystem layout for Linux systems. Gentoo follows FHS only partially. Whenever Gentoo policies and FHS disagree, Gentoo policies should be followed.</p> @@ -313,9 +314,9 @@ disagree, Gentoo policies should be followed.</p> </section> </section> <span id="document-editing"></span><section id="editing-and-publishing-updates-to-this-guide"> -<h2>Editing and publishing updates to this Guide<a class="headerlink" href="#editing-and-publishing-updates-to-this-guide" title="Permalink to this heading">¶</a></h2> +<h2>Editing and publishing updates to this Guide<a class="headerlink" href="#editing-and-publishing-updates-to-this-guide" title="Link to this heading">¶</a></h2> <section id="formatting-and-style"> -<h3>Formatting and style<a class="headerlink" href="#formatting-and-style" title="Permalink to this heading">¶</a></h3> +<h3>Formatting and style<a class="headerlink" href="#formatting-and-style" title="Link to this heading">¶</a></h3> <p>While editing the Guide, please respect the existing formatting rules. Notably:</p> <ul class="simple"> @@ -330,7 +331,7 @@ rules match multiple chapters, choose the one that fits it best. Make sure to match existing keywords in index.</p> </section> <section id="getting-sources"> -<h3>Getting sources<a class="headerlink" href="#getting-sources" title="Permalink to this heading">¶</a></h3> +<h3>Getting sources<a class="headerlink" href="#getting-sources" title="Link to this heading">¶</a></h3> <p>The reference repository is hosted at git.gentoo.org, and available via <a class="reference external" href="https://gitweb.gentoo.org/proj/policy-guide.git/">proj/policy-guide.git gitweb</a>. To clone it:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># via https</span> @@ -344,7 +345,7 @@ the GitHub <a class="reference external" href="https://github.com/gentoo/policy- instead.</p> </section> <section id="building"> -<h3>Building<a class="headerlink" href="#building" title="Permalink to this heading">¶</a></h3> +<h3>Building<a class="headerlink" href="#building" title="Link to this heading">¶</a></h3> <p>A tox-file is provided to build the Guide in a virtualenv, installing all necessary dependencies. To build the HTML version, run:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">tox</span> @@ -357,13 +358,13 @@ as a command-line argument, e.g.:</p> </div> </section> <section id="sending-contributions"> -<h3>Sending contributions<a class="headerlink" href="#sending-contributions" title="Permalink to this heading">¶</a></h3> +<h3>Sending contributions<a class="headerlink" href="#sending-contributions" title="Link to this heading">¶</a></h3> <p>Changes to this document can be either submitted to <a class="reference external" href="https://bugs.gentoo.org/enter_bug.cgi?product=Documentation&component=Policy+Guide">Policy Manual Gentoo Bugzilla component</a> as git-format patches attached to the bugs, or to <a class="reference external" href="https://github.com/gentoo/policy-guide">gentoo/policy-guide repository</a> as pull requests.</p> </section> <section id="merging-pull-requests"> -<h3>Merging pull requests<a class="headerlink" href="#merging-pull-requests" title="Permalink to this heading">¶</a></h3> +<h3>Merging pull requests<a class="headerlink" href="#merging-pull-requests" title="Link to this heading">¶</a></h3> <p>The recommended way to merge pull requests is to use <code class="docutils literal notranslate"><span class="pre">app-portage/pram</span></code>. To configure the remote before the first use, run the following command in your checkout:</p> @@ -376,7 +377,7 @@ run the following command in your checkout:</p> </div> </section> <section id="publishing"> -<h3>Publishing<a class="headerlink" href="#publishing" title="Permalink to this heading">¶</a></h3> +<h3>Publishing<a class="headerlink" href="#publishing" title="Link to this heading">¶</a></h3> <p>The built version of Policy Guide is currently published via a git repository. The recommended method is to clone the repository into <code class="docutils literal notranslate"><span class="pre">_build/html</span></code> in order to make Sphinx output into the checkout:</p> @@ -389,9 +390,9 @@ into <code class="docutils literal notranslate"><span class="pre">_build/html</s </section> </section> <span id="document-dependencies"></span><section id="dependencies"> -<h2>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this heading">¶</a></h2> -<span class="target" id="index-0"></span><section id="pg0001"> -<span id="optional-runtime-dependencies"></span><span id="index-1"></span><h3>Optional runtime dependencies<a class="headerlink" href="#pg0001" title="Permalink to this heading">¶</a></h3> +<h2>Dependencies<a class="headerlink" href="#dependencies" title="Link to this heading">¶</a></h2> +<section id="pg0001"> +<span id="optional-runtime-dependencies"></span><span id="index-1"></span><span id="index-0"></span><h3>Optional runtime dependencies<a class="headerlink" href="#pg0001" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0001</p> @@ -425,7 +426,7 @@ by the Council but no reference implementation has been written.</p> </div> </section> <section id="pg0002"> -<span id="dependencies-with-no-revision"></span><span id="index-2"></span><h3>=-dependencies with no revision<a class="headerlink" href="#pg0002" title="Permalink to this heading">¶</a></h3> +<span id="dependencies-with-no-revision"></span><span id="index-2"></span><h3>=-dependencies with no revision<a class="headerlink" href="#pg0002" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0002</p> @@ -457,9 +458,9 @@ requesting the latter, it warns developers to reconsider whether they used the correct operator.</p> </section> <section id="slot-and-subslot-dependencies"> -<span id="index-3"></span><h3>Slot and subslot dependencies<a class="headerlink" href="#slot-and-subslot-dependencies" title="Permalink to this heading">¶</a></h3> +<span id="index-3"></span><h3>Slot and subslot dependencies<a class="headerlink" href="#slot-and-subslot-dependencies" title="Link to this heading">¶</a></h3> <section id="pg0011"> -<span id="on-sub-slotted-packages"></span><h4>on (sub-)slotted packages<a class="headerlink" href="#pg0011" title="Permalink to this heading">¶</a></h4> +<span id="on-sub-slotted-packages"></span><h4>on (sub-)slotted packages<a class="headerlink" href="#pg0011" title="Link to this heading">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0011</p> @@ -496,7 +497,7 @@ to the newest package version available.</p> </div> </section> <section id="pg0012"> -<span id="special-case-qt-packages"></span><span id="index-4"></span><h4>special case: Qt packages<a class="headerlink" href="#pg0012" title="Permalink to this heading">¶</a></h4> +<span id="special-case-qt-packages"></span><span id="index-4"></span><h4>special case: Qt packages<a class="headerlink" href="#pg0012" title="Link to this heading">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0012</p> @@ -518,7 +519,7 @@ if your package uses one of the private API parts, and plain <code class="docuti or likewise dependency must be used otherwise.</p> </section> <section id="proactive-use-of-slot-operators"> -<h4>proactive use of slot operators<a class="headerlink" href="#proactive-use-of-slot-operators" title="Permalink to this heading">¶</a></h4> +<h4>proactive use of slot operators<a class="headerlink" href="#proactive-use-of-slot-operators" title="Link to this heading">¶</a></h4> <p>There is an open debate on whether developers should be proactively adding <code class="docutils literal notranslate"><span class="pre">:=</span></code> slot operators on packages that do not define subslots yet.</p> @@ -532,7 +533,7 @@ They point out the case of Qt packages as an example.</p> </section> </section> <section id="pg0003"> -<span id="revision-bumps-on-runtime-dependency-changes"></span><span id="index-5"></span><h3>Revision bumps on runtime dependency changes<a class="headerlink" href="#pg0003" title="Permalink to this heading">¶</a></h3> +<span id="revision-bumps-on-runtime-dependency-changes"></span><span id="index-5"></span><h3>Revision bumps on runtime dependency changes<a class="headerlink" href="#pg0003" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0003</p> @@ -575,9 +576,9 @@ if the package installed by the user still links to libfoo.</p> </div> </section> <section id="use-dependencies"> -<span id="index-6"></span><h3>USE dependencies<a class="headerlink" href="#use-dependencies" title="Permalink to this heading">¶</a></h3> +<span id="index-6"></span><h3>USE dependencies<a class="headerlink" href="#use-dependencies" title="Link to this heading">¶</a></h3> <section id="pg0021"> -<span id="on-packages-without-the-flag"></span><h4>on packages without the flag<a class="headerlink" href="#pg0021" title="Permalink to this heading">¶</a></h4> +<span id="on-packages-without-the-flag"></span><h4>on packages without the flag<a class="headerlink" href="#pg0021" title="Link to this heading">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0021</p> @@ -618,9 +619,9 @@ updating its reverse dependencies.</p> </section> </section> <span id="document-deprecation"></span><section id="deprecations"> -<h2>Deprecations<a class="headerlink" href="#deprecations" title="Permalink to this heading">¶</a></h2> +<h2>Deprecations<a class="headerlink" href="#deprecations" title="Link to this heading">¶</a></h2> <section id="pg1001"> -<span id="deprecated-eapis"></span><span id="index-0"></span><h3>Deprecated EAPIs<a class="headerlink" href="#pg1001" title="Permalink to this heading">¶</a></h3> +<span id="deprecated-eapis"></span><span id="index-0"></span><h3>Deprecated EAPIs<a class="headerlink" href="#pg1001" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>1001</p> @@ -642,7 +643,7 @@ no version bumps are expected.</p> in <code class="docutils literal notranslate"><span class="pre">metadata/layout.conf</span></code>.</p> </section> <section id="pg1003"> -<span id="deprecated-eclasses"></span><span id="index-1"></span><h3>Deprecated eclasses<a class="headerlink" href="#pg1003" title="Permalink to this heading">¶</a></h3> +<span id="deprecated-eclasses"></span><span id="index-1"></span><h3>Deprecated eclasses<a class="headerlink" href="#pg1003" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>1003</p> @@ -662,9 +663,9 @@ inside the eclass files.</p> </section> </section> <span id="document-ebuild-format"></span><section id="ebuild-file-format"> -<h2>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Permalink to this heading">¶</a></h2> +<h2>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Link to this heading">¶</a></h2> <section id="pg0101"> -<span id="coding-style"></span><span id="index-0"></span><h3>Coding style<a class="headerlink" href="#pg0101" title="Permalink to this heading">¶</a></h3> +<span id="coding-style"></span><span id="index-0"></span><h3>Coding style<a class="headerlink" href="#pg0101" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0101</p> @@ -691,7 +692,7 @@ Consistency avoids unnecessary changes when other developers edit the ebuild.</p> </section> <section id="pg0102"> -<span id="code-must-be-contained-within-ebuild-and-eclasses"></span><span id="index-1"></span><h3>Code must be contained within ebuild and eclasses<a class="headerlink" href="#pg0102" title="Permalink to this heading">¶</a></h3> +<span id="code-must-be-contained-within-ebuild-and-eclasses"></span><span id="index-1"></span><h3>Code must be contained within ebuild and eclasses<a class="headerlink" href="#pg0102" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0102</p> @@ -718,7 +719,7 @@ confuses other developers and tools that do not explicitly account for that possibility, including linting tools.</p> </section> <section id="pg0103"> -<span id="homepage-must-not-contain-variables"></span><span id="index-2"></span><h3>HOMEPAGE must not contain variables<a class="headerlink" href="#pg0103" title="Permalink to this heading">¶</a></h3> +<span id="homepage-must-not-contain-variables"></span><span id="index-2"></span><h3>HOMEPAGE must not contain variables<a class="headerlink" href="#pg0103" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0103</p> @@ -740,7 +741,7 @@ preprocessing, breaking URI support in terminals and editors, as well as reducing the usefulness of plain tools such as grep.</p> </section> <section id="pg0104"> -<span id="src-uri-must-not-refer-to-homepage"></span><span id="index-3"></span><h3>SRC_URI must not refer to HOMEPAGE<a class="headerlink" href="#pg0104" title="Permalink to this heading">¶</a></h3> +<span id="src-uri-must-not-refer-to-homepage"></span><span id="index-3"></span><h3>SRC_URI must not refer to HOMEPAGE<a class="headerlink" href="#pg0104" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0104</p> @@ -763,7 +764,7 @@ it hard to copy-paste part of the URI e.g. to investigate the directory index.</p> </section> <section id="pg0105"> -<span id="keywords-must-be-defined-on-a-single-line"></span><span id="index-4"></span><h3>KEYWORDS must be defined on a single line<a class="headerlink" href="#pg0105" title="Permalink to this heading">¶</a></h3> +<span id="keywords-must-be-defined-on-a-single-line"></span><span id="index-4"></span><h3>KEYWORDS must be defined on a single line<a class="headerlink" href="#pg0105" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0105</p> @@ -784,7 +785,7 @@ ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.</p> </section> <section id="pg0106"> -<span id="license-must-not-contain-variables"></span><span id="index-5"></span><h3>LICENSE must not contain variables<a class="headerlink" href="#pg0106" title="Permalink to this heading">¶</a></h3> +<span id="license-must-not-contain-variables"></span><span id="index-5"></span><h3>LICENSE must not contain variables<a class="headerlink" href="#pg0106" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0106</p> @@ -805,7 +806,7 @@ package versions), using variables there has little advantage. On the other hand, variables reduce the usefulness of plain tools such as grep.</p> </section> <section id="pg0107"> -<span id="d-must-be-used-only-in-src-install-and-pkg-preinst"></span><span id="index-6"></span><h3>D must be used only in src_install and pkg_preinst<a class="headerlink" href="#pg0107" title="Permalink to this heading">¶</a></h3> +<span id="d-must-be-used-only-in-src-install-and-pkg-preinst"></span><span id="index-6"></span><h3>D must be used only in src_install and pkg_preinst<a class="headerlink" href="#pg0107" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0107</p> @@ -827,9 +828,9 @@ does not exist in other phases.</p> </section> </section> <span id="document-filesystem"></span><section id="file-system-layout"> -<h2>File system layout<a class="headerlink" href="#file-system-layout" title="Permalink to this heading">¶</a></h2> +<h2>File system layout<a class="headerlink" href="#file-system-layout" title="Link to this heading">¶</a></h2> <section id="pg0201"> -<span id="installation-paths"></span><span id="index-0"></span><h3>Installation paths<a class="headerlink" href="#pg0201" title="Permalink to this heading">¶</a></h3> +<span id="installation-paths"></span><span id="index-0"></span><h3>Installation paths<a class="headerlink" href="#pg0201" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0201</p> @@ -900,7 +901,7 @@ exceptions are:</p> </ul> </section> <section id="pg0202"> -<span id="support-for-separate-usr"></span><span id="index-1"></span><h3>Support for separate /usr<a class="headerlink" href="#pg0202" title="Permalink to this heading">¶</a></h3> +<span id="support-for-separate-usr"></span><span id="index-1"></span><h3>Support for separate /usr<a class="headerlink" href="#pg0202" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0202</p> @@ -925,7 +926,7 @@ using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.</p> </section> <section id="pg0203"> -<span id="strict-multilib-layout"></span><span id="index-2"></span><h3>Strict multilib layout<a class="headerlink" href="#pg0203" title="Permalink to this heading">¶</a></h3> +<span id="strict-multilib-layout"></span><span id="index-2"></span><h3>Strict multilib layout<a class="headerlink" href="#pg0203" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0203</p> @@ -952,7 +953,7 @@ and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.</p> </section> <section id="pg0204"> -<span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h3>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Permalink to this heading">¶</a></h3> +<span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h3>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0204</p> @@ -978,7 +979,7 @@ used only during package builds, and installing them to rootfs would be a waste of space.</p> </section> <section id="pg0205"> -<span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h3>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Permalink to this heading">¶</a></h3> +<span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h3>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0205</p> @@ -1017,7 +1018,7 @@ to the games group, a new group (gamestat) needed to be created to fulfill that purpose.</p> </section> <section id="pg0206"> -<span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h3>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Permalink to this heading">¶</a></h3> +<span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h3>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0206</p> @@ -1048,9 +1049,9 @@ it is mounted in another location, e.g. for the purposes of recovery.</p> </section> </section> <span id="document-installed-files"></span><section id="installed-files"> -<h2>Installed files<a class="headerlink" href="#installed-files" title="Permalink to this heading">¶</a></h2> +<h2>Installed files<a class="headerlink" href="#installed-files" title="Link to this heading">¶</a></h2> <section id="pg0301"> -<span id="installation-of-small-files"></span><span id="index-0"></span><h3>Installation of small files<a class="headerlink" href="#pg0301" title="Permalink to this heading">¶</a></h3> +<span id="installation-of-small-files"></span><span id="index-0"></span><h3>Installation of small files<a class="headerlink" href="#pg0301" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0301</p> @@ -1085,7 +1086,7 @@ installed, completion files are not used at all.</p> </div> </section> <section id="pg0302"> -<span id="installation-of-static-libraries"></span><span id="index-1"></span><h3>Installation of static libraries<a class="headerlink" href="#pg0302" title="Permalink to this heading">¶</a></h3> +<span id="installation-of-static-libraries"></span><span id="index-1"></span><h3>Installation of static libraries<a class="headerlink" href="#pg0302" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0302</p> @@ -1117,7 +1118,7 @@ it is acceptable to strip static libraries in <code class="docutils literal notr </div> </section> <section id="pg0303"> -<span id="installation-of-libtool-la-files"></span><span id="index-2"></span><h3>Installation of libtool (.la) files<a class="headerlink" href="#pg0303" title="Permalink to this heading">¶</a></h3> +<span id="installation-of-libtool-la-files"></span><span id="index-2"></span><h3>Installation of libtool (.la) files<a class="headerlink" href="#pg0303" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0303</p> @@ -1151,7 +1152,7 @@ and while libtool keeps generating them, they are considered unnecessary and potentially harmful.</p> </section> <section id="pg0304"> -<span id="virtuals"></span><span id="index-3"></span><h3>Virtuals<a class="headerlink" href="#pg0304" title="Permalink to this heading">¶</a></h3> +<span id="virtuals"></span><span id="index-3"></span><h3>Virtuals<a class="headerlink" href="#pg0304" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0304</p> @@ -1171,7 +1172,7 @@ e.g., that they must not assign the <code class="docutils literal notranslate">< be impossible if they installed any files).</p> </section> <section id="pg0305"> -<span id="installation-of-manpages"></span><span id="index-4"></span><h3>Installation of manpages<a class="headerlink" href="#pg0305" title="Permalink to this heading">¶</a></h3> +<span id="installation-of-manpages"></span><span id="index-4"></span><h3>Installation of manpages<a class="headerlink" href="#pg0305" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0305</p> @@ -1194,9 +1195,9 @@ prebuilt manpages is a good compromise.</p> </section> </section> <span id="document-keywords"></span><section id="keywording-and-stabilization"> -<h2>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Permalink to this heading">¶</a></h2> +<h2>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Link to this heading">¶</a></h2> <section id="pg0401"> -<span id="rekeywording-on-dropped-keywords"></span><span id="index-0"></span><h3>Rekeywording on dropped keywords<a class="headerlink" href="#pg0401" title="Permalink to this heading">¶</a></h3> +<span id="rekeywording-on-dropped-keywords"></span><span id="index-0"></span><h3>Rekeywording on dropped keywords<a class="headerlink" href="#pg0401" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0401</p> @@ -1218,7 +1219,7 @@ affects other developers who in the future either want to stabilize a new version or to remove an old version.</p> </section> <section id="pg0402"> -<span id="stabilizing-new-versions"></span><span id="index-1"></span><h3>Stabilizing new versions<a class="headerlink" href="#pg0402" title="Permalink to this heading">¶</a></h3> +<span id="stabilizing-new-versions"></span><span id="index-1"></span><h3>Stabilizing new versions<a class="headerlink" href="#pg0402" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0402</p> @@ -1248,7 +1249,7 @@ is stable and whether arch teams are slacking or stabilization was not requested on remaining architectures in the first place.</p> </section> <section id="pg0403"> -<span id="removing-stable-keywords"></span><span id="index-2"></span><h3>Removing stable keywords<a class="headerlink" href="#pg0403" title="Permalink to this heading">¶</a></h3> +<span id="removing-stable-keywords"></span><span id="index-2"></span><h3>Removing stable keywords<a class="headerlink" href="#pg0403" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0403</p> @@ -1273,11 +1274,11 @@ of last rite mails.</p> </section> </section> <span id="document-languages"></span><section id="language-specific-policies"> -<h2>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Permalink to this heading">¶</a></h2> +<h2>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Link to this heading">¶</a></h2> <section id="python"> -<span id="index-0"></span><h3>Python<a class="headerlink" href="#python" title="Permalink to this heading">¶</a></h3> -<span class="target" id="index-1"></span><span class="target" id="index-2"></span><span class="target" id="index-3"></span><section id="pg0501"> -<span id="eclass-usage"></span><span id="index-4"></span><h4>Eclass usage<a class="headerlink" href="#pg0501" title="Permalink to this heading">¶</a></h4> +<span id="index-0"></span><h3>Python<a class="headerlink" href="#python" title="Link to this heading">¶</a></h3> +<section id="pg0501"> +<span id="eclass-usage"></span><span id="index-4"></span><span id="index-3"></span><span id="index-2"></span><span id="index-1"></span><h4>Eclass usage<a class="headerlink" href="#pg0501" title="Link to this heading">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0501</p> @@ -1310,7 +1311,7 @@ and variables also make it possible to gracefully retire old implementations with minimal changes to existing ebuilds.</p> </section> <section id="pg0502"> -<span id="python-2-deprecation"></span><span id="index-5"></span><h4>Python 2 deprecation<a class="headerlink" href="#pg0502" title="Permalink to this heading">¶</a></h4> +<span id="python-2-deprecation"></span><span id="index-5"></span><h4>Python 2 deprecation<a class="headerlink" href="#pg0502" title="Link to this heading">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0502</p> @@ -1346,9 +1347,9 @@ will cause major upgrade issues.</p> </section> </section> <span id="document-maintainer"></span><section id="package-maintainers"> -<h2>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Permalink to this heading">¶</a></h2> +<h2>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Link to this heading">¶</a></h2> <section id="pg0601"> -<span id="adding-new-maintainers"></span><span id="index-0"></span><h3>Adding new maintainers<a class="headerlink" href="#pg0601" title="Permalink to this heading">¶</a></h3> +<span id="adding-new-maintainers"></span><span id="index-0"></span><h3>Adding new maintainers<a class="headerlink" href="#pg0601" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0601</p> @@ -1377,7 +1378,7 @@ packages ended up being maintained solely by Python, and distinguishing them from packages actually within project’s profile was hard.</p> </section> <section id="pg0602"> -<span id="new-packages-without-a-maintainer"></span><span id="index-1"></span><h3>New packages without a maintainer<a class="headerlink" href="#pg0602" title="Permalink to this heading">¶</a></h3> +<span id="new-packages-without-a-maintainer"></span><span id="index-1"></span><h3>New packages without a maintainer<a class="headerlink" href="#pg0602" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0602</p> @@ -1397,9 +1398,9 @@ 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></section> +</section> <section id="pg0603"> -<span id="removing-package-maintainers"></span><span id="index-3"></span><h3>Removing package maintainers<a class="headerlink" href="#pg0603" title="Permalink to this heading">¶</a></h3> +<span id="removing-package-maintainers"></span><span id="index-3"></span><span id="index-2"></span><h3>Removing package maintainers<a class="headerlink" href="#pg0603" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0603</p> @@ -1431,9 +1432,9 @@ to them silently becoming maintainer-needed).</p> </section> </section> <span id="document-other-metadata"></span><section id="other-metadata-variables"> -<h2>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this heading">¶</a></h2> -<span class="target" id="index-0"></span><section id="pg0701"> -<span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><h3>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Permalink to this heading">¶</a></h3> +<h2>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Link to this heading">¶</a></h2> +<section id="pg0701"> +<span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><span id="index-0"></span><h3>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0701</p> @@ -1471,7 +1472,7 @@ manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.</p> </section> <section id="pg0702"> -<span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h3>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Permalink to this heading">¶</a></h3> +<span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h3>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0702</p> @@ -1502,7 +1503,7 @@ those cases, using the explicit No_homepage marker at least makes it easy to identify such packages.</p> </section> <section id="pg0703"> -<span id="restrict-test-for-use-test"></span><span id="index-3"></span><h3>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Permalink to this heading">¶</a></h3> +<span id="restrict-test-for-use-test"></span><span id="index-3"></span><h3>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0703</p> @@ -1536,7 +1537,7 @@ common, and there is little harm in overspecifying it.</p> </div> </section> <section id="pg0704"> -<span id="license"></span><span id="index-4"></span><h3>LICENSE<a class="headerlink" href="#pg0704" title="Permalink to this heading">¶</a></h3> +<span id="license"></span><span id="index-4"></span><h3>LICENSE<a class="headerlink" href="#pg0704" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0704</p> @@ -1584,9 +1585,9 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).</p> </section> </section> <span id="document-use-flags"></span><section id="use-flags"> -<h2>USE flags<a class="headerlink" href="#use-flags" title="Permalink to this heading">¶</a></h2> +<h2>USE flags<a class="headerlink" href="#use-flags" title="Link to this heading">¶</a></h2> <section id="pg0801"> -<span id="versioned-use-flags"></span><span id="index-0"></span><h3>Versioned USE flags<a class="headerlink" href="#pg0801" title="Permalink to this heading">¶</a></h3> +<span id="versioned-use-flags"></span><span id="index-0"></span><h3>Versioned USE flags<a class="headerlink" href="#pg0801" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0801</p> @@ -1617,7 +1618,7 @@ removed since.</p> </div> </section> <section id="pg0802"> -<span id="use-gui-flag"></span><span id="index-1"></span><h3>USE=gui flag<a class="headerlink" href="#pg0802" title="Permalink to this heading">¶</a></h3> +<span id="use-gui-flag"></span><span id="index-1"></span><h3>USE=gui flag<a class="headerlink" href="#pg0802" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0802</p> @@ -1646,7 +1647,7 @@ afterwards caused issues with packages supporting a choice between multiple GUIs.</p> </section> <section id="pg0803"> -<span id="underscores-in-use-flag-names"></span><span id="index-2"></span><h3>Underscores in USE flag names<a class="headerlink" href="#pg0803" title="Permalink to this heading">¶</a></h3> +<span id="underscores-in-use-flag-names"></span><span id="index-2"></span><h3>Underscores in USE flag names<a class="headerlink" href="#pg0803" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0803</p> @@ -1680,9 +1681,9 @@ or underscores depending on developer’s personal preference.</p> </section> </section> <span id="document-user-group"></span><section id="users-and-groups"> -<h2>Users and groups<a class="headerlink" href="#users-and-groups" title="Permalink to this heading">¶</a></h2> -<span class="target" id="index-0"></span><section id="pg0901"> -<span id="user-and-group-account-policy"></span><span id="index-1"></span><h3>User and group account policy<a class="headerlink" href="#pg0901" title="Permalink to this heading">¶</a></h3> +<h2>Users and groups<a class="headerlink" href="#users-and-groups" title="Link to this heading">¶</a></h2> +<section id="pg0901"> +<span id="user-and-group-account-policy"></span><span id="index-1"></span><span id="index-0"></span><h3>User and group account policy<a class="headerlink" href="#pg0901" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0901</p> @@ -1735,7 +1736,7 @@ been reserved for true system users and groups.</p> </div> </section> <section id="indices-and-tables"> -<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this heading">¶</a></h1> +<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Link to this heading">¶</a></h1> <ul class="simple"> <li><p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></p></li> <li><p><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></p></li> @@ -1904,7 +1905,7 @@ been reserved for true system users and groups.</p> <h3 class="footerhead">None</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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -1918,16 +1919,13 @@ been reserved for true system users and groups.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/dependencies.html b/dependencies.html index 26635a5..fbe5a03 100644 --- a/dependencies.html +++ b/dependencies.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Dependencies — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Deprecations" href="deprecation.html" /> @@ -133,9 +134,9 @@ <section id="dependencies"> -<h1>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this heading">¶</a></h1> -<span class="target" id="index-0"></span><section id="pg0001"> -<span id="optional-runtime-dependencies"></span><span id="index-1"></span><h2>Optional runtime dependencies<a class="headerlink" href="#pg0001" title="Permalink to this heading">¶</a></h2> +<h1>Dependencies<a class="headerlink" href="#dependencies" title="Link to this heading">¶</a></h1> +<section id="pg0001"> +<span id="optional-runtime-dependencies"></span><span id="index-1"></span><span id="index-0"></span><h2>Optional runtime dependencies<a class="headerlink" href="#pg0001" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0001</p> @@ -169,7 +170,7 @@ by the Council but no reference implementation has been written.</p> </div> </section> <section id="pg0002"> -<span id="dependencies-with-no-revision"></span><span id="index-2"></span><h2>=-dependencies with no revision<a class="headerlink" href="#pg0002" title="Permalink to this heading">¶</a></h2> +<span id="dependencies-with-no-revision"></span><span id="index-2"></span><h2>=-dependencies with no revision<a class="headerlink" href="#pg0002" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0002</p> @@ -201,9 +202,9 @@ requesting the latter, it warns developers to reconsider whether they used the correct operator.</p> </section> <section id="slot-and-subslot-dependencies"> -<span id="index-3"></span><h2>Slot and subslot dependencies<a class="headerlink" href="#slot-and-subslot-dependencies" title="Permalink to this heading">¶</a></h2> +<span id="index-3"></span><h2>Slot and subslot dependencies<a class="headerlink" href="#slot-and-subslot-dependencies" title="Link to this heading">¶</a></h2> <section id="pg0011"> -<span id="on-sub-slotted-packages"></span><h3>on (sub-)slotted packages<a class="headerlink" href="#pg0011" title="Permalink to this heading">¶</a></h3> +<span id="on-sub-slotted-packages"></span><h3>on (sub-)slotted packages<a class="headerlink" href="#pg0011" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0011</p> @@ -240,7 +241,7 @@ to the newest package version available.</p> </div> </section> <section id="pg0012"> -<span id="special-case-qt-packages"></span><span id="index-4"></span><h3>special case: Qt packages<a class="headerlink" href="#pg0012" title="Permalink to this heading">¶</a></h3> +<span id="special-case-qt-packages"></span><span id="index-4"></span><h3>special case: Qt packages<a class="headerlink" href="#pg0012" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0012</p> @@ -262,7 +263,7 @@ if your package uses one of the private API parts, and plain <code class="docuti or likewise dependency must be used otherwise.</p> </section> <section id="proactive-use-of-slot-operators"> -<h3>proactive use of slot operators<a class="headerlink" href="#proactive-use-of-slot-operators" title="Permalink to this heading">¶</a></h3> +<h3>proactive use of slot operators<a class="headerlink" href="#proactive-use-of-slot-operators" title="Link to this heading">¶</a></h3> <p>There is an open debate on whether developers should be proactively adding <code class="docutils literal notranslate"><span class="pre">:=</span></code> slot operators on packages that do not define subslots yet.</p> @@ -276,7 +277,7 @@ They point out the case of Qt packages as an example.</p> </section> </section> <section id="pg0003"> -<span id="revision-bumps-on-runtime-dependency-changes"></span><span id="index-5"></span><h2>Revision bumps on runtime dependency changes<a class="headerlink" href="#pg0003" title="Permalink to this heading">¶</a></h2> +<span id="revision-bumps-on-runtime-dependency-changes"></span><span id="index-5"></span><h2>Revision bumps on runtime dependency changes<a class="headerlink" href="#pg0003" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0003</p> @@ -319,9 +320,9 @@ if the package installed by the user still links to libfoo.</p> </div> </section> <section id="use-dependencies"> -<span id="index-6"></span><h2>USE dependencies<a class="headerlink" href="#use-dependencies" title="Permalink to this heading">¶</a></h2> +<span id="index-6"></span><h2>USE dependencies<a class="headerlink" href="#use-dependencies" title="Link to this heading">¶</a></h2> <section id="pg0021"> -<span id="on-packages-without-the-flag"></span><h3>on packages without the flag<a class="headerlink" href="#pg0021" title="Permalink to this heading">¶</a></h3> +<span id="on-packages-without-the-flag"></span><h3>on packages without the flag<a class="headerlink" href="#pg0021" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0021</p> @@ -453,7 +454,7 @@ updating its reverse dependencies.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -467,16 +468,13 @@ updating its reverse dependencies.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/deprecation.html b/deprecation.html index 8e511d2..6132295 100644 --- a/deprecation.html +++ b/deprecation.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Deprecations — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="deprecations"> -<h1>Deprecations<a class="headerlink" href="#deprecations" title="Permalink to this heading">¶</a></h1> +<h1>Deprecations<a class="headerlink" href="#deprecations" title="Link to this heading">¶</a></h1> <section id="pg1001"> -<span id="deprecated-eapis"></span><span id="index-0"></span><h2>Deprecated EAPIs<a class="headerlink" href="#pg1001" title="Permalink to this heading">¶</a></h2> +<span id="deprecated-eapis"></span><span id="index-0"></span><h2>Deprecated EAPIs<a class="headerlink" href="#pg1001" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>1001</p> @@ -157,7 +158,7 @@ no version bumps are expected.</p> in <code class="docutils literal notranslate"><span class="pre">metadata/layout.conf</span></code>.</p> </section> <section id="pg1003"> -<span id="deprecated-eclasses"></span><span id="index-1"></span><h2>Deprecated eclasses<a class="headerlink" href="#pg1003" title="Permalink to this heading">¶</a></h2> +<span id="deprecated-eclasses"></span><span id="index-1"></span><h2>Deprecated eclasses<a class="headerlink" href="#pg1003" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>1003</p> @@ -257,7 +258,7 @@ inside the eclass files.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -271,16 +272,13 @@ inside the eclass files.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/ebuild-format.html b/ebuild-format.html index a1cacbd..df4d239 100644 --- a/ebuild-format.html +++ b/ebuild-format.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Ebuild file format — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="ebuild-file-format"> -<h1>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Permalink to this heading">¶</a></h1> +<h1>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Link to this heading">¶</a></h1> <section id="pg0101"> -<span id="coding-style"></span><span id="index-0"></span><h2>Coding style<a class="headerlink" href="#pg0101" title="Permalink to this heading">¶</a></h2> +<span id="coding-style"></span><span id="index-0"></span><h2>Coding style<a class="headerlink" href="#pg0101" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0101</p> @@ -162,7 +163,7 @@ Consistency avoids unnecessary changes when other developers edit the ebuild.</p> </section> <section id="pg0102"> -<span id="code-must-be-contained-within-ebuild-and-eclasses"></span><span id="index-1"></span><h2>Code must be contained within ebuild and eclasses<a class="headerlink" href="#pg0102" title="Permalink to this heading">¶</a></h2> +<span id="code-must-be-contained-within-ebuild-and-eclasses"></span><span id="index-1"></span><h2>Code must be contained within ebuild and eclasses<a class="headerlink" href="#pg0102" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0102</p> @@ -189,7 +190,7 @@ confuses other developers and tools that do not explicitly account for that possibility, including linting tools.</p> </section> <section id="pg0103"> -<span id="homepage-must-not-contain-variables"></span><span id="index-2"></span><h2>HOMEPAGE must not contain variables<a class="headerlink" href="#pg0103" title="Permalink to this heading">¶</a></h2> +<span id="homepage-must-not-contain-variables"></span><span id="index-2"></span><h2>HOMEPAGE must not contain variables<a class="headerlink" href="#pg0103" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0103</p> @@ -211,7 +212,7 @@ preprocessing, breaking URI support in terminals and editors, as well as reducing the usefulness of plain tools such as grep.</p> </section> <section id="pg0104"> -<span id="src-uri-must-not-refer-to-homepage"></span><span id="index-3"></span><h2>SRC_URI must not refer to HOMEPAGE<a class="headerlink" href="#pg0104" title="Permalink to this heading">¶</a></h2> +<span id="src-uri-must-not-refer-to-homepage"></span><span id="index-3"></span><h2>SRC_URI must not refer to HOMEPAGE<a class="headerlink" href="#pg0104" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0104</p> @@ -234,7 +235,7 @@ it hard to copy-paste part of the URI e.g. to investigate the directory index.</p> </section> <section id="pg0105"> -<span id="keywords-must-be-defined-on-a-single-line"></span><span id="index-4"></span><h2>KEYWORDS must be defined on a single line<a class="headerlink" href="#pg0105" title="Permalink to this heading">¶</a></h2> +<span id="keywords-must-be-defined-on-a-single-line"></span><span id="index-4"></span><h2>KEYWORDS must be defined on a single line<a class="headerlink" href="#pg0105" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0105</p> @@ -255,7 +256,7 @@ ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.</p> </section> <section id="pg0106"> -<span id="license-must-not-contain-variables"></span><span id="index-5"></span><h2>LICENSE must not contain variables<a class="headerlink" href="#pg0106" title="Permalink to this heading">¶</a></h2> +<span id="license-must-not-contain-variables"></span><span id="index-5"></span><h2>LICENSE must not contain variables<a class="headerlink" href="#pg0106" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0106</p> @@ -276,7 +277,7 @@ package versions), using variables there has little advantage. On the other hand, variables reduce the usefulness of plain tools such as grep.</p> </section> <section id="pg0107"> -<span id="d-must-be-used-only-in-src-install-and-pkg-preinst"></span><span id="index-6"></span><h2>D must be used only in src_install and pkg_preinst<a class="headerlink" href="#pg0107" title="Permalink to this heading">¶</a></h2> +<span id="d-must-be-used-only-in-src-install-and-pkg-preinst"></span><span id="index-6"></span><h2>D must be used only in src_install and pkg_preinst<a class="headerlink" href="#pg0107" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0107</p> @@ -383,7 +384,7 @@ does not exist in other phases.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -397,16 +398,13 @@ does not exist in other phases.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/editing.html b/editing.html index 88c40ea..8d78cbd 100644 --- a/editing.html +++ b/editing.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Editing and publishing updates to this Guide — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Dependencies" href="dependencies.html" /> @@ -133,9 +134,9 @@ <section id="editing-and-publishing-updates-to-this-guide"> -<h1>Editing and publishing updates to this Guide<a class="headerlink" href="#editing-and-publishing-updates-to-this-guide" title="Permalink to this heading">¶</a></h1> +<h1>Editing and publishing updates to this Guide<a class="headerlink" href="#editing-and-publishing-updates-to-this-guide" title="Link to this heading">¶</a></h1> <section id="formatting-and-style"> -<h2>Formatting and style<a class="headerlink" href="#formatting-and-style" title="Permalink to this heading">¶</a></h2> +<h2>Formatting and style<a class="headerlink" href="#formatting-and-style" title="Link to this heading">¶</a></h2> <p>While editing the Guide, please respect the existing formatting rules. Notably:</p> <ul class="simple"> @@ -150,7 +151,7 @@ rules match multiple chapters, choose the one that fits it best. Make sure to match existing keywords in index.</p> </section> <section id="getting-sources"> -<h2>Getting sources<a class="headerlink" href="#getting-sources" title="Permalink to this heading">¶</a></h2> +<h2>Getting sources<a class="headerlink" href="#getting-sources" title="Link to this heading">¶</a></h2> <p>The reference repository is hosted at git.gentoo.org, and available via <a class="reference external" href="https://gitweb.gentoo.org/proj/policy-guide.git/">proj/policy-guide.git gitweb</a>. To clone it:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># via https</span> @@ -164,7 +165,7 @@ the GitHub <a class="reference external" href="https://github.com/gentoo/policy- instead.</p> </section> <section id="building"> -<h2>Building<a class="headerlink" href="#building" title="Permalink to this heading">¶</a></h2> +<h2>Building<a class="headerlink" href="#building" title="Link to this heading">¶</a></h2> <p>A tox-file is provided to build the Guide in a virtualenv, installing all necessary dependencies. To build the HTML version, run:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">tox</span> @@ -177,13 +178,13 @@ as a command-line argument, e.g.:</p> </div> </section> <section id="sending-contributions"> -<h2>Sending contributions<a class="headerlink" href="#sending-contributions" title="Permalink to this heading">¶</a></h2> +<h2>Sending contributions<a class="headerlink" href="#sending-contributions" title="Link to this heading">¶</a></h2> <p>Changes to this document can be either submitted to <a class="reference external" href="https://bugs.gentoo.org/enter_bug.cgi?product=Documentation&component=Policy+Guide">Policy Manual Gentoo Bugzilla component</a> as git-format patches attached to the bugs, or to <a class="reference external" href="https://github.com/gentoo/policy-guide">gentoo/policy-guide repository</a> as pull requests.</p> </section> <section id="merging-pull-requests"> -<h2>Merging pull requests<a class="headerlink" href="#merging-pull-requests" title="Permalink to this heading">¶</a></h2> +<h2>Merging pull requests<a class="headerlink" href="#merging-pull-requests" title="Link to this heading">¶</a></h2> <p>The recommended way to merge pull requests is to use <code class="docutils literal notranslate"><span class="pre">app-portage/pram</span></code>. To configure the remote before the first use, run the following command in your checkout:</p> @@ -196,7 +197,7 @@ run the following command in your checkout:</p> </div> </section> <section id="publishing"> -<h2>Publishing<a class="headerlink" href="#publishing" title="Permalink to this heading">¶</a></h2> +<h2>Publishing<a class="headerlink" href="#publishing" title="Link to this heading">¶</a></h2> <p>The built version of Policy Guide is currently published via a git repository. The recommended method is to clone the repository into <code class="docutils literal notranslate"><span class="pre">_build/html</span></code> in order to make Sphinx output into the checkout:</p> @@ -293,7 +294,7 @@ into <code class="docutils literal notranslate"><span class="pre">_build/html</s <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -307,16 +308,13 @@ into <code class="docutils literal notranslate"><span class="pre">_build/html</s </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/filesystem.html b/filesystem.html index 1ccdbb9..86d6656 100644 --- a/filesystem.html +++ b/filesystem.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>File system layout — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="file-system-layout"> -<h1>File system layout<a class="headerlink" href="#file-system-layout" title="Permalink to this heading">¶</a></h1> +<h1>File system layout<a class="headerlink" href="#file-system-layout" title="Link to this heading">¶</a></h1> <section id="pg0201"> -<span id="installation-paths"></span><span id="index-0"></span><h2>Installation paths<a class="headerlink" href="#pg0201" title="Permalink to this heading">¶</a></h2> +<span id="installation-paths"></span><span id="index-0"></span><h2>Installation paths<a class="headerlink" href="#pg0201" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0201</p> @@ -206,7 +207,7 @@ exceptions are:</p> </ul> </section> <section id="pg0202"> -<span id="support-for-separate-usr"></span><span id="index-1"></span><h2>Support for separate /usr<a class="headerlink" href="#pg0202" title="Permalink to this heading">¶</a></h2> +<span id="support-for-separate-usr"></span><span id="index-1"></span><h2>Support for separate /usr<a class="headerlink" href="#pg0202" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0202</p> @@ -231,7 +232,7 @@ using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.</p> </section> <section id="pg0203"> -<span id="strict-multilib-layout"></span><span id="index-2"></span><h2>Strict multilib layout<a class="headerlink" href="#pg0203" title="Permalink to this heading">¶</a></h2> +<span id="strict-multilib-layout"></span><span id="index-2"></span><h2>Strict multilib layout<a class="headerlink" href="#pg0203" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0203</p> @@ -258,7 +259,7 @@ and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.</p> </section> <section id="pg0204"> -<span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h2>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Permalink to this heading">¶</a></h2> +<span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h2>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0204</p> @@ -284,7 +285,7 @@ used only during package builds, and installing them to rootfs would be a waste of space.</p> </section> <section id="pg0205"> -<span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h2>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Permalink to this heading">¶</a></h2> +<span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h2>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0205</p> @@ -323,7 +324,7 @@ to the games group, a new group (gamestat) needed to be created to fulfill that purpose.</p> </section> <section id="pg0206"> -<span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h2>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Permalink to this heading">¶</a></h2> +<span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h2>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0206</p> @@ -438,7 +439,7 @@ it is mounted in another location, e.g. for the purposes of recovery.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -452,16 +453,13 @@ it is mounted in another location, e.g. for the purposes of recovery.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/genindex.html b/genindex.html index b1eb47e..b8088af 100644 --- a/genindex.html +++ b/genindex.html @@ -7,19 +7,20 @@ <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Index — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="#" /> <link rel="search" title="Search" href="search.html" /> </head><body> @@ -558,7 +559,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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -572,16 +573,13 @@ </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Gentoo Policy Guide — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></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" /> @@ -130,7 +131,7 @@ <section id="gentoo-policy-guide"> -<h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Permalink to this heading">¶</a></h1> +<h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Link to this heading">¶</a></h1> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. It combines both policies that are global by design (i.e. set by the QA @@ -271,7 +272,7 @@ in which the policy can be updated.</p> </div> </section> <section id="indices-and-tables"> -<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this heading">¶</a></h1> +<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Link to this heading">¶</a></h1> <ul class="simple"> <li><p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></p></li> <li><p><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></p></li> @@ -347,7 +348,7 @@ in which the policy can be updated.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -361,16 +362,13 @@ in which the policy can be updated.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/installed-files.html b/installed-files.html index f784992..ac42aee 100644 --- a/installed-files.html +++ b/installed-files.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Installed files — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="installed-files"> -<h1>Installed files<a class="headerlink" href="#installed-files" title="Permalink to this heading">¶</a></h1> +<h1>Installed files<a class="headerlink" href="#installed-files" title="Link to this heading">¶</a></h1> <section id="pg0301"> -<span id="installation-of-small-files"></span><span id="index-0"></span><h2>Installation of small files<a class="headerlink" href="#pg0301" title="Permalink to this heading">¶</a></h2> +<span id="installation-of-small-files"></span><span id="index-0"></span><h2>Installation of small files<a class="headerlink" href="#pg0301" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0301</p> @@ -170,7 +171,7 @@ installed, completion files are not used at all.</p> </div> </section> <section id="pg0302"> -<span id="installation-of-static-libraries"></span><span id="index-1"></span><h2>Installation of static libraries<a class="headerlink" href="#pg0302" title="Permalink to this heading">¶</a></h2> +<span id="installation-of-static-libraries"></span><span id="index-1"></span><h2>Installation of static libraries<a class="headerlink" href="#pg0302" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0302</p> @@ -202,7 +203,7 @@ it is acceptable to strip static libraries in <code class="docutils literal notr </div> </section> <section id="pg0303"> -<span id="installation-of-libtool-la-files"></span><span id="index-2"></span><h2>Installation of libtool (.la) files<a class="headerlink" href="#pg0303" title="Permalink to this heading">¶</a></h2> +<span id="installation-of-libtool-la-files"></span><span id="index-2"></span><h2>Installation of libtool (.la) files<a class="headerlink" href="#pg0303" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0303</p> @@ -236,7 +237,7 @@ and while libtool keeps generating them, they are considered unnecessary and potentially harmful.</p> </section> <section id="pg0304"> -<span id="virtuals"></span><span id="index-3"></span><h2>Virtuals<a class="headerlink" href="#pg0304" title="Permalink to this heading">¶</a></h2> +<span id="virtuals"></span><span id="index-3"></span><h2>Virtuals<a class="headerlink" href="#pg0304" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0304</p> @@ -256,7 +257,7 @@ e.g., that they must not assign the <code class="docutils literal notranslate">< be impossible if they installed any files).</p> </section> <section id="pg0305"> -<span id="installation-of-manpages"></span><span id="index-4"></span><h2>Installation of manpages<a class="headerlink" href="#pg0305" title="Permalink to this heading">¶</a></h2> +<span id="installation-of-manpages"></span><span id="index-4"></span><h2>Installation of manpages<a class="headerlink" href="#pg0305" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0305</p> @@ -362,7 +363,7 @@ prebuilt manpages is a good compromise.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -376,16 +377,13 @@ prebuilt manpages is a good compromise.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/keywords.html b/keywords.html index c3cc1d5..ed7a0f9 100644 --- a/keywords.html +++ b/keywords.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Keywording and stabilization — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="keywording-and-stabilization"> -<h1>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Permalink to this heading">¶</a></h1> +<h1>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Link to this heading">¶</a></h1> <section id="pg0401"> -<span id="rekeywording-on-dropped-keywords"></span><span id="index-0"></span><h2>Rekeywording on dropped keywords<a class="headerlink" href="#pg0401" title="Permalink to this heading">¶</a></h2> +<span id="rekeywording-on-dropped-keywords"></span><span id="index-0"></span><h2>Rekeywording on dropped keywords<a class="headerlink" href="#pg0401" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0401</p> @@ -157,7 +158,7 @@ affects other developers who in the future either want to stabilize a new version or to remove an old version.</p> </section> <section id="pg0402"> -<span id="stabilizing-new-versions"></span><span id="index-1"></span><h2>Stabilizing new versions<a class="headerlink" href="#pg0402" title="Permalink to this heading">¶</a></h2> +<span id="stabilizing-new-versions"></span><span id="index-1"></span><h2>Stabilizing new versions<a class="headerlink" href="#pg0402" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0402</p> @@ -187,7 +188,7 @@ is stable and whether arch teams are slacking or stabilization was not requested on remaining architectures in the first place.</p> </section> <section id="pg0403"> -<span id="removing-stable-keywords"></span><span id="index-2"></span><h2>Removing stable keywords<a class="headerlink" href="#pg0403" title="Permalink to this heading">¶</a></h2> +<span id="removing-stable-keywords"></span><span id="index-2"></span><h2>Removing stable keywords<a class="headerlink" href="#pg0403" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0403</p> @@ -293,7 +294,7 @@ of last rite mails.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -307,16 +308,13 @@ of last rite mails.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/languages.html b/languages.html index 18101f8..6f913e1 100644 --- a/languages.html +++ b/languages.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Language-specific policies — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Package Maintainers" href="maintainer.html" /> @@ -133,11 +134,11 @@ <section id="language-specific-policies"> -<h1>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Permalink to this heading">¶</a></h1> +<h1>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Link to this heading">¶</a></h1> <section id="python"> -<span id="index-0"></span><h2>Python<a class="headerlink" href="#python" title="Permalink to this heading">¶</a></h2> -<span class="target" id="index-1"></span><span class="target" id="index-2"></span><span class="target" id="index-3"></span><section id="pg0501"> -<span id="eclass-usage"></span><span id="index-4"></span><h3>Eclass usage<a class="headerlink" href="#pg0501" title="Permalink to this heading">¶</a></h3> +<span id="index-0"></span><h2>Python<a class="headerlink" href="#python" title="Link to this heading">¶</a></h2> +<section id="pg0501"> +<span id="eclass-usage"></span><span id="index-4"></span><span id="index-3"></span><span id="index-2"></span><span id="index-1"></span><h3>Eclass usage<a class="headerlink" href="#pg0501" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0501</p> @@ -170,7 +171,7 @@ and variables also make it possible to gracefully retire old implementations with minimal changes to existing ebuilds.</p> </section> <section id="pg0502"> -<span id="python-2-deprecation"></span><span id="index-5"></span><h3>Python 2 deprecation<a class="headerlink" href="#pg0502" title="Permalink to this heading">¶</a></h3> +<span id="python-2-deprecation"></span><span id="index-5"></span><h3>Python 2 deprecation<a class="headerlink" href="#pg0502" title="Link to this heading">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0502</p> @@ -289,7 +290,7 @@ will cause major upgrade issues.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -303,16 +304,13 @@ will cause major upgrade issues.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/maintainer.html b/maintainer.html index b7fcbff..981f333 100644 --- a/maintainer.html +++ b/maintainer.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Package Maintainers — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></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" /> @@ -133,9 +134,9 @@ <section id="package-maintainers"> -<h1>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Permalink to this heading">¶</a></h1> +<h1>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Link to this heading">¶</a></h1> <section id="pg0601"> -<span id="adding-new-maintainers"></span><span id="index-0"></span><h2>Adding new maintainers<a class="headerlink" href="#pg0601" title="Permalink to this heading">¶</a></h2> +<span id="adding-new-maintainers"></span><span id="index-0"></span><h2>Adding new maintainers<a class="headerlink" href="#pg0601" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0601</p> @@ -164,7 +165,7 @@ packages ended up being maintained solely by Python, and distinguishing them from packages actually within project’s profile was hard.</p> </section> <section id="pg0602"> -<span id="new-packages-without-a-maintainer"></span><span id="index-1"></span><h2>New packages without a maintainer<a class="headerlink" href="#pg0602" title="Permalink to this heading">¶</a></h2> +<span id="new-packages-without-a-maintainer"></span><span id="index-1"></span><h2>New packages without a maintainer<a class="headerlink" href="#pg0602" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0602</p> @@ -184,9 +185,9 @@ 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></section> +</section> <section id="pg0603"> -<span id="removing-package-maintainers"></span><span id="index-3"></span><h2>Removing package maintainers<a class="headerlink" href="#pg0603" title="Permalink to this heading">¶</a></h2> +<span id="removing-package-maintainers"></span><span id="index-3"></span><span id="index-2"></span><h2>Removing package maintainers<a class="headerlink" href="#pg0603" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0603</p> @@ -299,7 +300,7 @@ to them silently becoming maintainer-needed).</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -313,16 +314,13 @@ to them silently becoming maintainer-needed).</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/motivation.html b/motivation.html index f51c796..38e02ea 100644 --- a/motivation.html +++ b/motivation.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Motivation and history — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="motivation-and-history"> -<h1>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Permalink to this heading">¶</a></h1> +<h1>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Link to this heading">¶</a></h1> <section id="historical-state-of-policy-documentation"> -<h2>Historical state of policy documentation<a class="headerlink" href="#historical-state-of-policy-documentation" title="Permalink to this heading">¶</a></h2> +<h2>Historical state of policy documentation<a class="headerlink" href="#historical-state-of-policy-documentation" title="Link to this heading">¶</a></h2> <p>At the time, Gentoo was lacking a clear and focused document listing all development-related policies in a concise and clear way.</p> <p><a class="reference external" href="https://projects.gentoo.org/pms/latest/pms.html">PMS</a> provided a technical specification for the ebuild files but did @@ -162,7 +163,7 @@ established less or more formally in the past but were never really written down.</p> </section> <section id="purpose-of-the-policy-guide"> -<h2>Purpose of the Policy Guide<a class="headerlink" href="#purpose-of-the-policy-guide" title="Permalink to this heading">¶</a></h2> +<h2>Purpose of the Policy Guide<a class="headerlink" href="#purpose-of-the-policy-guide" title="Link to this heading">¶</a></h2> <p>The Policy Guide was created in order to address aforementioned documentation deficiencies. Its primary purpose is to collect all applicable policies from various sources and combine them into a single @@ -259,7 +260,7 @@ devmanual) should conform to policies stated here.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -273,16 +274,13 @@ devmanual) should conform to policies stated here.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/other-docs.html b/other-docs.html index 8f37388..06c9a74 100644 --- a/other-docs.html +++ b/other-docs.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Other policy documents — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Editing and publishing updates to this Guide" href="editing.html" /> @@ -133,11 +134,11 @@ <section id="other-policy-documents"> -<h1>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Permalink to this heading">¶</a></h1> +<h1>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Link to this heading">¶</a></h1> <section id="gentoo-specific-documentation"> -<h2>Gentoo-specific documentation<a class="headerlink" href="#gentoo-specific-documentation" title="Permalink to this heading">¶</a></h2> +<h2>Gentoo-specific documentation<a class="headerlink" href="#gentoo-specific-documentation" title="Link to this heading">¶</a></h2> <section id="package-manager-specification"> -<h3>Package Manager Specification<a class="headerlink" href="#package-manager-specification" title="Permalink to this heading">¶</a></h3> +<h3>Package Manager Specification<a class="headerlink" href="#package-manager-specification" title="Link to this heading">¶</a></h3> <p><a class="reference external" href="https://projects.gentoo.org/pms/latest/pms.html">PMS</a> provides the specification of ebuild format, as well as general guidelines for implementing package managers. All ebuilds in the Gentoo repository are required to conform to the PMS. Tree policies may @@ -147,7 +148,7 @@ in subsequent EAPIs that are approved by the Council. The project’s wiki page discusses how PMS can be changed via <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Package_Manager_Specification/Future_EAPI_process">future EAPI process</a>.</p> </section> <section id="gleps"> -<h3>GLEPs<a class="headerlink" href="#gleps" title="Permalink to this heading">¶</a></h3> +<h3>GLEPs<a class="headerlink" href="#gleps" title="Link to this heading">¶</a></h3> <p><a class="reference external" href="https://www.gentoo.org/glep/">GLEPs</a> provide the highest level policies applicable to Gentoo. Final or active GLEPs apply to all developers. Tree policies may impose additional restrictions on GLEPs but may not override them.</p> @@ -156,7 +157,7 @@ In general, all GLEP updates go through mailing list review and need to be approved by the Council.</p> </section> <section id="developer-manual"> -<h3>Developer Manual<a class="headerlink" href="#developer-manual" title="Permalink to this heading">¶</a></h3> +<h3>Developer Manual<a class="headerlink" href="#developer-manual" title="Link to this heading">¶</a></h3> <p><a class="reference external" href="https://devmanual.gentoo.org/">Devmanual</a> is the basic guide for ebuild developers. Besides policies, it contains many general recommendations and detailed instructions. Developer Manual does not specify policies itself, and needs to comply @@ -166,16 +167,16 @@ recommended that all changes are reviewed by the <a class="reference external" h </section> </section> <section id="external-standards"> -<h2>External standards<a class="headerlink" href="#external-standards" title="Permalink to this heading">¶</a></h2> +<h2>External standards<a class="headerlink" href="#external-standards" title="Link to this heading">¶</a></h2> <section id="posix"> -<h3>POSIX<a class="headerlink" href="#posix" title="Permalink to this heading">¶</a></h3> +<h3>POSIX<a class="headerlink" href="#posix" title="Link to this heading">¶</a></h3> <p><a class="reference external" href="http://get.posixcertified.ieee.org/">POSIX</a> is the basic standard for operating systems. However, its rules apply to the software packaged in Gentoo rather than the distribution itself. Nevertheless, when no more specific policy applies, following POSIX is recommended.</p> </section> <section id="fhs"> -<h3>FHS<a class="headerlink" href="#fhs" title="Permalink to this heading">¶</a></h3> +<h3>FHS<a class="headerlink" href="#fhs" title="Link to this heading">¶</a></h3> <p><a class="reference external" href="https://refspecs.linuxfoundation.org/fhs.shtml">FHS</a> specifies the suggested filesystem layout for Linux systems. Gentoo follows FHS only partially. Whenever Gentoo policies and FHS disagree, Gentoo policies should be followed.</p> @@ -272,7 +273,7 @@ disagree, Gentoo policies should be followed.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -286,16 +287,13 @@ disagree, Gentoo policies should be followed.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/other-metadata.html b/other-metadata.html index 72243cb..2a4afae 100644 --- a/other-metadata.html +++ b/other-metadata.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Other metadata variables — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="other-metadata-variables"> -<h1>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this heading">¶</a></h1> -<span class="target" id="index-0"></span><section id="pg0701"> -<span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><h2>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Permalink to this heading">¶</a></h2> +<h1>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Link to this heading">¶</a></h1> +<section id="pg0701"> +<span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><span id="index-0"></span><h2>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0701</p> @@ -173,7 +174,7 @@ manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.</p> </section> <section id="pg0702"> -<span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h2>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Permalink to this heading">¶</a></h2> +<span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h2>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0702</p> @@ -204,7 +205,7 @@ those cases, using the explicit No_homepage marker at least makes it easy to identify such packages.</p> </section> <section id="pg0703"> -<span id="restrict-test-for-use-test"></span><span id="index-3"></span><h2>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Permalink to this heading">¶</a></h2> +<span id="restrict-test-for-use-test"></span><span id="index-3"></span><h2>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0703</p> @@ -238,7 +239,7 @@ common, and there is little harm in overspecifying it.</p> </div> </section> <section id="pg0704"> -<span id="license"></span><span id="index-4"></span><h2>LICENSE<a class="headerlink" href="#pg0704" title="Permalink to this heading">¶</a></h2> +<span id="license"></span><span id="index-4"></span><h2>LICENSE<a class="headerlink" href="#pg0704" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0704</p> @@ -368,7 +369,7 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -382,16 +383,13 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/preface.html b/preface.html index 28296fc..20c8e87 100644 --- a/preface.html +++ b/preface.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Preface — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -137,9 +138,9 @@ <section id="preface"> -<h1>Preface<a class="headerlink" href="#preface" title="Permalink to this heading">¶</a></h1> +<h1>Preface<a class="headerlink" href="#preface" title="Link to this heading">¶</a></h1> <section id="introduction"> -<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h2> +<h2>Introduction<a class="headerlink" href="#introduction" title="Link to this heading">¶</a></h2> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. It combines both policies that are global by design (i.e. set by the QA @@ -149,7 +150,7 @@ indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> </section> <section id="authors"> -<h2>Authors<a class="headerlink" href="#authors" title="Permalink to this heading">¶</a></h2> +<h2>Authors<a class="headerlink" href="#authors" title="Link to this heading">¶</a></h2> <p>This document is maintained by the Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA project</a>.</p> <p>The current text authors are:</p> <ul class="simple"> @@ -158,7 +159,7 @@ in which the policy can be updated.</p> </ul> </section> <section id="license"> -<h2>License<a class="headerlink" href="#license" title="Permalink to this heading">¶</a></h2> +<h2>License<a class="headerlink" href="#license" title="Link to this heading">¶</a></h2> <p>This work is licensed under the <a class="reference external" href="https://creativecommons.org/licenses/by-sa/4.0/.">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</p> </section> @@ -245,7 +246,7 @@ in which the policy can be updated.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -259,16 +260,13 @@ in which the policy can be updated.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/search.html b/search.html index 33a642c..afa9f70 100644 --- a/search.html +++ b/search.html @@ -7,20 +7,21 @@ <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Search — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <script src="_static/searchtools.js"></script> <script src="_static/language_data.js"></script> <link rel="index" title="Index" href="genindex.html" /> @@ -189,7 +190,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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -203,16 +204,13 @@ </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/searchindex.js b/searchindex.js index 7258a93..d566c73 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["basics", "dependencies", "deprecation", "ebuild-format", "editing", "filesystem", "index", "installed-files", "keywords", "languages", "maintainer", "motivation", "other-docs", "other-metadata", "preface", "use-flags", "user-group"], "filenames": ["basics.rst", "dependencies.rst", "deprecation.rst", "ebuild-format.rst", "editing.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"], "titles": ["Basic information", "Dependencies", "Deprecations", "Ebuild file format", "Editing and publishing updates to this Guide", "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"], "terms": {"The": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "gentoo": [0, 1, 2, 3, 4, 5, 8, 9, 10, 11, 13, 14, 15, 16], "focu": 0, "three": [0, 1], "aim": [0, 1, 6, 10, 14, 15], "portabl": [0, 1, 7], "By": [0, 1], "follow": [0, 4, 5, 7, 8, 10, 12, 16], "should": [0, 1, 2, 5, 7, 8, 9, 11, 12, 13, 15, 16], "possibl": [0, 1, 3, 9, 10, 11], "packag": [0, 2, 3, 5, 6, 7, 8, 9, 13, 15, 16], "softwar": [0, 5, 7, 12], "so": [0, 5, 7, 11], "work": [0, 3, 5, 8, 13, 14, 15], "differ": [0, 1, 3, 13], "system": [0, 6, 7, 12, 13, 16], "setup": [0, 5], "thi": [0, 1, 3, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16], "includ": [0, 1, 3, 5, 7, 10, 13], "variou": [0, 10, 11, 15], "support": [0, 1, 3, 6, 7, 9, 13, 15], "architectur": [0, 5, 8], "compon": [0, 4], "servic": [0, 7], "manag": [0, 1, 5, 6, 7, 13], "combin": [0, 6, 11, 13, 14], "compil": [0, 7, 13], "linker": [0, 5], "flag": [0, 6, 7], "etc": [0, 3, 5], "maintain": [0, 2, 5, 6, 7, 8, 9, 11, 12, 14], "provid": [0, 4, 7, 9, 11, 12, 13, 16], "consist": [0, 3, 9, 15], "code": [0, 1, 6, 9, 13], "practic": [0, 7], "easi": [0, 13], "person": [0, 8, 15], "co": 0, "take": [0, 1, 8, 10], "over": [0, 8], "after": [0, 1, 4, 5], "previou": [0, 1, 4, 8], "also": [0, 7, 9, 11, 13, 15], "reduc": [0, 3, 9], "risk": 0, "mistak": [0, 1, 13], "experienc": [0, 1], "end": [0, 9, 10, 15], "user": [0, 1, 5, 6, 7, 9, 10, 13, 15], "experi": 0, "try": [0, 3, 10], "help": [0, 1, 3, 10], "develop": [0, 1, 3, 4, 5, 6, 8, 10, 11, 14, 15, 16], "same": [0, 13, 16], "concept": 0, "appli": [0, 1, 8, 10, 11, 12], "across": [0, 11], "easier": [0, 15], "achiev": 0, "hi": [0, 9], "likeli": 0, "surpris": [0, 3], "behavior": [0, 1, 7, 13], "current": [0, 2, 4, 5, 6, 10, 14], "ar": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "two": [0, 4, 13], "kind": 0, "tool": [0, 1, 3, 4, 7], "involv": 0, "detect": [0, 1], "violat": [0, 13], "lint": [0, 3], "class": 0, "repoman": [0, 1, 2, 3, 5, 8, 16], "pkgcheck": [0, 1, 2, 3, 5, 8, 9, 13, 15, 16], "those": [0, 3, 5, 9, 10, 13], "analyz": 0, "ebuild": [0, 1, 2, 5, 6, 7, 9, 11, 12, 13], "other": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 14, 15], "file": [0, 2, 4, 6, 8, 10, 11, 13], "repositori": [0, 4, 11, 12, 13], "known": [0, 8, 13], "thei": [0, 1, 5, 7, 8, 10, 13, 15], "limit": [0, 3], "problem": [0, 1], "can": [0, 1, 3, 4, 5, 6, 8, 11, 12, 13, 14, 15, 16], "without": [0, 3, 5, 6], "run": [0, 4, 5], "phase": [0, 3, 9, 15], "function": [0, 3, 5, 9], "build": [0, 1, 5, 6, 7, 9, 13, 15], "instal": [0, 1, 3, 4, 6, 9, 13, 15], "time": [0, 1, 8, 9, 11, 13], "qa": [0, 1, 3, 4, 5, 6, 7, 8, 10, 11, 13, 14, 15, 16], "implement": [0, 1, 9, 12, 13], "trigger": [0, 13], "while": [0, 1, 3, 4, 7, 13], "execut": [0, 5, 13], "test": [0, 3, 6], "path": [0, 3, 6, 7], "expect": [0, 2], "us": [0, 2, 4, 5, 6, 7, 9, 10, 11, 16], "both": [0, 3, 6, 7, 9, 14, 15], "befor": [0, 4, 8, 15, 16], "push": [0, 4, 16], "commit": [0, 4], "whether": [0, 1, 8], "correctli": [0, 3, 5], "addition": 0, "i": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "period": 0, "ci": 0, "all": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "non": [0, 1, 3, 4, 5, 8, 11, 13], "trivial": [0, 13], "report": [0, 1, 2, 3, 5, 7, 8, 9, 10, 13, 15, 16], "autom": 0, "mail": [0, 8, 10, 12], "list": [0, 2, 5, 7, 10, 11, 12, 13, 16], "relev": [0, 8], "supplement": [0, 7], "direct": [0, 13], "reliabl": [0, 9], "tree": [0, 2, 5, 6, 11, 12, 14], "wide": 0, "scan": 0, "team": [0, 3, 5, 6, 8, 10, 11, 14, 15], "task": 0, "Its": [0, 11], "role": 0, "govern": 0, "glep": [0, 1, 6, 16], "48": 0, "It": [0, 1, 3, 6, 7, 9, 10, 11, 13, 14, 15, 16], "focus": [0, 11], "document": [0, 4, 6, 7, 13, 14], "resolv": [0, 13], "doubt": [0, 16], "regard": 0, "them": [0, 5, 7, 10, 11, 12, 15], "educ": 0, "member": [0, 10], "action": 0, "minor": [0, 8], "qualiti": 0, "e": [0, 1, 3, 4, 5, 6, 7, 8, 11, 13, 14, 15], "when": [0, 1, 2, 3, 4, 5, 7, 10, 12, 13, 15], "fix": [0, 10, 16], "directli": [0, 9, 11], "far": [0, 11], "less": [0, 3, 11, 13], "effort": [0, 8], "than": [0, 3, 7, 9, 11, 12, 15], "wa": [0, 5, 8, 10, 11, 13], "request": [0, 1, 6, 8, 16], "refus": [0, 10], "final": [0, 11, 12], "case": [0, 5, 6, 8, 13], "repeat": [0, 3], "unwilling": 0, "issu": [0, 7, 9, 15], "disciplinari": 0, "measur": 0, "against": [0, 3, 11, 13], "question": [0, 1, 5, 8, 10, 13], "major": [0, 9, 12, 13, 16], "written": [0, 1, 10, 11], "down": [0, 11], "project": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "creat": [0, 5, 11, 12, 15, 16], "affect": [0, 3, 8], "specif": [0, 1, 6, 7, 11, 13, 14, 15], "area": 0, "contribut": [0, 6], "g": [0, 1, 3, 4, 5, 7, 8, 11, 13, 15], "systemd": [0, 7], "relat": [0, 11], "unit": [0, 7], "each": [0, 1, 11, 13], "indic": [0, 1, 2, 5, 11, 14], "bodi": [0, 6, 11, 14], "In": [0, 1, 3, 5, 9, 12, 13, 15], "order": [0, 1, 4, 5, 7, 9, 11, 13], "abolish": 0, "contact": 0, "If": [0, 1, 3, 5, 7, 8, 10, 13, 15, 16], "disagre": [0, 12], "ask": [0, 8], "overrid": [0, 12], "decis": [0, 11], "further": [0, 16], "council": [0, 1, 2, 5, 6, 11, 12, 14, 15], "pg": [1, 2, 3, 5, 7, 8, 9, 10, 13, 15, 16], "0001": 1, "sourc": [1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16], "refer": [1, 2, 4, 5, 6, 8, 9, 11, 13, 15, 16], "http": [1, 2, 3, 4, 5, 8, 9, 13, 15, 16], "wiki": [1, 8, 9, 11, 12, 13, 15], "org": [1, 2, 3, 4, 5, 8, 9, 13, 15, 16], "index": [1, 3, 4, 6, 8, 13, 15], "php": [1, 8, 13, 15], "titl": [1, 4, 8, 13, 15], "quality_assur": [1, 8, 13, 15], "polici": [1, 3, 4, 7, 8, 10, 13, 14, 15], "oldid": [1, 8, 13, 15], "104017": 1, "controlled_optional_rdepend": 1, "control": [1, 5, 7, 13, 15], "accept": [1, 5, 7, 13, 16], "except": [1, 3, 5, 8], "under": [1, 13, 14], "veri": [1, 5, 7, 10, 11, 15, 16], "circumst": [1, 13], "being": [1, 3, 7, 8, 9, 10, 13], "nonfunct": 1, "unless": [1, 7, 9, 10, 16], "least": [1, 3, 8, 13], "one": [1, 4, 5, 7, 8, 9, 10], "set": [1, 3, 6, 11, 14, 15], "There": [1, 5, 7, 10, 11], "prefer": [1, 4, 9, 15], "how": [1, 11, 12], "inform": [1, 6, 10, 11, 13], "wai": [1, 4, 11, 13, 15], "optfeatur": 1, "eclass": [1, 6, 13, 16], "readm": 1, "r1": [1, 9], "plain": [1, 3], "elog": 1, "messag": [1, 13, 15], "rational": [1, 3, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16], "toggl": 1, "enabl": [1, 7, 13, 15], "disabl": [1, 7, 13], "caus": [1, 7, 8, 9, 13, 15], "needless": 1, "rebuild": [1, 4, 7], "especi": [1, 5], "import": [1, 9, 16], "long": [1, 8, 9, 13], "62": 1, "propos": 1, "solut": 1, "permit": [1, 3, 5, 10, 13], "flip": 1, "ha": [1, 3, 5, 7, 9, 13, 15, 16], "been": [1, 5, 7, 13, 15, 16], "tent": 1, "approv": [1, 12, 16], "0002": 1, "whenev": [1, 3, 5, 7, 8, 12, 13, 15], "wildcard": 1, "equal": 1, "must": [1, 5, 6, 7, 8, 9, 10, 15, 16], "specifi": [1, 3, 4, 12, 13], "explicitli": [1, 3, 7, 9, 10, 11, 13, 15, 16], "zeroth": 1, "r0": 1, "necessari": [1, 4, 7, 10, 15], "tild": 1, "instead": [1, 4, 5, 9], "exampl": [1, 5, 7, 10, 13], "bad": [1, 5, 13], "dev": [1, 5, 10, 13, 15], "lib": [1, 5, 7], "libfrobn": 1, "1": [1, 12], "2": [1, 6, 13, 15], "3": [1, 9, 15], "good": [1, 5, 7, 13, 16], "r3": 1, "place": [1, 7, 8], "mean": [1, 15], "version": [1, 2, 3, 4, 5, 6, 13, 16], "common": [1, 3, 13, 14], "fact": 1, "explicit": [1, 3, 13], "equival": 1, "latter": [1, 5, 11, 13, 15], "warn": 1, "reconsid": 1, "correct": [1, 5, 13], "0011": 1, "archiv": [1, 7, 13, 15], "portag": [1, 4, 5], "9cae3a92412a007febe7ac0612d50f5f": 1, "match": [1, 4, 9, 16], "rang": [1, 16], "span": 1, "applic": [1, 5, 7, 11, 12, 13], "ani": [1, 3, 7, 10, 11, 12, 13, 15], "onli": [1, 5, 6, 7, 8, 11, 12], "valu": [1, 3, 5, 6], "nor": [1, 10, 13], "moment": 1, "miss": [1, 13], "start": [1, 11, 16], "therefor": [1, 3, 5, 6, 11, 14], "interchang": 1, "we": [1, 3, 13], "assum": [1, 15], "verifi": [1, 13], "yet": 1, "former": [1, 11], "paludi": 1, "logic": [1, 11], "pull": [1, 6], "correspond": [1, 5, 13], "newest": 1, "avail": [1, 4, 11, 13, 15], "0012": 1, "an": [1, 3, 5, 7, 8, 10, 11, 15, 16], "uncommon": [1, 7], "public": 1, "abi": [1, 5], "librari": [1, 6], "stabl": [1, 6], "within": [1, 5, 6, 8, 10, 15], "privat": 1, "your": [1, 4], "api": 1, "part": [1, 3, 5, 11], "5": 1, "likewis": 1, "otherwis": [1, 4, 7], "open": [1, 16], "debat": 1, "ad": [1, 4, 5, 6, 7, 16], "do": [1, 3, 7, 9, 13], "defin": [1, 6, 9, 12, 15], "propon": 1, "idea": 1, "point": [1, 3, 5, 7, 11], "out": [1, 9, 10, 11, 15], "revers": [1, 7, 9], "becom": [1, 6, 10, 14], "cumbersom": 1, "usual": [1, 13], "result": [1, 16], "lose": [1, 9], "opportun": 1, "onc": [1, 3, 8, 10], "argu": 1, "mani": [1, 5, 7, 9, 10, 12, 13], "futur": [1, 8, 10, 12, 15, 16], "reason": [1, 5, 16], "predict": 1, "oppon": 1, "claim": 1, "100": [1, 16], "0003": 1, "meet": [1, 5, 11, 15], "log": [1, 5, 11, 15], "20151011": [1, 5], "summari": [1, 5, 15], "txt": [1, 5, 15, 16], "": [1, 7, 10, 12, 15], "implicitli": 1, "propag": 1, "who": [1, 7, 8, 10, 11, 15], "have": [1, 3, 7, 8, 9, 13, 16], "alreadi": [1, 5, 9, 13], "need": [1, 5, 7, 10, 11, 12, 13, 15, 16], "prevent": [1, 10, 16], "from": [1, 3, 5, 8, 10, 11, 13, 16], "clean": 1, "increas": [1, 10], "doe": [1, 3, 7, 8, 10, 12, 13], "were": [1, 3, 7, 8, 11, 13, 16], "histor": [1, 3, 5, 6, 7, 13, 15, 16], "reli": [1, 5, 7], "call": [1, 4, 9], "dynam": [1, 3, 5, 6, 16], "which": [1, 3, 6, 7, 8, 11, 13, 14, 15], "unreli": 1, "featur": [1, 13], "simpli": 1, "timefram": 1, "dure": [1, 5], "old": [1, 5, 8, 9, 10, 13], "exist": [1, 2, 3, 4, 9, 15, 16], "had": [1, 8], "graph": [1, 8, 9], "breakag": [1, 8], "due": [1, 5, 7, 8], "requir": [1, 5, 7, 9, 11, 12, 13, 16], "account": [1, 3, 6], "ensur": [1, 5, 9, 13], "get": [1, 6], "updat": [1, 2, 6, 11, 12, 14, 16], "usag": [1, 6, 11], "side": 1, "you": 1, "t": 1, "either": [1, 4, 5, 7, 8, 9, 13, 15], "For": [1, 5, 10], "notic": [1, 7], "link": [1, 6, 7, 9, 13], "libfoo": 1, "unnecessarili": [1, 15], "decid": [1, 13], "remov": [1, 6, 7, 9, 13, 15, 16], "respons": [1, 13, 15, 16], "mai": [1, 3, 4, 5, 7, 12, 15], "immedi": [1, 8], "even": [1, 13, 15], "still": [1, 5, 8, 15], "0021": 1, "infer": [1, 13], "pm": [1, 11, 12, 13], "style": [1, 6], "anoth": [1, 4, 5, 13], "4": [1, 14], "restrict": [1, 5, 6, 11, 12], "refin": 1, "gtk2": [1, 15], "v2": 1, "foo": [1, 3], "default": [1, 7], "longer": [1, 5, 10], "libbar": 1, "accord": 1, "section": [1, 4], "error": [1, 3, 13], "furthermor": [1, 3, 5, 10, 11, 13], "check": [1, 5, 6], "make": [1, 3, 4, 5, 6, 7, 9, 10, 11, 13, 15], "its": [1, 5, 9, 11, 12], "1001": 2, "gitweb": [2, 4, 5], "repo": [2, 4, 5], "git": [2, 4, 5], "metadata": [2, 5, 6, 10], "layout": [2, 6, 12], "conf": 2, "new": [2, 4, 5, 6, 9, 11, 15, 16], "migrat": [2, 16], "newer": 2, "bump": [2, 6, 16], "proactiv": [2, 6], "store": 2, "1003": 2, "individu": [2, 3], "eclassdoc": 2, "tag": 2, "insid": 2, "0101": 3, "partial": [3, 11, 12], "via": [3, 4, 5, 7, 11, 12, 13, 15, 16], "leav": [3, 16], "most": 3, "choic": [3, 15], "few": [3, 15], "rule": [3, 4, 8, 12, 13, 15, 16], "enforc": [3, 6, 12, 13], "alwai": [3, 5], "indent": [3, 4], "tab": 3, "level": [3, 5, 12], "attempt": [3, 7, 11, 15], "align": [3, 4], "width": 3, "name": [3, 5, 6, 7], "bracket": 3, "form": [3, 11, 15], "rather": [3, 11, 12, 15], "bash": [3, 7], "condit": [3, 13], "posix": [3, 6], "ish": 3, "builtin": 3, "recommend": [3, 4, 7, 12, 15, 16], "construct": 3, "prone": 3, "avoid": [3, 7], "unnecessari": [3, 7, 8, 9, 15], "chang": [3, 4, 6, 9, 12], "edit": [3, 6, 11], "0102": 3, "bug": [3, 4, 8, 10, 13, 16], "612630": 3, "fulli": 3, "forbidden": [3, 10, 13], "load": 3, "addit": [3, 5, 7, 11, 12], "eval": 3, "method": [3, 4], "eblit": 3, "extern": [3, 6], "convert": [3, 15], "move": [3, 5], "standard": [3, 6], "locat": [3, 6, 7, 13], "principl": 3, "mainten": [3, 9, 10], "harder": 3, "confus": [3, 8, 15], "0103": 3, "highlight": 3, "syntax": 3, "uri": 3, "verbatim": 3, "allow": [3, 13], "gener": [3, 5, 7, 12, 13, 15], "sinc": [3, 5, 7, 13, 15], "littl": [3, 13], "advantag": [3, 15], "On": 3, "hand": 3, "render": 3, "unus": 3, "preprocess": 3, "break": [3, 9], "termin": 3, "editor": 3, "well": [3, 4, 6, 8, 11, 12, 13, 14], "grep": [3, 10], "0104": 3, "overlap": 3, "multipl": [3, 4, 13, 15], "entri": [3, 16], "design": [3, 6, 14], "encourag": 3, "add": [3, 10], "more": [3, 7, 11, 12, 13, 15], "page": [3, 6, 11, 12], "pypi": 3, "github": [3, 4], "incident": 3, "depend": [3, 4, 6, 7, 8, 9, 13, 15], "multi": 3, "goe": 3, "hard": [3, 10, 11, 13, 15], "copi": 3, "past": [3, 11], "investig": 3, "directori": [3, 5], "0105": 3, "liter": 3, "content": 3, "wrap": [3, 4], "append": 3, "arch": [3, 8], "ekeyword": 3, "larg": [3, 10, 11], "number": [3, 4, 9, 10, 16], "abil": [3, 11, 13], "process": [3, 6, 8, 12, 14, 16], "modifi": 3, "sure": [3, 4, 10], "0106": 3, "implicit": 3, "itself": [3, 12], "0107": 3, "ed": [3, 7, 8], "grant": [3, 5], "src_configur": 3, "lead": [3, 16], "embed": 3, "imag": [3, 7], "pleas": [4, 10, 13], "respect": 4, "notabl": 4, "line": [4, 6], "72": 4, "charact": 4, "space": [4, 5, 13], "between": [4, 5, 9, 13, 15, 16], "sentenc": 4, "full": [4, 5, 7], "stop": 4, "empti": [4, 7], "paragraph": 4, "text": [4, 14], "next": [4, 16], "chapter": 4, "fit": [4, 10], "topic": 4, "some": [4, 5, 7, 8, 11, 13], "choos": [4, 13, 15], "best": 4, "keyword": [4, 6], "host": [4, 5], "proj": [4, 5], "To": 4, "clone": 4, "anongit": 4, "ssh": 4, "wish": [4, 7, 15], "fork": 4, "own": [4, 5], "A": [4, 16], "tox": 4, "virtualenv": 4, "html": 4, "argument": 4, "command": 4, "latexpdf": 4, "submit": [4, 7], "manual": [4, 6, 15], "bugzilla": 4, "patch": [4, 7], "attach": 4, "app": [4, 7], "pram": 4, "configur": 4, "remot": 4, "first": [4, 7, 8], "checkout": 4, "config": [4, 7], "replac": [4, 7, 11, 15], "afterward": [4, 15], "n": [4, 8], "built": 4, "_build": 4, "sphinx": 4, "output": 4, "rm": 4, "r": 4, "site": 4, "0201": 5, "d": [5, 6, 13], "08gentoo": 5, "top": 5, "bin": 5, "boot": 5, "opt": 5, "sbin": 5, "srv": 5, "var": 5, "subdirectori": 5, "libexec": 5, "share": [5, 7], "src": 5, "triplet": 5, "doc": [5, 7], "hierarchi": 5, "revis": [5, 6], "pf": 5, "aforement": [5, 11], "appropri": [5, 13], "suffix": 5, "variant": 5, "chost": 5, "ctarget": 5, "toolchain": [5, 13], "gnu": 5, "guix": 5, "nix": 5, "0202": 5, "20130813": 5, "20130924": 5, "filesystem": [5, 12], "initramf": 5, "upstream": [5, 7, 9, 13], "2013": 5, "earli": [5, 9], "mount": 5, "difficult": 5, "subtli": 5, "broken": 5, "hack": 5, "udev": 5, "repair": 5, "rootf": 5, "0203": 5, "80multilib": 5, "fatal": [5, 13], "64": 5, "bit": 5, "amd64": 5, "lib64": 5, "larger": 5, "along": [5, 7, 11], "symlink": 5, "compat": [5, 9], "hardcod": [5, 7], "With": 5, "modern": 5, "profil": [5, 10], "found": [5, 11], "loader": [5, 7], "0204": 5, "80librari": 5, "la": [5, 6], "never": [5, 7, 11], "root": 5, "script": [5, 9, 13], "purpos": [5, 6, 13], "hold": 5, "strictli": [5, 13], "small": [5, 6, 10], "partit": 5, "would": [5, 7, 11], "wast": 5, "0205": 5, "clarifi": 5, "20151213": 5, "anymor": [5, 8], "normal": [5, 13], "guidelin": [5, 12], "As": 5, "high": 5, "score": 5, "state": [5, 6, 13], "group": [5, 6, 10], "world": 5, "readabl": 5, "privileg": 5, "access": 5, "gamestat": 5, "made": [5, 15], "setgid": 5, "writabl": 5, "technic": [5, 7, 10, 11, 12, 13, 15], "isol": 5, "boundari": 5, "blurri": 5, "web": [5, 13], "browser": 5, "inconsist": 5, "distribut": [5, 12], "where": 5, "data": 5, "impli": 5, "fulfil": 5, "0206": 5, "rel": 5, "special": [5, 6, 13, 15], "proc": 5, "suppos": 5, "dosym": 5, "frobnic": 5, "self": 5, "mtab": 5, "wrong": [5, 13], "recoveri": [5, 7], "definit": [6, 14], "clear": [6, 11, 14, 15], "bind": [6, 11, 14], "global": [6, 13, 14, 15], "meant": [6, 8, 10, 14], "suppli": [6, 14], "prefac": 6, "introduct": [6, 15], "author": 6, "licens": [6, 7], "motiv": 6, "histori": 6, "basic": [6, 7, 12], "goal": [6, 7], "complianc": 6, "appeal": 6, "fh": 6, "publish": 6, "format": [6, 12], "send": [6, 10], "merg": 6, "option": [6, 7, 13, 15], "runtim": [6, 9], "slot": [6, 9], "subslot": 6, "sub": 6, "qt": 6, "oper": [6, 12], "deprec": [6, 16], "eapi": [6, 12], "contain": [6, 10, 12, 15], "homepag": 6, "variabl": [6, 7, 9], "src_uri": 6, "singl": [6, 11, 13], "src_instal": [6, 7], "pkg_preinst": 6, "separ": [6, 13], "usr": 6, "strict": 6, "multilib": 6, "static": [6, 13], "libtool": 6, "game": 6, "ownership": 6, "absolut": 6, "symbol": 6, "target": 6, "virtual": 6, "manpag": 6, "stabil": 6, "rekeyword": 6, "drop": [6, 10], "languag": 6, "python": [6, 10], "multislot": 6, "meaning": 6, "gui": 6, "underscor": 6, "search": 6, "0301": 7, "introduc": [7, 9, 15], "size": 7, "neg": [7, 8], "consequ": 7, "program": [7, 9, 10], "Such": [7, 13], "uncondition": [7, 13], "shell": 7, "complet": [7, 11, 13], "local": [7, 15], "strip": 7, "categori": 7, "install_mask": 7, "cost": [7, 9], "much": [7, 13], "smaller": 7, "brought": 7, "context": 7, "libreoffic": 7, "did": [7, 11, 13], "he": 7, "spend": 7, "hour": 7, "huge": 7, "tini": 7, "could": [7, 10, 13], "consid": [7, 15], "here": [7, 8, 11], "0302": 7, "themselv": 7, "strongli": 7, "discourag": [7, 15], "secur": 7, "imposs": 7, "realli": [7, 11], "prolifer": 7, "harm": [7, 13], "go": [7, 11, 12], "howev": [7, 8, 11, 12, 13], "feasibl": 7, "twice": 7, "0303": 7, "might": 7, "plugin": 7, "fallback": 7, "pkg": 7, "liner": 7, "find": [7, 10, 11, 13], "type": 7, "f": 7, "delet": 7, "die": 7, "base": 7, "autotool": 7, "particular": [7, 11], "todai": 7, "keep": 7, "potenti": [7, 13], "0304": 7, "reserv": [7, 15, 16], "optim": 7, "certain": 7, "assumpt": [7, 13], "about": [7, 13], "assign": [7, 10, 16], "0305": 7, "man": 7, "ship": 7, "prebuilt": 7, "inconveni": 7, "compromis": 7, "0401": 8, "retest": 8, "exempt": 8, "often": [8, 10], "neglect": 8, "want": [8, 15], "0402": 8, "cc": 8, "experiment": 8, "close": 8, "remain": 8, "kept": 8, "subset": 8, "interest": [8, 10], "independ": 8, "duplic": 8, "slack": 8, "0403": 8, "126033": 8, "dropping_stable_keyword": 8, "last": [8, 10], "respond": 8, "90": 8, "dai": 8, "proceed": 8, "rite": 8, "0501": 9, "through": [9, 12], "modul": 9, "libpython": 9, "python_single_target": 9, "python_target": 9, "python_compat": 9, "python_usedep": 9, "python_single_usedep": 9, "python_gen_cond_dep": 9, "guarante": [9, 13], "handl": [9, 13], "whole": 9, "accident": 9, "helper": 9, "gracefulli": [9, 13], "retir": 9, "minim": 9, "0502": 9, "python_2_end": 9, "life": 9, "sooner": 9, "later": 9, "port": 9, "chanc": [9, 10], "soon": 9, "readi": 9, "reach": 9, "defer": 9, "2019": 9, "frequent": [9, 10], "grow": 9, "exponenti": 9, "term": 9, "give": 9, "better": [9, 11], "prepar": 9, "delai": [9, 16], "until": 9, "upgrad": [9, 13], "0601": 10, "consent": 10, "agre": 10, "backup": 10, "knowledg": 10, "what": 10, "wors": 10, "origin": [10, 11, 13], "resign": 10, "neither": [10, 13], "awar": 10, "why": 10, "up": 10, "sole": 10, "distinguish": [10, 15], "actual": 10, "0602": 10, "dedic": [10, 13], "mere": 10, "split": 10, "unmaintain": 10, "suffer": 10, "unfair": 10, "inappropri": 10, "burden": 10, "care": 10, "0603": 10, "reassign": 10, "comment": 10, "xml": 10, "grab": 10, "lost": 10, "easili": 10, "compar": 10, "silent": 10, "At": 11, "lack": 11, "concis": 11, "suffici": 11, "explan": 11, "wider": 11, "intend": 11, "mention": 11, "establish": 11, "eight": 11, "flat": [11, 15], "scale": 11, "turn": [11, 13], "devmanu": [11, 12], "reject": 11, "amount": 11, "stale": 11, "everi": 11, "unclear": 11, "obsolet": 11, "tip": 11, "scatter": 11, "lot": 11, "de": 11, "facto": 11, "formal": 11, "address": 11, "defici": 11, "primari": [11, 13], "collect": 11, "organ": 11, "word": 11, "understand": 11, "spirit": 11, "precis": 11, "queri": [11, 13], "aris": [11, 15, 16], "conform": [11, 12], "upon": 12, "discuss": [12, 15], "done": 12, "subsequ": 12, "highest": 12, "activ": 12, "impos": 12, "review": [12, 16], "guid": [12, 14], "besid": 12, "detail": 12, "instruct": 12, "compli": 12, "nevertheless": 12, "suggest": 12, "linux": 12, "0701": 13, "109991": [13, 15], "2fuse": 13, "dependent_slot": 13, "174407": 13, "scope": 13, "alter": 13, "overlai": 13, "declar": 13, "pre": 13, "2016": 13, "simultan": 13, "parallel": 13, "emerg": 13, "depclean": 13, "invari": 13, "cach": 13, "undefin": 13, "unpredict": 13, "invalid": 13, "0702": 13, "83cc5bbd7bbe8bdf04dd3c3bc7f8a035": 13, "www": 13, "similar": 13, "no_homepag": 13, "download": 13, "tracker": 13, "job": 13, "subpag": 13, "anywher": 13, "marker": 13, "identifi": 13, "0703": 13, "prerequisit": 13, "unset": 13, "ius": 13, "contrari": 13, "skip": 13, "fail": 13, "omit": 13, "overspecifi": 13, "0704": 13, "pertain": 13, "express": [13, 15], "bundl": 13, "present": 13, "shall": 13, "binari": 13, "effect": 13, "cover": 13, "simplest": 13, "noth": 13, "protect": 13, "deriv": 13, "rememb": 13, "init": 13, "gpl": 13, "micha\u0142": 14, "g\u00f3rny": 14, "mgorni": 14, "ulrich": 14, "m\u00fcller": 14, "ulm": 14, "creativ": 14, "attribut": 14, "sharealik": 14, "0": [14, 16], "intern": 14, "0801": 15, "versioned_use_flag": 15, "switch": 15, "qt4": 15, "qt5": 15, "hierarch": 15, "gtk": 15, "gtk3": 15, "0802": 15, "cf3f5a59ac918335766632bd02438722": 15, "offer": 15, "x": 15, "toolkit": 15, "widget": 15, "simpl": [15, 16], "adjust": 15, "per": 15, "discov": 15, "obtain": 15, "0803": 15, "20191013": 15, "use_expand": 15, "newli": 15, "regular": [15, 16], "valid": 15, "low": 15, "prioriti": 15, "resembl": 15, "proper": 15, "shorter": 15, "unprefix": 15, "hyphen": 15, "imit": 15, "like": 15, "lengthen": 15, "mismatch": 15, "extend": 15, "improv": 15, "0901": 16, "702460": 16, "81": 16, "uid": 16, "gid": 16, "499": 16, "baselayout": 16, "reus": 16, "acct": 16, "justifi": 16, "101": 16, "749": 16, "select": 16, "arbitrari": 16, "free": 16, "success": 16, "upward": 16, "gap": 16, "desir": 16, "serv": 16, "synchron": 16, "primit": 16, "collis": 16, "second": 16, "simplifi": 16, "aid": 16, "rapid": 16, "adopt": 16, "pointless": 16, "cross": 16, "distro": 16, "sync": 16, "favor": 16, "alloc": 16, "chosen": 16, "immin": 16, "ones": 16, "999": 16, "downward": 16, "lowest": 16, "true": 16}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"basic": 0, "inform": 0, "goal": 0, "polici": [0, 6, 9, 11, 12, 16], "make": 0, "complianc": 0, "check": 0, "enforc": 0, "chang": [0, 1], "appeal": 0, "depend": 1, "option": 1, "runtim": 1, "revis": 1, "slot": [1, 13], "subslot": 1, "sub": 1, "packag": [1, 10, 12], "special": 1, "case": 1, "qt": 1, "proactiv": 1, "us": [1, 3, 13, 15], "oper": 1, "bump": 1, "without": [1, 10], "flag": [1, 13, 15], "deprec": [2, 9], "eapi": 2, "eclass": [2, 3, 9], "ebuild": 3, "file": [3, 5, 7], "format": [3, 4], "code": 3, "style": [3, 4], "must": [3, 13], "contain": 3, "within": 3, "homepag": [3, 13], "variabl": [3, 13], "src_uri": 3, "refer": 3, "keyword": [3, 8], "defin": 3, "singl": 3, "line": 3, "licens": [3, 13, 14], "d": 3, "onli": 3, "src_instal": 3, "pkg_preinst": 3, "edit": 4, "publish": 4, "updat": 4, "thi": 4, "guid": [4, 6, 11], "get": 4, "sourc": 4, "build": 4, "send": 4, "contribut": 4, "merg": 4, "pull": 4, "request": 4, "system": 5, "layout": 5, "instal": [5, 7], "path": 5, "todo": [5, 8, 15], "support": 5, "separ": 5, "usr": 5, "strict": 5, "multilib": 5, "static": [5, 7], "librari": [5, 7], "libtool": [5, 7], "game": 5, "locat": 5, "ownership": 5, "absolut": 5, "symbol": 5, "link": 5, "target": 5, "gentoo": [6, 12], "content": 6, "indic": 6, "tabl": 6, "small": 7, "la": 7, "virtual": 7, "manpag": 7, "stabil": 8, "rekeyword": 8, "drop": 8, "new": [8, 10], "version": [8, 15], "remov": [8, 10], "stabl": 8, "languag": 9, "specif": [9, 12], "python": 9, "usag": 9, "2": 9, "maintain": 10, "ad": 10, "motiv": 11, "histori": 11, "histor": 11, "state": 11, "document": [11, 12], "purpos": 11, "other": [12, 13], "manag": 12, "glep": 12, "develop": 12, "manual": 12, "extern": 12, "standard": 12, "posix": 12, "fh": 12, "metadata": 13, "dynam": 13, "multislot": 13, "valu": 13, "meaning": 13, "restrict": 13, "test": 13, "prefac": 14, "introduct": 14, "author": 14, "gui": 15, "underscor": 15, "name": 15, "user": 16, "group": 16, "account": 16}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.todo": 2, "sphinx": 57}, "alltitles": {"Basic information": [[0, "basic-information"]], "Goals of policy making": [[0, "goals-of-policy-making"]], "Policy compliance checking": [[0, "policy-compliance-checking"]], "Policy enforcement": [[0, "policy-enforcement"]], "Policy making, changes and appeals": [[0, "policy-making-changes-and-appeals"]], "Dependencies": [[1, "dependencies"]], "Optional runtime dependencies": [[1, "pg0001"]], "=-dependencies with no revision": [[1, "pg0002"]], "Slot and subslot dependencies": [[1, "slot-and-subslot-dependencies"]], "on (sub-)slotted packages": [[1, "pg0011"]], "special case: Qt packages": [[1, "pg0012"]], "proactive use of slot operators": [[1, "proactive-use-of-slot-operators"]], "Revision bumps on runtime dependency changes": [[1, "pg0003"]], "USE dependencies": [[1, "use-dependencies"]], "on packages without the flag": [[1, "pg0021"]], "Deprecations": [[2, "deprecations"]], "Deprecated EAPIs": [[2, "pg1001"]], "Deprecated eclasses": [[2, "pg1003"]], "Ebuild file format": [[3, "ebuild-file-format"]], "Coding style": [[3, "pg0101"]], "Code must be contained within ebuild and eclasses": [[3, "pg0102"]], "HOMEPAGE must not contain variables": [[3, "pg0103"]], "SRC_URI must not refer to HOMEPAGE": [[3, "pg0104"]], "KEYWORDS must be defined on a single line": [[3, "pg0105"]], "LICENSE must not contain variables": [[3, "pg0106"]], "D must be used only in src_install and pkg_preinst": [[3, "pg0107"]], "Editing and publishing updates to this Guide": [[4, "editing-and-publishing-updates-to-this-guide"]], "Formatting and style": [[4, "formatting-and-style"]], "Getting sources": [[4, "getting-sources"]], "Building": [[4, "building"]], "Sending contributions": [[4, "sending-contributions"]], "Merging pull requests": [[4, "merging-pull-requests"]], "Publishing": [[4, "publishing"]], "File system layout": [[5, "file-system-layout"]], "Installation paths": [[5, "pg0201"]], "Todo": [[5, "id1"], [8, "id1"], [15, "id1"]], "Support for separate /usr": [[5, "pg0202"]], "Strict multilib layout": [[5, "pg0203"]], "Static libraries and libtool files": [[5, "pg0204"]], "Game install locations and ownership": [[5, "pg0205"]], "Absolute symbolic link targets": [[5, "pg0206"]], "Gentoo Policy Guide": [[6, "gentoo-policy-guide"]], "Contents:": [[6, null]], "Indices and tables": [[6, "indices-and-tables"]], "Installed files": [[7, "installed-files"]], "Installation of small files": [[7, "pg0301"]], "Installation of static libraries": [[7, "pg0302"]], "Installation of libtool (.la) files": [[7, "pg0303"]], "Virtuals": [[7, "pg0304"]], "Installation of manpages": [[7, "pg0305"]], "Keywording and stabilization": [[8, "keywording-and-stabilization"]], "Rekeywording on dropped keywords": [[8, "pg0401"]], "Stabilizing new versions": [[8, "pg0402"]], "Removing stable keywords": [[8, "pg0403"]], "Language-specific policies": [[9, "language-specific-policies"]], "Python": [[9, "python"]], "Eclass usage": [[9, "pg0501"]], "Python 2 deprecation": [[9, "pg0502"]], "Package Maintainers": [[10, "package-maintainers"]], "Adding new maintainers": [[10, "pg0601"]], "New packages without a maintainer": [[10, "pg0602"]], "Removing package maintainers": [[10, "pg0603"]], "Motivation and history": [[11, "motivation-and-history"]], "Historical state of policy documentation": [[11, "historical-state-of-policy-documentation"]], "Purpose of the Policy Guide": [[11, "purpose-of-the-policy-guide"]], "Other policy documents": [[12, "other-policy-documents"]], "Gentoo-specific documentation": [[12, "gentoo-specific-documentation"]], "Package Manager Specification": [[12, "package-manager-specification"]], "GLEPs": [[12, "gleps"]], "Developer Manual": [[12, "developer-manual"]], "External standards": [[12, "external-standards"]], "POSIX": [[12, "posix"]], "FHS": [[12, "fhs"]], "Other metadata variables": [[13, "other-metadata-variables"]], "Dynamic slots (multislot flag)": [[13, "pg0701"]], "HOMEPAGE value must be meaningful": [[13, "pg0702"]], "RESTRICT=test for USE=-test": [[13, "pg0703"]], "LICENSE": [[13, "pg0704"]], "Preface": [[14, "preface"]], "Introduction": [[14, "introduction"]], "Authors": [[14, "authors"]], "License": [[14, "license"]], "USE flags": [[15, "use-flags"]], "Versioned USE flags": [[15, "pg0801"]], "USE=gui flag": [[15, "pg0802"]], "Underscores in USE flag names": [[15, "pg0803"]], "Users and groups": [[16, "users-and-groups"]], "User and group account policy": [[16, "pg0901"]]}, "indexentries": {"= with no revision": [[1, "index-2"]], "qt": [[1, "index-4"], [15, "index-0"], [15, "index-1"]], "use flags": [[1, "index-1"], [1, "index-6"], [7, "index-0"], [13, "index-1"], [13, "index-3"], [15, "index-0"], [15, "index-1"], [15, "index-2"]], "dependency": [[1, "index-0"], [1, "index-2"], [1, "index-3"], [1, "index-5"], [1, "index-6"]], "dynamic": [[1, "index-5"], [13, "index-0"]], "for optional rdepend": [[1, "index-1"]], "optional runtime": [[1, "index-0"]], "revision bump": [[1, "index-5"]], "slot/subslot": [[1, "index-3"], [1, "index-4"], [13, "index-0"]], "eapi": [[2, "index-0"]], "deprecated": [[2, "index-0"], [2, "index-1"]], "eclass": [[2, "index-1"], [9, "index-1"], [9, "index-2"], [9, "index-3"], [9, "index-4"]], "bash": [[3, "index-0"]], "conditions": [[3, "index-0"]], "d": [[3, "index-6"]], "eblit": [[3, "index-1"]], "homepage": [[3, "index-2"], [3, "index-3"], [13, "index-2"]], "indentation": [[3, "index-0"]], "keywords": [[3, "index-4"], [8, "index-0"], [8, "index-1"], [8, "index-2"]], "license": [[3, "index-5"], [13, "index-4"]], "one line": [[3, "index-4"]], "src uri": [[3, "index-3"]], "variable": [[3, "index-2"], [3, "index-5"], [3, "index-6"]], "variable reference": [[3, "index-0"]], "absolute target": [[5, "index-5"]], "file system": [[5, "index-0"], [5, "index-1"], [5, "index-2"], [5, "index-3"], [5, "index-4"]], "games": [[5, "index-4"]], "installation paths": [[5, "index-0"]], "libtool file": [[5, "index-3"], [7, "index-2"]], "multilib-strict": [[5, "index-2"]], "separate /usr": [[5, "index-1"]], "static library": [[5, "index-3"], [7, "index-1"]], "symbolic link": [[5, "index-5"]], "installed files": [[7, "index-0"], [7, "index-1"], [7, "index-2"], [7, "index-3"], [7, "index-4"]], "manpages": [[7, "index-4"]], "small files": [[7, "index-0"]], "virtuals": [[7, "index-3"]], "rekeywording": [[8, "index-0"]], "removing stable": [[8, "index-2"]], "stabilizing new versions": [[8, "index-1"]], "python": [[9, "index-0"], [9, "index-1"], [9, "index-5"]], "python 2": [[9, "index-5"]], "python-any-r1": [[9, "index-2"]], "python-r1": [[9, "index-3"]], "python-single-r1": [[9, "index-4"]], "adding": [[10, "index-0"]], "maintainer": [[10, "index-0"], [10, "index-1"], [10, "index-2"]], "new packages without": [[10, "index-1"]], "removing": [[10, "index-2"]], "up for grabs": [[10, "index-3"]], "gentoo.org": [[13, "index-2"]], "meaningful value": [[13, "index-2"]], "multislot": [[13, "index-1"]], "restrict": [[13, "index-3"]], "test; use=-test": [[13, "index-3"]], "test; restrict": [[13, "index-3"]], "gtk": [[15, "index-0"], [15, "index-1"]], "gui": [[15, "index-1"]], "gui flag": [[15, "index-1"]], "underscore": [[15, "index-2"]], "versioned": [[15, "index-0"]], "group": [[16, "index-1"]], "user": [[16, "index-0"]]}})
\ No newline at end of file +Search.setIndex({"docnames": ["basics", "dependencies", "deprecation", "ebuild-format", "editing", "filesystem", "index", "installed-files", "keywords", "languages", "maintainer", "motivation", "other-docs", "other-metadata", "preface", "use-flags", "user-group"], "filenames": ["basics.rst", "dependencies.rst", "deprecation.rst", "ebuild-format.rst", "editing.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"], "titles": ["Basic information", "Dependencies", "Deprecations", "Ebuild file format", "Editing and publishing updates to this Guide", "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"], "terms": {"The": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "gentoo": [0, 1, 2, 3, 4, 5, 8, 9, 10, 11, 13, 14, 15, 16], "focu": 0, "three": [0, 1], "aim": [0, 1, 6, 10, 14, 15], "portabl": [0, 1, 7], "By": [0, 1], "follow": [0, 4, 5, 7, 8, 10, 12, 16], "should": [0, 1, 2, 5, 7, 8, 9, 11, 12, 13, 15, 16], "possibl": [0, 1, 3, 9, 10, 11], "packag": [0, 2, 3, 5, 6, 7, 8, 9, 13, 15, 16], "softwar": [0, 5, 7, 12], "so": [0, 5, 7, 11], "work": [0, 3, 5, 8, 13, 14, 15], "differ": [0, 1, 3, 13], "system": [0, 6, 7, 12, 13, 16], "setup": [0, 5], "thi": [0, 1, 3, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16], "includ": [0, 1, 3, 5, 7, 10, 13], "variou": [0, 10, 11, 15], "support": [0, 1, 3, 6, 7, 9, 13, 15], "architectur": [0, 5, 8], "compon": [0, 4], "servic": [0, 7], "manag": [0, 1, 5, 6, 7, 13], "combin": [0, 6, 11, 13, 14], "compil": [0, 7, 13], "linker": [0, 5], "flag": [0, 6, 7], "etc": [0, 3, 5], "maintain": [0, 2, 5, 6, 7, 8, 9, 11, 12, 14], "provid": [0, 4, 7, 9, 11, 12, 13, 16], "consist": [0, 3, 9, 15], "code": [0, 1, 6, 9, 13], "practic": [0, 7], "easi": [0, 13], "person": [0, 8, 15], "co": 0, "take": [0, 1, 8, 10], "over": [0, 8], "after": [0, 1, 4, 5], "previou": [0, 1, 4, 8], "also": [0, 7, 9, 11, 13, 15], "reduc": [0, 3, 9], "risk": 0, "mistak": [0, 1, 13], "experienc": [0, 1], "end": [0, 9, 10, 15], "user": [0, 1, 5, 6, 7, 9, 10, 13, 15], "experi": 0, "try": [0, 3, 10], "help": [0, 1, 3, 10], "develop": [0, 1, 3, 4, 5, 6, 8, 10, 11, 14, 15, 16], "same": [0, 13, 16], "concept": 0, "appli": [0, 1, 8, 10, 11, 12], "across": [0, 11], "easier": [0, 15], "achiev": 0, "hi": [0, 9], "likeli": 0, "surpris": [0, 3], "behavior": [0, 1, 7, 13], "current": [0, 2, 4, 5, 6, 10, 14], "ar": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "two": [0, 4, 13], "kind": 0, "tool": [0, 1, 3, 4, 7], "involv": 0, "detect": [0, 1], "violat": [0, 13], "lint": [0, 3], "class": 0, "repoman": [0, 1, 2, 3, 5, 8, 16], "pkgcheck": [0, 1, 2, 3, 5, 8, 9, 13, 15, 16], "those": [0, 3, 5, 9, 10, 13], "analyz": 0, "ebuild": [0, 1, 2, 5, 6, 7, 9, 11, 12, 13], "other": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 14, 15], "file": [0, 2, 4, 6, 8, 10, 11, 13], "repositori": [0, 4, 11, 12, 13], "known": [0, 8, 13], "thei": [0, 1, 5, 7, 8, 10, 13, 15], "limit": [0, 3], "problem": [0, 1], "can": [0, 1, 3, 4, 5, 6, 8, 11, 12, 13, 14, 15, 16], "without": [0, 3, 5, 6], "run": [0, 4, 5], "phase": [0, 3, 9, 15], "function": [0, 3, 5, 9], "build": [0, 1, 5, 6, 7, 9, 13, 15], "instal": [0, 1, 3, 4, 6, 9, 13, 15], "time": [0, 1, 8, 9, 11, 13], "qa": [0, 1, 3, 4, 5, 6, 7, 8, 10, 11, 13, 14, 15, 16], "implement": [0, 1, 9, 12, 13], "trigger": [0, 13], "while": [0, 1, 3, 4, 7, 13], "execut": [0, 5, 13], "test": [0, 3, 6], "path": [0, 3, 6, 7], "expect": [0, 2], "us": [0, 2, 4, 5, 6, 7, 9, 10, 11, 16], "both": [0, 3, 6, 7, 9, 14, 15], "befor": [0, 4, 8, 15, 16], "push": [0, 4, 16], "commit": [0, 4], "whether": [0, 1, 8], "correctli": [0, 3, 5], "addition": 0, "i": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "period": 0, "ci": 0, "all": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "non": [0, 1, 3, 4, 5, 8, 11, 13], "trivial": [0, 13], "report": [0, 1, 2, 3, 5, 7, 8, 9, 10, 13, 15, 16], "autom": 0, "mail": [0, 8, 10, 12], "list": [0, 2, 5, 7, 10, 11, 12, 13, 16], "relev": [0, 8], "supplement": [0, 7], "direct": [0, 13], "reliabl": [0, 9], "tree": [0, 2, 5, 6, 11, 12, 14], "wide": 0, "scan": 0, "team": [0, 3, 5, 6, 8, 10, 11, 14, 15], "task": 0, "Its": [0, 11], "role": 0, "govern": 0, "glep": [0, 1, 6, 16], "48": 0, "It": [0, 1, 3, 6, 7, 9, 10, 11, 13, 14, 15, 16], "focus": [0, 11], "document": [0, 4, 6, 7, 13, 14], "resolv": [0, 13], "doubt": [0, 16], "regard": 0, "them": [0, 5, 7, 10, 11, 12, 15], "educ": 0, "member": [0, 10], "action": 0, "minor": [0, 8], "qualiti": 0, "e": [0, 1, 3, 4, 5, 6, 7, 8, 11, 13, 14, 15], "when": [0, 1, 2, 3, 4, 5, 7, 10, 12, 13, 15], "fix": [0, 10, 16], "directli": [0, 9, 11], "far": [0, 11], "less": [0, 3, 11, 13], "effort": [0, 8], "than": [0, 3, 7, 9, 11, 12, 15], "wa": [0, 5, 8, 10, 11, 13], "request": [0, 1, 6, 8, 16], "refus": [0, 10], "final": [0, 11, 12], "case": [0, 5, 6, 8, 13], "repeat": [0, 3], "unwilling": 0, "issu": [0, 7, 9, 15], "disciplinari": 0, "measur": 0, "against": [0, 3, 11, 13], "question": [0, 1, 5, 8, 10, 13], "major": [0, 9, 12, 13, 16], "written": [0, 1, 10, 11], "down": [0, 11], "project": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "creat": [0, 5, 11, 12, 15, 16], "affect": [0, 3, 8], "specif": [0, 1, 6, 7, 11, 13, 14, 15], "area": 0, "contribut": [0, 6], "g": [0, 1, 3, 4, 5, 7, 8, 11, 13, 15], "systemd": [0, 7], "relat": [0, 11], "unit": [0, 7], "each": [0, 1, 11, 13], "indic": [0, 1, 2, 5, 11, 14], "bodi": [0, 6, 11, 14], "In": [0, 1, 3, 5, 9, 12, 13, 15], "order": [0, 1, 4, 5, 7, 9, 11, 13], "abolish": 0, "contact": 0, "If": [0, 1, 3, 5, 7, 8, 10, 13, 15, 16], "disagre": [0, 12], "ask": [0, 8], "overrid": [0, 12], "decis": [0, 11], "further": [0, 16], "council": [0, 1, 2, 5, 6, 11, 12, 14, 15], "pg": [1, 2, 3, 5, 7, 8, 9, 10, 13, 15, 16], "0001": 1, "sourc": [1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16], "refer": [1, 2, 4, 5, 6, 8, 9, 11, 13, 15, 16], "http": [1, 2, 3, 4, 5, 8, 9, 13, 15, 16], "wiki": [1, 8, 9, 11, 12, 13, 15], "org": [1, 2, 3, 4, 5, 8, 9, 13, 15, 16], "index": [1, 3, 4, 6, 8, 13, 15], "php": [1, 8, 13, 15], "titl": [1, 4, 8, 13, 15], "quality_assur": [1, 8, 13, 15], "polici": [1, 3, 4, 7, 8, 10, 13, 14, 15], "oldid": [1, 8, 13, 15], "104017": 1, "controlled_optional_rdepend": 1, "control": [1, 5, 7, 13, 15], "accept": [1, 5, 7, 13, 16], "except": [1, 3, 5, 8], "under": [1, 13, 14], "veri": [1, 5, 7, 10, 11, 15, 16], "circumst": [1, 13], "being": [1, 3, 7, 8, 9, 10, 13], "nonfunct": 1, "unless": [1, 7, 9, 10, 16], "least": [1, 3, 8, 13], "one": [1, 4, 5, 7, 8, 9, 10], "set": [1, 3, 6, 11, 14, 15], "There": [1, 5, 7, 10, 11], "prefer": [1, 4, 9, 15], "how": [1, 11, 12], "inform": [1, 6, 10, 11, 13], "wai": [1, 4, 11, 13, 15], "optfeatur": 1, "eclass": [1, 6, 13, 16], "readm": 1, "r1": [1, 9], "plain": [1, 3], "elog": 1, "messag": [1, 13, 15], "rational": [1, 3, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16], "toggl": 1, "enabl": [1, 7, 13, 15], "disabl": [1, 7, 13], "caus": [1, 7, 8, 9, 13, 15], "needless": 1, "rebuild": [1, 4, 7], "especi": [1, 5], "import": [1, 9, 16], "long": [1, 8, 9, 13], "62": 1, "propos": 1, "solut": 1, "permit": [1, 3, 5, 10, 13], "flip": 1, "ha": [1, 3, 5, 7, 9, 13, 15, 16], "been": [1, 5, 7, 13, 15, 16], "tent": 1, "approv": [1, 12, 16], "0002": 1, "whenev": [1, 3, 5, 7, 8, 12, 13, 15], "wildcard": 1, "equal": 1, "must": [1, 5, 6, 7, 8, 9, 10, 15, 16], "specifi": [1, 3, 4, 12, 13], "explicitli": [1, 3, 7, 9, 10, 11, 13, 15, 16], "zeroth": 1, "r0": 1, "necessari": [1, 4, 7, 10, 15], "tild": 1, "instead": [1, 4, 5, 9], "exampl": [1, 5, 7, 10, 13], "bad": [1, 5, 13], "dev": [1, 5, 10, 13, 15], "lib": [1, 5, 7], "libfrobn": 1, "1": [1, 12], "2": [1, 6, 13, 15], "3": [1, 9, 15], "good": [1, 5, 7, 13, 16], "r3": 1, "place": [1, 7, 8], "mean": [1, 15], "version": [1, 2, 3, 4, 5, 6, 13, 16], "common": [1, 3, 13, 14], "fact": 1, "explicit": [1, 3, 13], "equival": 1, "latter": [1, 5, 11, 13, 15], "warn": 1, "reconsid": 1, "correct": [1, 5, 13], "0011": 1, "archiv": [1, 7, 13, 15], "portag": [1, 4, 5], "9cae3a92412a007febe7ac0612d50f5f": 1, "match": [1, 4, 9, 16], "rang": [1, 16], "span": 1, "applic": [1, 5, 7, 11, 12, 13], "ani": [1, 3, 7, 10, 11, 12, 13, 15], "onli": [1, 5, 6, 7, 8, 11, 12], "valu": [1, 3, 5, 6], "nor": [1, 10, 13], "moment": 1, "miss": [1, 13], "start": [1, 11, 16], "therefor": [1, 3, 5, 6, 11, 14], "interchang": 1, "we": [1, 3, 13], "assum": [1, 15], "verifi": [1, 13], "yet": 1, "former": [1, 11], "paludi": 1, "logic": [1, 11], "pull": [1, 6], "correspond": [1, 5, 13], "newest": 1, "avail": [1, 4, 11, 13, 15], "0012": 1, "an": [1, 3, 5, 7, 8, 10, 11, 15, 16], "uncommon": [1, 7], "public": 1, "abi": [1, 5], "librari": [1, 6], "stabl": [1, 6], "within": [1, 5, 6, 8, 10, 15], "privat": 1, "your": [1, 4], "api": 1, "part": [1, 3, 5, 11], "5": 1, "likewis": 1, "otherwis": [1, 4, 7], "open": [1, 16], "debat": 1, "ad": [1, 4, 5, 6, 7, 16], "do": [1, 3, 7, 9, 13], "defin": [1, 6, 9, 12, 15], "propon": 1, "idea": 1, "point": [1, 3, 5, 7, 11], "out": [1, 9, 10, 11, 15], "revers": [1, 7, 9], "becom": [1, 6, 10, 14], "cumbersom": 1, "usual": [1, 13], "result": [1, 16], "lose": [1, 9], "opportun": 1, "onc": [1, 3, 8, 10], "argu": 1, "mani": [1, 5, 7, 9, 10, 12, 13], "futur": [1, 8, 10, 12, 15, 16], "reason": [1, 5, 16], "predict": 1, "oppon": 1, "claim": 1, "100": [1, 16], "0003": 1, "meet": [1, 5, 11, 15], "log": [1, 5, 11, 15], "20151011": [1, 5], "summari": [1, 5, 15], "txt": [1, 5, 15, 16], "": [1, 7, 10, 12, 15], "implicitli": 1, "propag": 1, "who": [1, 7, 8, 10, 11, 15], "have": [1, 3, 7, 8, 9, 13, 16], "alreadi": [1, 5, 9, 13], "need": [1, 5, 7, 10, 11, 12, 13, 15, 16], "prevent": [1, 10, 16], "from": [1, 3, 5, 8, 10, 11, 13, 16], "clean": 1, "increas": [1, 10], "doe": [1, 3, 7, 8, 10, 12, 13], "were": [1, 3, 7, 8, 11, 13, 16], "histor": [1, 3, 5, 6, 7, 13, 15, 16], "reli": [1, 5, 7], "call": [1, 4, 9], "dynam": [1, 3, 5, 6, 16], "which": [1, 3, 6, 7, 8, 11, 13, 14, 15], "unreli": 1, "featur": [1, 13], "simpli": 1, "timefram": 1, "dure": [1, 5], "old": [1, 5, 8, 9, 10, 13], "exist": [1, 2, 3, 4, 9, 15, 16], "had": [1, 8], "graph": [1, 8, 9], "breakag": [1, 8], "due": [1, 5, 7, 8], "requir": [1, 5, 7, 9, 11, 12, 13, 16], "account": [1, 3, 6], "ensur": [1, 5, 9, 13], "get": [1, 6], "updat": [1, 2, 6, 11, 12, 14, 16], "usag": [1, 6, 11], "side": 1, "you": 1, "t": 1, "either": [1, 4, 5, 7, 8, 9, 13, 15], "For": [1, 5, 10], "notic": [1, 7], "link": [1, 6, 7, 9, 13], "libfoo": 1, "unnecessarili": [1, 15], "decid": [1, 13], "remov": [1, 6, 7, 9, 13, 15, 16], "respons": [1, 13, 15, 16], "mai": [1, 3, 4, 5, 7, 12, 15], "immedi": [1, 8], "even": [1, 13, 15], "still": [1, 5, 8, 15], "0021": 1, "infer": [1, 13], "pm": [1, 11, 12, 13], "style": [1, 6], "anoth": [1, 4, 5, 13], "4": [1, 14], "restrict": [1, 5, 6, 11, 12], "refin": 1, "gtk2": [1, 15], "v2": 1, "foo": [1, 3], "default": [1, 7], "longer": [1, 5, 10], "libbar": 1, "accord": 1, "section": [1, 4], "error": [1, 3, 13], "furthermor": [1, 3, 5, 10, 11, 13], "check": [1, 5, 6], "make": [1, 3, 4, 5, 6, 7, 9, 10, 11, 13, 15], "its": [1, 5, 9, 11, 12], "1001": 2, "gitweb": [2, 4, 5], "repo": [2, 4, 5], "git": [2, 4, 5], "metadata": [2, 5, 6, 10], "layout": [2, 6, 12], "conf": 2, "new": [2, 4, 5, 6, 9, 11, 15, 16], "migrat": [2, 16], "newer": 2, "bump": [2, 6, 16], "proactiv": [2, 6], "store": 2, "1003": 2, "individu": [2, 3], "eclassdoc": 2, "tag": 2, "insid": 2, "0101": 3, "partial": [3, 11, 12], "via": [3, 4, 5, 7, 11, 12, 13, 15, 16], "leav": [3, 16], "most": 3, "choic": [3, 15], "few": [3, 15], "rule": [3, 4, 8, 12, 13, 15, 16], "enforc": [3, 6, 12, 13], "alwai": [3, 5], "indent": [3, 4], "tab": 3, "level": [3, 5, 12], "attempt": [3, 7, 11, 15], "align": [3, 4], "width": 3, "name": [3, 5, 6, 7], "bracket": 3, "form": [3, 11, 15], "rather": [3, 11, 12, 15], "bash": [3, 7], "condit": [3, 13], "posix": [3, 6], "ish": 3, "builtin": 3, "recommend": [3, 4, 7, 12, 15, 16], "construct": 3, "prone": 3, "avoid": [3, 7], "unnecessari": [3, 7, 8, 9, 15], "chang": [3, 4, 6, 9, 12], "edit": [3, 6, 11], "0102": 3, "bug": [3, 4, 8, 10, 13, 16], "612630": 3, "fulli": 3, "forbidden": [3, 10, 13], "load": 3, "addit": [3, 5, 7, 11, 12], "eval": 3, "method": [3, 4], "eblit": 3, "extern": [3, 6], "convert": [3, 15], "move": [3, 5], "standard": [3, 6], "locat": [3, 6, 7, 13], "principl": 3, "mainten": [3, 9, 10], "harder": 3, "confus": [3, 8, 15], "0103": 3, "highlight": 3, "syntax": 3, "uri": 3, "verbatim": 3, "allow": [3, 13], "gener": [3, 5, 7, 12, 13, 15], "sinc": [3, 5, 7, 13, 15], "littl": [3, 13], "advantag": [3, 15], "On": 3, "hand": 3, "render": 3, "unus": 3, "preprocess": 3, "break": [3, 9], "termin": 3, "editor": 3, "well": [3, 4, 6, 8, 11, 12, 13, 14], "grep": [3, 10], "0104": 3, "overlap": 3, "multipl": [3, 4, 13, 15], "entri": [3, 16], "design": [3, 6, 14], "encourag": 3, "add": [3, 10], "more": [3, 7, 11, 12, 13, 15], "page": [3, 6, 11, 12], "pypi": 3, "github": [3, 4], "incident": 3, "depend": [3, 4, 6, 7, 8, 9, 13, 15], "multi": 3, "goe": 3, "hard": [3, 10, 11, 13, 15], "copi": 3, "past": [3, 11], "investig": 3, "directori": [3, 5], "0105": 3, "liter": 3, "content": 3, "wrap": [3, 4], "append": 3, "arch": [3, 8], "ekeyword": 3, "larg": [3, 10, 11], "number": [3, 4, 9, 10, 16], "abil": [3, 11, 13], "process": [3, 6, 8, 12, 14, 16], "modifi": 3, "sure": [3, 4, 10], "0106": 3, "implicit": 3, "itself": [3, 12], "0107": 3, "ed": [3, 7, 8], "grant": [3, 5], "src_configur": 3, "lead": [3, 16], "embed": 3, "imag": [3, 7], "pleas": [4, 10, 13], "respect": 4, "notabl": 4, "line": [4, 6], "72": 4, "charact": 4, "space": [4, 5, 13], "between": [4, 5, 9, 13, 15, 16], "sentenc": 4, "full": [4, 5, 7], "stop": 4, "empti": [4, 7], "paragraph": 4, "text": [4, 14], "next": [4, 16], "chapter": 4, "fit": [4, 10], "topic": 4, "some": [4, 5, 7, 8, 11, 13], "choos": [4, 13, 15], "best": 4, "keyword": [4, 6], "host": [4, 5], "proj": [4, 5], "To": 4, "clone": 4, "anongit": 4, "ssh": 4, "wish": [4, 7, 15], "fork": 4, "own": [4, 5], "A": [4, 16], "tox": 4, "virtualenv": 4, "html": 4, "argument": 4, "command": 4, "latexpdf": 4, "submit": [4, 7], "manual": [4, 6, 15], "bugzilla": 4, "patch": [4, 7], "attach": 4, "app": [4, 7], "pram": 4, "configur": 4, "remot": 4, "first": [4, 7, 8], "checkout": 4, "config": [4, 7], "replac": [4, 7, 11, 15], "afterward": [4, 15], "n": [4, 8], "built": 4, "_build": 4, "sphinx": 4, "output": 4, "rm": 4, "r": 4, "site": 4, "0201": 5, "d": [5, 6, 13], "08gentoo": 5, "top": 5, "bin": 5, "boot": 5, "opt": 5, "sbin": 5, "srv": 5, "var": 5, "subdirectori": 5, "libexec": 5, "share": [5, 7], "src": 5, "triplet": 5, "doc": [5, 7], "hierarchi": 5, "revis": [5, 6], "pf": 5, "aforement": [5, 11], "appropri": [5, 13], "suffix": 5, "variant": 5, "chost": 5, "ctarget": 5, "toolchain": [5, 13], "gnu": 5, "guix": 5, "nix": 5, "0202": 5, "20130813": 5, "20130924": 5, "filesystem": [5, 12], "initramf": 5, "upstream": [5, 7, 9, 13], "2013": 5, "earli": [5, 9], "mount": 5, "difficult": 5, "subtli": 5, "broken": 5, "hack": 5, "udev": 5, "repair": 5, "rootf": 5, "0203": 5, "80multilib": 5, "fatal": [5, 13], "64": 5, "bit": 5, "amd64": 5, "lib64": 5, "larger": 5, "along": [5, 7, 11], "symlink": 5, "compat": [5, 9], "hardcod": [5, 7], "With": 5, "modern": 5, "profil": [5, 10], "found": [5, 11], "loader": [5, 7], "0204": 5, "80librari": 5, "la": [5, 6], "never": [5, 7, 11], "root": 5, "script": [5, 9, 13], "purpos": [5, 6, 13], "hold": 5, "strictli": [5, 13], "small": [5, 6, 10], "partit": 5, "would": [5, 7, 11], "wast": 5, "0205": 5, "clarifi": 5, "20151213": 5, "anymor": [5, 8], "normal": [5, 13], "guidelin": [5, 12], "As": 5, "high": 5, "score": 5, "state": [5, 6, 13], "group": [5, 6, 10], "world": 5, "readabl": 5, "privileg": 5, "access": 5, "gamestat": 5, "made": [5, 15], "setgid": 5, "writabl": 5, "technic": [5, 7, 10, 11, 12, 13, 15], "isol": 5, "boundari": 5, "blurri": 5, "web": [5, 13], "browser": 5, "inconsist": 5, "distribut": [5, 12], "where": 5, "data": 5, "impli": 5, "fulfil": 5, "0206": 5, "rel": 5, "special": [5, 6, 13, 15], "proc": 5, "suppos": 5, "dosym": 5, "frobnic": 5, "self": 5, "mtab": 5, "wrong": [5, 13], "recoveri": [5, 7], "definit": [6, 14], "clear": [6, 11, 14, 15], "bind": [6, 11, 14], "global": [6, 13, 14, 15], "meant": [6, 8, 10, 14], "suppli": [6, 14], "prefac": 6, "introduct": [6, 15], "author": 6, "licens": [6, 7], "motiv": 6, "histori": 6, "basic": [6, 7, 12], "goal": [6, 7], "complianc": 6, "appeal": 6, "fh": 6, "publish": 6, "format": [6, 12], "send": [6, 10], "merg": 6, "option": [6, 7, 13, 15], "runtim": [6, 9], "slot": [6, 9], "subslot": 6, "sub": 6, "qt": 6, "oper": [6, 12], "deprec": [6, 16], "eapi": [6, 12], "contain": [6, 10, 12, 15], "homepag": 6, "variabl": [6, 7, 9], "src_uri": 6, "singl": [6, 11, 13], "src_instal": [6, 7], "pkg_preinst": 6, "separ": [6, 13], "usr": 6, "strict": 6, "multilib": 6, "static": [6, 13], "libtool": 6, "game": 6, "ownership": 6, "absolut": 6, "symbol": 6, "target": 6, "virtual": 6, "manpag": 6, "stabil": 6, "rekeyword": 6, "drop": [6, 10], "languag": 6, "python": [6, 10], "multislot": 6, "meaning": 6, "gui": 6, "underscor": 6, "search": 6, "0301": 7, "introduc": [7, 9, 15], "size": 7, "neg": [7, 8], "consequ": 7, "program": [7, 9, 10], "Such": [7, 13], "uncondition": [7, 13], "shell": 7, "complet": [7, 11, 13], "local": [7, 15], "strip": 7, "categori": 7, "install_mask": 7, "cost": [7, 9], "much": [7, 13], "smaller": 7, "brought": 7, "context": 7, "libreoffic": 7, "did": [7, 11, 13], "he": 7, "spend": 7, "hour": 7, "huge": 7, "tini": 7, "could": [7, 10, 13], "consid": [7, 15], "here": [7, 8, 11], "0302": 7, "themselv": 7, "strongli": 7, "discourag": [7, 15], "secur": 7, "imposs": 7, "realli": [7, 11], "prolifer": 7, "harm": [7, 13], "go": [7, 11, 12], "howev": [7, 8, 11, 12, 13], "feasibl": 7, "twice": 7, "0303": 7, "might": 7, "plugin": 7, "fallback": 7, "pkg": 7, "liner": 7, "find": [7, 10, 11, 13], "type": 7, "f": 7, "delet": 7, "die": 7, "base": 7, "autotool": 7, "particular": [7, 11], "todai": 7, "keep": 7, "potenti": [7, 13], "0304": 7, "reserv": [7, 15, 16], "optim": 7, "certain": 7, "assumpt": [7, 13], "about": [7, 13], "assign": [7, 10, 16], "0305": 7, "man": 7, "ship": 7, "prebuilt": 7, "inconveni": 7, "compromis": 7, "0401": 8, "retest": 8, "exempt": 8, "often": [8, 10], "neglect": 8, "want": [8, 15], "0402": 8, "cc": 8, "experiment": 8, "close": 8, "remain": 8, "kept": 8, "subset": 8, "interest": [8, 10], "independ": 8, "duplic": 8, "slack": 8, "0403": 8, "126033": 8, "dropping_stable_keyword": 8, "last": [8, 10], "respond": 8, "90": 8, "dai": 8, "proceed": 8, "rite": 8, "0501": 9, "through": [9, 12], "modul": 9, "libpython": 9, "python_single_target": 9, "python_target": 9, "python_compat": 9, "python_usedep": 9, "python_single_usedep": 9, "python_gen_cond_dep": 9, "guarante": [9, 13], "handl": [9, 13], "whole": 9, "accident": 9, "helper": 9, "gracefulli": [9, 13], "retir": 9, "minim": 9, "0502": 9, "python_2_end": 9, "life": 9, "sooner": 9, "later": 9, "port": 9, "chanc": [9, 10], "soon": 9, "readi": 9, "reach": 9, "defer": 9, "2019": 9, "frequent": [9, 10], "grow": 9, "exponenti": 9, "term": 9, "give": 9, "better": [9, 11], "prepar": 9, "delai": [9, 16], "until": 9, "upgrad": [9, 13], "0601": 10, "consent": 10, "agre": 10, "backup": 10, "knowledg": 10, "what": 10, "wors": 10, "origin": [10, 11, 13], "resign": 10, "neither": [10, 13], "awar": 10, "why": 10, "up": 10, "sole": 10, "distinguish": [10, 15], "actual": 10, "0602": 10, "dedic": [10, 13], "mere": 10, "split": 10, "unmaintain": 10, "suffer": 10, "unfair": 10, "inappropri": 10, "burden": 10, "care": 10, "0603": 10, "reassign": 10, "comment": 10, "xml": 10, "grab": 10, "lost": 10, "easili": 10, "compar": 10, "silent": 10, "At": 11, "lack": 11, "concis": 11, "suffici": 11, "explan": 11, "wider": 11, "intend": 11, "mention": 11, "establish": 11, "eight": 11, "flat": [11, 15], "scale": 11, "turn": [11, 13], "devmanu": [11, 12], "reject": 11, "amount": 11, "stale": 11, "everi": 11, "unclear": 11, "obsolet": 11, "tip": 11, "scatter": 11, "lot": 11, "de": 11, "facto": 11, "formal": 11, "address": 11, "defici": 11, "primari": [11, 13], "collect": 11, "organ": 11, "word": 11, "understand": 11, "spirit": 11, "precis": 11, "queri": [11, 13], "aris": [11, 15, 16], "conform": [11, 12], "upon": 12, "discuss": [12, 15], "done": 12, "subsequ": 12, "highest": 12, "activ": 12, "impos": 12, "review": [12, 16], "guid": [12, 14], "besid": 12, "detail": 12, "instruct": 12, "compli": 12, "nevertheless": 12, "suggest": 12, "linux": 12, "0701": 13, "109991": [13, 15], "2fuse": 13, "dependent_slot": 13, "174407": 13, "scope": 13, "alter": 13, "overlai": 13, "declar": 13, "pre": 13, "2016": 13, "simultan": 13, "parallel": 13, "emerg": 13, "depclean": 13, "invari": 13, "cach": 13, "undefin": 13, "unpredict": 13, "invalid": 13, "0702": 13, "83cc5bbd7bbe8bdf04dd3c3bc7f8a035": 13, "www": 13, "similar": 13, "no_homepag": 13, "download": 13, "tracker": 13, "job": 13, "subpag": 13, "anywher": 13, "marker": 13, "identifi": 13, "0703": 13, "prerequisit": 13, "unset": 13, "ius": 13, "contrari": 13, "skip": 13, "fail": 13, "omit": 13, "overspecifi": 13, "0704": 13, "pertain": 13, "express": [13, 15], "bundl": 13, "present": 13, "shall": 13, "binari": 13, "effect": 13, "cover": 13, "simplest": 13, "noth": 13, "protect": 13, "deriv": 13, "rememb": 13, "init": 13, "gpl": 13, "micha\u0142": 14, "g\u00f3rny": 14, "mgorni": 14, "ulrich": 14, "m\u00fcller": 14, "ulm": 14, "creativ": 14, "attribut": 14, "sharealik": 14, "0": [14, 16], "intern": 14, "0801": 15, "versioned_use_flag": 15, "switch": 15, "qt4": 15, "qt5": 15, "hierarch": 15, "gtk": 15, "gtk3": 15, "0802": 15, "cf3f5a59ac918335766632bd02438722": 15, "offer": 15, "x": 15, "toolkit": 15, "widget": 15, "simpl": [15, 16], "adjust": 15, "per": 15, "discov": 15, "obtain": 15, "0803": 15, "20191013": 15, "use_expand": 15, "newli": 15, "regular": [15, 16], "valid": 15, "low": 15, "prioriti": 15, "resembl": 15, "proper": 15, "shorter": 15, "unprefix": 15, "hyphen": 15, "imit": 15, "like": 15, "lengthen": 15, "mismatch": 15, "extend": 15, "improv": 15, "0901": 16, "702460": 16, "81": 16, "uid": 16, "gid": 16, "499": 16, "baselayout": 16, "reus": 16, "acct": 16, "justifi": 16, "101": 16, "749": 16, "select": 16, "arbitrari": 16, "free": 16, "success": 16, "upward": 16, "gap": 16, "desir": 16, "serv": 16, "synchron": 16, "primit": 16, "collis": 16, "second": 16, "simplifi": 16, "aid": 16, "rapid": 16, "adopt": 16, "pointless": 16, "cross": 16, "distro": 16, "sync": 16, "favor": 16, "alloc": 16, "chosen": 16, "immin": 16, "ones": 16, "999": 16, "downward": 16, "lowest": 16, "true": 16}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"basic": 0, "inform": 0, "goal": 0, "polici": [0, 6, 9, 11, 12, 16], "make": 0, "complianc": 0, "check": 0, "enforc": 0, "chang": [0, 1], "appeal": 0, "depend": 1, "option": 1, "runtim": 1, "revis": 1, "slot": [1, 13], "subslot": 1, "sub": 1, "packag": [1, 10, 12], "special": 1, "case": 1, "qt": 1, "proactiv": 1, "us": [1, 3, 13, 15], "oper": 1, "bump": 1, "without": [1, 10], "flag": [1, 13, 15], "deprec": [2, 9], "eapi": 2, "eclass": [2, 3, 9], "ebuild": 3, "file": [3, 5, 7], "format": [3, 4], "code": 3, "style": [3, 4], "must": [3, 13], "contain": 3, "within": 3, "homepag": [3, 13], "variabl": [3, 13], "src_uri": 3, "refer": 3, "keyword": [3, 8], "defin": 3, "singl": 3, "line": 3, "licens": [3, 13, 14], "d": 3, "onli": 3, "src_instal": 3, "pkg_preinst": 3, "edit": 4, "publish": 4, "updat": 4, "thi": 4, "guid": [4, 6, 11], "get": 4, "sourc": 4, "build": 4, "send": 4, "contribut": 4, "merg": 4, "pull": 4, "request": 4, "system": 5, "layout": 5, "instal": [5, 7], "path": 5, "todo": [5, 8, 15], "support": 5, "separ": 5, "usr": 5, "strict": 5, "multilib": 5, "static": [5, 7], "librari": [5, 7], "libtool": [5, 7], "game": 5, "locat": 5, "ownership": 5, "absolut": 5, "symbol": 5, "link": 5, "target": 5, "gentoo": [6, 12], "content": 6, "indic": 6, "tabl": 6, "small": 7, "la": 7, "virtual": 7, "manpag": 7, "stabil": 8, "rekeyword": 8, "drop": 8, "new": [8, 10], "version": [8, 15], "remov": [8, 10], "stabl": 8, "languag": 9, "specif": [9, 12], "python": 9, "usag": 9, "2": 9, "maintain": 10, "ad": 10, "motiv": 11, "histori": 11, "histor": 11, "state": 11, "document": [11, 12], "purpos": 11, "other": [12, 13], "manag": 12, "glep": 12, "develop": 12, "manual": 12, "extern": 12, "standard": 12, "posix": 12, "fh": 12, "metadata": 13, "dynam": 13, "multislot": 13, "valu": 13, "meaning": 13, "restrict": 13, "test": 13, "prefac": 14, "introduct": 14, "author": 14, "gui": 15, "underscor": 15, "name": 15, "user": 16, "group": 16, "account": 16}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.todo": 2, "sphinx": 60}, "alltitles": {"Basic information": [[0, "basic-information"]], "Goals of policy making": [[0, "goals-of-policy-making"]], "Policy compliance checking": [[0, "policy-compliance-checking"]], "Policy enforcement": [[0, "policy-enforcement"]], "Policy making, changes and appeals": [[0, "policy-making-changes-and-appeals"]], "Dependencies": [[1, "dependencies"]], "Optional runtime dependencies": [[1, "pg0001"]], "=-dependencies with no revision": [[1, "pg0002"]], "Slot and subslot dependencies": [[1, "slot-and-subslot-dependencies"]], "on (sub-)slotted packages": [[1, "pg0011"]], "special case: Qt packages": [[1, "pg0012"]], "proactive use of slot operators": [[1, "proactive-use-of-slot-operators"]], "Revision bumps on runtime dependency changes": [[1, "pg0003"]], "USE dependencies": [[1, "use-dependencies"]], "on packages without the flag": [[1, "pg0021"]], "Deprecations": [[2, "deprecations"]], "Deprecated EAPIs": [[2, "pg1001"]], "Deprecated eclasses": [[2, "pg1003"]], "Ebuild file format": [[3, "ebuild-file-format"]], "Coding style": [[3, "pg0101"]], "Code must be contained within ebuild and eclasses": [[3, "pg0102"]], "HOMEPAGE must not contain variables": [[3, "pg0103"]], "SRC_URI must not refer to HOMEPAGE": [[3, "pg0104"]], "KEYWORDS must be defined on a single line": [[3, "pg0105"]], "LICENSE must not contain variables": [[3, "pg0106"]], "D must be used only in src_install and pkg_preinst": [[3, "pg0107"]], "Editing and publishing updates to this Guide": [[4, "editing-and-publishing-updates-to-this-guide"]], "Formatting and style": [[4, "formatting-and-style"]], "Getting sources": [[4, "getting-sources"]], "Building": [[4, "building"]], "Sending contributions": [[4, "sending-contributions"]], "Merging pull requests": [[4, "merging-pull-requests"]], "Publishing": [[4, "publishing"]], "File system layout": [[5, "file-system-layout"]], "Installation paths": [[5, "pg0201"]], "Todo": [[5, "id1"], [8, "id1"], [15, "id1"]], "Support for separate /usr": [[5, "pg0202"]], "Strict multilib layout": [[5, "pg0203"]], "Static libraries and libtool files": [[5, "pg0204"]], "Game install locations and ownership": [[5, "pg0205"]], "Absolute symbolic link targets": [[5, "pg0206"]], "Gentoo Policy Guide": [[6, "gentoo-policy-guide"]], "Contents:": [[6, null]], "Indices and tables": [[6, "indices-and-tables"]], "Installed files": [[7, "installed-files"]], "Installation of small files": [[7, "pg0301"]], "Installation of static libraries": [[7, "pg0302"]], "Installation of libtool (.la) files": [[7, "pg0303"]], "Virtuals": [[7, "pg0304"]], "Installation of manpages": [[7, "pg0305"]], "Keywording and stabilization": [[8, "keywording-and-stabilization"]], "Rekeywording on dropped keywords": [[8, "pg0401"]], "Stabilizing new versions": [[8, "pg0402"]], "Removing stable keywords": [[8, "pg0403"]], "Language-specific policies": [[9, "language-specific-policies"]], "Python": [[9, "python"]], "Eclass usage": [[9, "pg0501"]], "Python 2 deprecation": [[9, "pg0502"]], "Package Maintainers": [[10, "package-maintainers"]], "Adding new maintainers": [[10, "pg0601"]], "New packages without a maintainer": [[10, "pg0602"]], "Removing package maintainers": [[10, "pg0603"]], "Motivation and history": [[11, "motivation-and-history"]], "Historical state of policy documentation": [[11, "historical-state-of-policy-documentation"]], "Purpose of the Policy Guide": [[11, "purpose-of-the-policy-guide"]], "Other policy documents": [[12, "other-policy-documents"]], "Gentoo-specific documentation": [[12, "gentoo-specific-documentation"]], "Package Manager Specification": [[12, "package-manager-specification"]], "GLEPs": [[12, "gleps"]], "Developer Manual": [[12, "developer-manual"]], "External standards": [[12, "external-standards"]], "POSIX": [[12, "posix"]], "FHS": [[12, "fhs"]], "Other metadata variables": [[13, "other-metadata-variables"]], "Dynamic slots (multislot flag)": [[13, "pg0701"]], "HOMEPAGE value must be meaningful": [[13, "pg0702"]], "RESTRICT=test for USE=-test": [[13, "pg0703"]], "LICENSE": [[13, "pg0704"]], "Preface": [[14, "preface"]], "Introduction": [[14, "introduction"]], "Authors": [[14, "authors"]], "License": [[14, "license"]], "USE flags": [[15, "use-flags"]], "Versioned USE flags": [[15, "pg0801"]], "USE=gui flag": [[15, "pg0802"]], "Underscores in USE flag names": [[15, "pg0803"]], "Users and groups": [[16, "users-and-groups"]], "User and group account policy": [[16, "pg0901"]]}, "indexentries": {"= with no revision": [[1, "index-2"]], "qt": [[1, "index-4"], [15, "index-0"], [15, "index-1"]], "use flags": [[1, "index-1"], [1, "index-6"], [7, "index-0"], [13, "index-1"], [13, "index-3"], [15, "index-0"], [15, "index-1"], [15, "index-2"]], "dependency": [[1, "index-0"], [1, "index-2"], [1, "index-3"], [1, "index-5"], [1, "index-6"]], "dynamic": [[1, "index-5"], [13, "index-0"]], "for optional rdepend": [[1, "index-1"]], "optional runtime": [[1, "index-0"]], "revision bump": [[1, "index-5"]], "slot/subslot": [[1, "index-3"], [1, "index-4"], [13, "index-0"]], "eapi": [[2, "index-0"]], "deprecated": [[2, "index-0"], [2, "index-1"]], "eclass": [[2, "index-1"], [9, "index-1"], [9, "index-2"], [9, "index-3"], [9, "index-4"]], "bash": [[3, "index-0"]], "conditions": [[3, "index-0"]], "d": [[3, "index-6"]], "eblit": [[3, "index-1"]], "homepage": [[3, "index-2"], [3, "index-3"], [13, "index-2"]], "indentation": [[3, "index-0"]], "keywords": [[3, "index-4"], [8, "index-0"], [8, "index-1"], [8, "index-2"]], "license": [[3, "index-5"], [13, "index-4"]], "one line": [[3, "index-4"]], "src uri": [[3, "index-3"]], "variable": [[3, "index-2"], [3, "index-5"], [3, "index-6"]], "variable reference": [[3, "index-0"]], "absolute target": [[5, "index-5"]], "file system": [[5, "index-0"], [5, "index-1"], [5, "index-2"], [5, "index-3"], [5, "index-4"]], "games": [[5, "index-4"]], "installation paths": [[5, "index-0"]], "libtool file": [[5, "index-3"], [7, "index-2"]], "multilib-strict": [[5, "index-2"]], "separate /usr": [[5, "index-1"]], "static library": [[5, "index-3"], [7, "index-1"]], "symbolic link": [[5, "index-5"]], "installed files": [[7, "index-0"], [7, "index-1"], [7, "index-2"], [7, "index-3"], [7, "index-4"]], "manpages": [[7, "index-4"]], "small files": [[7, "index-0"]], "virtuals": [[7, "index-3"]], "rekeywording": [[8, "index-0"]], "removing stable": [[8, "index-2"]], "stabilizing new versions": [[8, "index-1"]], "python": [[9, "index-0"], [9, "index-1"], [9, "index-5"]], "python 2": [[9, "index-5"]], "python-any-r1": [[9, "index-2"]], "python-r1": [[9, "index-3"]], "python-single-r1": [[9, "index-4"]], "adding": [[10, "index-0"]], "maintainer": [[10, "index-0"], [10, "index-1"], [10, "index-2"]], "new packages without": [[10, "index-1"]], "removing": [[10, "index-2"]], "up for grabs": [[10, "index-3"]], "gentoo.org": [[13, "index-2"]], "meaningful value": [[13, "index-2"]], "multislot": [[13, "index-1"]], "restrict": [[13, "index-3"]], "test; use=-test": [[13, "index-3"]], "test; restrict": [[13, "index-3"]], "gtk": [[15, "index-0"], [15, "index-1"]], "gui": [[15, "index-1"]], "gui flag": [[15, "index-1"]], "underscore": [[15, "index-2"]], "versioned": [[15, "index-0"]], "group": [[16, "index-1"]], "user": [[16, "index-0"]]}})
\ No newline at end of file diff --git a/std-policy-index.html b/std-policy-index.html index a8f4dd1..45a0a9a 100644 --- a/std-policy-index.html +++ b/std-policy-index.html @@ -7,19 +7,20 @@ <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Policy Index — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> @@ -419,7 +420,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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -433,16 +434,13 @@ </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/use-flags.html b/use-flags.html index 4eb5512..14298b3 100644 --- a/use-flags.html +++ b/use-flags.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>USE flags — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <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" /> @@ -133,9 +134,9 @@ <section id="use-flags"> -<h1>USE flags<a class="headerlink" href="#use-flags" title="Permalink to this heading">¶</a></h1> +<h1>USE flags<a class="headerlink" href="#use-flags" title="Link to this heading">¶</a></h1> <section id="pg0801"> -<span id="versioned-use-flags"></span><span id="index-0"></span><h2>Versioned USE flags<a class="headerlink" href="#pg0801" title="Permalink to this heading">¶</a></h2> +<span id="versioned-use-flags"></span><span id="index-0"></span><h2>Versioned USE flags<a class="headerlink" href="#pg0801" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0801</p> @@ -166,7 +167,7 @@ removed since.</p> </div> </section> <section id="pg0802"> -<span id="use-gui-flag"></span><span id="index-1"></span><h2>USE=gui flag<a class="headerlink" href="#pg0802" title="Permalink to this heading">¶</a></h2> +<span id="use-gui-flag"></span><span id="index-1"></span><h2>USE=gui flag<a class="headerlink" href="#pg0802" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0802</p> @@ -195,7 +196,7 @@ afterwards caused issues with packages supporting a choice between multiple GUIs.</p> </section> <section id="pg0803"> -<span id="underscores-in-use-flag-names"></span><span id="index-2"></span><h2>Underscores in USE flag names<a class="headerlink" href="#pg0803" title="Permalink to this heading">¶</a></h2> +<span id="underscores-in-use-flag-names"></span><span id="index-2"></span><h2>Underscores in USE flag names<a class="headerlink" href="#pg0803" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0803</p> @@ -310,7 +311,7 @@ or underscores depending on developer’s personal preference.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -324,16 +325,13 @@ or underscores depending on developer’s personal preference.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. diff --git a/user-group.html b/user-group.html index ffeab1e..0c9cdd4 100644 --- a/user-group.html +++ b/user-group.html @@ -5,22 +5,23 @@ <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> - <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> + <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Users and groups — 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="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <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"> - <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" /> + <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> + <link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css?v=637b0b67" /> + <link rel="stylesheet" type="text/css" href="_static/custom.css?v=56c4699f" /> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> - <script src="_static/doctools.js"></script> - <script src="_static/sphinx_highlight.js"></script> + <script src="_static/documentation_options.js?v=5929fcd5"></script> + <script src="_static/doctools.js?v=888ff710"></script> + <script src="_static/sphinx_highlight.js?v=dc90522c"></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" /> @@ -130,9 +131,9 @@ <section id="users-and-groups"> -<h1>Users and groups<a class="headerlink" href="#users-and-groups" title="Permalink to this heading">¶</a></h1> -<span class="target" id="index-0"></span><section id="pg0901"> -<span id="user-and-group-account-policy"></span><span id="index-1"></span><h2>User and group account policy<a class="headerlink" href="#pg0901" title="Permalink to this heading">¶</a></h2> +<h1>Users and groups<a class="headerlink" href="#users-and-groups" title="Link to this heading">¶</a></h1> +<section id="pg0901"> +<span id="user-and-group-account-policy"></span><span id="index-1"></span><span id="index-0"></span><h2>User and group account policy<a class="headerlink" href="#pg0901" title="Link to this heading">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG<span class="colon">:</span></dt> <dd class="field-odd"><p>0901</p> @@ -255,7 +256,7 @@ been reserved for true system users and groups.</p> <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 6.2.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 7.2.6</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.8</a></span> </div> <div class="col-xs-12 col-md-4"> </div> @@ -269,16 +270,13 @@ been reserved for true system users and groups.</p> </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://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> - </ul> + <div class="text-center"> + <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> <div class="col-xs-10 col-sm-9 col-md-10"> - <strong>© 2001–2023 Gentoo Authors</strong><br> + <strong>© 2001–2024 Gentoo Authors</strong><br> <small> - Gentoo is a trademark of the Gentoo Foundation, Inc. + Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.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. |