[atk] Removed unneeded comments



commit dac4a581ebd377e4e67c35bf2c0a6a7f86fa03de
Author: Alejandro Piñeiro <apinheiro igalia com>
Date:   Wed Jul 31 17:42:10 2013 +0200

    Removed unneeded comments
    
    The first one is already on the documentation of
    atk_implementor_ref_accessible.
    
    Second one basic glib usage. If needed it should be placed
    at documentation and not as a big comment on the main atk
    object header.

 atk/atkobject.h |   72 -------------------------------------------------------
 1 files changed, 0 insertions(+), 72 deletions(-)
---
diff --git a/atk/atkobject.h b/atk/atkobject.h
index 4e15919..1871dd5 100755
--- a/atk/atkobject.h
+++ b/atk/atkobject.h
@@ -547,18 +547,6 @@ struct _AtkImplementorIface
 };
 GType atk_implementor_get_type (void);
 
-/*
- * This method uses the ref_accessible method in AtkImplementorIface,
- * if the object's class implements AtkImplementorIface.
- * Otherwise it returns %NULL.
- *
- * IMPORTANT:
- * Note also that because this method may return flyweight objects,
- * it increments the returned AtkObject's reference count.
- * Therefore it is the responsibility of the calling
- * program to unreference the object when no longer needed.
- * (c.f. gtk_widget_get_accessible() where this is not the case).
- */
 AtkObject*              atk_implementor_ref_accessible            (AtkImplementor *implementor);
 
 /*
@@ -617,66 +605,6 @@ gboolean              atk_object_remove_relationship           (AtkObject      *
 const gchar*          atk_role_get_localized_name              (AtkRole     role);
 const gchar*          atk_object_get_object_locale             (AtkObject   *accessible);
 
-/* */
-
-
-/*
- * Note: the properties which are registered with the GType
- *   property registry, for type ATK_TYPE_OBJECT, are as follows:
- *
- *   "accessible-name"
- *   "accessible-description"
- *   "accessible-parent"
- *   "accessible-role"
- *   "accessible-value"
- *   "accessible-component-layer"
- *   "accessible-component-zorder"
- *   "accessible-table-caption"
- *   "accessible-table-column-description"
- *   "accessible-table-column-header"
- *   "accessible-table-row-description"
- *   "accessible-table-row-header"
- *   "accessible-table-summary"
- *   "accessible-model"
- *
- * accessibility property change listeners should use the
- *   normal GObject property interfaces and "property-change"
- *   signal handler semantics to interpret the property change
- *   information relayed from AtkObject.
- *   (AtkObject instances will connect to the "notify"
- *   signal in their host objects, and relay the signals when appropriate).
- */
-
-/* For other signals, see related interfaces
- *
- *    AtkActionIface,
- *    AtkComponentIface,
- *    AtkHypertextIface,
- *    AtkImageIface,
- *    AtkSelectionIface,
- *    AtkTableIface,
- *    AtkTextIface,
- *    AtkValueIface.
- *
- *  The usage model for obtaining these interface instances is:
- *    ATK_<interfacename>_GET_IFACE(GObject *accessible),
- *    where accessible, though specified as a GObject, is
- *    the AtkObject instance being queried.
- *  More usually, the interface will be used via a cast to the
- *    interface's corresponding "type":
- *
- *    AtkText textImpl = ATK_TEXT(accessible);
- *    if (textImpl)
- *      {
- *        cpos = atk_text_get_caret_position(textImpl);
- *      }
- *
- *  If it's known in advance that accessible implements AtkTextIface,
- *    this is shortened to:
- *
- *    cpos = atk_text_get_caret_position (ATK_TEXT (accessible));
- */
-
 G_END_DECLS
 
 #endif /* __ATK_OBJECT_H__ */


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]