docs: Tiny typo.

[platform/upstream/atk.git] / atk / atktablecell.h

diff --git a/atk/atktablecell.h b/atk/atktablecell.h
old mode 100755 (executable)
new mode 100644 (file)
index 7926f9f..0e70d69
--- a/atk/atktablecell.h
+++ b/atk/atktablecell.h
@@ -28,11 +28,6 @@
 
 G_BEGIN_DECLS
 
-/*
- * AtkTableCell gives access to the cells of a two-dimentional table.
- */
-
-
 #define ATK_TYPE_TABLE_CELL                    (atk_table_cell_get_type ())
 #define ATK_IS_TABLE_CELL(obj)                 G_TYPE_CHECK_INSTANCE_TYPE ((obj), ATK_TYPE_TABLE_CELL)
 #define ATK_TABLE_CELL(obj)                    G_TYPE_CHECK_INSTANCE_CAST ((obj), ATK_TYPE_TABLE_CELL, AtkTableCell)
@@ -44,39 +39,64 @@ typedef struct _AtkTableCell AtkTableCell;
 #endif
 typedef struct _AtkTableCellIface AtkTableCellIface;
 
+/**
+ * AtkTableCellIface:
+ * @get_column_span: virtual function that returns the number of
+ * columns occupied by this cell accessible. @Since: 2.12
+ * @get_column_header_cells: virtual function that returns the column
+ * headers as an array of cell accessibles. @Since: 2.12
+ * @get_position: virtual function that retrieves the tabular position
+ * of this cell. @Since: 2.12
+ * @get_row_span: virtual function that returns the number of rows
+ * occupied by this cell. @Since: 2.12
+ * @get_row_header_cells: virtual function that returns the row
+ * headers as an array of cell accessibles. @Since: 2.12
+ * @get_row_column_span: virtual function that get the row an column
+ * indexes and span of this cell. @Since: 2.12
+ * @get_table: virtual function that returns a reference to the
+ * accessible of the containing table. @Since: 2.12
+ */
 struct _AtkTableCellIface
 {
   GTypeInterface parent;
 
-  gint        (*get_column_span)       (AtkTableCell *cell);
-  GPtrArray * (*get_column_header_cells) (AtkTableCell *cell);
-  gboolean        (*get_position)            (AtkTableCell *cell,
-                                              gint         *row,
-                                              gint         *column);
-  gint        (*get_row_span)          (AtkTableCell *cell);
-GPtrArray *   (*get_row_header_cells)    (AtkTableCell *cell);
-  gboolean    (*get_row_column_span)  (AtkTableCell *cell,
-                                          gint         *row,
-                                          gint         *column,
-                                          gint         *row_span,
-                                          gint         *column_span);
-  AtkObject * (*get_table)               (AtkTableCell *cell);
+  gint          (*get_column_span)         (AtkTableCell *cell);
+  GPtrArray *   (*get_column_header_cells) (AtkTableCell *cell);
+  gboolean      (*get_position)            (AtkTableCell *cell,
+                                            gint         *row,
+                                            gint         *column);
+  gint          (*get_row_span)            (AtkTableCell *cell);
+  GPtrArray *   (*get_row_header_cells)    (AtkTableCell *cell);
+  gboolean      (*get_row_column_span)     (AtkTableCell *cell,
+                                            gint         *row,
+                                            gint         *column,
+                                            gint         *row_span,
+                                            gint         *column_span);
+  AtkObject *   (*get_table)               (AtkTableCell *cell);
 };
 
+ATK_AVAILABLE_IN_2_12
 GType atk_table_cell_get_type (void);
 
-gint        atk_table_cell_get_column_span       (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
+gint        atk_table_cell_get_column_span         (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
 GPtrArray * atk_table_cell_get_column_header_cells (AtkTableCell *cell);
-gboolean     atk_table_cell_get_position           (AtkTableCell *cell,
+ATK_AVAILABLE_IN_2_12
+gboolean    atk_table_cell_get_position            (AtkTableCell *cell,
                                                     gint         *row,
                                                     gint         *column);
-gint        atk_table_cell_get_row_span          (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
+gint        atk_table_cell_get_row_span            (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
 GPtrArray * atk_table_cell_get_row_header_cells    (AtkTableCell *cell);
-gboolean    atk_table_cell_get_row_column_span  (AtkTableCell *cell,
+ATK_AVAILABLE_IN_2_12
+gboolean    atk_table_cell_get_row_column_span     (AtkTableCell *cell,
                                                     gint         *row,
                                                     gint         *column,
                                                     gint         *row_span,
                                                     gint         *column_span);
+ATK_AVAILABLE_IN_2_12
 AtkObject * atk_table_cell_get_table               (AtkTableCell *cell);
 
 G_END_DECLS