Fix memory management issues

[platform/upstream/at-spi2-core.git] / atspi / atspi-device-listener.h

diff --git a/atspi/atspi-device-listener.h b/atspi/atspi-device-listener.h
index 169738c..d91a203 100644 (file)
--- a/atspi/atspi-device-listener.h
+++ b/atspi/atspi-device-listener.h
@@ -8,19 +8,19 @@
  *           
  *
  * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Library General Public
+ * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
+ * version 2.1 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
+ * You should have received a copy of the GNU Lesser General Public
  * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
  */
 
 #ifndef _ATSPI_DEVICE_LISTENER_H_
@@ -30,6 +30,10 @@
 
 #include "atspi-types.h"
 
+G_BEGIN_DECLS
+
+GType atspi_device_event_get_type (void);
+
 /**
  * AtspiDeviceListenerCB:
  * @stroke: (transfer full): The #AtspiDeviceEvent for which notification is
@@ -38,8 +42,8 @@
  *
  * A callback function prototype via which clients receive device event notifications.
  *
- * Returns: %TRUE if the client wishes to consume/preempt the event, preventing it from being
- * relayed to the currently focussed application, %FALSE if the event delivery should proceed as normal.
+ * Returns: #TRUE if the client wishes to consume/preempt the event, preventing it from being
+ * relayed to the currently focussed application, #FALSE if the event delivery should proceed as normal.
  **/
 typedef gboolean (*AtspiDeviceListenerCB)    (const AtspiDeviceEvent *stroke,
                                                     void                      *user_data);
@@ -49,10 +53,10 @@ typedef gboolean (*AtspiDeviceListenerCB)    (const AtspiDeviceEvent *stroke,
  * @stroke: (transfer full): The #AtspiDeviceEvent for which notification is
  *          being received.
  *
- * Like #AtspiDeviceListenerCB but with no user data.
+ * Similar to #AtspiDeviceListenerCB, but with no user data.
  *
- * Returns: %TRUE if the client wishes to consume/preempt the event, preventing it from being
- * relayed to the currently focussed application, %FALSE if the event delivery should proceed as normal.
+ * Returns: #TRUE if the client wishes to consume/preempt the event, preventing it from being
+ * relayed to the currently focussed application, #FALSE if the event delivery should proceed as normal.
  **/
 typedef gboolean (*AtspiDeviceListenerSimpleCB)    (const AtspiDeviceEvent *stroke);
 
@@ -75,7 +79,7 @@ typedef struct _AtspiDeviceListenerClass AtspiDeviceListenerClass;
 struct _AtspiDeviceListenerClass
 {
   GObjectClass parent_class;
-  gboolean (*device_event) (AtspiDeviceListener *, const AtspiDeviceEvent *);
+  gboolean (*device_event) (AtspiDeviceListener *listener, const AtspiDeviceEvent *event);
 };
 
 GType atspi_device_listener_get_type (void);
@@ -87,4 +91,7 @@ AtspiDeviceListener *atspi_device_listener_new_simple (AtspiDeviceListenerSimple
 void atspi_device_listener_add_callback (AtspiDeviceListener *listener, AtspiDeviceListenerCB callback, GDestroyNotify callback_destroyed, void *user_data);
 
 void atspi_device_listener_remove_callback (AtspiDeviceListener  *listener, AtspiDeviceListenerCB callback);
+
+G_END_DECLS
+
 #endif /* _ATSPI_DEVICE_LISTENER_H_ */