[atk/docs-fixes: 52/56] Annotate the version for AtkTableCellIface



commit a7efeefd859b50efd8d2c0d22d73e61b20149914
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Tue Jun 26 17:07:20 2018 +0100

    Annotate the version for AtkTableCellIface
    
    There's no point in using the unsupported `@Since` syntax on every
    virtual function, when the whole structure was added in the same ATK
    version. We should annotate the structure instead.

 atk/atktablecell.h | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)
---
diff --git a/atk/atktablecell.h b/atk/atktablecell.h
index 53d0dd7..5fd19d2 100644
--- a/atk/atktablecell.h
+++ b/atk/atktablecell.h
@@ -42,24 +42,30 @@ typedef struct _AtkTableCellIface AtkTableCellIface;
 /**
  * AtkTableCellIface:
  * @get_column_span: virtual function that returns the number of
- * columns occupied by this cell accessible. @Since: 2.12
+ *   columns occupied by this cell accessible
  * @get_column_header_cells: virtual function that returns the column
- * headers as an array of cell accessibles. @Since: 2.12
+ *   headers as an array of cell accessibles
  * @get_position: virtual function that retrieves the tabular position
- * of this cell. @Since: 2.12
+ *   of this cell
  * @get_row_span: virtual function that returns the number of rows
- * occupied by this cell. @Since: 2.12
+ *   occupied by this cell
  * @get_row_header_cells: virtual function that returns the row
- * headers as an array of cell accessibles. @Since: 2.12
+ *   headers as an array of cell accessibles
  * @get_row_column_span: virtual function that get the row an column
- * indexes and span of this cell. @Since: 2.12
+ *   indexes and span of this cell
  * @get_table: virtual function that returns a reference to the
- * accessible of the containing table. @Since: 2.12
+ *   accessible of the containing table
+ *
+ * AtkTableCell is an interface for cells inside an #AtkTable.
+ *
+ * Since: 2.12
  */
 struct _AtkTableCellIface
 {
+  /*< private >*/
   GTypeInterface parent;
 
+  /*< public >*/
   gint          (*get_column_span)         (AtkTableCell *cell);
   GPtrArray *   (*get_column_header_cells) (AtkTableCell *cell);
   gboolean      (*get_position)            (AtkTableCell *cell,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]