Adding descriptions to atspi-table.c

diff --git a/doc/libatspi/tmpl/atspi-table.sgml b/doc/libatspi/tmpl/atspi-table.sgml
index fc0000e..a90cea4 100644 (file)
--- a/doc/libatspi/tmpl/atspi-table.sgml
+++ b/doc/libatspi/tmpl/atspi-table.sgml
@@ -2,11 +2,19 @@
 atspi-table
 
 <!-- ##### SECTION Short_Description ##### -->
-
+An interface used by containers whose data is arranged in a tabular form.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+An interface used by containers whose contained data is arranged
+in a tabular (i.e. row-column) form. Tables may resemble
+a two-dimensional grid, as in a spreadsheet, or may feature objects
+which span multiple rows and/or columns, but whose bounds are
+aligned on a row/column matrix. Objects within tables are children
+of the table object, and they may be referenced either via a child
+index or via a row/column pair. Table 'cells' may implement other
+interfaces, such as Text, Action, Image, and Component, and should do
+so as appropriate to their onscreen rresentation and/or behavior.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->