Added AtkHyperlinkImpl interface. See RFE #344284.

2 files changed, 53 insertions, 2 deletions

diff --git a/docs/tmpl/atkhyperlink.sgml b/docs/tmpl/atkhyperlink.sgml
index b0bcc62..12ed025 100644
--- a/docs/tmpl/atkhyperlink.sgml
+++ b/docs/tmpl/atkhyperlink.sgml
@@ -6,8 +6,11 @@ An ATK object which encapsulates a link or set of links in a hypertext document.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-An ATK object which encapsulates a link or set of links in a hypertext document.
-It implements the AtkAction interface.
+An ATK object which encapsulates a link or set of links 
+(for instance in the case of client-side image maps) in a hypertext document.
+It may implement the AtkAction interface.  AtkHyperlink may also be used
+to refer to inline embedded content, since it allows specification of a start
+and end offset within the host AtkHypertext object.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/tmpl/atkhyperlinkimpl.sgml b/docs/tmpl/atkhyperlinkimpl.sgml
new file mode 100644
index 0000000..fd97906
--- /dev/null
+++ b/docs/tmpl/atkhyperlinkimpl.sgml
@@ -0,0 +1,48 @@
+<!-- ##### SECTION Title ##### -->
+AtkHyperlinkImpl
+
+<!-- ##### SECTION Short_Description ##### -->
+An interface from which the AtkHyperlink associated with an
+AtkObject may be obtained. 
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+AtkHyperlinkImpl allows AtkObjects to
+refer to their associated AtkHyperlink instance, if one
+exists.  AtkHyperlinkImpl differs from AtkHyperlink in that 
+AtkHyperlinkImpl is an interface, whereas AtkHyperlink is
+a object type.  The AtkHyperlinkImpl interface allows
+a client to query an AtkObject for the availability of
+an associated AtkHyperlink instance, and obtain that
+instance.  It is thus particularly useful in cases where
+embedded content or inline content within a text object
+is present, since the embedding text object implements
+AtkHypertext and the inline/embedded objects are 
+exposed as children which implement AtkHyperlinkImpl,
+in addition to their being obtainable via AtkHypertext:getLink
+followed by AtkHyperlink:getObject.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT AtkHyperlinkImpl ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION atk_hyperlink_impl_get_hyperlink ##### -->
+<para>
+
+</para>
+
+@obj: 
+@Returns: 
+
+