From a5c213d53976e7b9ef0a5206a5f4f6fc4128f1c4 Mon Sep 17 00:00:00 2001
From: Ulrich Müller The Gentoo policies focus on three aims: Portability. By following the policies, it should be possible
@@ -154,7 +155,7 @@ his goals and reduce the likeliness of surprising behavior. Currently, there are two kinds of tools involved in detecting policy
violations:Basic information¶
+Basic information¶
Goals of policy making¶
+Goals of policy making¶
Policy compliance checking¶
+Policy compliance checking¶
@@ -177,7 +178,7 @@ supplements the direct use of linting tools by developers with reliable
tree-wide scans.
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.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
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. 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. This work is licensed under the Creative Commons Attribution-ShareAlike
4.0 International License. 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. 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. The Gentoo policies focus on three aims: Portability. By following the policies, it should be possible
@@ -214,7 +215,7 @@ his goals and reduce the likeliness of surprising behavior. Currently, there are two kinds of tools involved in detecting policy
violations: 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. 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 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 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. 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
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 specifies the suggested filesystem layout for Linux systems.
Gentoo follows FHS only partially. Whenever Gentoo policies and FHS
disagree, Gentoo policies should be followed. While editing the Guide, please respect the existing formatting rules.
Notably: The reference repository is hosted at git.gentoo.org, and available
via proj/policy-guide.git gitweb. To clone it: A tox-file is provided to build the Guide in a virtualenv, installing
all necessary dependencies. To build the HTML version, run: 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. The recommended way to merge pull requests is to use
The built version of Policy Guide is currently published via a git
repository. The recommended method is to clone the repository
into 0001 0002 0011 0012 There is an open debate on whether developers should be proactively
adding 0003 0021 1001 1003 0101 0102 0103 0104 0105 0106 0107 0201 0202 0203 0204 0205 0206 0301 0304 0305 0401 0402 0403 0501 0502 0601 0602 0603 0701 0702 0703 0704 0801
+ © 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¶
+Gentoo Policy Guide¶
Preface¶
+Preface¶
Introduction¶
+Introduction¶
License¶
+License¶
Motivation and history¶
+Motivation and history¶
Historical state of policy documentation¶
+Historical state of policy documentation¶
Purpose of the Policy Guide¶
+Purpose of the Policy Guide¶
Basic information¶
+Basic information¶
Goals of policy making¶
+Goals of policy making¶
Policy compliance checking¶
+Policy compliance checking¶
@@ -237,7 +238,7 @@ supplements the direct use of linting tools by developers with reliable
tree-wide scans.
Policy enforcement¶
+Policy enforcement¶
Policy making, changes and appeals¶
+Policy making, changes and appeals¶
Other policy documents¶
+Other policy documents¶
Gentoo-specific documentation¶
+Gentoo-specific documentation¶
Package Manager Specification¶
+Package Manager Specification¶
GLEPs¶
+GLEPs¶
Developer Manual¶
+Developer Manual¶
External standards¶
+External standards¶
POSIX¶
+POSIX¶
FHS¶
+FHS¶
Editing and publishing updates to this Guide¶
+Editing and publishing updates to this Guide¶
Formatting and style¶
+Formatting and style¶
@@ -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¶
# via https
@@ -344,7 +345,7 @@ the GitHub
-
Building¶
+Building¶
tox
@@ -357,13 +358,13 @@ as a command-line argument, e.g.:
Sending contributions¶
+Sending contributions¶
Merging pull requests¶
+Merging pull requests¶
app-portage/pram
. To configure the remote before the first use,
run the following command in your checkout:Publishing¶
+Publishing¶
_build/html
in order to make Sphinx output into the checkout:_build/html
Dependencies¶
-Optional runtime dependencies¶
+Dependencies¶
+Optional runtime dependencies¶
=-dependencies with no revision¶
+=-dependencies with no revision¶
Slot and subslot dependencies¶
+Slot and subslot dependencies¶
on (sub-)slotted packages¶
+on (sub-)slotted packages¶
special case: Qt packages¶
+special case: Qt packages¶
-
proactive use of slot operators¶
+proactive use of slot operators¶
:=
slot operators on packages that do not define subslots
yet.Revision bumps on runtime dependency changes¶
+Revision bumps on runtime dependency changes¶
USE dependencies¶
+USE dependencies¶
on packages without the flag¶
+on packages without the flag¶
Deprecations¶
+Deprecations¶
Deprecated EAPIs¶
+Deprecated EAPIs¶
metadata/layout.conf
.
Deprecated eclasses¶
+Deprecated eclasses¶
Ebuild file format¶
+Ebuild file format¶
Coding style¶
+Coding style¶
Code must be contained within ebuild and eclasses¶
+Code must be contained within ebuild and eclasses¶
HOMEPAGE must not contain variables¶
+HOMEPAGE must not contain variables¶
SRC_URI must not refer to HOMEPAGE¶
+SRC_URI must not refer to HOMEPAGE¶
KEYWORDS must be defined on a single line¶
+KEYWORDS must be defined on a single line¶
LICENSE must not contain variables¶
+LICENSE must not contain variables¶
D must be used only in src_install and pkg_preinst¶
+D must be used only in src_install and pkg_preinst¶
File system layout¶
+File system layout¶
Installation paths¶
+Installation paths¶
Support for separate /usr¶
+Support for separate /usr¶
Strict multilib layout¶
+Strict multilib layout¶
Static libraries and libtool files¶
+Static libraries and libtool files¶
Game install locations and ownership¶
+Game install locations and ownership¶
Absolute symbolic link targets¶
+Absolute symbolic link targets¶
Installed files¶
+Installed files¶
Installation of small files¶
+Installation of small files¶
Installation of static libraries¶
+Installation of static libraries¶
Virtuals¶
+Virtuals¶
<
be impossible if they installed any files).
Installation of manpages¶
+Installation of manpages¶
Keywording and stabilization¶
+Keywording and stabilization¶
Rekeywording on dropped keywords¶
+Rekeywording on dropped keywords¶
Stabilizing new versions¶
+Stabilizing new versions¶
Removing stable keywords¶
+Removing stable keywords¶
Language-specific policies¶
+Language-specific policies¶
Python¶
-Eclass usage¶
+Python¶
+Eclass usage¶
Python 2 deprecation¶
+Python 2 deprecation¶
Package Maintainers¶
+Package Maintainers¶
Adding new maintainers¶
+Adding new maintainers¶
New packages without a maintainer¶
+New packages without a maintainer¶
Removing package maintainers¶
+Removing package maintainers¶
Other metadata variables¶
-Dynamic slots (multislot flag)¶
+Other metadata variables¶
+Dynamic slots (multislot flag)¶
HOMEPAGE value must be meaningful¶
+HOMEPAGE value must be meaningful¶
RESTRICT=test for USE=-test¶
+RESTRICT=test for USE=-test¶
LICENSE¶
+LICENSE¶
USE flags¶
+USE flags¶
Versioned USE flags¶
+Versioned USE flags¶
0802
@@ -1646,7 +1647,7 @@ afterwards caused issues with packages supporting a choice between multiple GUIs.0803
@@ -1680,9 +1681,9 @@ or underscores depending on developer’s personal preference.0901
@@ -1735,7 +1736,7 @@ been reserved for true system users and groups.0001
@@ -169,7 +170,7 @@ by the Council but no reference implementation has been written.0002
@@ -201,9 +202,9 @@ requesting the latter, it warns developers to reconsider whether they used the correct operator.0011
@@ -240,7 +241,7 @@ to the newest package version available.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.
0003
@@ -319,9 +320,9 @@ if the package installed by the user still links to libfoo.0021
@@ -453,7 +454,7 @@ updating its reverse dependencies.1001
@@ -157,7 +158,7 @@ no version bumps are expected. inmetadata/layout.conf
.
1003
@@ -257,7 +258,7 @@ inside the eclass files.0101
@@ -162,7 +163,7 @@ Consistency avoids unnecessary changes when other developers edit the ebuild.0102
@@ -189,7 +190,7 @@ confuses other developers and tools that do not explicitly account for that possibility, including linting tools.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.0104
@@ -234,7 +235,7 @@ it hard to copy-paste part of the URI e.g. to investigate the directory index.0105
@@ -255,7 +256,7 @@ ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.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.0107
@@ -383,7 +384,7 @@ does not exist in other phases.While editing the Guide, please respect the existing formatting rules. Notably:
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¶
@@ -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¶
-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.
-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
+
+
+
+
+
+
+
+
+
+
+
+