diff options
| author |   Michał Górny <mgorny@gentoo.org> | 2020-04-10 08:39:36 +0200 |
|---|---|---|
| committer |   Ulrich Müller <ulm@gentoo.org> | 2020-04-22 10:59:44 +0200 |
| commit | ef8e921ef2fc342969d0e16c910e7ecf29c2898a (patch) | |
| tree | 5c1cad15e964290bd2115325ebf421b83d1b2acf /glep-0072.rst | |
| parent | glep-0072: Update initial values (diff) | |
| download | glep-ef8e921ef2fc342969d0e16c910e7ecf29c2898a.tar.gz glep-ef8e921ef2fc342969d0e16c910e7ecf29c2898a.tar.bz2 glep-ef8e921ef2fc342969d0e16c910e7ecf29c2898a.zip | |
glep-0072: Combine and amend description of states
Provide a combined description for every status that explains what it
means, how it's used by linting tools and how it affects stabilization
requests.
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'glep-0072.rst')
| -rw-r--r-- | glep-0072.rst | 46 |
1 files changed, 19 insertions, 27 deletions
diff --git a/glep-0072.rst b/glep-0072.rst index 33a9578..7b5f9ba 100644 --- a/glep-0072.rst +++ b/glep-0072.rst @@ -112,49 +112,41 @@ On introduction, the setting will be ``stable`` for all architectures using stable keywords, and ``testing`` for those that do not (``alpha``, ``mips``, ``riscv``, Prefix profiles at the moment). -Meaning of the values for repoman ---------------------------------- +Meaning of the values +--------------------- stable ~~~~~~ -When a profile of an architecture arch is tested, then repoman checks -consistency of the dependency tree for ``arch`` and for ``~arch`` separately. +Stable means that the architecture is actively maintaining stable keywords. +When dependency graphs of packages with stable keywords are tested, they +are tested separately for ``arch`` and ``~arch`` systems. -Which profiles of the architecture are tested is still controlled -by profiles.desc (and ``-d`` / ``-e`` switches). +Stable architectures are listed first in keyword-relevant contexts (``eshowkw``, +Bugzilla) and developers are expected to file stabilization requests on these +arches. This is the current behaviour and shall be the default if nothing is specified for an architecture. transitional ~~~~~~~~~~~~ -When a profile of an architecture is tested, then repoman treats ``arch`` -in ebuilds as ``~arch``, and tests consistency only for ``~arch``. +Transitional means that the architecture does not maintain a consistent stable +dependency graph but uses stable keywords on some packages. When dependency +graphs of packages with stable keywords are tested, they are tested only +for ``~arch`` systems, i.e. stable keywords are ignored. -Which profiles of the arch are tested is still controlled by profiles.desc -(and ``-d`` / ``-e`` switches). +Transitional architectures are generally listed after stable architectures, +possibly mixed with testing. Developers are expected to file stabilization +requests. -A new switch for repoman may be provided to temporarily upgrade +A new switch for linting tools may be provided to temporarily upgrade an architecture from ``transitional`` to ``stable`` status (for architecture team work). testing ~~~~~~~ -When a profile of an architecture is tested, then repoman treats ``arch`` -as an error and aborts. Consistency is only tested for ``~arch``. - -Which profiles of the arch are tested is still controlled by profiles.desc -(and ``-d`` / ``-e`` switches). - -Meaning of the values for other tools -------------------------------------- - -All architectures with the value ``stable`` are considered as stable -architectures, in the sense that - -- they require stabilization requests on bugzilla, which are handled - by an arch team -- they may, e.g., be listed first by tools such as eshowkw -- and similar, to the discretion of tool authors +Testing means that the architecture does not use stable keywords at all. +Presence of such keywords is considered an error. Consistency is tested +only for ``~arch``. Backwards Compatibility |