1 |
commit: a6e07a7839514aa39abb4259d05ef5dc6fb6b7d7 |
2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
3 |
AuthorDate: Wed Feb 26 13:32:15 2020 +0000 |
4 |
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> |
5 |
CommitDate: Mon Mar 2 05:15:24 2020 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=a6e07a78 |
7 |
|
8 |
Cover deprecated EAPIs |
9 |
|
10 |
While this is probably too obvious to require an explicit policy, |
11 |
it makes sense to assign a PG identifier for it. |
12 |
|
13 |
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org> |
14 |
|
15 |
deprecation.rst | 19 +++++++++++++++++++ |
16 |
1 file changed, 19 insertions(+) |
17 |
|
18 |
diff --git a/deprecation.rst b/deprecation.rst |
19 |
new file mode 100644 |
20 |
index 0000000..7264fa1 |
21 |
--- /dev/null |
22 |
+++ b/deprecation.rst |
23 |
@@ -0,0 +1,19 @@ |
24 |
+Deprecations |
25 |
+============ |
26 |
+ |
27 |
+ |
28 |
+.. index:: EAPI; deprecated |
29 |
+ |
30 |
+Deprecated EAPIs |
31 |
+---------------- |
32 |
+:PG: 1001 |
33 |
+:Source: Council |
34 |
+:Reference: https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/layout.conf |
35 |
+:Reported: by pkgcheck and repoman |
36 |
+ |
37 |
+Deprecated EAPIs should not be used in new ebuilds. Existing packages |
38 |
+should be migrated to newer EAPIs on version bumps, or proactively when |
39 |
+no version bumps are expected. |
40 |
+ |
41 |
+The current list of deprecated EAPIs is stored as ``eapis-deprecated`` |
42 |
+in ``metadata/layout.conf``. |