[PATCH libinput 5/6] doc: document the base structures so they show up in doxygen
Peter Hutterer
peter.hutterer at who-t.net
Tue Dec 9 16:34:03 PST 2014
Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
---
src/libinput.h | 34 ++++++++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
diff --git a/src/libinput.h b/src/libinput.h
index d6e0446..7e5d93c 100644
--- a/src/libinput.h
+++ b/src/libinput.h
@@ -302,8 +302,31 @@ enum libinput_event_type {
LIBINPUT_EVENT_TOUCH_FRAME
};
+/**
+ * @ingroup base
+ * @struct libinput
+ *
+ * The base handle for accessing libinput. This struct is refcounted, use
+ * libinput_ref() and libinput_unref().
+ */
struct libinput;
+
+/**
+ * @ingroup device
+ * @struct libinput_device
+ *
+ * The base handle for accessing libinput devices. This struct is
+ * refcounted, use libinput_device_ref() and libinput_device_unref().
+ */
struct libinput_device;
+
+/**
+ * @ingroup seat
+ * @struct libinput_seat
+ *
+ * The base handle for accessing libinput seats. This struct is
+ * refcounted, use libinput_seat_ref() and libinput_seat_unref().
+ */
struct libinput_seat;
/**
@@ -919,6 +942,17 @@ libinput_event_touch_get_base_event(struct libinput_event_touch *event);
* @defgroup base Initialization and manipulation of libinput contexts
*/
+/**
+ * @ingroup base
+ * @struct libinput_interface
+ *
+ * libinput does not open file descriptors to devices directly, instead
+ * open_restricted() and close_restricted() are called for each path that
+ * must be opened.
+ *
+ * @see libinput_udev_create_context
+ * @see libinput_path_create_context
+ */
struct libinput_interface {
/**
* Open the device at the given path with the flags provided and
--
2.1.0
More information about the wayland-devel
mailing list