wlroots-hyprland/include/wlr/interfaces/wlr_tablet_tool.h

/*
 * This an unstable interface of wlroots. No guarantees are made regarding the
 * future consistency of this API.
 */
#ifndef WLR_USE_UNSTABLE
#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
#endif

#ifndef WLR_INTERFACES_WLR_TABLET_TOOL_H
#define WLR_INTERFACES_WLR_TABLET_TOOL_H

#include <wlr/types/wlr_tablet_tool.h>

struct wlr_tablet_impl {
	void (*destroy)(struct wlr_tablet *tablet);
};

void wlr_tablet_init(struct wlr_tablet *tablet,
		const struct wlr_tablet_impl *impl);
void wlr_tablet_destroy(struct wlr_tablet *tablet);

#endif
Initial pass on API stability guarantees This introduces -DWLR_USE_UNSTABLE and adds information regarding the stability status to all headers. I started with a conservative set of headers to mark as stable: - types/wlr_matrix.h - util/edges.h - util/log.h - util/region.h - xcursor.h 2018-07-13 14:40:56 +02:00			`/*`
			`* This an unstable interface of wlroots. No guarantees are made regarding the`
			`* future consistency of this API.`
			`*/`
			`#ifndef WLR_USE_UNSTABLE`
			`#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"`
			`#endif`

Use more consistent include guard names 2017-09-23 10:26:01 +02:00			`#ifndef WLR_INTERFACES_WLR_TABLET_TOOL_H`
			`#define WLR_INTERFACES_WLR_TABLET_TOOL_H`

Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 2017-06-20 00:41:02 +02:00			`#include <wlr/types/wlr_tablet_tool.h>`

rename wlr_tablet_tool to wlr_tablet The previous naming was based on the input-device capability names from libinput. With code that uses the libinput_tablet_tool and mapping into tablet-v2, this is confusing, so the name is changed to follow the names used in the protocol. 2018-06-16 11:19:48 +02:00			`struct wlr_tablet_impl {`
			`void (destroy)(struct wlr_tablet tablet);`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 2017-06-20 00:41:02 +02:00			`};`

rename wlr_tablet_tool to wlr_tablet The previous naming was based on the input-device capability names from libinput. With code that uses the libinput_tablet_tool and mapping into tablet-v2, this is confusing, so the name is changed to follow the names used in the protocol. 2018-06-16 11:19:48 +02:00			`void wlr_tablet_init(struct wlr_tablet *tablet,`
Make implementation function lists static const This requires a change to the type of `struct wlr_tablet` and `wlr_tablet_init` signature, both of which are part of the unstable API. 2021-02-04 14:57:18 +01:00			`const struct wlr_tablet_impl *impl);`
rename wlr_tablet_tool to wlr_tablet The previous naming was based on the input-device capability names from libinput. With code that uses the libinput_tablet_tool and mapping into tablet-v2, this is confusing, so the name is changed to follow the names used in the protocol. 2018-06-16 11:19:48 +02:00			`void wlr_tablet_destroy(struct wlr_tablet *tablet);`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 2017-06-20 00:41:02 +02:00
			`#endif`