From e36374307644141cf16736a4fc53c09b1f06a1c5 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Mon, 17 Nov 2014 11:43:53 -0500 Subject: [PATCH] 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 file changed, 7 insertions(+), 1 deletion(-) 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 -- 2.7.4