Adding descriptions for atspi-component.

[platform/upstream/at-spi2-core.git] / doc / libatspi / tmpl / atspi-component.sgml

diff --git a/doc/libatspi/tmpl/atspi-component.sgml b/doc/libatspi/tmpl/atspi-component.sgml
index 39e0915..546137e 100644 (file)
--- a/doc/libatspi/tmpl/atspi-component.sgml
+++ b/doc/libatspi/tmpl/atspi-component.sgml
@@ -2,11 +2,19 @@
 atspi-component
 
 <!-- ##### SECTION Short_Description ##### -->
-
+ An interface implemented by objects which have onscreen visual 
+ representations.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+  The Component interface is implemented by objects which occupy on-screen
+  space, e.g. objects which have onscreen visual representations. The methods
+  in Component allow clients to identify where the objects lie in the onscreen
+  coordinate system, their relative size, stacking order, and position. It
+  also provides a mechanism whereby keyboard focus may be transferred to 
+  specific user interface elements programmatically.  This is a 2D API. 
+  Coordinates of 3D objects are projected into the 2-dimensional screen view
+  for purposes of this interface.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->