mirror of
https://github.com/awesomeWM/awesome
synced 2024-11-17 07:47:41 +01:00
ee80fe052f
The API level concept is something used by other projects such as Android and iOS to allow deprecated features to be removed and the bahavior to be altered without breaking compability with existing code. The same will apply to AwesomeWM. The current API level is "4" and as long as config use this, no deprecation or bahavior change will be exposed. If the user sets it to an higher value or we release the next major version and new users start to use the, then current, default config, they will use the new API level. The the far future, if ever, we could fork the entire Lua libraries to support legacy APIs. This would only require to keep the core API support for those legacy calls. In the meantime, `gears.debug` will use this to manage the deprecation and some conditional code will be added as a last resort attempt to preserve behavior compatibility while moving forward with breaking changes.
32 lines
1.2 KiB
C
32 lines
1.2 KiB
C
/*
|
|
* version.h - version message utility functions header
|
|
*
|
|
* Copyright © 2008 Julien Danjou <julien@danjou.info>
|
|
* Copyright © 2008 Hans Ulrich Niedermann <hun@n-dimensional.de>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
|
|
#ifndef AWESOME_COMMON_VERSION_H
|
|
#define AWESOME_COMMON_VERSION_H
|
|
|
|
void eprint_version(void) __attribute__ ((noreturn));
|
|
const char *awesome_version_string(void);
|
|
const char *awesome_release_string(void);
|
|
int awesome_default_api_level(void);
|
|
|
|
#endif
|
|
|
|
// vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80
|