doc: update doc to explicitly state that the seat isn't referenced

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
(cherry picked from commit c2dfe504ed7110e1cf85c52f7b8495dc0b5f08d8)

diff --git a/src/libinput.h b/src/libinput.h
index 631848423533b5a1dac34b6710b83a1949260180..5b08035f53af2d130aba7938991945775832bc4a 100644 (file)
--- a/src/libinput.h
+++ b/src/libinput.h
@@ -3066,6 +3066,11 @@ libinput_device_get_output_name(struct libinput_device *device);
  * seat name pair at any given time, but if no external reference is kept, it
  * may be destroyed if no device belonging to it is left.
  *
+ * The returned seat is not refcounted and may become invalid after
+ * the next call to libinput. Use libinput_seat_ref() and
+ * libinput_seat_unref() to continue using the handle outside of the
+ * immediate scope.
+ *
  * @param device A previously obtained device
  * @return The seat this input device belongs to
  */