From: Peter Hutterer Date: Tue, 24 May 2016 01:33:50 +0000 (+1000) Subject: doc: update doc to explicitly state that the seat isn't referenced X-Git-Tag: 1.3.1~5 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=5acd9a373b5fa2a9652d5852b4d282edf8d765e5;p=platform%2Fupstream%2Flibinput.git doc: update doc to explicitly state that the seat isn't referenced Signed-off-by: Peter Hutterer (cherry picked from commit c2dfe504ed7110e1cf85c52f7b8495dc0b5f08d8) --- diff --git a/src/libinput.h b/src/libinput.h index 63184842..5b08035f 100644 --- 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 */