Final updates for 1.0.2 (20081013).

api/AccessibleAction.idl

@@ -93,12 +93,20 @@ interface IAccessibleAction : IUnknown
      [out, retval] BSTR *description
     );
 
-  /** @brief Returns an array of BSTRs describing one or more key bindings, if there
-   are any, associated with the specified action.
+  /** @brief Returns an array of BSTRs describing one or more key bindings, if
+   there are any, associated with the specified action.
 
-   The returned strings are the human readable key sequences to be used for each 
-   action, e.g. ctrl+shift+D.  An AT such as an On Screen Keyboard might not expose 
-   these bindings but provide alternative means of activation.
+   The returned strings are the localized human readable key sequences to be
+   used to activate each action, e.g. "Ctrl+Shift+D".  Since these key
+   sequences are to be used when the object has focus, they are like
+   mnemonics (access keys), and not like shortcut (accelerator) keys.
+
+   There is no need to implement this method for single action controls since
+   that would be redundant with the standard MSAA programming practice of
+   getting the mnemonic from get_accKeyboardShortcut.
+
+   An AT such as an On Screen Keyboard might not expose these bindings but
+   provide alternative means of activation.
 
    Note: the client allocates and passes in an array of pointers.  The server
    allocates the BSTRs and passes back one or more pointers to these BSTRs into

api/AccessibleHyperlink.idl

@@ -144,6 +144,12 @@ interface IAccessibleHyperlink : IAccessibleAction
    This is a volatile state that may change without sending an appropriate event.
    Returns TRUE if the referenced target is still valid and FALSE otherwise.
 
+   This has also been used to indicate whether or not the URI of the anchorTarget
+   is malformed.
+
+   Note: This method is not being used, is deprecated, and should not be implemented or
+   used.  It is likely that this method will be removed in a later version of the IDL.
+
    @param [out] valid
    @retval S_OK
    @retval S_FALSE if there is nothing to return, [out] value is FALSE 

changelog.txt

@@ -1,4 +1,4 @@
-2008-September-18 Pete Brunet <[email protected]>
+2008-October-13 Pete Brunet <[email protected]>
 
 	* General comments
 	Added a comment to the following methods that the max size [in] parameter is not used.
@@ -77,6 +77,7 @@
 	*api\AccessibleHyperlink.idl
 	Added reference to General Information section on VARIANTs.
 	Clarified case where objects have more than one action.
+	valid method is deprecated
 
 	*api\AccessibleRelation.idl
 	targets method: renamed out parameter from target to targets