[at-spi2-core] Adding descriptions to atspi-table.c

[Mike Gorse <mgorse src gnome org>]

commit 901e7e69a4787d8fa8836eaa8d0dfdcdac1c9883
Author: Aline Bessa <alibezz gmail com>
Date:   Wed Jul 27 23:14:33 2011 -0300

    Adding descriptions to atspi-table.c

 doc/libatspi/tmpl/atspi-table.sgml |   12 ++++++++++--
 1 files changed, 10 insertions(+), 2 deletions(-)
---
diff --git a/doc/libatspi/tmpl/atspi-table.sgml b/doc/libatspi/tmpl/atspi-table.sgml
index fc0000e..a90cea4 100644
--- 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 ##### -->