Clarified behavior of atk_text_get_text_... interfaces

Corrected name of status bar role

diff --git a/ChangeLog b/ChangeLog
index 2a3ce12..313472b 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2001-05-23  Padraig O'Briain  <padraigo@sun.com>
+
+       * atk/atkobject.h: Correct naming of role for status bar
+        * atk/atktext.c: 
+       Clarify behaviour of atk_text_get_text_after/at/before_offset
+ 
 Sun May 13 11:35:32 2001  Owen Taylor  <otaylor@redhat.com>
 
        * autogen.sh (have_automake): Require libtool-1.4, automake-1.4p1.

diff --git a/atk/atkobject.h b/atk/atkobject.h
index 0e81d6e..76b5f5f 100755 (executable)
--- a/atk/atkobject.h
+++ b/atk/atkobject.h
@@ -205,8 +205,8 @@ typedef enum
   /* An object used to get an integer or floating point number from the user */
   ATK_ROLE_SPIN_BUTTON,
   /* An object which reports messages of minor importance to the user */
-  ATK_STATUS_BAR,
-  /* An object used to rpesent information in terms of rows and columns. */
+  ATK_ROLE_STATUSBAR,
+  /* An object used to represent information in terms of rows and columns. */
   ATK_ROLE_TABLE,
   ATK_ROLE_TABLE_CELL,
   ATK_ROLE_TABLE_COLUMN_HEADER,

diff --git a/atk/atktext.c b/atk/atktext.c
index e8471e2..0b09096 100755 (executable)
--- a/atk/atktext.c
+++ b/atk/atktext.c
@@ -151,6 +151,13 @@ atk_text_get_character_at_offset (AtkText      *text,
  * @boundary_type: An #AtkTextBoundary
  *
  * Returns: the text after @offset up to the specified @boundary_type.
+ * If the boundary type is ATK_TEXT_BOUNDARY_WORD_START or
+ * ATK_TEXT_BOUNDARY_WORD_END part of a word may be returned.
+ * If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the start point 
+ * will be the offset and will continue to the start of the next sentence. 
+ * The first word may not be a complete word. Similarly for 
+ * ATK_TEXT_BOUNDARY_SENTENCE_END, ATK_TEXT_BOUNDARY_LINE_START and
+ * ATK_TEXT_BOUNDARY_LINE_END
  **/
 gchar*
 atk_text_get_text_after_offset (AtkText          *text,
@@ -177,6 +184,12 @@ atk_text_get_text_after_offset (AtkText          *text,
  * @boundary_type: An #AtkTextBoundary
  *
  * Returns: the text at @offset up to the specified @boundary_type.
+ * If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START or 
+ * ATK_TEXT_BOUNDARY_WORD_END a complete word is returned; 
+ * if the boundary type is  ATK_TEXT_BOUNDARY_SENTENCE_START or 
+ * ATK_TEXT_BOUNDARY_SENTENCE_END a complete sentence
+ * is returned; if the boundary type is ATK_TEXT_BOUNDARY_LINE_START or
+ * ATK_TEXT_BOUNDARY_LINE_END a complete line is returned.
  **/
 gchar*
 atk_text_get_text_at_offset (AtkText          *text,
@@ -202,7 +215,14 @@ atk_text_get_text_at_offset (AtkText          *text,
  * @offset: position
  * @boundary_type: An #AtkTextBoundary
  *
- * Returns: the text before @offset up to the specified @boundary_type.
+ * Returns: the text before @offset starting from the specified @boundary_type.
+ * If the boundary type is ATK_TEXT_BOUNDARY_WORD_START or
+ * ATK_TEXT_BOUNDARY_WORD_END part of a word may be returned.
+ * If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the start point 
+ * will be at the start of the sentence, and will continue to the offset. 
+ * The last word may not be a complete word. Similarly for 
+ * ATK_TEXT_BOUNDARY_SENTENCE_END, ATK_TEXT_BOUNDARY_LINE_START and
+ * ATK_TEXT_BOUNDARY_LINE_END
  **/
 gchar*
 atk_text_get_text_before_offset (AtkText          *text,