Annotate filter to allow none for device event listeners
authorMike Gorse <mgorse@suse.com>
Tue, 14 May 2013 18:00:54 +0000 (13:00 -0500)
committerMike Gorse <mgorse@suse.com>
Tue, 14 May 2013 18:00:54 +0000 (13:00 -0500)
Atspi_register_device_event_listener and
atspi_deregister_device_event_listener take a filter (currently unused).
It can be NULL, so it should be annotated as such.

https://bugzilla.gnome.org/show_bug.cgi?id=700237

atspi/atspi-registry.c

index fa87660..8722b37 100644 (file)
@@ -348,7 +348,7 @@ atspi_deregister_keystroke_listener (AtspiDeviceListener *listener,
  *             the events.
  * @event_types: an #AtspiDeviceEventMask mask indicating which
  *             types of key events are requested (%ATSPI_KEY_PRESSED, etc.).
- * @filter: Unused parameter.
+ * @filter: (allow-none): Unused parameter.
  * @error: (allow-none): a pointer to a %NULL #GError pointer, or %NULL
  *             
  * Registers a listener for device events, for instance button events.
@@ -386,7 +386,7 @@ atspi_register_device_event_listener (AtspiDeviceListener  *listener,
  * atspi_deregister_device_event_listener:
  * @listener: a pointer to the #AtspiDeviceListener for which
  *            device events are requested.
- * @filter: Unused parameter.
+ * @filter: (allow-none): Unused parameter.
  * @error: (allow-none): a pointer to a %NULL #GError pointer, or %NULL
  *
  * Removes a device event listener from the registry's listener queue,