Restructured docs directory, added docs/reference/idl and docs/reference/cspi.
[platform/core/uifw/at-spi2-atk.git] / ChangeLog
index dc742e2..f7a6f58 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,8 +1,388 @@
-2001-11-13  Michael Meeks  <michael@ximian.com>
+2001-21-11  Bill Haneman  <bill.haneman@sun.com>
+
+       * configure.in:
+       * docs/Makefile.am:
+       * docs/reference:
+       * docs/reference:Makefile.am:
+       * docs/reference/cspi:
+       * docs/reference/cspi:Makefile.am:
+       * docs/reference/cspi:tmpl:
+       * docs/reference/cspi:tmpl:*.sgml:
+       * docs/reference/idl:
+       * docs/reference/idl:Makefile.am:
+       * docs/reference/idl:at-spi-idl-sections.txt:
+       * docs/reference/idl:at-spi-idl-docs.sgml:
+       * docs/reference/idl:tmpl:
+       * docs/reference/idl:tmpl:*.sgml:
+
+       Restructured docs directory to allow separate 'reference' docs
+       section, and forked idl and cspi docs.  Added the sgml template
+       files to CVS.  Added the first sections/structural sgml for the
+       IDL docs.
+
+2001-11-21  Laszlo Peter  <laca@ireland.sun.com>
+
+       * configure.in, libspi/Makefile.am: find libXtst.
+
+2001-11-21  Michael Meeks  <michael@ximian.com>
+
+       * test/accessx-gui.c: s/spi_value/value/ - doh.
+
+       * libspi/base.[ch]: add.
+
+2001-18-11  Bill Haneman <bill.haneman@sun.com>
+
+       * idl/Accessible.idl:
+       * idl/Application.idl:
+       * idl/Registry.idl:
+       * idl/Action.idl:
+       Started gtk-doc cleanup on IDL.
+
+       * libspi/deviceeventcontroller.c:
+       Added and connected non-preemptive key notification from the
+       toolkits (in addition to the pre-emptive support from XServer
+       which we had before, but which causes 'focus flashing').  Filters
+       are presently limited to key modifiers and global/non-global,
+       KeySets are presently ignored, as are KeyEvent masks.
+
+       Fixed naughtiness in dec_key_listener_new(), we copy the CORBA
+       structs into the persistant structure rather than just storing
+       pointers to things that might not persist across servant
+       invocations.
+
+       The XGrabKey call now does async keygrabs, because synchronous
+       ones were deadlocking with GDK_event code in a very nasty way.
+
+       Added boolean to internal method notify_keylisteners, to indicate
+       whether the event came from the 'toolkit source' or the 'global
+       (XServer) source' - this is used in the notification process to
+       determine which listeners to send the event to.
+
+       deviceeventcontroller.c is now warning-free.
+       
+       * libspi/registry.c:
+       Fixed regression in application de-registration.
+       Also fixed some really brain-dead weirdness having to do with
+       event dispatching - event structs are now duplicated before being
+       re-marshalled in the dispatch to listeners.  This also fixes a
+       Solaris build problem.
+       
+       
+2001-20-11  Michael Meeks  <michael@ximian.com>
+
+       * libspi/registry.c
+       (impl_accessibility_registry_deregister_global_event_listener): 
+       segv. protection.
+
+       * libspi/deviceeventcontroller.c
+       (spi_device_event_controller_check_key_event): return
+       FALSE on no virtual method.
+
+       * libspi/*..h: make includes work on a correctly pathed install.
+
+       * libspi/*.h: include glib/gmacros.h, use G_BEGIN / END _DECLS.
+
+       * libspi/application.h: kill unused ( and whacked out )
+       gboolean *spi_application_set_id (AtkObject *app, long id);
+
+2001-20-11  Michael Meeks  <michael@ximian.com>
+
+       * libspi/*.[ch]: further convert to bonobo's type func
+       macros, remove redundnant casts etc.
+
+       * libspi/text.c s/accessibility_text/spi_text/g,
+       re-order to de-cruft.
+
+       * libspi/hypertext.c: re-order to kill a huge slew
+       of redundant forward decls.
+
+       * libspi/relation.c: ditto.
+
+       * libspi/image.c: ditto.
+
+       * */.cvsignore: update
+       
+2001-20-11  Michael Meeks  <michael@ximian.com>
+
+       * libspi/deviceeventcontroller.c
+       (_controller_register_with_devices): use g_getenv,
+       kill stdlib.h include.
+
+       * libspi/keystrokelistener.c
+       (spi_keystroke_listener_get_type): kill
+       (spi_keystroke_listener_class_init),
+       (spi_keystroke_listener_init): rename to this.
+
+       * libspi/text.c (impl_getAttributes): fix warning / bug.
+
+       * libspi/*.[ch]: more headers, includes and over commenting.
+       
+2001-20-11  Michael Meeks  <michael@ximian.com>
+
+       * libspi/*.[ch]: fixup headers, includes and over commenting.
+
+       * libspi/image.c (impl__get_imageDescription): const
+       correctness warning fix. remove redundant casting.
+
+       * libspi/table.c (impl_getRowDescription): ditto.
+       (impl_getColumnDescription): ditto.
+
+       * libspi/libspi.h: add.
+
+2001-19-11  Michael Meeks  <michael@ximian.com>
+
+       * libspi/editabletext.c (impl_setAttributes): fix warnings.
+
+       * libspi/component.c (accessibility_component_get_type): 
+       rename to (spi_component_get_type): and macroify.
+       (accessibility_component_init): rename to
+       (spi_component_init): this
+       (accessibility_component_class_init): rename to
+       (spi_component_class_init): this
+
+       * libspi/action.c (spi_action_get_type): kill, use the macro.
+
+       * libspi/deviceeventcontroller.c (_compare_listeners): re-order
+       to avoid prototype.
+
+       * libspi/application.c (spi_application_object_event_listener),
+       (impl_accessibility_application_register_object_event_listener):
+       warning fixes / const understanding updates.
+
+       * libspi/accessible.c (impl_accessibility_accessible_get_relation_set):
+       warning fixes.
+
+2001-18-11  Bill Haneman <bill.haneman@sun.com>
+
+       * libspi/spi_accessible.c: Added docs and C bindings for
+       AccessibleStateSet. (No implementations yet).  Documentation
+       coverage for C bindings now 100%. Made docs for event listeners
+       more explicit.
+       
+       * idl/Registry.idl:
+       Added methods 
+            boolean notifyListenersSync (in DeviceEventListener listener,
+                                    in DeviceEvent event);
+
+            oneway void notifyListenersAsync (in DeviceEventListener listener,
+                                         in DeviceEvent event);
+
+       Added DeviceEventListener and DeviceEvent structs (may deprecate
+       KeyStroke and KeystrokeListener in favor of this generic
+       event/listener framework for devices).
+
+       * libspi/deviceeventcontroller.c:
+
+       Changed some key listener code to take masks, etc., and paved the
+       way for integration of toolkit/non-preemptive key events. Changed
+       signatures of some internal methods.
+
+       * at-bridge/bridge.c:
+        Fixed regression connecting to interface signals, apparently
+       caused by GTK+ changes.
+
+       Added an internal bridge_state_listener to deal with
+       property-change:accessible-state signals.
+
+       Changed the key_listeners GList to store structs (including masks,
+       etc.) instead of just CORBA_Objects (required for full
+       implementation of key listener API).
+
+       Connected the bridge to all currently supported Atk signals.
+       Events now supported: 
+           object:property-change
+            object:property-change:accessible-name
+            object:property-change:accessible-state
+            object:property-change:accessible-description
+            object:property-change:accessible-parent
+            object:property-change:accessible-value
+            object:property-change:accessible-role
+            object:property-change:accessible-table-caption
+            object:property-change:accessible-table-column-description
+            object:property-change:accessible-table-column-header
+            object:property-change:accessible-table-row-description
+            object:property-change:accessible-table-row-header
+            object:property-change:accessible-table-summary
+            object:children-changed
+            object:visible-data-changed
+            object:selection-changed
+            object:text-selection-changed
+            object:text-changed
+            object:text-caret-moved
+            object:row-inserted
+            object:row-reordered
+            object:row-deleted
+            object:column-inserted
+            object:column-reordered
+            object:column-deleted
+            object:model-changed        
+
+2001-16-11  Bill Haneman <bill.haneman@sun.com>
+
+       * libspi/hyperlink.c,h:
+       Fixed some broken stuff in hyperlink.
+       
+       * libspi/relation.h:
+       * libspi/relation.c:
+       * cspi/spi_accessible.c:
+       Initial implementations of AccessibleRelation methods, and docs.
+
+       * libspi/accessible.c:
+       Fixed a bug that caused SEGV  if an accessible
+       object's description is NULL, and a client
+       requests it.  An empty string is now returned.
+
+       * cspi/spi_editabletext.c:
+       * cspi/spi_hypertext.c:
+       * cspi/spi_image.c:
+       * cspi/spi_hyperlink.c:
+       * cspi/spi_table.c:
+       Added docs.  
+
+       Doc coverage now 95%.
+
+2001-16-11  Bill Haneman <bill.haneman@sun.com>
+
+       One last namespacing revision:
+       * libspi/accessibleeventlistener.[ch]:
+       Renamed SpiAccessibleEventListener to SpiEventListener,
+       (no need for two namespaces ;-)
+
+       And lots of documentation fixes:
+
+       * docs/at-spi-docs.sgml:
+       Fixed 'underscore vs. hyphen' bug that was preventing
+       the gtk-doc API docs from being automatically generated.
+
+       * cspi/spi-impl.h
+       * cspi/spi-listener.h
+       * cspi/spi.h
+       * cspi/spi_accessible.c
+       * cspi/spi_action.c
+       * cspi/spi_application.c
+       * cspi/spi_component.c
+       * cspi/spi_editabletext.c
+       * cspi/spi_event.c
+       * cspi/spi_hypertext.c
+       * cspi/spi_main.c
+       * cspi/spi_registry.c
+       * cspi/spi_selection.c
+       * cspi/spi_text.c
+       * cspi/spi_value.c
+       * docs/Makefile.am
+       * docs/at-spi-docs.sgml
+       * docs/at-spi-sections.txt
+       
+       Added and fixed up gtk-doc documentation in cspi.
+       
+       Interfaces now (fully) documented (subject to revision and enhancement):
+       SPI_main
+       Event Listener Support
+       Registry API
+       AccessibleApplication
+       Accessible
+       AccessibleAction
+       AccessibleComponent
+       AccessibleEditableText
+       AccessibleSelection
+       AccessibleText
+       AccessibleValue
+
+       still pending:
+       AccessibleStateSet
+       AccessibleRelationSet
+       AccessibleImage
+       AccessibleTable
+       AccessibleHyperlink
+       
+2001-14-11  Bill Haneman <bill.haneman@sun.com>
+
+       * at-bridge/bridge.c:
+       Initial work for toolkit-level key snooper connection by bridge.
+
+       * cspi/spi-impl.h:
+       * cspi/spi_*.h:
+       * cspi/spi_*.c:
+       New typedefs and fixes to support new namespacing, and cleaner
+       separation of cspi bindings from libspi bonobo implementation.  
+       Removed inconsistent and extraneous Spi* namespace prefix that
+       had crept into cspi headers.
+       Lots of comment fixes that sed had missed.
+
+       * cspi/spi-roletypes.h:
+       * cspi/spi-statetypes.h:
+       Added SPI_ prefix to Role and State typedefs, and changed all-caps ROLE type
+       to AccessibleRoleType.
+       
+       * libspi/accessibleeventlistener.h:
+       Fixed minor namespacing weirdness.
+
+       * libspi/deviceeventcontroller.c:
+        Reordered some internal API for device listeners.
+       Changed the key registry final boolean to 'is_system_global'
+       rather than 'is_synchronous', which is more descriptive of its 
+       actual meaning.
+       Added spi_device_event_controller_new().
+       Added  SpiRegistry backpointer to SpiDeviceEventControllerClass.
+        
+       * libspi/keystrokelistener.[ch]:
+       Namespaced KeystrokeListener to SpiKeystrokeListener.
+       Changed uses of keymasks to use SPI_ prefix, and did other
+       knock-on fixups.
+
+       * libspi/keymasks.h:
+       Namespaced keymask constants with SPI_ prefix.
+
+       * libspi/registry.c:
+       Some warning fixes, and knock-on fixes from namespace changes.
+
+       * test/Makefile.am:
+       Added rules for accessx-gui test program.
+
+       * test/accessx-gui.c:
+       Added a simple GUI program in GTK+-2.0 for the AccessX keyboard
+       utility.  It doesn't actually use at-spi, but it's still cool and
+       useful ;-)
+
+       * test/keysynth-demo.c:
+       * test/simple-at.c:
+       * test/at.c:
+       * test/app.c:
+       Fixes so that these test clients work properly with the namespaced
+       libraries. (Incompletely tested for technical reasons, fixes may follow)
+       
+
+2001-13-11  Michael Meeks  <michael@ximian.com>
+
+       * libspi/application.c
+       (impl_accessibility_application_get_version),
+       (impl_accessibility_application_get_toolkit_name):
+       warning fixes.
+       (impl_accessibility_application_set_id),
+       (impl_accessibility_application_get_id): remove
+       redundant casting code.
+
+       * libspi/action.c (impl_getDescription): fix warnings.
+
+       * libspi/accessible.c
+       (impl_accessibility_accessible_get_parent),
+       (impl_accessibility_accessible_get_child_at_index),
+       (impl_accessibility_accessible_get_state),
+       (impl_accessibility_accessible_get_relation_set):
+       warning fixes & include action.h
+
+2001-13-11  Michael Meeks  <michael@ximian.com>
+
+       * *.[ch] fix bits I screwed up:
+
+               s/([^ \tb(\*\&\?\",])spi_/\1/g;
+               s/([^ \tb(\*\&\?\",])Spi/\1/g;
+       
+2001-13-11  Michael Meeks  <michael@ximian.com>
 
        * *.[ch] Namespace libspi into spi_ and Spi.
 
-2001-11-13  Michael Meeks  <michael@ximian.com>
+2001-13-11  Michael Meeks  <michael@ximian.com>
 
        * Makefile.am: dist & install at-spi-1.0.pc
 
 
        * configure.in: build it.
 
-2001-11-12  Bill Haneman <bill.haneman@sun.com>
+2001-12-11  Bill Haneman <bill.haneman@sun.com>
 
         * test/keysynth-demo.c:
         Use a 'realize' signal-handler to set the WM properties for