[at-spi2-core] Make the documentation of ATSPI's STATE_ACTIVE consistent with that of ATK's.

[Joanmarie Diggs <joanied src gnome org>]

commit e36374307644141cf16736a4fc53c09b1f06a1c5
Author: Joanmarie Diggs <jdiggs igalia com>
Date:   Mon Nov 17 11:43:53 2014 -0500

    Make the documentation of ATSPI's STATE_ACTIVE consistent with that of ATK's.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=740274

 atspi/atspi-constants.h |    8 +++++++-
 1 files changed, 7 insertions(+), 1 deletions(-)
---
diff --git a/atspi/atspi-constants.h b/atspi/atspi-constants.h
index 3675bcc..3b7653d 100644
--- a/atspi/atspi-constants.h
+++ b/atspi/atspi-constants.h
@@ -412,7 +412,13 @@ typedef enum {
  * @ATSPI_STATE_INVALID: Indicates an invalid state - probably an error 
  * condition.
  * @ATSPI_STATE_ACTIVE: Indicates a window is currently the active window, or
- * is an active subelement within a container or table.
+ * an object is the active subelement within a container or table.
+ * @ATSPI_STATE_ACTIVE should not be used for objects which have
+ * @ATSPI_STATE_FOCUSABLE or @ATSPI_STATE_SELECTABLE: Those objects should use
+ * @ATSPI_STATE_FOCUSED and @ATSPI_STATE_SELECTED respectively.
+ * @ATSPI_STATE_ACTIVE is a means to indicate that an object which is not
+ * focusable and not selectable is the currently-active item within its
+ * parent container.
  * @ATSPI_STATE_ARMED: Indicates that the object is armed.
  * @ATSPI_STATE_BUSY: Indicates the current object is busy, i.e. onscreen
  * representation is in the process of changing, or       the object is