evdev: Add a conditional define guard to expose API

The evdev backend has always been excluded from Clutter's API
stability guarantee though in an informal way. This commit makes it
explicit by forcing users to define CLUTTER_ENABLE_COMPOSITOR_API.

https://bugzilla.gnome.org/show_bug.cgi?id=725102
This commit is contained in:
Rui Matos 2014-02-24 14:22:19 +01:00
parent b9abda52b6
commit 133f95fd0d
2 changed files with 11 additions and 0 deletions

View File

@ -326,6 +326,12 @@ Release Notes for Clutter 1.18
libevdev and libgudev directly, but relies on libinput for discovering,
reading and processing input devices.
• The Clutter evdev input device backend was already considered
experimental and not subject to Clutter's API and ABI stabitility
guarantees. Starting from 1.18, users have to explicitly acknowldge
this by having to #define CLUTTER_ENABLE_COMPOSITOR_API to use its
public API.
Release Notes for Clutter 1.16
-------------------------------------------------------------------------------

View File

@ -31,6 +31,10 @@
G_BEGIN_DECLS
#if !defined(CLUTTER_ENABLE_COMPOSITOR_API) && !defined(CLUTTER_COMPILATION)
#error "You need to define CLUTTER_ENABLE_COMPOSITOR_API before including clutter-evdev.h"
#endif
/**
* ClutterOpenDeviceCallback:
* @path: the device path
@ -81,6 +85,7 @@ void clutter_evdev_set_pointer_constrain_callback (ClutterDeviceManager
void clutter_evdev_set_keyboard_map (ClutterDeviceManager *evdev,
struct xkb_keymap *keymap);
G_END_DECLS
#endif /* __CLUTTER_EVDEV_H__ */