Revert "Merge remote-tracking branch 'origin/sandbox/mniesluchow/upstream_2_16' into...

[platform/upstream/atk.git] / atk / atkstateset.c

diff --git a/atk/atkstateset.c b/atk/atkstateset.c
index d240ee6..1497bed 100755 (executable)
--- a/atk/atkstateset.c
+++ b/atk/atkstateset.c
@@ -17,8 +17,6 @@
  * Boston, MA 02111-1307, USA.
  */
 
-#include "config.h"
-
 #include <glib-object.h>
 
 #include "atkobject.h"
@@ -26,12 +24,11 @@
 
 /**
  * SECTION:atkstateset
- * @Short_description: An AtkStateSet contains the states of an object.
+ * @Short_description: An AtkStateSet determines a component's state set.
  * @Title:AtkStateSet
  *
- * An AtkStateSet is a read-only representation of the full set of #AtkStates
- * that apply to an object at a given time. This set is not meant to be
- * modified, but rather created when #atk_object_ref_state_set() is called.
+ * An AtkStateSet determines a component's state set. It is composed
+ * of a set of AtkStates.
  */
 
 #define ATK_STATE(state_enum)             ((AtkState)((guint64)1 << ((state_enum)%64)))
@@ -116,13 +113,8 @@ atk_state_set_is_empty (AtkStateSet   *set)
  * @set: an #AtkStateSet
  * @type: an #AtkStateType
  *
- * Adds the state of the specified type to the state set if it is not already
- * present.
- *
- * Note that because an #AtkStateSet is a read-only object, this method should
- * be used to add a state to a newly-created set which will then be returned by
- * #atk_object_ref_state_set. It should not be used to modify the existing state
- * of an object. See also #atk_object_notify_state_change.
+ * Add a new state for the specified type to the current state set if
+ * it is not already present.
  *
  * Returns: %TRUE if  the state for @type is not already in @set.
  **/
@@ -149,12 +141,7 @@ atk_state_set_add_state (AtkStateSet   *set,
  * @types: (array length=n_types): an array of #AtkStateType
  * @n_types: The number of elements in the array
  *
- * Adds the states of the specified types to the state set.
- *
- * Note that because an #AtkStateSet is a read-only object, this method should
- * be used to add states to a newly-created set which will then be returned by
- * #atk_object_ref_state_set. It should not be used to modify the existing state
- * of an object. See also #atk_object_notify_state_change.
+ * Add the states for the specified types to the current state set.
  **/
 void
 atk_state_set_add_states (AtkStateSet   *set,
@@ -251,11 +238,6 @@ atk_state_set_contains_states (AtkStateSet   *set,
  *
  * Removes the state for the specified type from the state set.
  *
- * Note that because an #AtkStateSet is a read-only object, this method should
- * be used to remove a state to a newly-created set which will then be returned
- * by #atk_object_ref_state_set. It should not be used to modify the existing
- * state of an object. See also #atk_object_notify_state_change.
- *
  * Returns: %TRUE if @type was the state type is in @set.
  **/
 gboolean
@@ -317,8 +299,8 @@ atk_state_set_and_sets (AtkStateSet  *set,
  *
  * Constructs the union of the two sets.
  *
- * Returns: (nullable) (transfer full): a new #AtkStateSet which is
- * the union of the two sets, returning %NULL is empty.
+ * Returns: (transfer full): a new #AtkStateSet which is the union of the two
+ * sets, returning %NULL is empty.
  **/
 AtkStateSet*
 atk_state_set_or_sets (AtkStateSet  *set,