summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2016-06-02 13:07:17 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2016-06-22 08:48:01 +1000
commit22b504fc814cb42e6cb518d7b2af6dce1213e145 (patch)
tree7f5676a989553c37f4abc38bed51e149d828958e /src
parenteb9d47a8aea4f0f202359d8e68907556b92b5997 (diff)
doc: split the tablet pad events into their own doxygen module page
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Jason Gerecke <jason.gerecke@wacom.com> Reviewed-by: Carlos Garnacho <carlosg@gnome.org>
Diffstat (limited to 'src')
-rw-r--r--src/libinput.h38
1 files changed, 23 insertions, 15 deletions
diff --git a/src/libinput.h b/src/libinput.h
index ed3eb7d7..dcfa09f7 100644
--- a/src/libinput.h
+++ b/src/libinput.h
@@ -136,7 +136,7 @@ enum libinput_pointer_axis_source {
};
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* The source for a @ref LIBINPUT_EVENT_TABLET_PAD_RING event. See
* libinput_event_tablet_pad_get_ring_source() for details.
@@ -151,7 +151,7 @@ enum libinput_tablet_pad_ring_axis_source {
};
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* The source for a @ref LIBINPUT_EVENT_TABLET_PAD_STRIP event. See
* libinput_event_tablet_pad_get_strip_source() for details.
@@ -502,7 +502,7 @@ struct libinput_event_touch;
struct libinput_event_tablet_tool;
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
* @struct libinput_event_tablet_pad
*
* Tablet pad event representing a button press, or ring/strip update on
@@ -1449,7 +1449,8 @@ libinput_event_gesture_get_angle_delta(struct libinput_event_gesture *event);
/**
* @defgroup event_tablet Tablet events
*
- * Events that come from tools on or the pad of tablet devices.
+ * Events that come from tools on tablet devices. For events from the pad,
+ * see @ref event_tablet_pad.
*
* Events from tablet devices are exposed by two interfaces, tools and pads.
* Tool events originate (usually) from a stylus-like device, pad events
@@ -2212,7 +2213,14 @@ libinput_tablet_tool_set_user_data(struct libinput_tablet_tool *tool,
void *user_data);
/**
- * @ingroup event_tablet
+ * @defgroup event_tablet_pad Tablet pad events
+ *
+ * Events that come from the pad of tablet devices. For events from the
+ * tablet tools, see @ref event_tablet.
+ */
+
+/**
+ * @ingroup event_tablet_pad
*
* @return The generic libinput_event of this event
*/
@@ -2220,7 +2228,7 @@ struct libinput_event *
libinput_event_tablet_pad_get_base_event(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Returns the current position of the ring, in degrees counterclockwise
* from the northern-most point of the ring in the tablet's current logical
@@ -2243,7 +2251,7 @@ double
libinput_event_tablet_pad_get_ring_position(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Returns the number of the ring that has changed state, with 0 being the
* first ring. On tablets with only one ring, this function always returns
@@ -2260,7 +2268,7 @@ unsigned int
libinput_event_tablet_pad_get_ring_number(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Returns the source of the interaction with the ring. If the source is
* @ref LIBINPUT_TABLET_PAD_RING_SOURCE_FINGER, libinput sends a ring
@@ -2277,7 +2285,7 @@ enum libinput_tablet_pad_ring_axis_source
libinput_event_tablet_pad_get_ring_source(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Returns the current position of the strip, normalized to the range
* [0, 1], with 0 being the top/left-most point in the tablet's current
@@ -2300,7 +2308,7 @@ double
libinput_event_tablet_pad_get_strip_position(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Returns the number of the strip that has changed state, with 0 being the
* first strip. On tablets with only one strip, this function always returns
@@ -2317,7 +2325,7 @@ unsigned int
libinput_event_tablet_pad_get_strip_number(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Returns the source of the interaction with the strip. If the source is
* @ref LIBINPUT_TABLET_PAD_STRIP_SOURCE_FINGER, libinput sends a strip
@@ -2334,7 +2342,7 @@ enum libinput_tablet_pad_strip_axis_source
libinput_event_tablet_pad_get_strip_source(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Return the button number that triggered this event, starting at 0.
* For events that are not of type @ref LIBINPUT_EVENT_TABLET_PAD_BUTTON,
@@ -2355,7 +2363,7 @@ uint32_t
libinput_event_tablet_pad_get_button_number(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* Return the button state of the event.
*
@@ -2370,7 +2378,7 @@ enum libinput_button_state
libinput_event_tablet_pad_get_button_state(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* @param event The libinput tablet pad event
* @return The event time for this event
@@ -2379,7 +2387,7 @@ uint32_t
libinput_event_tablet_pad_get_time(struct libinput_event_tablet_pad *event);
/**
- * @ingroup event_tablet
+ * @ingroup event_tablet_pad
*
* @param event The libinput tablet pad event
* @return The event time for this event in microseconds