Added directory 'util' for accessibility-related
[platform/core/uifw/at-spi2-atk.git] / ChangeLog
index 46371f7..b1580f9 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,463 @@
+<2001-09-27  Bill Haneman <bill.haneman@sun.com>
+
+       * util:
+       * util/Makefile.am: 
+               Created a new directory for 
+                       accessibility-related utilities, primarily for
+                       testing and demo purposes, but with possible
+                       end-user utility.
+       
+       * util/magnifier.c:
+       * util/magnifier.h:
+       * util/mag_image.c:
+       * util/mag_image.h:
+               Onscreen magnifier utility that
+                       is implemented as a bonobo service.
+       
+       * util/mag_client.c:
+       * util/mag_client.h:
+               Client-side support (simple C bindings) 
+                       for Magnification service
+       
+       * util/mag_control.c:
+               Client program example for 
+                       Magnification service
+       
+       * util/Accessibility_Magnifier.server.in:
+               Bonobo-activation file for the 
+                       Magnification service.
+       
+       * util/idl:
+       * util/idl/Magnifier.idl:
+               IDL defining the bonobo Magnification
+                       service interface.
+
+       * test/simple-at.c:
+               Modifications to use the bonobo-activated magnifier
+                       above, in place of trying to connect to an existing
+                       magnifier that uses socket-listening IPC.
+
+               If env variable MAGNIFIER is set, a magnifier service
+                       will be started if one does not exist.
+       
+<2001-09-25  Bill Haneman <bill.haneman@sun.com>
+       * at-bridge/bridge.c:
+               applied patch from Marc to build and run 
+               against new glib and gtk+ (seemed like a change 
+               to bonobo_init signature was made ?)
+       * test/simple-at.c:
+               made festival-server support turned off by default.
+               Added support for a simple magnifier (off by default)
+               which will be added to a 'util' directory later.
+       * at-bridge/Makefile.am:
+               Changed "application.h" header from a 'source'
+               to a 'dependency' of libat-bridge.
+
+<2001-09-12  Marc Mulcahy <marc.mulcahy@sun.com>
+       * cspi/Makefile.am:
+               Added spi-util.c.
+
+       * cspi/spi-util.c:
+               Fixed typo
+
+       * cspi/spi.c:
+               Added interface implementation c files to list of
+                       includes so they are included in libcspi.
+
+       * cspi/spi.h:
+               Changed prototype of AccessibleAction_doAction to return a
+                       boolean.
+               Changed prototype of AccessibleTable_getCaption to
+                       return an Accessible.
+               Changed prototype of AccessibleTable_getSelectedRows
+                       and AccessibleTable_getSelectedColumns to
+                       return a long (returns the number of selected rows
+                       or columns respectively).
+               Changed name of AccessibleText_refRunAttributes to
+                       AccessibleText_getAttributes.
+               Changed prototype of AccessibleText_getCharacterExtents to
+                       return a void rather than a boolean. 
+               Added support for a AccessibleCoordType parameter
+                       specifying what type of coordinates are desired.
+               Added an AccessibleCordType parameter to
+                       AccessibleText_getPointAtOffset.
+
+       * cspi/spi_accessible.c:
+               Added code to return the outstanding interfaces from
+                       Accessible_queryInterface.
+
+       * cspi/spi_action.c:
+               Fixed typos.
+               Corrected call to getNActions to call the c binding
+                       for an attribute.
+
+       * cspi/spi_editabletext.c:
+               Fixed typos.
+               Changed name from setRunAttributes to setAttributes.
+
+       * cspi/spi_hyperlink.c:
+               Fixed typos.
+               Changed call to getNAnchors to correctly call the c
+                       binding for an attribute.
+
+       * cspi/spi_hypertext.c:
+               Fixed typos.
+               Changed getImageDescription to correctly call the
+                       binding for an attribute.
+
+       * cspi/spi_selection.c:
+               Changed getNSelectedChildren to correctly call the c
+                       binding for the attribute.
+               Changed refSelectedChild to getSelectedChild.
+
+       * cspi/spi_table.c:
+               Fixed typos.
+               Changed getCaption to return an Accessible.
+               Fixed calls which retrieve attributes.
+               Changed refAt to getAccessibleAt.
+               Changed getNSelectedRows and getNSelectedColumns to
+                       return longs.
+
+       * cspi/spi_text.c:
+               Changed getCharacterExtents and getPointAtOffset to accept an
+                       AccessibleCoordType.
+               Fixed typos.
+               Changed calls which retrieve attributes.
+               Changed refRunAttributes to getAttributes.
+
+       * cspi/spi_value.c:
+               Fixed typos.
+
+       * idl/Hyperlink.idl:
+               Changed n_anchors attribute to nAnchors to keep naming
+                       convention consistent.
+
+       * idl/Table.idl:
+               Made Table inherit from Bonobo::Unknown.
+               Added nSelectedColumns and nSelectedRows attributes.
+
+       * idl/Value.idl:
+               Made Value inherit from Bonobo::Unknown.
+
+       * libspi/hyperlink.c:
+               Change for nAnchors attributte name change.
+
+<2001-09-12  Marc Mulcahy <marc.mulcahy@sun.com>
+       * cspi/Makefile.am:
+               Added spi-util.c.
+
+       * cspi/spi-util.c:
+               Fixed typo
+
+       * cspi/spi.c:
+               Added interface implementation c files to list of
+                       includes so they are included in libcspi.
+
+       * cspi/spi.h:
+               Changed prototype of AccessibleAction_doAction to return a
+                       boolean.
+               Changed prototype of AccessibleTable_getCaption to
+                       return an Accessible.
+               Changed prototype of AccessibleTable_getSelectedRows
+                       and AccessibleTable_getSelectedColumns to
+                       return a long (returns the number of selected rows
+                       or columns respectively).
+               Changed name of AccessibleText_refRunAttributes to
+                       AccessibleText_getAttributes.
+               Changed prototype of AccessibleText_getCharacterExtents to
+                       return a void rather than a boolean. 
+               Added support for a AccessibleCoordType parameter
+                       specifying what type of coordinates are desired.
+               Added an AccessibleCordType parameter to
+                       AccessibleText_getPointAtOffset.
+
+       * cspi/spi_accessible.c:
+               Added code to return the outstanding interfaces from
+                       Accessible_queryInterface.
+
+       * cspi/spi_action.c:
+               Fixed typos.
+               Corrected call to getNActions to call the c binding
+                       for an attribute.
+
+       * cspi/spi_editabletext.c:
+               Fixed typos.
+               Changed name from setRunAttributes to setAttributes.
+
+       * cspi/spi_hyperlink.c:
+               Fixed typos.
+               Changed call to getNAnchors to correctly call the c
+                       binding for an attribute.
+
+       * cspi/spi_hypertext.c:
+               Fixed typos.
+               Changed getImageDescription to correctly call the
+                       binding for an attribute.
+
+       * cspi/spi_selection.c:
+               Changed getNSelectedChildren to correctly call the c
+                       binding for the attribute.
+               Changed refSelectedChild to getSelectedChild.
+
+       * cspi/spi_table.c:
+               Fixed typos.
+               Changed getCaption to return an Accessible.
+               Fixed calls which retrieve attributes.
+               Changed refAt to getAccessibleAt.
+               Changed getNSelectedRows and getNSelectedColumns to
+                       return longs.
+
+       * cspi/spi_text.c:
+               Changed getCharacterExtents and getPointAtOffset to accept an
+                       AccessibleCoordType.
+               Fixed typos.
+               Changed calls which retrieve attributes.
+               Changed refRunAttributes to getAttributes.
+
+       * cspi/spi_value.c:
+               Fixed typos.
+
+       * idl/Hyperlink.idl:
+               Changed n_anchors attribute to nAnchors to keep naming
+                       convention consistent.
+
+       * idl/Table.idl:
+               Made Table inherit from Bonobo::Unknown.
+               Added nSelectedColumns and nSelectedRows attributes.
+
+       * idl/Value.idl:
+               Made Value inherit from Bonobo::Unknown.
+
+       * libspi/hyperlink.c:
+               Change for nAnchors attributte name change.
+
+
+<2001-09-05  Marc Mulcahy <marc.mulcahy@sun.com>
+
+       implementations-- made server implementations own AtkObject pointers
+       rather than their respective AtkInterrface pointers to fix
+       refcounting.  AtkHyperlink is still broken.
+
+<2001-09-04  Bill Haneman <bill.haneman@sun.com>
+       * cspi/spi_accessible.c:
+               Added method Accessible_Role_getName(),
+                       and requisite string array (role_names).
+               Added conversion string_from_corba_strin() call
+                       to Accessible_getName and _getDescription.
+       * libspi/accessible.c:
+               Added implementation for Accessible_getRole()
+       * test/simple-at.c:
+               Added festival support, used if environment variable
+                       FESTIVAL is set.
+       
+2001-09-04  Bill Haneman <bill.haneman@sun.com>
+
+       * at-bridge/bridge.c:
+           Now allocate Accessibility_Event using
+           Accessibility_Event__alloc() instead of g_new0().
+       * libspi/accessibleeventlistener.c:
+           Initialize AccessibleEventListener->callbacks to NULL.
+           Fixed accessible__event_listener_init() param, changed to
+           "AccessibleEventListener *" type.
+           Changed a bonobo_object_release_unref() call to
+           Accessibility_Accessible_unref().
+       * libspi/listener.c:
+           Changed Bonobo_Unknown_unref to (equivalent) 
+           Accessibility_Accessible_unref.
+       * libspi/registry.c:
+           Changed bonobo_object_release_unref to 
+           Accessibility_Accessible_unref.
+       
+<2001-09-04  Marc Mulcahy <marc.mulcahy@sun.com>
+       
+       * Added files:
+           spi_action.c spi_editabletext.c spi_hyperlink.c spi_hypertext.c
+           spi_image.c spi_selection.c spi_table.c spi_text.c spi_value.c
+           spi-util.c spi-util.h
+           Implementations for C bindings to remaining accessibility 
+           interfaces.
+
+<2001-09-04 Marc Mulcahy <marc.mulcahy@sun.com>
+       
+       * idl/Action.idl:
+           changed return value of Action from void to boolean to 
+           bring in line with ATK.
+
+       * idl/Text.idl:
+           Changed getText funcions to return "out" start and end offsets.
+           Changed getAttributes to take and offset and return the start 
+           and end offset of the attribute run.
+           Changed getOffsetAtPoint and getCharacterExtents to take an 
+            enum describing whether coordinates are window or screen.
+
+       * Added files:
+           libspi/action.c libspi/action.h libspi/editabletext.c 
+           libspi/editabletext.h libspi/hyperlink.c libspi/hyperlink.h
+           libspi/hypertext.c libspi/hypertext.h libspi/image.c 
+           libspi/image.h libspi/selection.c libspi/selection.h
+           libspi/table.c libspi/table.h libspi/text.c libspi/text.h 
+           libspi/value.c libspi/value.h
+           Added server implementations for outstanding ATK interfaces 
+           not yet implemented.
+2001-09-04  Bill Haneman <bill.haneman@sun.com>
+
+       * idl/Action.idl:
+               Added (missing) getName() method. 
+               Made nActions an attribute.
+       * idl/EditableText.idl:
+               Changed order of params in setAttributes.
+       * idl/Hyperlink.idl:
+               Removed getAnchor, added getURI.
+       * idl/Image.idl:
+               Changed attributes to methods, for efficiency
+               (so that getting extents can be done in one call)
+       * idl/Selection.idl:
+               Changed nSelectedChildren to attribute, and re-indented.
+       * idl/Table.idl: changed nrows, ncolumns, caption, summary 
+               to attributes.
+       * idl/Text.idl: reformatted to match our coding style.
+               (temporarily?) removed getRowColumnAtOffset().
+               Changed text selection API to support multi-select and
+               non-contiguous selections, as in ATK.
+       * idl/Value.idl: changed some methods to attributes.
+
+2001-08-24  Mark McLoughlin <mark@skynet.ie>
+
+       * libspi/listener.c(impl_notify_event):
+       BonoboUnkown_unref the source instead
+       of bonobo_object_release_unref - the ORB
+       handles the releasing.
+
+       * configure.in: require ORBit-2.3.94 for
+       this behaviour.
+
+2001-08-21  Bill Haneman <bill.haneman@sun.com>
+
+        Tagged CVS repository 'EA_1_0'.
+        * README.EARLY_ACCESS:
+        Alphabetized acknowledgements list, and
+        added someone.
+        Listed some known dependencies of at-spi.
+
+2001-08-20  Bill Haneman <bill.haneman@sun.com>
+
+       * docs/at-spi-docs.sgml:
+       * docs/at-spi-sections.txt:
+       * docs/at-spi-overrides.txt: (Added zero-length file)
+       Documentation improvements - gtk-doc should build
+       docs for all implemented C bindings now.
+       * cspi/Makefile.am:
+       * cspi/spi_main.c:
+       * cspi/spi.c: (New file)
+       * cspi/spi_event.c: (New file)
+       * cspi/spi_registry.c: (New file)
+       * cspi/spi_accessible.c: (New file)
+       * cspi/spi_application.c: (New file)
+       * cspi/spi_component.c: (New file)
+       Split spi_main.c into six parts, and included them from
+       "spi.c".  This is a bit of a hack, probably temporary,
+       but required by gtk-doc, apparently.
+       
+2001-08-20  Bill Haneman <bill.haneman@sun.com>
+
+       * docs/Makefile.am:
+       * docs/at-spi-docs.sgml:
+       * docs/at-spi-sections.txt:
+       * configure.in:
+       Initial checkins/modifications for gtk-doc generation.
+       * cspi/spi.h:
+       * cspi/spi.c:
+       Added (missing) interface query methods to Accessible's C binding.
+       * cspi/spi-impl.h:
+       Added GenericInterface type definition.
+       * test/simple-at.c:
+       Added query for AccessibleComponent interface to focus event handler.
+       Added printout of bounding box for focussed component.
+       * libspi/component.c:
+       Added partial implementation for AccessibleComponent to C binding.
+       * idl/Application.idl:
+       * libspi/registry.c:
+       * libspi/listener.c:
+       * libspi/application.c:
+       * libspi/application.h:
+       Changed "ID" attribute type from string to long.
+
+2001-08-19  Bill Haneman <bill.haneman@sun.com>
+
+       * cspi/spi.h:
+       * cspi/spi.c:
+       Made method naming consistent: methods taking object args
+       start with uppercase, other methods (except those using
+       acronyms) start with lowercase.  Underscores delimit between
+       object names and method names:
+       SPI_init() - uppercase since it starts with an acronym.
+       getDesktopCount () - lowercase start since no object param0.
+       Accessible_getName() - uppercase object type name, studlyCaps method
+                              name.
+
+       *cspi/spi.h:
+       Added gtk-doc documentation for all currently implemented
+       methods in the C bindings API.
+
+2001-08-18  Bill Haneman <bill.haneman@sun.com>
+
+       * Makefile.am : changed build order to build test last.
+       * cspi/spi.h :
+       * cspi/spi_main.c :
+       Changed "createEventListener" to "CreateEventListener".
+       * libspi/accessibleeventlistener.c :
+       Bugfix for addition of callbacks.
+       * test/Makefile.am :
+       * test/simple-at.c :
+       Added new test that uses the C bindings API.
+       * idl/Event.idl :
+       * libspi/listener.c :
+       * libspi/registry.c :
+       * libspi/accessibleeventlistener.c :
+       * at-bridge/bridge.c :
+       Renamed member "target" of Accessibility_Event to "source",
+       which is more descriptive.
+       
+
+2001-08-18  Bill Haneman <bill.haneman@sun.com>
+
+       * Makefile.am: 
+       * configure.in :
+       * cspi/Makefile.am :
+       Added makefile support for at-spi/cspi directory.
+       * cspi/spi.h : 
+       * cspi/spi-impl.h :
+       * cspi/spi-listener.h : (NEW FILE)
+       Added support for/use of spi-listener.h.
+       * cspi/spi_main.c :
+       C bindings now build successfully, with no warnings.
+       * libspi/accessibleeventlistener.h : (NEW FILE)
+       * libspi/accessibleeventlistener.c : (NEW FILE)
+       * libspi/Makefile.am :
+       Added new object type "AccessibleEventListener"
+       which inherits from Listener, and allows attachment
+       of in-process callbacks (so that a client with a listening
+       object instance can add functionality to the local 
+       implementation, dynamically).
+
+2001-08-18  Bill Haneman <bill.haneman@sun.com>
+
+       * libspi/accessible.c: 
+       Add implementation for get_index_in_parent().
+       * cspi/spi.h : 
+       Added #include of "spi-roletypes.h", and
+       added enumerated type AccessibleCoordType.
+       Added definition for KeystrokeListener (function type).
+
+       ADDED FILES:
+       * cspi/spi-statetypes.h :
+       * cspi/spi-roletypes.h :
+       * cspi/spi-impl.h :
+       Added these headers, used by spi.h.
+       * cspi/spi_main.c : 
+       Added code (NOTE: not yet built by make).
+
 2001-08-18  Mark McLoughlin <mark@skynet.ie>
 
        * libspi/Makefile.am: generate imodule
        and we now relay those focus events to any "focus:" listeners.
        This now works with the bridge as a GTK_MODULE when running test/at.
        * libspi/registry.c :
-       * libspi/listener.c : now we ref event sources before propagating, and unref on receipt.
-       * libspi/registry.c : some changes to internal structs, to support event typestring hashes.
+       * libspi/listener.c : 
+       now we ref event sources before propagating, and unref on receipt.
+       * libspi/registry.c : 
+       some changes to internal structs, to support event typestring hashes.
        * text/app.c : changed the way the appname is generated.
        * cspi : added directory that will hold the C bindings library for 
                non-CORBA/bonobo-savvy clients.
        * idl/Hyperlink.idl : added readonly n_links attribute
        * idl/Image.idl : changed methods to attributes.
        
-       KNOWN PROBLEMS:
-       poll() fails after a few event notifications, when the number of file descriptors
-       gets too large.  Investigating.
-       
 2001-08-15  Mark McLoughlin <mark@skynet.ie>
 
        * at-bridge/Makefile.am: link against