1 |
commit: b68900f597b4e1b2a06bbfe5978e787fddcccc04 |
2 |
Author: Andreas Sturmlechner <asturm <AT> gentoo <DOT> org> |
3 |
AuthorDate: Thu Nov 14 11:11:52 2019 +0000 |
4 |
Commit: Andreas Sturmlechner <asturm <AT> gentoo <DOT> org> |
5 |
CommitDate: Thu Nov 14 11:29:13 2019 +0000 |
6 |
URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=b68900f5 |
7 |
|
8 |
kde5.eclass: Add porting and deprecation notes |
9 |
|
10 |
Signed-off-by: Andreas Sturmlechner <asturm <AT> gentoo.org> |
11 |
|
12 |
eclass/kde5.eclass | 25 ++++++++++++++++++------- |
13 |
1 file changed, 18 insertions(+), 7 deletions(-) |
14 |
|
15 |
diff --git a/eclass/kde5.eclass b/eclass/kde5.eclass |
16 |
index ecc16bdae99..ef45ba420d7 100644 |
17 |
--- a/eclass/kde5.eclass |
18 |
+++ b/eclass/kde5.eclass |
19 |
@@ -7,17 +7,18 @@ |
20 |
# @SUPPORTED_EAPIS: 7 |
21 |
# @BLURB: Support eclass for packages that follow KDE packaging conventions. |
22 |
# @DESCRIPTION: |
23 |
-# This eclass is intended to streamline the creation of ebuilds for packages |
24 |
-# that follow KDE upstream packaging conventions. It's primarily intended for |
25 |
-# the three upstream release groups (Frameworks, Plasma, Applications) but |
26 |
-# is also for any package that follows similar conventions. |
27 |
+# This eclass is *deprecated*. Please read the PORTING notes for switching to |
28 |
+# ecm.eclass in case the package is using extra-cmake-modules, otherwise just |
29 |
+# use cmake-utils.eclass instead. For projects hosted on kde.org infrastructure, |
30 |
+# inherit kde.org.eclass to fetch and unpack sources independent of the build |
31 |
+# system being used. |
32 |
# |
33 |
# This eclass unconditionally inherits kde5-functions.eclass and all its public |
34 |
# functions and variables may be considered as part of this eclass's API. |
35 |
# |
36 |
-# This eclass unconditionally inherits cmake-utils.eclass and all its public |
37 |
-# variables and helper functions (not phase functions) may be considered as part |
38 |
-# of this eclass's API. |
39 |
+# This eclass unconditionally inherits kde.org.eclass and cmake-utils.eclass |
40 |
+# and all their public variables and helper functions (not phase functions) may |
41 |
+# be considered as part of this eclass's API. |
42 |
# |
43 |
# This eclass's phase functions are not intended to be mixed and matched, so if |
44 |
# any phase functions are overridden the version here should also be called. |
45 |
@@ -59,6 +60,7 @@ EXPORT_FUNCTIONS pkg_setup src_prepare src_configure src_compile src_test src_in |
46 |
# For any other value, add dependencies on dev-qt/qtcore:5, kde-frameworks/kf-env |
47 |
# and kde-frameworks/extra-cmake-modules:5. Additionally, required blockers may |
48 |
# be set depending on the value of CATEGORY. |
49 |
+# PORTING: no replacement |
50 |
: ${KDE_AUTODEPS:=true} |
51 |
|
52 |
# @ECLASS-VARIABLE: KDE_DEBUG |
53 |
@@ -66,6 +68,7 @@ EXPORT_FUNCTIONS pkg_setup src_prepare src_configure src_compile src_test src_in |
54 |
# If set to "false", add -DNDEBUG (via cmake-utils_src_configure) and -DQT_NO_DEBUG |
55 |
# to CPPFLAGS. |
56 |
# Otherwise, add debug to IUSE. |
57 |
+# PORTING: ECM_DEBUG in ecm.eclass |
58 |
: ${KDE_DEBUG:=true} |
59 |
|
60 |
# @ECLASS-VARIABLE: KDE_DESIGNERPLUGIN |
61 |
@@ -73,12 +76,14 @@ EXPORT_FUNCTIONS pkg_setup src_prepare src_configure src_compile src_test src_in |
62 |
# If set to "false", do nothing. |
63 |
# Otherwise, add "designer" to IUSE to toggle build of designer plugins |
64 |
# and add the necessary DEPENDs. |
65 |
+# PORTING: ECM_DESIGNERPLUGIN in ecm.eclass |
66 |
: ${KDE_DESIGNERPLUGIN:=false} |
67 |
|
68 |
# @ECLASS-VARIABLE: KDE_EXAMPLES |
69 |
# @DESCRIPTION: |
70 |
# If set to "false", unconditionally ignore a top-level examples subdirectory. |
71 |
# Otherwise, add "examples" to IUSE to toggle adding that subdirectory. |
72 |
+# PORTING: ECM_EXAMPLES in ecm.eclass |
73 |
: ${KDE_EXAMPLES:=false} |
74 |
|
75 |
# @ECLASS-VARIABLE: KDE_HANDBOOK |
76 |
@@ -90,16 +95,19 @@ EXPORT_FUNCTIONS pkg_setup src_prepare src_configure src_compile src_test src_in |
77 |
# when USE=!handbook. In case package requires KF5KDELibs4Support, see next: |
78 |
# If set to "forceoptional", remove a KF5DocTools dependency from the root |
79 |
# CMakeLists.txt in addition to the above. |
80 |
+# PORTING: ECM_HANDBOOK in ecm.eclass |
81 |
: ${KDE_HANDBOOK:=false} |
82 |
|
83 |
# @ECLASS-VARIABLE: KDE_DOC_DIR |
84 |
# @DESCRIPTION: |
85 |
# Specifies the location of the KDE handbook if not the default. |
86 |
+# PORTING: ECM_HANDBOOK_DIR in ecm.eclass |
87 |
: ${KDE_DOC_DIR:=doc} |
88 |
|
89 |
# @ECLASS-VARIABLE: KDE_PO_DIRS |
90 |
# @DESCRIPTION: |
91 |
# Specifies the possible locations of KDE l10n files if not the default. |
92 |
+# PORTING: ECM_PO_DIRS in ecm.eclass |
93 |
: ${KDE_PO_DIRS:="po poqm"} |
94 |
|
95 |
# @ECLASS-VARIABLE: KDE_QTHELP |
96 |
@@ -107,6 +115,7 @@ EXPORT_FUNCTIONS pkg_setup src_prepare src_configure src_compile src_test src_in |
97 |
# If set to "false", do nothing. |
98 |
# Otherwise, add "doc" to IUSE, add the appropriate dependency, generate |
99 |
# and install Qt compressed help files with -DBUILD_QCH=ON when USE=doc. |
100 |
+# PORTING: ECM_QTHELP in ecm.eclass |
101 |
if [[ ${CATEGORY} = kde-frameworks ]]; then |
102 |
: ${KDE_QTHELP:=true} |
103 |
fi |
104 |
@@ -124,6 +133,7 @@ fi |
105 |
# autotest(s), unittest(s) and test(s) subdirs from *any* CMakeLists.txt in ${S} |
106 |
# and below conditional on BUILD_TESTING. This is always meant as a short-term |
107 |
# fix and creates ${T}/${P}-tests-optional.patch to refine and submit upstream. |
108 |
+# PORTING: ECM_TEST in ecm.eclass |
109 |
if [[ ${CATEGORY} = kde-frameworks ]]; then |
110 |
: ${KDE_TEST:=true} |
111 |
fi |
112 |
@@ -322,6 +332,7 @@ kde5_src_prepare() { |
113 |
done |
114 |
fi |
115 |
|
116 |
+ # PORTING: bogus, overzealous 'en' docbook disabling is not carried over |
117 |
if [[ ${KDE_BUILD_TYPE} = release && ${CATEGORY} != kde-apps ]] ; then |
118 |
if [[ ${KDE_HANDBOOK} != false && -d ${KDE_DOC_DIR} && -v LINGUAS ]] ; then |
119 |
pushd ${KDE_DOC_DIR} > /dev/null || die |