Bug 83479 - Document wl_proxy user data surprises
Summary: Document wl_proxy user data surprises
Alias: None
Product: Wayland
Classification: Unclassified
Component: wayland (show other bugs)
Version: unspecified
Hardware: All All
: medium enhancement
Assignee: Wayland bug list
QA Contact:
Depends on:
Blocks: 83429
  Show dependency treegraph
Reported: 2014-09-04 07:28 UTC by Pekka Paalanen
Modified: 2018-06-08 23:48 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


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.