[PATCH libinput 01/10] Add an enum for configuration return codes
Peter Hutterer
peter.hutterer at who-t.net
Mon Jun 2 22:34:54 PDT 2014
Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
---
src/libinput.h | 32 ++++++++++++++++++++++++++++++++
1 file changed, 32 insertions(+)
diff --git a/src/libinput.h b/src/libinput.h
index d771e21..c9ec71a 100644
--- a/src/libinput.h
+++ b/src/libinput.h
@@ -1330,6 +1330,38 @@ int
libinput_device_has_capability(struct libinput_device *device,
enum libinput_device_capability capability);
+/**
+ * @defgroup config Device configuration
+ *
+ * Enable, disable and check for device-specific features. For all features,
+ * libinput assigns a default based on the hardware configuration. This
+ * default can be restored with the matching reset function call.
+ *
+ * Some configuration option may be dependent on or mutually exclusive with
+ * with other options. The behavior in those cases is
+ * implementation-defined, the caller must ensure that the options are set
+ * in the right order.
+ */
+
+enum libinput_config_status {
+ LIBINPUT_CONFIG_STATUS_SUCCESS = 0, /**< Config applied successfully */
+ LIBINPUT_CONFIG_STATUS_UNSUPPORTED, /**< Configuration not available on
+ this device */
+ LIBINPUT_CONFIG_STATUS_INVALID, /**< Invalid parameter range */
+};
+
+/**
+ * @ingroup config Device configuration
+ *
+ * Return a string describing the error.
+ *
+ * @param status The status to translate to a string
+ * @return A human-readable string representing the error or NULL for an
+ * invalid status.
+ */
+const char *
+libinput_config_status_to_str(enum libinput_config_status status);
+
#ifdef __cplusplus
}
#endif
--
1.9.0
More information about the wayland-devel
mailing list