INTEGRATION: CWS uaa05 (1.6.18); FILE MERGED

2003/06/12 14:50:06 af 1.6.18.1: #109196# Fixed autodoc syntax.

1 files changed, 31 insertions, 3 deletions

diff --git a/offapi/com/sun/star/modules.idl b/offapi/com/sun/star/modules.idl
index 457782c04b77..cfc6b9657a5e 100644
--- a/offapi/com/sun/star/modules.idl
+++ b/offapi/com/sun/star/modules.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: modules.idl,v $
  *
- *  $Revision: 1.6 $
+ *  $Revision: 1.7 $
  *
- *  last change: $Author: vg $ $Date: 2003-05-22 13:04:39 $
+ *  last change: $Author: vg $ $Date: 2003-06-20 09:49:10 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -66,7 +66,35 @@ module com { module sun { module star {
 /// Java AWT-like user interface toolkit interface specifications for UNO.
 module awt {};
 
-/// UNO Accessibility API
+/** UNO Accessibility API
+
+    <p>This modules contains the basic interfaces of the UAA (UNO
+    Accessibility API).  Services that describe how these interfaces are
+    implemented can be found in other modules.  The services in this module
+    describe only what every accessible object has to support.</p>
+
+    <p>Making a class accessible starts by supporting the <type
+    scope="::com::sun::star::accessibility">XAccessible</type> interface.
+    This interface' only method returns the actual accessibility object, an
+    instance of <type
+    scope="::com::sun::star::accessibility">XAccessibleContext</type>.
+    These two interfaces may be implemented by the same class in which case
+    a call to <method scope="::com::sun::star::accessibility"
+    >XAccessible::getAccessible</method> returns the same object that is
+    called.  Alternatively the implementation of the <type
+    scope="::com::sun::star::accessibility">XAccessibleContext</type>
+    interface can be done by another class.  This makes it possible to put
+    all accessibility implementations into their own library which has only
+    to be loaded when necessary.</p>
+
+    <p>Note that all other interfaces have to be implemented by the same
+    class that implements the <type
+    scope="::com::sun::star::accessibility">XAccessibleContext</type>
+    interface.  Note also that there is no way back from an accessibility
+    object to the object from which it has been obtained by means of the
+    UAA.  If you need such a back-link you have to provide one on your
+    own.</p>
+*/
 module accessibility {};
 
 /// Charting diagram interfaces.