wlseeds/include/wlr/interfaces/wlr_tablet_pad.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_PAD_H
#define WLR_INTERFACES_WLR_TABLET_PAD_H

#include <wlr/types/wlr_tablet_pad.h>

struct wlr_tablet_pad_impl {
	const char *name;
};

void wlr_tablet_pad_init(struct wlr_tablet_pad *pad,
	const struct wlr_tablet_pad_impl *impl, const char *name);

/**
 * Cleans up the resources owned by a struct wlr_tablet_pad.
 *
 * This function will not clean the memory allocated by
 * struct wlr_tablet_pad_group, it's the responsibility of the caller to clean
 * it.
 */
void wlr_tablet_pad_finish(struct wlr_tablet_pad *pad);

#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 6 years ago			`/*`
			`* 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 7 years ago			`#ifndef WLR_INTERFACES_WLR_TABLET_PAD_H`
			`#define WLR_INTERFACES_WLR_TABLET_PAD_H`

Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 8 years ago			`#include <wlr/types/wlr_tablet_pad.h>`

			`struct wlr_tablet_pad_impl {`
interface/wlr_tablet_pad: rework destroy sequence The destroy callback in wlr_tablet_pad_impl has been removed. The function `wlr_tablet_pad_finish` has been introduced to clean up the resources owned by a wlr_tablet_pad. `wlr_input_device_destroy` no longer destroys the wlr_tablet_pad, attempting to destroy a wlr_tablet_pad will result in a no-op. The field `name` has been added to the wlr_tablet_pad_impl to be able to identify a given wlr_tablet_pad device. 3 years ago			`const char *name;`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 8 years ago			`};`

Refactor out wlr_tablet_pad_state 7 years ago			`void wlr_tablet_pad_init(struct wlr_tablet_pad *pad,`
types/wlr_tablet_pad: constify impl 3 years ago			`const struct wlr_tablet_pad_impl impl, const char name);`
interface/wlr_tablet_pad: rework destroy sequence The destroy callback in wlr_tablet_pad_impl has been removed. The function `wlr_tablet_pad_finish` has been introduced to clean up the resources owned by a wlr_tablet_pad. `wlr_input_device_destroy` no longer destroys the wlr_tablet_pad, attempting to destroy a wlr_tablet_pad will result in a no-op. The field `name` has been added to the wlr_tablet_pad_impl to be able to identify a given wlr_tablet_pad device. 3 years ago
			`/**`
Reformat doc comments Unify the way we document our APIs. See CONTRIBUTING.md for the rules. 3 years ago			`* Cleans up the resources owned by a struct wlr_tablet_pad.`
			`*`
			`* This function will not clean the memory allocated by`
			`* struct wlr_tablet_pad_group, it's the responsibility of the caller to clean`
			`* it.`
interface/wlr_tablet_pad: rework destroy sequence The destroy callback in wlr_tablet_pad_impl has been removed. The function `wlr_tablet_pad_finish` has been introduced to clean up the resources owned by a wlr_tablet_pad. `wlr_input_device_destroy` no longer destroys the wlr_tablet_pad, attempting to destroy a wlr_tablet_pad will result in a no-op. The field `name` has been added to the wlr_tablet_pad_impl to be able to identify a given wlr_tablet_pad device. 3 years ago			`*/`
			`void wlr_tablet_pad_finish(struct wlr_tablet_pad *pad);`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 8 years ago
			`#endif`