From a5c213d53976e7b9ef0a5206a5f4f6fc4128f1c4 Mon Sep 17 00:00:00 2001 From: Ulrich Müller Date: Sat, 23 Mar 2024 18:23:37 +0100 Subject: Rebuild MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Ulrich Müller --- _static/basic.css | 22 +++++ _static/documentation_options.js | 3 +- _static/searchtools.js | 26 +++-- _static/sphinx_highlight.js | 16 ++- basics.html | 42 ++++---- combined.html | 206 +++++++++++++++++++-------------------- dependencies.html | 54 +++++----- deprecation.html | 38 ++++---- ebuild-format.html | 48 +++++---- editing.html | 46 +++++---- filesystem.html | 46 +++++---- genindex.html | 30 +++--- index.html | 36 ++++--- installed-files.html | 44 ++++----- keywords.html | 40 ++++---- languages.html | 42 ++++---- maintainer.html | 42 ++++---- motivation.html | 38 ++++---- other-docs.html | 48 +++++---- other-metadata.html | 44 ++++----- preface.html | 40 ++++---- search.html | 30 +++--- searchindex.js | 2 +- std-policy-index.html | 30 +++--- use-flags.html | 40 ++++---- 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 @@ - + Basic information — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Basic information

+

Basic information

-

Goals of policy making

+

Goals of policy making

The Gentoo policies focus on three aims:

  1. Portability. By following the policies, it should be possible @@ -154,7 +155,7 @@ his goals and reduce the likeliness of surprising behavior.

-

Policy compliance checking

+

Policy compliance checking

Currently, there are two kinds of tools involved in detecting policy violations:

    @@ -177,7 +178,7 @@ supplements the direct use of linting tools by developers with reliable tree-wide scans.

-

Policy enforcement

+

Policy enforcement

The Gentoo QA team is tasked with enforcement of the tree policies. Its role is governed by GLEP 48. It focuses on documenting the policies, resolving doubts regarding them and educating @@ -190,7 +191,7 @@ refuses to resolve policy violations.

team can issue disciplinary measures against the developer in question.

-

Policy making, changes and appeals

+

Policy making, changes and appeals

The majority of policies are written down and maintained by the QA team. Other Gentoo projects also create policies that affect their specific areas of contributions (e.g. systemd project created @@ -285,7 +286,7 @@ be appealed to the Gentoo Policy Guide

@@ -299,16 +300,13 @@ be appealed to the -
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/combined.html b/combined.html index 4412881..adabc6d 100644 --- a/combined.html +++ b/combined.html @@ -5,20 +5,21 @@ - + Gentoo Policy Guide documentation - - - + + + + - + @@ -110,7 +111,7 @@
-

Gentoo Policy Guide

+

Gentoo Policy Guide

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.

-

Preface

+

Preface

-

Introduction

+

Introduction

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.

-

Authors

+

Authors

This document is maintained by the Gentoo QA project.

The current text authors are:

    @@ -141,15 +142,15 @@ in which the policy can be updated.

-

License

+

License

This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.

-

Motivation and history

+

Motivation and history

-

Historical state of policy documentation

+

Historical state of policy documentation

At the time, Gentoo was lacking a clear and focused document listing all development-related policies in a concise and clear way.

PMS 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.

-

Purpose of the Policy Guide

+

Purpose of the Policy Guide

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.

-

Basic information

+

Basic information

-

Goals of policy making

+

Goals of policy making

The Gentoo policies focus on three aims:

  1. Portability. By following the policies, it should be possible @@ -214,7 +215,7 @@ his goals and reduce the likeliness of surprising behavior.

-

Policy compliance checking

+

Policy compliance checking

Currently, there are two kinds of tools involved in detecting policy violations:

    @@ -237,7 +238,7 @@ supplements the direct use of linting tools by developers with reliable tree-wide scans.

-

Policy enforcement

+

Policy enforcement

The Gentoo QA team is tasked with enforcement of the tree policies. Its role is governed by GLEP 48. It focuses on documenting the policies, resolving doubts regarding them and educating @@ -250,7 +251,7 @@ refuses to resolve policy violations.

team can issue disciplinary measures against the developer in question.

-

Policy making, changes and appeals

+

Policy making, changes and appeals

The majority of policies are written down and maintained by the QA team. Other Gentoo projects also create policies that affect their specific areas of contributions (e.g. systemd project created @@ -263,11 +264,11 @@ be appealed to the

-

Other policy documents

+

Other policy documents

-

Gentoo-specific documentation

+

Gentoo-specific documentation

-

Package Manager Specification

+

Package Manager Specification

PMS 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 future EAPI process.

-

GLEPs

+

GLEPs

GLEPs 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.

@@ -286,7 +287,7 @@ In general, all GLEP updates go through mailing list review and need to be approved by the Council.

-

Developer Manual

+

Developer Manual

Devmanual 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

-

External standards

+

External standards

-

POSIX

+

POSIX

POSIX 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.

-

FHS

+

FHS

FHS specifies the suggested filesystem layout for Linux systems. Gentoo follows FHS only partially. Whenever Gentoo policies and FHS disagree, Gentoo policies should be followed.

@@ -313,9 +314,9 @@ disagree, Gentoo policies should be followed.

-

Editing and publishing updates to this Guide

+

Editing and publishing updates to this Guide

-

Formatting and style

+

Formatting and style

While editing the Guide, please respect the existing formatting rules. Notably:

    @@ -330,7 +331,7 @@ rules match multiple chapters, choose the one that fits it best. Make sure to match existing keywords in index.

-

Getting sources

+

Getting sources

The reference repository is hosted at git.gentoo.org, and available via proj/policy-guide.git gitweb. To clone it:

# via https
@@ -344,7 +345,7 @@ the GitHub 
-

Building

+

Building

A tox-file is provided to build the Guide in a virtualenv, installing all necessary dependencies. To build the HTML version, run:

tox
@@ -357,13 +358,13 @@ as a command-line argument, e.g.:

-

Sending contributions

+

Sending contributions

Changes to this document can be either submitted to Policy Manual Gentoo Bugzilla component as git-format patches attached to the bugs, or to gentoo/policy-guide repository as pull requests.

-

Merging pull requests

+

Merging pull requests

The recommended way to merge pull requests is to use app-portage/pram. To configure the remote before the first use, run the following command in your checkout:

@@ -376,7 +377,7 @@ run the following command in your checkout:

-

Publishing

+

Publishing

The built version of Policy Guide is currently published via a git repository. The recommended method is to clone the repository into _build/html in order to make Sphinx output into the checkout:

@@ -389,9 +390,9 @@ into _build/html
-

Dependencies

-
-

Optional runtime dependencies

+

Dependencies

+
+

Optional runtime dependencies

PG:

0001

@@ -425,7 +426,7 @@ by the Council but no reference implementation has been written.

-

=-dependencies with no revision

+

=-dependencies with no revision

PG:

0002

@@ -457,9 +458,9 @@ requesting the latter, it warns developers to reconsider whether they used the correct operator.

-

Slot and subslot dependencies

+

Slot and subslot dependencies

-

on (sub-)slotted packages

+

on (sub-)slotted packages

PG:

0011

@@ -496,7 +497,7 @@ to the newest package version available.

-

special case: Qt packages

+

special case: Qt packages

PG:

0012

@@ -518,7 +519,7 @@ if your package uses one of the private API parts, and plain -

proactive use of slot operators

+

proactive use of slot operators

There is an open debate on whether developers should be proactively adding := slot operators on packages that do not define subslots yet.

@@ -532,7 +533,7 @@ They point out the case of Qt packages as an example.

-

Revision bumps on runtime dependency changes

+

Revision bumps on runtime dependency changes

PG:

0003

@@ -575,9 +576,9 @@ if the package installed by the user still links to libfoo.

-

USE dependencies

+

USE dependencies

-

on packages without the flag

+

on packages without the flag

PG:

0021

@@ -618,9 +619,9 @@ updating its reverse dependencies.

-

Deprecations

+

Deprecations

-

Deprecated EAPIs

+

Deprecated EAPIs

PG:

1001

@@ -642,7 +643,7 @@ no version bumps are expected.

in metadata/layout.conf.

-

Deprecated eclasses

+

Deprecated eclasses

PG:

1003

@@ -662,9 +663,9 @@ inside the eclass files.

-

Ebuild file format

+

Ebuild file format

-

Coding style

+

Coding style

PG:

0101

@@ -691,7 +692,7 @@ Consistency avoids unnecessary changes when other developers edit the ebuild.

-

Code must be contained within ebuild and eclasses

+

Code must be contained within ebuild and eclasses

PG:

0102

@@ -718,7 +719,7 @@ confuses other developers and tools that do not explicitly account for that possibility, including linting tools.

-

HOMEPAGE must not contain variables

+

HOMEPAGE must not contain variables

PG:

0103

@@ -740,7 +741,7 @@ preprocessing, breaking URI support in terminals and editors, as well as reducing the usefulness of plain tools such as grep.

-

SRC_URI must not refer to HOMEPAGE

+

SRC_URI must not refer to HOMEPAGE

PG:

0104

@@ -763,7 +764,7 @@ it hard to copy-paste part of the URI e.g. to investigate the directory index.

-

KEYWORDS must be defined on a single line

+

KEYWORDS must be defined on a single line

PG:

0105

@@ -784,7 +785,7 @@ ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.

-

LICENSE must not contain variables

+

LICENSE must not contain variables

PG:

0106

@@ -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.

-

D must be used only in src_install and pkg_preinst

+

D must be used only in src_install and pkg_preinst

PG:

0107

@@ -827,9 +828,9 @@ does not exist in other phases.

-

File system layout

+

File system layout

-

Installation paths

+

Installation paths

PG:

0201

@@ -900,7 +901,7 @@ exceptions are:

-

Support for separate /usr

+

Support for separate /usr

PG:

0202

@@ -925,7 +926,7 @@ using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.

-

Strict multilib layout

+

Strict multilib layout

PG:

0203

@@ -952,7 +953,7 @@ and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.

-

Static libraries and libtool files

+

Static libraries and libtool files

PG:

0204

@@ -978,7 +979,7 @@ used only during package builds, and installing them to rootfs would be a waste of space.

-

Game install locations and ownership

+

Game install locations and ownership

PG:

0205

@@ -1017,7 +1018,7 @@ to the games group, a new group (gamestat) needed to be created to fulfill that purpose.

-

Absolute symbolic link targets

+

Absolute symbolic link targets

PG:

0206

@@ -1048,9 +1049,9 @@ it is mounted in another location, e.g. for the purposes of recovery.

-

Installed files

+

Installed files

-

Installation of small files

+

Installation of small files

PG:

0301

@@ -1085,7 +1086,7 @@ installed, completion files are not used at all.

-

Installation of static libraries

+

Installation of static libraries

PG:

0302

@@ -1117,7 +1118,7 @@ it is acceptable to strip static libraries in -

Installation of libtool (.la) files

+

Installation of libtool (.la) files

PG:

0303

@@ -1151,7 +1152,7 @@ and while libtool keeps generating them, they are considered unnecessary and potentially harmful.

-

Virtuals

+

Virtuals

PG:

0304

@@ -1171,7 +1172,7 @@ e.g., that they must not assign the < be impossible if they installed any files).

-

Installation of manpages

+

Installation of manpages

PG:

0305

@@ -1194,9 +1195,9 @@ prebuilt manpages is a good compromise.

-

Keywording and stabilization

+

Keywording and stabilization

-

Rekeywording on dropped keywords

+

Rekeywording on dropped keywords

PG:

0401

@@ -1218,7 +1219,7 @@ affects other developers who in the future either want to stabilize a new version or to remove an old version.

-

Stabilizing new versions

+

Stabilizing new versions

PG:

0402

@@ -1248,7 +1249,7 @@ is stable and whether arch teams are slacking or stabilization was not requested on remaining architectures in the first place.

-

Removing stable keywords

+

Removing stable keywords

PG:

0403

@@ -1273,11 +1274,11 @@ of last rite mails.

-

Language-specific policies

+

Language-specific policies

-

Python

-
-

Eclass usage

+

Python

+
+

Eclass usage

PG:

0501

@@ -1310,7 +1311,7 @@ and variables also make it possible to gracefully retire old implementations with minimal changes to existing ebuilds.

-

Python 2 deprecation

+

Python 2 deprecation

PG:

0502

@@ -1346,9 +1347,9 @@ will cause major upgrade issues.

-

Package Maintainers

+

Package Maintainers

-

Adding new maintainers

+

Adding new maintainers

PG:

0601

@@ -1377,7 +1378,7 @@ packages ended up being maintained solely by Python, and distinguishing them from packages actually within project’s profile was hard.

-

New packages without a maintainer

+

New packages without a maintainer

PG:

0602

@@ -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.

-
+
-

Removing package maintainers

+

Removing package maintainers

PG:

0603

@@ -1431,9 +1432,9 @@ to them silently becoming maintainer-needed).

-

Other metadata variables

-
-

Dynamic slots (multislot flag)

+

Other metadata variables

+
+

Dynamic slots (multislot flag)

PG:

0701

@@ -1471,7 +1472,7 @@ manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.

-

HOMEPAGE value must be meaningful

+

HOMEPAGE value must be meaningful

PG:

0702

@@ -1502,7 +1503,7 @@ those cases, using the explicit No_homepage marker at least makes it easy to identify such packages.

-

RESTRICT=test for USE=-test

+

RESTRICT=test for USE=-test

PG:

0703

@@ -1536,7 +1537,7 @@ common, and there is little harm in overspecifying it.

-

LICENSE

+

LICENSE

PG:

0704

@@ -1584,9 +1585,9 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).

-

USE flags

+

USE flags

-

Versioned USE flags

+

Versioned USE flags

PG:

0801

@@ -1617,7 +1618,7 @@ removed since.

-

USE=gui flag

+

USE=gui flag

PG:

0802

@@ -1646,7 +1647,7 @@ afterwards caused issues with packages supporting a choice between multiple GUIs.

-

Underscores in USE flag names

+

Underscores in USE flag names

PG:

0803

@@ -1680,9 +1681,9 @@ or underscores depending on developer’s personal preference.

-

Users and groups

-
-

User and group account policy

+

Users and groups

+
+

User and group account policy

PG:

0901

@@ -1735,7 +1736,7 @@ been reserved for true system users and groups.

-

Indices and tables

+

Indices and tables

  • Index

  • Search Page

  • @@ -1904,7 +1905,7 @@ been reserved for true system users and groups.

    None

    @@ -1918,16 +1919,13 @@ been reserved for true system users and groups.

    -
    - +
    - © 2001–2023 Gentoo Authors
    + © 2001–2024 Gentoo Authors
    - 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/dependencies.html b/dependencies.html index 26635a5..fbe5a03 100644 --- a/dependencies.html +++ b/dependencies.html @@ -5,22 +5,23 @@ - + Dependencies — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
    -

    Dependencies

    -
    -

    Optional runtime dependencies

    +

    Dependencies

    +
    +

    Optional runtime dependencies

    PG:

    0001

    @@ -169,7 +170,7 @@ by the Council but no reference implementation has been written.

-

=-dependencies with no revision

+

=-dependencies with no revision

PG:

0002

@@ -201,9 +202,9 @@ requesting the latter, it warns developers to reconsider whether they used the correct operator.

-

Slot and subslot dependencies

+

Slot and subslot dependencies

-

on (sub-)slotted packages

+

on (sub-)slotted packages

PG:

0011

@@ -240,7 +241,7 @@ to the newest package version available.

-

special case: Qt packages

+

special case: Qt packages

PG:

0012

@@ -262,7 +263,7 @@ if your package uses one of the private API parts, and plain -

proactive use of slot operators

+

proactive use of slot operators

There is an open debate on whether developers should be proactively adding := slot operators on packages that do not define subslots yet.

@@ -276,7 +277,7 @@ They point out the case of Qt packages as an example.

-

Revision bumps on runtime dependency changes

+

Revision bumps on runtime dependency changes

PG:

0003

@@ -319,9 +320,9 @@ if the package installed by the user still links to libfoo.

-

USE dependencies

+

USE dependencies

-

on packages without the flag

+

on packages without the flag

PG:

0021

@@ -453,7 +454,7 @@ updating its reverse dependencies.

Gentoo Policy Guide

@@ -467,16 +468,13 @@ updating its reverse dependencies.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/deprecation.html b/deprecation.html index 8e511d2..6132295 100644 --- a/deprecation.html +++ b/deprecation.html @@ -5,22 +5,23 @@ - + Deprecations — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Deprecations

+

Deprecations

-

Deprecated EAPIs

+

Deprecated EAPIs

PG:

1001

@@ -157,7 +158,7 @@ no version bumps are expected.

in metadata/layout.conf.

-

Deprecated eclasses

+

Deprecated eclasses

PG:

1003

@@ -257,7 +258,7 @@ inside the eclass files.

Gentoo Policy Guide

@@ -271,16 +272,13 @@ inside the eclass files.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ - + Ebuild file format — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Ebuild file format

+

Ebuild file format

-

Coding style

+

Coding style

PG:

0101

@@ -162,7 +163,7 @@ Consistency avoids unnecessary changes when other developers edit the ebuild.

-

Code must be contained within ebuild and eclasses

+

Code must be contained within ebuild and eclasses

PG:

0102

@@ -189,7 +190,7 @@ confuses other developers and tools that do not explicitly account for that possibility, including linting tools.

-

HOMEPAGE must not contain variables

+

HOMEPAGE must not contain variables

PG:

0103

@@ -211,7 +212,7 @@ preprocessing, breaking URI support in terminals and editors, as well as reducing the usefulness of plain tools such as grep.

-

SRC_URI must not refer to HOMEPAGE

+

SRC_URI must not refer to HOMEPAGE

PG:

0104

@@ -234,7 +235,7 @@ it hard to copy-paste part of the URI e.g. to investigate the directory index.

-

KEYWORDS must be defined on a single line

+

KEYWORDS must be defined on a single line

PG:

0105

@@ -255,7 +256,7 @@ ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.

-

LICENSE must not contain variables

+

LICENSE must not contain variables

PG:

0106

@@ -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.

-

D must be used only in src_install and pkg_preinst

+

D must be used only in src_install and pkg_preinst

PG:

0107

@@ -383,7 +384,7 @@ does not exist in other phases.

Gentoo Policy Guide

@@ -397,16 +398,13 @@ does not exist in other phases.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/editing.html b/editing.html index 88c40ea..8d78cbd 100644 --- a/editing.html +++ b/editing.html @@ -5,22 +5,23 @@ - + Editing and publishing updates to this Guide — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Editing and publishing updates to this Guide

+

Editing and publishing updates to this Guide

-

Formatting and style

+

Formatting and style

While editing the Guide, please respect the existing formatting rules. Notably:

    @@ -150,7 +151,7 @@ rules match multiple chapters, choose the one that fits it best. Make sure to match existing keywords in index.

-

Getting sources

+

Getting sources

The reference repository is hosted at git.gentoo.org, and available via proj/policy-guide.git gitweb. To clone it:

# via https
@@ -164,7 +165,7 @@ the GitHub 
-

Building

+

Building

A tox-file is provided to build the Guide in a virtualenv, installing all necessary dependencies. To build the HTML version, run:

tox
@@ -177,13 +178,13 @@ as a command-line argument, e.g.:

-

Sending contributions

+

Sending contributions

Changes to this document can be either submitted to Policy Manual Gentoo Bugzilla component as git-format patches attached to the bugs, or to gentoo/policy-guide repository as pull requests.

-

Merging pull requests

+

Merging pull requests

The recommended way to merge pull requests is to use app-portage/pram. To configure the remote before the first use, run the following command in your checkout:

@@ -196,7 +197,7 @@ run the following command in your checkout:

-

Publishing

+

Publishing

The built version of Policy Guide is currently published via a git repository. The recommended method is to clone the repository into _build/html in order to make Sphinx output into the checkout:

@@ -293,7 +294,7 @@ into _build/htmlGentoo Policy Guide
@@ -307,16 +308,13 @@ into _build/html
-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/filesystem.html b/filesystem.html index 1ccdbb9..86d6656 100644 --- a/filesystem.html +++ b/filesystem.html @@ -5,22 +5,23 @@ - + File system layout — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

File system layout

+

File system layout

-

Installation paths

+

Installation paths

PG:

0201

@@ -206,7 +207,7 @@ exceptions are:

-

Support for separate /usr

+

Support for separate /usr

PG:

0202

@@ -231,7 +232,7 @@ using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.

-

Strict multilib layout

+

Strict multilib layout

PG:

0203

@@ -258,7 +259,7 @@ and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.

-

Static libraries and libtool files

+

Static libraries and libtool files

PG:

0204

@@ -284,7 +285,7 @@ used only during package builds, and installing them to rootfs would be a waste of space.

-

Game install locations and ownership

+

Game install locations and ownership

PG:

0205

@@ -323,7 +324,7 @@ to the games group, a new group (gamestat) needed to be created to fulfill that purpose.

-

Absolute symbolic link targets

+

Absolute symbolic link targets

PG:

0206

@@ -438,7 +439,7 @@ it is mounted in another location, e.g. for the purposes of recovery.

Gentoo Policy Guide

@@ -452,16 +453,13 @@ it is mounted in another location, e.g. for the purposes of recovery.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/genindex.html b/genindex.html index b1eb47e..b8088af 100644 --- a/genindex.html +++ b/genindex.html @@ -7,19 +7,20 @@ Index — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -558,7 +559,7 @@

Gentoo Policy Guide

@@ -572,16 +573,13 @@
-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/index.html b/index.html index 66fe4ae..ece3686 100644 --- a/index.html +++ b/index.html @@ -5,22 +5,23 @@ - + Gentoo Policy Guide — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -130,7 +131,7 @@
-

Gentoo Policy Guide

+

Gentoo Policy Guide

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.

-

Indices and tables

+

Indices and tables

  • Index

  • Search Page

  • @@ -347,7 +348,7 @@ in which the policy can be updated.

    Gentoo Policy Guide

    @@ -361,16 +362,13 @@ in which the policy can be updated.

    -
    - +
    - © 2001–2023 Gentoo Authors
    + © 2001–2024 Gentoo Authors
    - 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ - + Installed files — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
    -

    Installed files

    +

    Installed files

    -

    Installation of small files

    +

    Installation of small files

    PG:

    0301

    @@ -170,7 +171,7 @@ installed, completion files are not used at all.

-

Installation of static libraries

+

Installation of static libraries

PG:

0302

@@ -202,7 +203,7 @@ it is acceptable to strip static libraries in -

Installation of libtool (.la) files

+

Installation of libtool (.la) files

PG:

0303

@@ -236,7 +237,7 @@ and while libtool keeps generating them, they are considered unnecessary and potentially harmful.

-

Virtuals

+

Virtuals

PG:

0304

@@ -256,7 +257,7 @@ e.g., that they must not assign the < be impossible if they installed any files).

-

Installation of manpages

+

Installation of manpages

PG:

0305

@@ -362,7 +363,7 @@ prebuilt manpages is a good compromise.

Gentoo Policy Guide

@@ -376,16 +377,13 @@ prebuilt manpages is a good compromise.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/keywords.html b/keywords.html index c3cc1d5..ed7a0f9 100644 --- a/keywords.html +++ b/keywords.html @@ -5,22 +5,23 @@ - + Keywording and stabilization — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Keywording and stabilization

+

Keywording and stabilization

-

Rekeywording on dropped keywords

+

Rekeywording on dropped keywords

PG:

0401

@@ -157,7 +158,7 @@ affects other developers who in the future either want to stabilize a new version or to remove an old version.

-

Stabilizing new versions

+

Stabilizing new versions

PG:

0402

@@ -187,7 +188,7 @@ is stable and whether arch teams are slacking or stabilization was not requested on remaining architectures in the first place.

-

Removing stable keywords

+

Removing stable keywords

PG:

0403

@@ -293,7 +294,7 @@ of last rite mails.

Gentoo Policy Guide

@@ -307,16 +308,13 @@ of last rite mails.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/languages.html b/languages.html index 18101f8..6f913e1 100644 --- a/languages.html +++ b/languages.html @@ -5,22 +5,23 @@ - + Language-specific policies — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,11 +134,11 @@
-

Language-specific policies

+

Language-specific policies

-

Python

-
-

Eclass usage

+

Python

+
+

Eclass usage

PG:

0501

@@ -170,7 +171,7 @@ and variables also make it possible to gracefully retire old implementations with minimal changes to existing ebuilds.

-

Python 2 deprecation

+

Python 2 deprecation

PG:

0502

@@ -289,7 +290,7 @@ will cause major upgrade issues.

Gentoo Policy Guide

@@ -303,16 +304,13 @@ will cause major upgrade issues.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/maintainer.html b/maintainer.html index b7fcbff..981f333 100644 --- a/maintainer.html +++ b/maintainer.html @@ -5,22 +5,23 @@ - + Package Maintainers — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Package Maintainers

+

Package Maintainers

-

Adding new maintainers

+

Adding new maintainers

PG:

0601

@@ -164,7 +165,7 @@ packages ended up being maintained solely by Python, and distinguishing them from packages actually within project’s profile was hard.

-

New packages without a maintainer

+

New packages without a maintainer

PG:

0602

@@ -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.

-
+
-

Removing package maintainers

+

Removing package maintainers

PG:

0603

@@ -299,7 +300,7 @@ to them silently becoming maintainer-needed).

Gentoo Policy Guide

@@ -313,16 +314,13 @@ to them silently becoming maintainer-needed).

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/motivation.html b/motivation.html index f51c796..38e02ea 100644 --- a/motivation.html +++ b/motivation.html @@ -5,22 +5,23 @@ - + Motivation and history — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Motivation and history

+

Motivation and history

-

Historical state of policy documentation

+

Historical state of policy documentation

At the time, Gentoo was lacking a clear and focused document listing all development-related policies in a concise and clear way.

PMS 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.

-

Purpose of the Policy Guide

+

Purpose of the Policy Guide

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.

Gentoo Policy Guide

@@ -273,16 +274,13 @@ devmanual) should conform to policies stated here.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ - + Other policy documents — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,11 +134,11 @@
-

Other policy documents

+

Other policy documents

-

Gentoo-specific documentation

+

Gentoo-specific documentation

-

Package Manager Specification

+

Package Manager Specification

PMS 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 future EAPI process.

-

GLEPs

+

GLEPs

GLEPs 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.

@@ -156,7 +157,7 @@ In general, all GLEP updates go through mailing list review and need to be approved by the Council.

-

Developer Manual

+

Developer Manual

Devmanual 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

-

External standards

+

External standards

-

POSIX

+

POSIX

POSIX 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.

-

FHS

+

FHS

FHS specifies the suggested filesystem layout for Linux systems. Gentoo follows FHS only partially. Whenever Gentoo policies and FHS disagree, Gentoo policies should be followed.

@@ -272,7 +273,7 @@ disagree, Gentoo policies should be followed.

Gentoo Policy Guide

@@ -286,16 +287,13 @@ disagree, Gentoo policies should be followed.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ - + Other metadata variables — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

Other metadata variables

-
-

Dynamic slots (multislot flag)

+

Other metadata variables

+
+

Dynamic slots (multislot flag)

PG:

0701

@@ -173,7 +174,7 @@ manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.

-

HOMEPAGE value must be meaningful

+

HOMEPAGE value must be meaningful

PG:

0702

@@ -204,7 +205,7 @@ those cases, using the explicit No_homepage marker at least makes it easy to identify such packages.

-

RESTRICT=test for USE=-test

+

RESTRICT=test for USE=-test

PG:

0703

@@ -238,7 +239,7 @@ common, and there is little harm in overspecifying it.

-

LICENSE

+

LICENSE

PG:

0704

@@ -368,7 +369,7 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).

Gentoo Policy Guide

@@ -382,16 +383,13 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/preface.html b/preface.html index 28296fc..20c8e87 100644 --- a/preface.html +++ b/preface.html @@ -5,22 +5,23 @@ - + Preface — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -137,9 +138,9 @@
-

Preface

+

Preface

-

Introduction

+

Introduction

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.

-

Authors

+

Authors

This document is maintained by the Gentoo QA project.

The current text authors are:

    @@ -158,7 +159,7 @@ in which the policy can be updated.

-

License

+

License

This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.

@@ -245,7 +246,7 @@ in which the policy can be updated.

Gentoo Policy Guide

@@ -259,16 +260,13 @@ in which the policy can be updated.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. diff --git a/search.html b/search.html index 33a642c..afa9f70 100644 --- a/search.html +++ b/search.html @@ -7,20 +7,21 @@ Search — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -189,7 +190,7 @@

Gentoo Policy Guide

@@ -203,16 +204,13 @@
-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ Policy Index — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -419,7 +420,7 @@

Gentoo Policy Guide

@@ -433,16 +434,13 @@
-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ - + USE flags — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -133,9 +134,9 @@
-

USE flags

+

USE flags

-

Versioned USE flags

+

Versioned USE flags

PG:

0801

@@ -166,7 +167,7 @@ removed since.

-

USE=gui flag

+

USE=gui flag

PG:

0802

@@ -195,7 +196,7 @@ afterwards caused issues with packages supporting a choice between multiple GUIs.

-

Underscores in USE flag names

+

Underscores in USE flag names

PG:

0803

@@ -310,7 +311,7 @@ or underscores depending on developer’s personal preference.

Gentoo Policy Guide

@@ -324,16 +325,13 @@ or underscores depending on developer’s personal preference.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines 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 @@ - + Users and groups — Gentoo Policy Guide documentation - - - + + + - - + + + - - - + + + @@ -130,9 +131,9 @@
-

Users and groups

-
-

User and group account policy

+

Users and groups

+
+

User and group account policy

PG:

0901

@@ -255,7 +256,7 @@ been reserved for true system users and groups.

Gentoo Policy Guide

@@ -269,16 +270,13 @@ been reserved for true system users and groups.

-
- +
- © 2001–2023 Gentoo Authors
+ © 2001–2024 Gentoo Authors
- 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 CC-BY-SA-4.0 license. The Gentoo Name and Logo Usage Guidelines apply. -- cgit v1.2.3-65-gdbad