Add property accessible-table-caption-object. This addresses bug #74814.

2003-01-21  Padraig O'Briain  <padraig.obriain@sun.com>

	* atk/atkobject.c: Add property accessible-table-caption-object.
	This addresses bug #74814.

	* atk/atkobject.h: Move some documentation from template file to
	avoid warnings when building.

	* atk/atkrelation.c: Add new properties relation and target.
	This addresses bug #72426.

	* atktext.[ch]: Add new functions atk_text_get_range_extents and
	atk_text_get_bounded_ranges.
	Also added data structures AtkTextRectangle and AtkTextRange, enum
	AtkTextClipType and helper function  atk_text_free_ranges.
	This addresses bug #100943.
	(atk_text_get_character_extents): Ensure that the reported width is
	not negative. This fixes bug #102954)

	* docs/atk-sections.txt: Add new functions and data items.

	* docs/tmpl/atk-object.sgml: Remove some docuementation and put in
	atkobject.h. Add reference to accessible-table-caption-object.

	* docs/tmpl/atk-relation.sgml: Add new properties

	* docs/tmpl/atktext.sgml: Add new functions and data items.

4 files changed, 86 insertions, 6 deletions

diff --git a/docs/atk-sections.txt b/docs/atk-sections.txt
index 47ba1a2..2929091 100644
--- a/docs/atk-sections.txt
+++ b/docs/atk-sections.txt
@@ -370,6 +370,9 @@ atk_table_get_type
 <TITLE>AtkText</TITLE>
 AtkText
 AtkTextBoundary
+AtkTextClipType
+AtkTextRange
+AtkTextRectangle
 AtkAttribute
 AtkAttributeSet
 AtkTextAttribute
@@ -384,6 +387,9 @@ atk_text_get_run_attributes
 atk_text_get_default_attributes
 atk_text_get_character_count
 atk_text_get_offset_at_point
+atk_text_get_bounded_ranges
+atk_text_get_range_extents
+atk_text_free_ranges
 atk_text_get_n_selections
 atk_text_get_selection
 atk_text_add_selection
@@ -403,9 +409,11 @@ ATK_TYPE_TEXT
 ATK_TEXT_GET_IFACE
 ATK_TYPE_TEXT_ATTRIBUTE
 ATK_TYPE_TEXT_BOUNDARY
+ATK_TYPE_TEXT_CLIP_TYPE
 atk_text_get_type
 atk_text_attribute_get_type
 atk_text_boundary_get_type
+atk_text_clip_type_get_type
 </SECTION>
 
 <SECTION>
diff --git a/docs/tmpl/atkobject.sgml b/docs/tmpl/atkobject.sgml
index 223fea7..1dee081 100644
--- a/docs/tmpl/atkobject.sgml
+++ b/docs/tmpl/atkobject.sgml
@@ -40,9 +40,6 @@ The AtkObject structure should not be accessed directly.
 
 <!-- ##### ENUM AtkRole ##### -->
 <para>
-These are the built-in enumerated roles that UI components can have in
-ATK.  Other roles may be added at runtime, so an AtkRole >=
-ATK_ROLE_LAST_DEFINED is not necessarily an error.
 </para>
 
 @ATK_ROLE_INVALID: 
@@ -132,9 +129,6 @@ ATK_ROLE_LAST_DEFINED is not necessarily an error.
 
 <!-- ##### ENUM AtkLayer ##### -->
 <para>
-These enumerated "layer values" are used when determining which UI
-rendering layer a component is drawn into, which can help in making
-determinations of when components occlude one another.
 </para>
 
 @ATK_LAYER_INVALID: 
@@ -509,6 +503,11 @@ This signal support, which may be any of the accessible state types.
 
 </para>
 
+<!-- ##### ARG AtkObject:accessible-table-caption-object ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG AtkObject:accessible-table-column-description ##### -->
 <para>
 
diff --git a/docs/tmpl/atkrelation.sgml b/docs/tmpl/atkrelation.sgml
index a6c258c..e525303 100644
--- a/docs/tmpl/atkrelation.sgml
+++ b/docs/tmpl/atkrelation.sgml
@@ -101,3 +101,13 @@ The AtkRelation structure should not be accessed directly.
 @Returns: 
 
 
+<!-- ##### ARG AtkRelation:relation-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG AtkRelation:target ##### -->
+<para>
+
+</para>
+
diff --git a/docs/tmpl/atktext.sgml b/docs/tmpl/atktext.sgml
index 89494eb..4910972 100644
--- a/docs/tmpl/atktext.sgml
+++ b/docs/tmpl/atktext.sgml
@@ -51,6 +51,36 @@ The AtkText structure does not contain any fields.
 @ATK_TEXT_BOUNDARY_LINE_START: 
 @ATK_TEXT_BOUNDARY_LINE_END: 
 
+<!-- ##### ENUM AtkTextClipType ##### -->
+<para>
+
+</para>
+
+@ATK_TEXT_CLIP_NONE: 
+@ATK_TEXT_CLIP_MIN: 
+@ATK_TEXT_CLIP_MAX: 
+@ATK_TEXT_CLIP_BOTH: 
+
+<!-- ##### STRUCT AtkTextRange ##### -->
+<para>
+
+</para>
+
+@bounds: 
+@start_offset: 
+@end_offset: 
+@content: 
+
+<!-- ##### STRUCT AtkTextRectangle ##### -->
+<para>
+
+</para>
+
+@x: 
+@y: 
+@width: 
+@height: 
+
 <!-- ##### STRUCT AtkAttribute ##### -->
 <para>
 
@@ -225,6 +255,39 @@ The AtkText structure does not contain any fields.
 @Returns: 
 
 
+<!-- ##### FUNCTION atk_text_get_bounded_ranges ##### -->
+<para>
+
+</para>
+
+@text: 
+@rect: 
+@coord_type: 
+@x_clip_type: 
+@y_clip_type: 
+@Returns: 
+
+
+<!-- ##### FUNCTION atk_text_get_range_extents ##### -->
+<para>
+
+</para>
+
+@text: 
+@start_offset: 
+@end_offset: 
+@coord_type: 
+@rect: 
+
+
+<!-- ##### FUNCTION atk_text_free_ranges ##### -->
+<para>
+
+</para>
+
+@ranges: 
+
+
 <!-- ##### FUNCTION atk_text_get_n_selections ##### -->
 <para>