Changeset View
Changeset View
Standalone View
Standalone View
src/KexiVersion.h.cmake
1 | /* This file is part of the KDE project | 1 | /* This file is part of the KDE project | ||
---|---|---|---|---|---|
2 | Copyright (c) 2003-2016 Kexi Team <kexi@kde.org> | 2 | Copyright (c) 2003-2016 KEXI Team <kexi@kde.org> | ||
3 | 3 | | |||
4 | Version information based on calligraversion.h, | 4 | Version information based on calligraversion.h, | ||
5 | Copyright (c) 2003 David Faure <faure@kde.org> | 5 | Copyright (c) 2003 David Faure <faure@kde.org> | ||
6 | Copyright (c) 2003 Lukas Tinkl <lukas@kde.org> | 6 | Copyright (c) 2003 Lukas Tinkl <lukas@kde.org> | ||
7 | Copyright (c) 2004 Nicolas Goutte <goutte@kde.org> | 7 | Copyright (c) 2004 Nicolas Goutte <goutte@kde.org> | ||
8 | 8 | | |||
9 | This library is free software; you can redistribute it and/or | 9 | This library is free software; you can redistribute it and/or | ||
10 | modify it under the terms of the GNU Library General Public | 10 | modify it under the terms of the GNU Library General Public | ||
Show All 15 Lines | |||||
26 | #define KEXIVERSION_H | 26 | #define KEXIVERSION_H | ||
27 | 27 | | |||
28 | #include <core/kexicore_export.h> | 28 | #include <core/kexicore_export.h> | ||
29 | 29 | | |||
30 | // -- WARNING: do not edit values below, instead edit constants in SetKexiVersionInfo.cmake | 30 | // -- WARNING: do not edit values below, instead edit constants in SetKexiVersionInfo.cmake | ||
31 | 31 | | |||
32 | class QString; | 32 | class QString; | ||
33 | 33 | | |||
34 | #define KEXI_APP_NAME "Kexi" | | |||
35 | | ||||
36 | /** | 34 | /** | ||
37 | * @def KEXI_VERSION_STRING | 35 | * @def KEXI_VERSION_STRING | ||
38 | * @ingroup KexiMacros | 36 | * @ingroup KexiMacros | ||
39 | * @brief Version of Kexi as string, at compile time | 37 | * @brief Version of KEXI as string, at compile time | ||
40 | * | 38 | * | ||
41 | * This macro contains the Kexi version in string form. As it is a macro, | 39 | * This macro contains the KEXI version in string form. As it is a macro, | ||
42 | * it contains the version at compile time. See Kexi::versionString() if you need | 40 | * it contains the version at compile time. See Kexi::versionString() if you need | ||
43 | * a version used at runtime. | 41 | * a version used at runtime. | ||
44 | * | 42 | * | ||
45 | * @note The version string might contain spaces and special characters, | 43 | * @note The version string might contain spaces and special characters, | ||
46 | * especially for development versions of Kexi. | 44 | * especially for development versions of KEXI. | ||
47 | * If you use that macro directly for a file format (e.g. OASIS Open Document) | 45 | * If you use that macro directly for a file format (e.g. OASIS Open Document) | ||
48 | * or for a protocol (e.g. http) be careful that it is appropriate. | 46 | * or for a protocol (e.g. http) be careful that it is appropriate. | ||
49 | * (Fictional) example: "3.0 Alpha" | 47 | * (Fictional) example: "3.0 Alpha" | ||
50 | */ | 48 | */ | ||
51 | #define KEXI_VERSION_STRING "@PROJECT_VERSION_STRING@" | 49 | #define KEXI_VERSION_STRING "@PROJECT_VERSION_STRING@" | ||
52 | 50 | | |||
53 | /** | 51 | /** | ||
54 | * @def KEXI_VERSION_MAJOR_MINOR_RELEASE | 52 | * @def KEXI_VERSION_MAJOR_MINOR_RELEASE | ||
55 | * @ingroup KexiMacros | 53 | * @ingroup KexiMacros | ||
56 | * @brief Version string containing "major.minor.release" | 54 | * @brief Version string containing "major.minor.release" | ||
57 | * @brief Version of Kexi as string, at compile time | 55 | * @brief Version of KEXI as string, at compile time | ||
58 | * | 56 | * | ||
59 | * This macro contains the Kexi version in string form. As it is a macro, | 57 | * This macro contains the KEXI version in string form. As it is a macro, | ||
60 | * it contains the version at compile time. | 58 | * it contains the version at compile time. | ||
61 | * | 59 | * | ||
62 | * @note The version string never contains spaces or special characters. | 60 | * @note The version string never contains spaces or special characters. | ||
63 | */ | 61 | */ | ||
64 | #define KEXI_VERSION_MAJOR_MINOR_RELEASE "@PROJECT_VERSION_MAJOR@.@PROJECT_VERSION_MINOR@.@PROJECT_VERSION_RELEASE@" | 62 | #define KEXI_VERSION_MAJOR_MINOR_RELEASE "@PROJECT_VERSION_MAJOR@.@PROJECT_VERSION_MINOR@.@PROJECT_VERSION_RELEASE@" | ||
65 | 63 | | |||
66 | /** | 64 | /** | ||
67 | * @def KEXI_STABLE_VERSION_MAJOR | 65 | * @def KEXI_STABLE_VERSION_MAJOR | ||
68 | * @ingroup KexiMacros | 66 | * @ingroup KexiMacros | ||
69 | * @brief Major version of stable Kexi, at compile time | 67 | * @brief Major version of stable KEXI, at compile time | ||
70 | * KEXI_VERSION_MAJOR is computed based on this value. | 68 | * KEXI_VERSION_MAJOR is computed based on this value. | ||
71 | */ | 69 | */ | ||
72 | #define KEXI_STABLE_VERSION_MAJOR @PROJECT_STABLE_VERSION_MAJOR@ | 70 | #define KEXI_STABLE_VERSION_MAJOR @PROJECT_STABLE_VERSION_MAJOR@ | ||
73 | 71 | | |||
74 | /** | 72 | /** | ||
75 | * @def KEXI_VERSION_MAJOR | 73 | * @def KEXI_VERSION_MAJOR | ||
76 | * @ingroup KexiMacros | 74 | * @ingroup KexiMacros | ||
77 | * @brief Major version of Kexi, at compile time | 75 | * @brief Major version of KEXI, at compile time | ||
78 | * | 76 | * | ||
79 | * Generally it's the same as KEXI_STABLE_VERSION_MAJOR but for unstable x.0 | 77 | * Generally it's the same as KEXI_STABLE_VERSION_MAJOR but for unstable x.0 | ||
80 | * x is decreased by one, e.g. 3.0 Beta is 2.99. | 78 | * x is decreased by one, e.g. 3.0 Beta is 2.99. | ||
81 | */ | 79 | */ | ||
82 | #define KEXI_VERSION_MAJOR @PROJECT_VERSION_MAJOR@ | 80 | #define KEXI_VERSION_MAJOR @PROJECT_VERSION_MAJOR@ | ||
83 | 81 | | |||
84 | /** | 82 | /** | ||
85 | * @def KEXI_STABLE_VERSION_MINOR | 83 | * @def KEXI_STABLE_VERSION_MINOR | ||
86 | * @ingroup KexiMacros | 84 | * @ingroup KexiMacros | ||
87 | * @brief Minor version of stable Kexi, at compile time | 85 | * @brief Minor version of stable KEXI, at compile time | ||
88 | * KEXI_VERSION_MINOR is computed based on this value. | 86 | * KEXI_VERSION_MINOR is computed based on this value. | ||
89 | */ | 87 | */ | ||
90 | #define KEXI_STABLE_VERSION_MINOR @PROJECT_STABLE_VERSION_MINOR@ | 88 | #define KEXI_STABLE_VERSION_MINOR @PROJECT_STABLE_VERSION_MINOR@ | ||
91 | 89 | | |||
92 | /** | 90 | /** | ||
93 | * @def KEXI_VERSION_MINOR | 91 | * @def KEXI_VERSION_MINOR | ||
94 | * @ingroup KexiMacros | 92 | * @ingroup KexiMacros | ||
95 | * @brief Minor version of Kexi, at compile time | 93 | * @brief Minor version of KEXI, at compile time | ||
96 | * | 94 | * | ||
97 | * Generally it's equal to KEXI_STABLE_VERSION_MINOR for stable releases, | 95 | * Generally it's equal to KEXI_STABLE_VERSION_MINOR for stable releases, | ||
98 | * equal to 99 for x.0 unstable releases (e.g. it's 3.0 Beta has minor version 99), | 96 | * equal to 99 for x.0 unstable releases (e.g. it's 3.0 Beta has minor version 99), | ||
99 | * and equal to KEXI_STABLE_VERSION_MINOR-1 for unstable releases other than x.0. | 97 | * and equal to KEXI_STABLE_VERSION_MINOR-1 for unstable releases other than x.0. | ||
100 | */ | 98 | */ | ||
101 | #define KEXI_VERSION_MINOR @PROJECT_VERSION_MINOR@ | 99 | #define KEXI_VERSION_MINOR @PROJECT_VERSION_MINOR@ | ||
102 | 100 | | |||
103 | /** | 101 | /** | ||
104 | * @def KEXI_VERSION_RELEASE | 102 | * @def KEXI_VERSION_RELEASE | ||
105 | * @ingroup KexiMacros | 103 | * @ingroup KexiMacros | ||
106 | * @brief Release version of Kexi, at compile time. | 104 | * @brief Release version of KEXI, at compile time. | ||
107 | * 89 for Alpha. | 105 | * 89 for Alpha. | ||
108 | */ | 106 | */ | ||
109 | #define KEXI_VERSION_RELEASE @PROJECT_VERSION_RELEASE@ | 107 | #define KEXI_VERSION_RELEASE @PROJECT_VERSION_RELEASE@ | ||
110 | 108 | | |||
111 | /** | 109 | /** | ||
112 | * @def KEXI_STABLE_VERSION_RELEASE | 110 | * @def KEXI_STABLE_VERSION_RELEASE | ||
113 | * @ingroup KexiMacros | 111 | * @ingroup KexiMacros | ||
114 | * @brief Release version of Kexi, at compile time. | 112 | * @brief Release version of KEXI, at compile time. | ||
115 | * | 113 | * | ||
116 | * Equal to KEXI_VERSION_RELEASE for stable releases and 0 for unstable ones. | 114 | * Equal to KEXI_VERSION_RELEASE for stable releases and 0 for unstable ones. | ||
117 | */ | 115 | */ | ||
118 | #define KEXI_STABLE_VERSION_RELEASE @PROJECT_STABLE_VERSION_RELEASE@ | 116 | #define KEXI_STABLE_VERSION_RELEASE @PROJECT_STABLE_VERSION_RELEASE@ | ||
119 | 117 | | |||
120 | /** | 118 | /** | ||
121 | * @def KEXI_ALPHA | 119 | * @def KEXI_ALPHA | ||
122 | * @ingroup KexiMacros | 120 | * @ingroup KexiMacros | ||
123 | * @brief If defined (1..9), indicates at compile time that Kexi is in alpha stage | 121 | * @brief If defined (1..9), indicates at compile time that KEXI is in alpha stage | ||
124 | */ | 122 | */ | ||
125 | #cmakedefine KEXI_ALPHA @KEXI_ALPHA@ | 123 | #cmakedefine KEXI_ALPHA @KEXI_ALPHA@ | ||
126 | 124 | | |||
127 | /** | 125 | /** | ||
128 | * @def KEXI_BETA | 126 | * @def KEXI_BETA | ||
129 | * @ingroup KexiMacros | 127 | * @ingroup KexiMacros | ||
130 | * @brief If defined (1..9), indicates at compile time that Kexi is in beta stage | 128 | * @brief If defined (1..9), indicates at compile time that KEXI is in beta stage | ||
131 | */ | 129 | */ | ||
132 | #cmakedefine KEXI_BETA @KEXI_BETA@ | 130 | #cmakedefine KEXI_BETA @KEXI_BETA@ | ||
133 | 131 | | |||
134 | /** | 132 | /** | ||
135 | * @def KEXI_RC | 133 | * @def KEXI_RC | ||
136 | * @ingroup KexiMacros | 134 | * @ingroup KexiMacros | ||
137 | * @brief If defined (1..9), indicates at compile time that Kexi is in "release candidate" stage | 135 | * @brief If defined (1..9), indicates at compile time that KEXI is in "release candidate" stage | ||
138 | */ | 136 | */ | ||
139 | #cmakedefine KEXI_RC @KEXI_RC@ | 137 | #cmakedefine KEXI_RC @KEXI_RC@ | ||
140 | 138 | | |||
141 | /** | 139 | /** | ||
142 | * @def KEXI_STABLE | 140 | * @def KEXI_STABLE | ||
143 | * @ingroup KexiMacros | 141 | * @ingroup KexiMacros | ||
144 | * @brief If defined, indicates at compile time that Kexi is in stable stage | 142 | * @brief If defined, indicates at compile time that KEXI is in stable stage | ||
145 | */ | 143 | */ | ||
146 | #cmakedefine KEXI_STABLE @KEXI_STABLE@ | 144 | #cmakedefine KEXI_STABLE @KEXI_STABLE@ | ||
147 | 145 | | |||
148 | /** | 146 | /** | ||
149 | * @ingroup KexiMacros | 147 | * @ingroup KexiMacros | ||
150 | * @brief Make a number from the major, minor and release number of a Kexi version | 148 | * @brief Make a number from the major, minor and release number of a KEXI version | ||
151 | * | 149 | * | ||
152 | * This function can be used for preprocessing when KEXI_IS_VERSION is not | 150 | * This function can be used for preprocessing when KEXI_IS_VERSION is not | ||
153 | * appropriate. | 151 | * appropriate. | ||
154 | */ | 152 | */ | ||
155 | #define KEXI_MAKE_VERSION( a,b,c ) (((a) << 16) | ((b) << 8) | (c)) | 153 | #define KEXI_MAKE_VERSION( a,b,c ) (((a) << 16) | ((b) << 8) | (c)) | ||
156 | 154 | | |||
157 | /** | 155 | /** | ||
158 | * @ingroup KexiMacros | 156 | * @ingroup KexiMacros | ||
159 | * @brief Version of Kexi as number, at compile time | 157 | * @brief Version of KEXI as number, at compile time | ||
160 | * | 158 | * | ||
161 | * This macro contains the Kexi version in number form. As it is a macro, | 159 | * This macro contains the KEXI version in number form. As it is a macro, | ||
162 | * it contains the version at compile time. See version() if you need | 160 | * it contains the version at compile time. See version() if you need | ||
163 | * the Kexi version used at runtime. | 161 | * the KEXI version used at runtime. | ||
164 | */ | 162 | */ | ||
165 | #define KEXI_VERSION \ | 163 | #define KEXI_VERSION \ | ||
166 | KEXI_MAKE_VERSION(KEXI_VERSION_MAJOR,KEXI_VERSION_MINOR,KEXI_VERSION_RELEASE) | 164 | KEXI_MAKE_VERSION(KEXI_VERSION_MAJOR,KEXI_VERSION_MINOR,KEXI_VERSION_RELEASE) | ||
167 | 165 | | |||
168 | /** | 166 | /** | ||
169 | * @ingroup KexiMacros | 167 | * @ingroup KexiMacros | ||
170 | * @brief Check if the Kexi version matches a certain version or is higher | 168 | * @brief Check if the KEXI version matches a certain version or is higher | ||
171 | * | 169 | * | ||
172 | * This macro is typically used to compile conditionally a part of code: | 170 | * This macro is typically used to compile conditionally a part of code: | ||
173 | * @code | 171 | * @code | ||
174 | * #if KEXI_IS_VERSION(2,3,0) | 172 | * #if KEXI_IS_VERSION(2,3,0) | ||
175 | * // Code for Kexi 2.3.0 | 173 | * // Code for KEXI 2.3.0 | ||
176 | * #else | 174 | * #else | ||
177 | * // Code for older Kexi | 175 | * // Code for older KEXI | ||
178 | * #endif | 176 | * #endif | ||
179 | * @endcode | 177 | * @endcode | ||
180 | * | 178 | * | ||
181 | * @warning Especially during development phases of Kexi, be careful | 179 | * @warning Especially during development phases of KEXI, be careful | ||
182 | * when choosing the version number that you are checking against. | 180 | * when choosing the version number that you are checking against. | ||
183 | * Otherwise you might risk to break the next Kexi release. | 181 | * Otherwise you might risk to break the next KEXI release. | ||
184 | * Therefore be careful that development version have a | 182 | * Therefore be careful that development version have a | ||
185 | * version number lower than the released version, so do not check | 183 | * version number lower than the released version, so do not check | ||
186 | * e.g. for Kexi 4.3 with KEXI_IS_VERSION(4,3,0) | 184 | * e.g. for KEXI 4.3 with KEXI_IS_VERSION(4,3,0) | ||
187 | * but with the actual version number at a time a needed feature was introduced, e.g. 4.3.2. | 185 | * but with the actual version number at a time a needed feature was introduced, e.g. 4.3.2. | ||
188 | */ | 186 | */ | ||
189 | #define KEXI_IS_VERSION(a,b,c) ( KEXI_VERSION >= KEXI_MAKE_VERSION(a,b,c) ) | 187 | #define KEXI_IS_VERSION(a,b,c) ( KEXI_VERSION >= KEXI_MAKE_VERSION(a,b,c) ) | ||
190 | 188 | | |||
191 | /** | 189 | /** | ||
192 | * @def KEXI_YEAR | 190 | * @def KEXI_YEAR | ||
193 | * @ingroup KexiMacros | 191 | * @ingroup KexiMacros | ||
194 | * @brief Year of the Kexi release, set at compile time | 192 | * @brief Year of the KEXI release, set at compile time | ||
195 | * | 193 | * | ||
196 | * This macro is used in "About application" dialog for strings such as "© 2012-..., The Author Team". | 194 | * This macro is used in "About application" dialog for strings such as "© 2012-..., The Author Team". | ||
197 | */ | 195 | */ | ||
198 | #cmakedefine KEXI_YEAR "@KEXI_YEAR@" | 196 | #cmakedefine KEXI_YEAR "@KEXI_YEAR@" | ||
199 | 197 | | |||
200 | /** | 198 | /** | ||
201 | * @def KEXI_GIT_SHA1_STRING | 199 | * @def KEXI_GIT_SHA1_STRING | ||
202 | * @ingroup KexiMacros | 200 | * @ingroup KexiMacros | ||
203 | * @brief Indicates the git sha1 commit which was used for compilation of Kexi | 201 | * @brief Indicates the git sha1 commit which was used for compilation of KEXI | ||
204 | */ | 202 | */ | ||
205 | #cmakedefine KEXI_GIT_SHA1_STRING "@KEXI_GIT_SHA1_STRING@" | 203 | #cmakedefine KEXI_GIT_SHA1_STRING "@KEXI_GIT_SHA1_STRING@" | ||
206 | 204 | | |||
207 | /** | 205 | /** | ||
208 | * @def KEXI_GIT_BRANCH_STRING | 206 | * @def KEXI_GIT_BRANCH_STRING | ||
209 | * @ingroup KexiMacros | 207 | * @ingroup KexiMacros | ||
210 | * @brief Indicates the git branch name which was used for compilation of Kexi | 208 | * @brief Indicates the git branch name which was used for compilation of KEXI | ||
211 | */ | 209 | */ | ||
212 | #cmakedefine KEXI_GIT_BRANCH_STRING "@KEXI_GIT_BRANCH_STRING@" | 210 | #cmakedefine KEXI_GIT_BRANCH_STRING "@KEXI_GIT_BRANCH_STRING@" | ||
213 | 211 | | |||
214 | /** | 212 | /** | ||
215 | * @def KEXI_DISTRIBUTION_VERSION | 213 | * @def KEXI_DISTRIBUTION_VERSION | ||
216 | * @ingroup KexiMacros | 214 | * @ingroup KexiMacros | ||
217 | * @brief Name of Kexi version useful to construct co-installabile releases | 215 | * @brief Name of KEXI version useful to construct co-installabile releases | ||
218 | * By default is it equal to KEXI_STABLE_VERSION_MAJOR.KEXI_STABLE_VERSION_MINOR. | 216 | * By default is it equal to KEXI_STABLE_VERSION_MAJOR.KEXI_STABLE_VERSION_MINOR. | ||
219 | * It can be changed at configure stage by setting the KEXI_CUSTOM_DISTRIBUTION_VERSION | 217 | * It can be changed at configure stage by setting the KEXI_CUSTOM_DISTRIBUTION_VERSION | ||
220 | * CMake variable. | 218 | * CMake variable. | ||
221 | * @see KEXI_BASE_PATH | 219 | * @see KEXI_BASE_PATH | ||
222 | */ | 220 | */ | ||
223 | #cmakedefine KEXI_DISTRIBUTION_VERSION "@KEXI_DISTRIBUTION_VERSION@" | 221 | #cmakedefine KEXI_DISTRIBUTION_VERSION "@KEXI_DISTRIBUTION_VERSION@" | ||
224 | 222 | | |||
225 | /** | 223 | /** | ||
226 | * @def KEXI_BASE_PATH | 224 | * @def KEXI_BASE_PATH | ||
227 | * @ingroup KexiMacros | 225 | * @ingroup KexiMacros | ||
228 | * @brief Relative path name useful to construct co-installabile file names and paths | 226 | * @brief Relative path name useful to construct co-installabile file names and paths | ||
229 | * It is equal to "kexi/N" where N is KEXI_DISTRIBUTION_VERSION. | 227 | * It is equal to "kexi/N" where N is KEXI_DISTRIBUTION_VERSION. | ||
230 | */ | 228 | */ | ||
231 | #cmakedefine KEXI_BASE_PATH "@KEXI_BASE_PATH@" | 229 | #cmakedefine KEXI_BASE_PATH "@KEXI_BASE_PATH@" | ||
232 | 230 | | |||
233 | /** | 231 | /** | ||
234 | * Namespace for general Kexi functions. | 232 | * Namespace for general KEXI functions. | ||
235 | */ | 233 | */ | ||
236 | namespace Kexi | 234 | namespace Kexi | ||
237 | { | 235 | { | ||
238 | /** | 236 | /** | ||
239 | * Returns the encoded number of Kexi's version, see the KEXI_VERSION macro. | 237 | * Returns the encoded number of KEXI version, see the KEXI_VERSION macro. | ||
240 | * In contrary to that macro this function returns the number of the actually | 238 | * In contrary to that macro this function returns the number of the actually | ||
241 | * installed Kexi version, not the number of the Kexi version that was | 239 | * installed KEXI version, not the number of the KEXI version that was | ||
242 | * installed when the program was compiled. | 240 | * installed when the program was compiled. | ||
243 | * @return the version number, encoded in a single int | 241 | * @return the version number, encoded in a single int | ||
244 | */ | 242 | */ | ||
245 | KEXICORE_EXPORT unsigned int version(); | 243 | KEXICORE_EXPORT unsigned int version(); | ||
246 | /** | 244 | /** | ||
247 | * Returns the major number of Kexi's version, e.g. | 245 | * Returns the major number of KEXI version, e.g. | ||
248 | * 1 for Kexi 1.2.3. | 246 | * 1 for KEXI 1.2.3. | ||
249 | * @return the major version number | 247 | * @return the major version number | ||
250 | */ | 248 | */ | ||
251 | KEXICORE_EXPORT unsigned int versionMajor(); | 249 | KEXICORE_EXPORT unsigned int versionMajor(); | ||
252 | /** | 250 | /** | ||
253 | * Returns the minor number of Kexi's version, e.g. | 251 | * Returns the minor number of KEXI version, e.g. | ||
254 | * 2 for Kexi 1.2.3. | 252 | * 2 for KEXI 1.2.3. | ||
255 | * @return the minor version number | 253 | * @return the minor version number | ||
256 | */ | 254 | */ | ||
257 | KEXICORE_EXPORT unsigned int versionMinor(); | 255 | KEXICORE_EXPORT unsigned int versionMinor(); | ||
258 | /** | 256 | /** | ||
259 | * Returns the release of Kexi's version, e.g. | 257 | * Returns the release of KEXI version, e.g. | ||
260 | * 3 for Kexi 1.2.3. | 258 | * 3 for KEXI 1.2.3. | ||
261 | * @return the release number | 259 | * @return the release number | ||
262 | */ | 260 | */ | ||
263 | KEXICORE_EXPORT unsigned int versionRelease(); | 261 | KEXICORE_EXPORT unsigned int versionRelease(); | ||
264 | /** | 262 | /** | ||
265 | * Returns the Kexi version as string, e.g. "1.2.3" | 263 | * Returns the KEXI version as string, e.g. "1.2.3" | ||
266 | * Sometimes it may be even something like "1.2.3 beta 2" | 264 | * Sometimes it may be even something like "1.2.3 beta 2" | ||
267 | * @return the Kexi version. You can keep the string forever | 265 | * @return the KEXI version. You can keep the string forever | ||
268 | */ | 266 | */ | ||
269 | KEXICORE_EXPORT const char *versionString(); | 267 | KEXICORE_EXPORT const char *versionString(); | ||
270 | /** | 268 | /** | ||
271 | * @return the Kexi version string (versionString()) but appends extra information | 269 | * @return the KEXI version string (versionString()) but appends extra information | ||
272 | * such as "(git 4e06281 master)" if available. | 270 | * such as "(git 4e06281 master)" if available. | ||
273 | */ | 271 | */ | ||
274 | KEXICORE_EXPORT const char *fullVersionString(); | 272 | KEXICORE_EXPORT const char *fullVersionString(); | ||
275 | /** | 273 | /** | ||
276 | * Returns the encoded number of stable Kexi's version. | 274 | * Returns the encoded number of stable KEXI version. | ||
277 | * For 2.3.1 it returns 2.3.1, for 2.5.70 returns 2.6.0, for 2.9.70 returns 3.0.0. | 275 | * For 2.3.1 it returns 2.3.1, for 2.5.70 returns 2.6.0, for 2.9.70 returns 3.0.0. | ||
278 | * In contrary to KEXI_STABLE_VERSION macro this function returns the number | 276 | * In contrary to KEXI_STABLE_VERSION macro this function returns the number | ||
279 | * of the actually installed Kexi version, not the number of the Kexi version that was | 277 | * of the actually installed KEXI version, not the number of the KEXI version that was | ||
280 | * installed when the program was compiled. | 278 | * installed when the program was compiled. | ||
281 | * @return the version number, encoded in a single int | 279 | * @return the version number, encoded in a single int | ||
282 | * @see Kexi::version() | 280 | * @see Kexi::version() | ||
283 | * @see KEXI_STABLE_VERSION | 281 | * @see KEXI_STABLE_VERSION | ||
284 | */ | 282 | */ | ||
285 | KEXICORE_EXPORT unsigned int stableVersion(); | 283 | KEXICORE_EXPORT unsigned int stableVersion(); | ||
286 | /** | 284 | /** | ||
287 | * Returns the major number of stable Kexi's version, e.g. | 285 | * Returns the major number of stable KEXI version, e.g. | ||
288 | * 1 for Kexi 1.2.3. | 286 | * 1 for KEXI 1.2.3. | ||
289 | * @return the major stable version number | 287 | * @return the major stable version number | ||
290 | */ | 288 | */ | ||
291 | KEXICORE_EXPORT unsigned int stableVersionMajor(); | 289 | KEXICORE_EXPORT unsigned int stableVersionMajor(); | ||
292 | /** | 290 | /** | ||
293 | * Returns the minor number of stable Kexi's version, e.g. | 291 | * Returns the minor number of stable KEXI version, e.g. | ||
294 | * 2 for Kexi 1.2.3. | 292 | * 2 for KEXI 1.2.3. | ||
295 | * @return the minor stable version number | 293 | * @return the minor stable version number | ||
296 | */ | 294 | */ | ||
297 | KEXICORE_EXPORT unsigned int stableVersionMinor(); | 295 | KEXICORE_EXPORT unsigned int stableVersionMinor(); | ||
298 | /** | 296 | /** | ||
299 | * Returns the release of stable Kexi's version, e.g. | 297 | * Returns the release of stable KEXI version, e.g. | ||
300 | * 3 for Kexi 1.2.3. | 298 | * 3 for KEXI 1.2.3. | ||
301 | * @return the release stable version number | 299 | * @return the release stable version number | ||
302 | */ | 300 | */ | ||
303 | KEXICORE_EXPORT unsigned int stableVersionRelease(); | 301 | KEXICORE_EXPORT unsigned int stableVersionRelease(); | ||
304 | /** | 302 | /** | ||
305 | * Returns the stable Kexi version as string, e.g. "1.2.3" | 303 | * Returns the stable KEXI version as string, e.g. "1.2.3" | ||
306 | * It never contains alpha, beta or rc part. | 304 | * It never contains alpha, beta or rc part. | ||
307 | * @return the stable Kexi version. | 305 | * @return the stable KEXI version. | ||
308 | */ | 306 | */ | ||
309 | KEXICORE_EXPORT QString stableVersionString(); | 307 | KEXICORE_EXPORT QString stableVersionString(); | ||
310 | } | 308 | } | ||
311 | 309 | | |||
312 | #endif | 310 | #endif |