summaryrefslogtreecommitdiff
path: root/HACKING
diff options
context:
space:
mode:
authorPhilip Chimento <philip.chimento@gmail.com>2011-06-18 18:31:28 +0100
committerPhilip Withnall <philip@tecnocode.co.uk>2011-06-18 18:31:40 +0100
commitfafa68352959512861bcbc8c9d3f0295a70e767c (patch)
tree31bf1d90f4c825f2a280201f8df7d6236180f405 /HACKING
parent75ededc68bdc77d522156c3fbcb2b2e4cd93e102 (diff)
downloadlibgdata-fafa68352959512861bcbc8c9d3f0295a70e767c.tar.gz
introspection: Add GDestroyNotify to progress callbacks
All query_async functions that take a progress callback should have a GDestroyNotify parameter for freeing the progress callback data, since there is no suitable (scope) annotation. This breaks API by changing the signatures for: • gdata_access_handler_get_rules_async() • gdata_service_query_async() • gdata_calendar_service_query_all_calendars_async() • gdata_calendar_service_query_own_calendars_async() • gdata_calendar_service_query_events_async() • gdata_contacts_service_query_contacts_async() • gdata_contacts_service_query_groups_async() • gdata_documents_service_query_documents_async() • gdata_picasaweb_service_query_all_albums_async() • gdata_picasaweb_service_query_files_async() • gdata_youtube_service_query_standard_feed_async() • gdata_youtube_service_query_videos_async() • gdata_youtube_service_query_related_async() Closes: bgo#649728
Diffstat (limited to 'HACKING')
-rw-r--r--HACKING3
1 files changed, 3 insertions, 0 deletions
diff --git a/HACKING b/HACKING
index ae531dca..9d9f699b 100644
--- a/HACKING
+++ b/HACKING
@@ -121,6 +121,9 @@ Adding public API
See http://www.gnu.org/software/libtool/manual/html_node/Libtool-versioning.html for information about libtool's versioning system. See also the
“Versioning” section below.
+ - Any async function which uses non-async-scope callbacks as well as the async ready callback should provide GDestroyNotify callbacks for destroying
+ the user data for those callbacks. See https://bugzilla.gnome.org/show_bug.cgi?id=649728 for details.
+
Choosing function names
=======================