Bug 83479

Summary:	Document wl_proxy user data surprises
Product:	Wayland	Reporter:	Pekka Paalanen <ppaalanen>
Component:	wayland	Assignee:	Wayland bug list <wayland-bugs>
Status:	RESOLVED MOVED	QA Contact:
Severity:	enhancement
Priority:	medium
Version:	unspecified
Hardware:	All
OS:	All
Whiteboard:
i915 platform:		i915 features:
Bug Depends on:
Bug Blocks:	83429

Description Pekka Paalanen 2014-09-04 07:28:50 UTC

People get surprised, that for a wl_proxy:
- add_listener can only be used once, so it's more a "init", not "add"
- add_listener sets the same user data as set_user_data does

Might as well review that all aspect of the user data are documented.

This should be both in the per-function doc comments picked up by Doxygen, and when a "big docs" chapter about the client side API gets started, there.

Comment 1 GitLab Migration User 2018-06-08 23:48:53 UTC

-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/wayland/wayland/issues/21.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.