--- atk_docs_orig.xml	2010-04-07 00:01:35.000000000 -0400
+++ atk_docs_new.xml	2010-04-07 23:16:08.000000000 -0400
@@ -422,6 +422,7 @@
 <description>
 Gets the hyperlink associated with this object.
 
+Since: 1.12
 
 </description>
 <parameters>
@@ -432,7 +433,6 @@
 </parameters>
 <return>an AtkHyperlink object which points to this implementing AtkObject.
 
-Since: 1.12
 </return>
 </function>
 
@@ -2363,7 +2363,13 @@
 
 <function name="atk_hyperlink_get_object">
 <description>
-Returns: an #AtkObject associated with this hyperlinks i-th anchor
+Returns the item associated with this hyperlinks nth anchor.
+For instance, the returned #AtkObject will implement #AtkText
+if @link_ is a text hyperlink, #AtkImage if @link_ is an image
+hyperlink etc. 
+
+Multiple anchors are primarily used by client-side image maps.
+
 
 </description>
 <parameters>
@@ -2537,7 +2543,21 @@
 
 <function name="atk_action_get_name">
 <description>
-Returns a name string, or %NULL
+Returns a non-localized string naming the specified action of the 
+object. This name is generally not descriptive of the end result 
+of the action, but instead names the 'interaction type' which the 
+object supports. By convention, the above strings should be used to 
+represent the actions which correspond to the common point-and-click 
+interaction techniques of the same name: i.e. 
+&quot;click&quot;, &quot;press&quot;, &quot;release&quot;, &quot;drag&quot;, &quot;drop&quot;, &quot;popup&quot;, etc.
+The &quot;popup&quot; action should be used to pop up a context menu for the 
+object, if one exists.
+
+For technical reasons, some toolkits cannot guarantee that the 
+reported action is actually 'bound' to a nontrivial user event;
+i.e. the result of some actions via atk_action_do_action() may be
+NIL.
+
 
 </description>
 <parameters>
@@ -2660,6 +2680,7 @@
 Note that it is possible for get_uri to return NULL but for
 get_stream to work nonetheless, since not all GIOChannels connect to URIs.
 
+Since: 1.12
 
 </description>
 <parameters>
@@ -2676,7 +2697,6 @@
 <return>  Returns a string representing a URI, or NULL if no corresponding URI
 can be constructed.
 
-Since: 1.12
 </return>
 </function>
 
@@ -2954,7 +2974,11 @@
 
 <function name="atk_component_get_alpha">
 <description>
-Returns: An alpha value from 0 to 1.0, inclusive.
+Returns the alpha value (i.e. the opacity) for this
+@component, on a scale from 0 (fully transparent) to 1.0
+(fully opaque).
+
+Since: 1.12
 
 </description>
 <parameters>
@@ -2964,7 +2988,6 @@
 </parameter>
 </parameters>
 <return> An alpha value from 0 to 1.0, inclusive.
-Since: 1.12
 </return>
 </function>
 
@@ -3097,7 +3120,8 @@
 
 <function name="atk_action_get_localized_name">
 <description>
-Returns a name string, or %NULL
+Returns the localized name of the specified action of the object.
+
 
 </description>
 <parameters>
@@ -3159,7 +3183,8 @@
 
 <function name="atk_action_get_description">
 <description>
-Returns a description string, or %NULL
+Returns a description of the specified action of the object.
+
 
 </description>
 <parameters>
@@ -3213,7 +3238,18 @@
 
 <function name="atk_action_get_keybinding">
 <description>
-Returns a string representing the available keybindings, or %NULL
+Returns a keybinding associated with this action, if one exists.
+The returned string is in the format &quot;&lt;a&gt;;&lt;b&gt;;&lt;c&gt;&quot;
+(i.e. semicolon-delimited), where &lt;a&gt; is the keybinding which
+activates the object if it is presently enabled onscreen, 
+&lt;b&gt; corresponds to the keybinding or sequence of keys
+which invokes the action even if the relevant element is not
+currently posted on screen (for instance, for a menu item it
+posts the parent menus before invoking).  The last token in the
+above string, if non-empty, represents a keyboard shortcut which
+invokes the same action without posting the component or its
+enclosing menus or dialogs. 
+
 
 </description>
 <parameters>
@@ -4366,7 +4402,7 @@
 </parameter_description>
 </parameter>
 </parameters>
-<return>: a gchar* representing the specified mime type; the caller
+<return> a gchar* representing the specified mime type; the caller
 should not free the character string.
 </return>
 </function>
