deprecation.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

Deprecations
============


.. index:: EAPI; deprecated

Deprecated EAPIs
----------------
:PG: 1001
:Source: Council
:Reference: https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/layout.conf
:Reported: by pkgcheck and repoman

Deprecated EAPIs should not be used in new ebuilds.  Existing packages
should be migrated to newer EAPIs on version bumps, or proactively when
no version bumps are expected.

The current list of deprecated EAPIs is stored as ``eapis-deprecated``
in ``metadata/layout.conf``.


.. index:: eclass; deprecated

Deprecated eclasses
-------------------
:PG: 1003
:Source: individual eclass maintainers
:Reference: https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf
:Reported: by pkgcheck and repoman

Deprecated eclasses should not be used in new ebuilds.  Existing
packages should be updated not to use these eclasses on version bumps,
or proactively when no version bumps are expected.

Deprecations are indicated using the ``@DEPRECATED`` eclassdoc tag
inside the eclass files.