From eeee654031296398c903e3797b434e155948bdac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Corentin=20No=C3=ABl?= Date: Fri, 7 Apr 2023 11:04:32 +0200 Subject: cursor-tracker: Enhance the documentation and increase annotation coverage Add the (optional) parameters when they are actually supported and at least add the minimal documentation on functions. Part-of: --- clutter/clutter/clutter-seat.c | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'clutter/clutter') diff --git a/clutter/clutter/clutter-seat.c b/clutter/clutter/clutter-seat.c index 956907b42..1c057325b 100644 --- a/clutter/clutter/clutter-seat.c +++ b/clutter/clutter/clutter-seat.c @@ -679,6 +679,17 @@ clutter_seat_has_touchscreen (ClutterSeat *seat) return has_touchscreen; } +/** + * clutter_seat_query_state: + * @seat: a #ClutterSeat + * @device: a #ClutterInputDevice + * @sequence: (nullable): a #ClutterEventSequence + * @coords: (out caller-allocates) (optional): the coordinates of the pointer + * @modifiers: (out) (optional): the current #ClutterModifierType of the pointer + * + * Returns: %TRUE if @device (or the specific @sequence) is on the stage, %FALSE + * otherwise. + **/ gboolean clutter_seat_query_state (ClutterSeat *seat, ClutterInputDevice *device, -- cgit v1.2.1