alpha
/
Kaleidoscope
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '9dfe51a238'
${ noResults }
Kaleidoscope/src/kaleidoscope_internal/deprecations.h

51 lines
2.6 KiB
Raw Normal View History Unescape

License clarificataion & copyright headers After talking with Jesse, this changes the license to GPLv3 (only), where appropriate, and adds copyright headers to all files that were missing them. Signed-off-by: Gergely Nagy <algernon@madhouse-project.org>
6 years ago
/* Kaleidoscope - Firmware for computer input devices
LEDControl: Add disable/enable functions, and a toggle key This adds `LEDControl.disable()` and `LEDControl.enable()` which disable and enable LED operations, respectively. These are meant to replace the current `LEDControl.paused` property (which is getting deprecated with this change), and do some additional work on top of just disabling or re-enabling future updates and sync. Namely, `disable()` will also turn LEDs off, while `enable()` will refresh them all, too. We also add a dedicated `Key_LEDToggle` key to disable/enable LEDs. This is useful when one wants to turn LEDs off, without changing active LED mode to `LEDOff`. Signed-off-by: Gergely Nagy <algernon@keyboard.io>
5 years ago
* Copyright (C) 2013-2020 Keyboard.io, Inc.
License clarificataion & copyright headers After talking with Jesse, this changes the license to GPLv3 (only), where appropriate, and adds copyright headers to all files that were missing them. Signed-off-by: Gergely Nagy <algernon@madhouse-project.org>
6 years ago
*
* 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, version 3.
*
* 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, see <http://www.gnu.org/licenses/>.
*/
Move deprecation messages to a separate header Moving the deprecation messages to a separate header, and adding a few helpers allow us to write much more detailed deprecation messages, without needlessly making the code look incredibly messy. This also updates most of the deprecation messages to be much more helpful, and provide hints at how to fix the warnings produced by them. Signed-off-by: Gergely Nagy <algernon@keyboard.io>
7 years ago
#pragma once
#define DEPRECATED(tag) \
__attribute__((deprecated(_DEPRECATE(_DEPRECATED_MESSAGE_ ## tag))))
#define _DEPRECATE(message) "\n" \
"------------------------------------------------------------------------\n" \
message \
"\n" \
"------------------------------------------------------------------------\n" \
/* Messages */
Deprecate named hardware objects Some boards used to provide the device object under an alias named after the device itself. For the sake of consistency, we do not want to provide these aliases in the future. As such, deprecate them, and update all users to use `KeyboardHardware` instead. Signed-off-by: Gergely Nagy <algernon@keyboard.io>
5 years ago
Deprecate the old `kaleidoscope::hid` facade Signed-off-by: Gergely Nagy <algernon@keyboard.io>
5 years ago
#define _DEPRECATED_MESSAGE_HID_FACADE __NL__ \
"The HID facade in the `kaleidoscope::hid` namespace is deprecated.\n" __NL__ \
"Please use `Kaleidoscope.hid()` instead."
Key union converted to a proper class Unions are a C-reminiscense that are better avoided in modern C++. They cause specific problems due to their nature of representing independent types. The way they are used in Kaleidoscope, they can easily be replaced by a class. This enables it to properly work with Key objects in constexpr context where with the old union-based implementation the compiler reported errors when one Key was constructed based on a key_code/flags pair and another one through raw-data. In such a case, the compiler assumes that both Key instances represent something entirely different. This is because unions were never meant for type conversions and the C++ standard considers their use for that purpose as undefined behavior. The new class provides accessor methods for raw-data access and for key_code/flags-data access. This is a breaking change as it is is not possible to replace direct member access patterns like key.raw = 0xFFFF; based on the raw-accessors. For the .keyCode and .flags members, proxy objects are used to enable the generation of suitable deprecations warnings. All direct access via .raw, .keyCode and .flags have been replaced throughout Kaleidoscope. Information on how to upgrade is provided in UPGRADING.md Signed-off-by: Florian Fleissner <florian.fleissner@inpartik.de>
5 years ago
#define _DEPRECATED_MESSAGE_DIRECT_KEY_MEMBER_ACCESS \
"Direct access to `Key` class' data members is deprecated.\n" \
"Please use `Key::setKeyCode()`/`Key::getKeyCode()` or\n" \
"`Key::setFlags()`/`Key::getFlags()` instead.\n" \
"\n" \
"For further information and examples on how to do that, \n" \
"please see UPGRADING.md."
#define _DEPRECATED_MESSAGE_KEY_MEMBER_RAW_ACCESS \
"The member variable `raw` of class Key had to be removed. Please \n" \
"use `Key::setRaw()`/`Key::getRaw()` to set and get raw data.\n" \
"\n" \
"Important: This is not a deprecation. Your code will compile but fail\n" \
" to link until all access to `Key::raw` has been replaced.\n" \
"\n" \
"For further information and examples on how to do that, \n" \
"please see UPGRADING.md."