After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 646427 - g_bus_own_name() docs don't mention what name_acquired_handler is good for
g_bus_own_name() docs don't mention what name_acquired_handler is good for
Status: RESOLVED WONTFIX
Product: glib
Classification: Platform
Component: gdbus
2.28.x
Other Linux
: Normal normal
: ---
Assigned To: David Zeuthen (not reading bugmail)
gtkdev
Depends on:
Blocks:
 
 
Reported: 2011-04-01 10:53 UTC by Murray Cumming
Modified: 2011-04-27 03:12 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Murray Cumming 2011-04-01 10:53:24 UTC 
The g_bus_own_name() documentation
  http://library.gnome.org/devel//gio/2.27/gio-Owning-Bus-Names.html#g-bus-own-name
says that name_acquired_handler is too late to register objects, though they should be unregistered in name_lost_handler. None of the tests in gio/tests/ seem to use it for anything. So I wonder what it's for.
Comment 1 David Zeuthen (not reading bugmail) 2011-04-01 14:00:32 UTC 
The docs very clearly states

 name_acquired_handler : Handler to invoke when name is acquired or NULL.

One way to think about well-known names is that it's just an alias for your unique name. Just like www.gnome.org is an alias for one or more IPv4 and IPv6 addresses. One example of watching name ownership is this: ownership of the name org.freedesktop.Notifications indicate (by contract) that you will show notifications. It could be that your desktop shell will want to change appearance depending on whether you own the name or not.

I don't think it's appropriate at this API level to mention anything here.
Comment 2 Matthias Clasen 2011-04-27 03:12:31 UTC 
taking the comment as a wontfix