wlseeds/include/wlr/interfaces/wlr_input_device.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_INPUT_DEVICE_H
#define WLR_INTERFACES_WLR_INPUT_DEVICE_H

#include <wlr/types/wlr_input_device.h>

struct wlr_input_device_impl {
	void (*destroy)(struct wlr_input_device *wlr_device);
};

void wlr_input_device_init(struct wlr_input_device *wlr_device,
	enum wlr_input_device_type type, const struct wlr_input_device_impl *impl,
	const char *name);

/**
 * Cleans up all of the provided wlr_input_device resources and signals the
 * destroy event.
 */
void wlr_input_device_finish(struct wlr_input_device *wlr_device);

/**
 * Calls the specialized input device destroy function.
 * If the wlr_input_device is not owned by a specialized input device, the
 * function will finish the wlr_input_device, and either call its implementation
 * destroy function if one has been given, or free the wlr_input_device.
 */
void wlr_input_device_destroy(struct wlr_input_device *dev);

#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_INPUT_DEVICE_H`
			`#define WLR_INTERFACES_WLR_INPUT_DEVICE_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_input_device.h>`

			`struct wlr_input_device_impl {`
Refactor out wlr_input_device_state 7 years ago			`void (destroy)(struct wlr_input_device wlr_device);`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 8 years ago			`};`

types/wlr_input_device: default vendor and product id to 0 vendor and product id are set when needed by the libinput backend 3 years ago			`void wlr_input_device_init(struct wlr_input_device *wlr_device,`
			`enum wlr_input_device_type type, const struct wlr_input_device_impl *impl,`
			`const char *name);`
interfaces/wlr_input_device: introduce wlr_input_device_finish This function releases the wlr_input_device allocated memory (it's name and it's output name), and signals its destroy event. 3 years ago
			`/**`
			`* Cleans up all of the provided wlr_input_device resources and signals the`
			`* destroy event.`
			`*/`
			`void wlr_input_device_finish(struct wlr_input_device *wlr_device);`

types/wlr_input_device: call the specialized input device destroy function on destroy In case the `wlr_input_device` is not owned by a specialized input device, the function will finish the wlr_input_device and call it's implementation destroy function if an implementation has been supplied, or simply free it. 3 years ago			`/**`
			`* Calls the specialized input device destroy function.`
			`* If the wlr_input_device is not owned by a specialized input device, the`
			`* function will finish the wlr_input_device, and either call its implementation`
			`* destroy function if one has been given, or free the wlr_input_device.`
			`*/`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 8 years ago			`void wlr_input_device_destroy(struct wlr_input_device *dev);`

			`#endif`