Versions 0.0.8, interface, binary age 0. Fix trailing comma on

Wed Nov 21 17:54:44 2001  Owen Taylor  <otaylor@redhat.com>
        * configure.in (ATK_MICRO_VERSION): Versions 0.0.8,
        interface, binary age 0.
        * atk/atkobject.h (enum): Fix trailing comma on
        enumeration.
        * docs/atk-sections.txt: Update.
        * NEWS: Updates

16 files changed, 235 insertions, 31 deletions

diff --git a/ChangeLog b/ChangeLog
index 7767b0d..56b08de 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+Wed Nov 21 17:54:44 2001  Owen Taylor  <otaylor@redhat.com>
+
+	* configure.in (ATK_MICRO_VERSION): Versions 0.0.8,
+	interface, binary age 0.
+
+	* atk/atkobject.h (enum): Fix trailing comma on
+	enumeration.
+
+	* docs/atk-sections.txt: Update.
+
+	* NEWS: Updates
+
 2001-11-21  Padraig O'Briain  <padraig.obriain@sun.com>
 
 	* atk/atkobject.[c|h]:
diff --git a/NEWS b/NEWS
index 3fd8764..6a943f4 100644
--- a/NEWS
+++ b/NEWS
@@ -1,8 +1,18 @@
+Changes in 0.7
+
+* Some restructuring of how change notification works, use
+  signals not properties in some cases. [Padraig O'Briain, Bill Haneman] 
+* Various small API fixes and improvements [Padraig]
+* Add key event hooks [Bill]
+* Documentation improvements [Padraig]
+* Win32 build improvements [Tor Lillqvist]
+* Bug fixes [Padraig, Bill]
+
 Changes in 0.6
 
 * Small improvements to AtkText, AtkRelation, AtkObject APIs. 
   [Padraig O'Briain, Bill Haneman]
-* Win32 build fixes [Tor Lillqvst]
+* Win32 build fixes [Tor Lillqvist]
 * Bug fixes and optimizations [Padraig]
 * Makefile fix [Jacob Berkman]
 * Doc improvements [Padraig]
diff --git a/atk/atkobject.h b/atk/atkobject.h
index 46016f4..576fecb 100755
--- a/atk/atkobject.h
+++ b/atk/atkobject.h
@@ -208,7 +208,7 @@ typedef enum
   ATK_LAYER_WIDGET,
   ATK_LAYER_MDI,
   ATK_LAYER_POPUP,
-  ATK_LAYER_OVERLAY,
+  ATK_LAYER_OVERLAY
 } AtkLayer;
 
 #define ATK_TYPE_OBJECT                           (atk_object_get_type ())
diff --git a/configure.in b/configure.in
index 3d14154..16c6420 100644
--- a/configure.in
+++ b/configure.in
@@ -26,7 +26,7 @@ dnl ==========================================================================
 
 ATK_MAJOR_VERSION=0
 ATK_MINOR_VERSION=0
-ATK_MICRO_VERSION=7
+ATK_MICRO_VERSION=8
 ATK_INTERFACE_AGE=0
 ATK_BINARY_AGE=0
 ## with 1.0 you'd insert MINOR_VERSION in here, i.e. 0.3->1.0.0->1.0.1->1.0.2
diff --git a/docs/Makefile.am b/docs/Makefile.am
index d993720..1218321 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -15,7 +15,8 @@ INSTALLDIR=$(prefix)/share/gtk-doc
 
 HTML_DIR = ${datadir}/gtk-doc/html
 
-TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
+# Header files to ignore when scanning
+IGNORE_HFILES =	atkmarshal.h
 
 # Images to copy into HTML directory
 HTML_IMAGES =
@@ -41,18 +42,20 @@ GPATH = $(srcdir)
 
 TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
 
-EXTRA_DIST =				\
+EXTRA_DIST = 				\
 	$(content_files)		\
 	$(extra_files)			\
 	$(HTML_IMAGES)			\
 	$(DOC_MAIN_SGML_FILE)		\
+	$(DOC_MODULE).types		\
 	$(DOC_MODULE)-sections.txt	\
 	$(DOC_MODULE)-overrides.txt
 
-DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \	   $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
+DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \
+	   $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
 
-SCANOBJ_FILES =			\
-	$(DOC_MODULE).args	\
+SCANOBJ_FILES = 		\
+	$(DOC_MODULE).args 	\
 	$(DOC_MODULE).hierarchy \
 	$(DOC_MODULE).signals
 
@@ -65,12 +68,12 @@ scan-build.stamp: $(HFILE_GLOB)
 	@echo '*** Scanning header files ***'
 	if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \
 	    CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \
-		else \
-	cd $(srcdir) ; \
-	for i in $(SCANOBJ_FILES) ; do \
-		test -f $$i || touch $$i ; \
-	done \
-        fi
+	else \
+	    cd $(srcdir) ; \
+	    for i in $(SCANOBJ_FILES) ; do \
+               test -f $$i || touch $$i ; \
+	    done \
+	fi
 	cd $(srcdir) && \
 	  gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES)
 	touch scan-build.stamp
@@ -93,7 +96,7 @@ tmpl.stamp: tmpl-build.stamp
 sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
 	@echo '*** Building SGML ***'
 	cd $(srcdir) && \
-        gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS)
+	gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS)
 	touch sgml-build.stamp
 
 sgml.stamp: sgml-build.stamp
@@ -103,10 +106,11 @@ sgml.stamp: sgml-build.stamp
 
 html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
 	@echo '*** Building HTML ***'
-	test -d $(srcdir)/html || mkdir $(srcdir)/html
+	rm -rf $(srcdir)/html 
+	mkdir $(srcdir)/html
 	cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
 	test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html )
-	@echo '-- Fixing Crossreferences'
+	@echo '-- Fixing Crossreferences' 
 	cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
 	touch html-build.stamp
 endif
@@ -121,13 +125,13 @@ maintainer-clean-local: clean
 
 install-data-local:
 	$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
-	(installfiles=`echo $(srcdir)/html/*.html`; \
-	if test "$$installfiles" = '$(srcdir)/html/*.html'; \
+	(installfiles=`echo $(srcdir)/html/*`; \
+	if test "$$installfiles" = '$(srcdir)/html/*'; \
 	then echo '-- Nothing to install' ; \
 	else \
 	  for i in $$installfiles; do \
-	echo '-- Installing '$$i ; \
-	$(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
+	    echo '-- Installing '$$i ; \
+	    $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
 	  done; \
 	  echo '-- Installing $(srcdir)/html/index.sgml' ; \
 	  $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \
@@ -150,12 +154,6 @@ dist-hook: dist-check-gtkdoc dist-hook-local
 	mkdir $(distdir)/html
 	-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
 	-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
-	cp $(srcdir)/html/index.sgml $(distdir)/html
-	-cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html
-
-	images=$(HTML_IMAGES) ;			\
-	for i in $$images ; do			\
-	  cp $(srcdir)/$$i $(distdir)/html ;  \
-	done
+	-cp $(srcdir)/html/* $(distdir)/html
 
-.PHONY : html sgml templates scan dist-hook-local
+.PHONY : dist-hook-local
diff --git a/docs/atk-sections.txt b/docs/atk-sections.txt
index 966621a..c65deff 100644
--- a/docs/atk-sections.txt
+++ b/docs/atk-sections.txt
@@ -113,6 +113,7 @@ atk_image_get_type
 <SECTION>
 <FILE>atknoopobject</FILE>
 <TITLE>AtkNoOpObject</TITLE>
+AtkNoOpObject
 atk_no_op_object_new
 <SUBSECTION Standard>
 ATK_NO_OP_OBJECT
@@ -127,6 +128,7 @@ ATK_NO_OP_OBJECT_GET_CLASS
 <SECTION>
 <FILE>atknoopobjectfactory</FILE>
 <TITLE>AtkNoOpObjectFactory</TITLE>
+AtkNoOpObjectFactory
 atk_no_op_object_factory_new
 <SUBSECTION Standard>
 ATK_NO_OP_OBJECT_FACTORY
@@ -141,6 +143,7 @@ ATK_NO_OP_OBJECT_FACTORY_GET_CLASS
 <SECTION>
 <FILE>atkobject</FILE>
 <TITLE>AtkObject</TITLE>
+AtkObject
 AtkRole
 atk_role_register
 AtkLayer
@@ -187,6 +190,7 @@ atk_object_get_type
 <SECTION>
 <FILE>atkobjectfactory</FILE>
 <TITLE>AtkObjectFactory</TITLE>
+AtkObjectFactory
 atk_object_factory_create_accessible
 atk_object_factory_invalidate
 <SUBSECTION Standard>
@@ -202,6 +206,7 @@ ATK_OBJECT_FACTORY_GET_CLASS
 <SECTION>
 <FILE>atkregistry</FILE>
 <TITLE>AtkRegistry</TITLE>
+AtkRegistry
 atk_registry_set_factory_type
 atk_registry_get_factory_type
 atk_registry_get_factory
@@ -210,6 +215,7 @@ atk_get_default_registry
 ATK_REGISTRY
 ATK_IS_REGISTRY
 ATK_TYPE_REGISTRY
+atk_registry_get_type
 ATK_REGISTRY_CLASS
 ATK_IS_REGISTRY_CLASS
 ATK_REGISTRY_GET_CLASS
@@ -218,8 +224,10 @@ ATK_REGISTRY_GET_CLASS
 <SECTION>
 <FILE>atkrelation</FILE>
 <TITLE>AtkRelation</TITLE>
+AtkRelation
 AtkRelationType
 atk_relation_type_register
+atk_relation_type_from_string
 atk_relation_new
 atk_relation_get_relation_type
 atk_relation_get_target
@@ -396,6 +404,7 @@ atk_value_get_type
 <SECTION>
 <FILE>atkhyperlink</FILE>
 <TITLE>AtkHyperlink</TITLE>
+AtkHyperlink
 atk_hyperlink_get_uri
 atk_hyperlink_get_object
 atk_hyperlink_get_end_index
@@ -425,28 +434,47 @@ atk_state_type_for_name
 <SECTION>
 <FILE>atkstreamablecontent</FILE>
 <TITLE>AtkStreamableContent</TITLE>
+AtkStreamableContent
+AtkStreamableContentIface
 atk_streamable_content_get_n_mime_types
 atk_streamable_content_get_mime_type
 atk_streamable_content_get_stream	
 <SUBSECTION Standard>
+ATK_STREAMABLE_CONTENT
+ATK_IS_STREAMABLE_CONTENT
+ATK_TYPE_STREAMABLE_CONTENT
 atk_streamable_content_get_type
+ATK_STREAMABLE_CONTENT_GET_IFACE
 </SECTION>
 
 <SECTION>
 <FILE>atkutil</FILE>
 <TITLE>AtkUtil</TITLE>
+AtkUtil
 AtkCoordType
 atk_add_focus_tracker
 atk_remove_focus_tracker
 atk_focus_tracker_init
 atk_focus_tracker_notify
+AtkEventListener
+AtkEventListenerInit
 atk_add_global_event_listener
 atk_remove_global_event_listener
+AtkKeyEventStruct
+AtkKeyEventType
+AtkKeySnoopFunc
+atk_add_key_event_listener
+atk_remove_key_event_listener
 atk_get_root
 atk_get_toolkit_name
 atk_get_toolkit_version
 <SUBSECTION Standard>
-AtkEventListener
-AtkEventListenerInit
+ATK_UTIL
+ATK_IS_UTIL
+ATK_TYPE_UTIL
+atk_util_get_type
+ATK_UTIL_CLASS
+ATK_IS_UTIL_CLASS
+ATK_UTIL_GET_CLASS
 </SECTION>
 
diff --git a/docs/atk.types b/docs/atk.types
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/docs/atk.types
diff --git a/docs/tmpl/atkhyperlink.sgml b/docs/tmpl/atkhyperlink.sgml
index 941a348..6a55e80 100644
--- a/docs/tmpl/atkhyperlink.sgml
+++ b/docs/tmpl/atkhyperlink.sgml
@@ -14,6 +14,13 @@ AtkHyperlink
 
 </para>
 
+<!-- ##### STRUCT AtkHyperlink ##### -->
+<para>
+
+</para>
+
+@parent: 
+
 <!-- ##### FUNCTION atk_hyperlink_get_uri ##### -->
 <para>
 
diff --git a/docs/tmpl/atknoopobject.sgml b/docs/tmpl/atknoopobject.sgml
index eb2114f..2a6a21e 100644
--- a/docs/tmpl/atknoopobject.sgml
+++ b/docs/tmpl/atknoopobject.sgml
@@ -14,6 +14,13 @@ Provides non-functioning stub #AtkObjects.
 
 </para>
 
+<!-- ##### STRUCT AtkNoOpObject ##### -->
+<para>
+
+</para>
+
+@parent: 
+
 <!-- ##### FUNCTION atk_no_op_object_new ##### -->
 <para>
 
diff --git a/docs/tmpl/atknoopobjectfactory.sgml b/docs/tmpl/atknoopobjectfactory.sgml
index 96ff764..38c2c3e 100644
--- a/docs/tmpl/atknoopobjectfactory.sgml
+++ b/docs/tmpl/atknoopobjectfactory.sgml
@@ -14,6 +14,13 @@ An #AtkObjectFactory which creates non-functioning stub #AtkObjects.
 
 </para>
 
+<!-- ##### STRUCT AtkNoOpObjectFactory ##### -->
+<para>
+
+</para>
+
+@parent: 
+
 <!-- ##### FUNCTION atk_no_op_object_factory_new ##### -->
 <para>
 
diff --git a/docs/tmpl/atkobject.sgml b/docs/tmpl/atkobject.sgml
index 5cab149..5c895d7 100644
--- a/docs/tmpl/atkobject.sgml
+++ b/docs/tmpl/atkobject.sgml
@@ -19,6 +19,19 @@ of the other ATK interfaces:
 
 </para>
 
+<!-- ##### STRUCT AtkObject ##### -->
+<para>
+
+</para>
+
+@parent: 
+@description: 
+@name: 
+@accessible_parent: 
+@role: 
+@relation_set: 
+@layer: 
+
 <!-- ##### ENUM AtkRole ##### -->
 <para>
 
diff --git a/docs/tmpl/atkobjectfactory.sgml b/docs/tmpl/atkobjectfactory.sgml
index ec56949..77b6827 100644
--- a/docs/tmpl/atkobjectfactory.sgml
+++ b/docs/tmpl/atkobjectfactory.sgml
@@ -15,6 +15,13 @@ A factory for creating #AtkObjects.
 
 </para>
 
+<!-- ##### STRUCT AtkObjectFactory ##### -->
+<para>
+
+</para>
+
+@parent: 
+
 <!-- ##### FUNCTION atk_object_factory_create_accessible ##### -->
 <para>
 
diff --git a/docs/tmpl/atkregistry.sgml b/docs/tmpl/atkregistry.sgml
index ebc68ec..61d2dfb 100644
--- a/docs/tmpl/atkregistry.sgml
+++ b/docs/tmpl/atkregistry.sgml
@@ -15,6 +15,15 @@ A registry for registering new #AtkObject factories.
 
 </para>
 
+<!-- ##### STRUCT AtkRegistry ##### -->
+<para>
+
+</para>
+
+@parent: 
+@factory_type_registry: 
+@factory_singleton_cache: 
+
 <!-- ##### FUNCTION atk_registry_set_factory_type ##### -->
 <para>
 
diff --git a/docs/tmpl/atkrelation.sgml b/docs/tmpl/atkrelation.sgml
index 8b6969a..04d11da 100644
--- a/docs/tmpl/atkrelation.sgml
+++ b/docs/tmpl/atkrelation.sgml
@@ -14,6 +14,15 @@ Defines the functional relationship between two #AtkObjects.
 
 </para>
 
+<!-- ##### STRUCT AtkRelation ##### -->
+<para>
+
+</para>
+
+@parent: 
+@target: 
+@relationship: 
+
 <!-- ##### ENUM AtkRelationType ##### -->
 <para>
 
@@ -37,6 +46,15 @@ Defines the functional relationship between two #AtkObjects.
 @Returns: 
 
 
+<!-- ##### FUNCTION atk_relation_type_from_string ##### -->
+<para>
+
+</para>
+
+@name: 
+@Returns: 
+
+
 <!-- ##### FUNCTION atk_relation_new ##### -->
 <para>
 
diff --git a/docs/tmpl/atkstreamablecontent.sgml b/docs/tmpl/atkstreamablecontent.sgml
index 65bcdfe..8eab311 100644
--- a/docs/tmpl/atkstreamablecontent.sgml
+++ b/docs/tmpl/atkstreamablecontent.sgml
@@ -15,6 +15,22 @@ that contains streamable content.
 
 </para>
 
+<!-- ##### STRUCT AtkStreamableContent ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT AtkStreamableContentIface ##### -->
+<para>
+
+</para>
+
+@parent: 
+@get_n_mime_types: 
+@get_mime_type: 
+@get_stream: 
+
 <!-- ##### FUNCTION atk_streamable_content_get_n_mime_types ##### -->
 <para>
 
diff --git a/docs/tmpl/atkutil.sgml b/docs/tmpl/atkutil.sgml
index 027f90e..bd03dde 100644
--- a/docs/tmpl/atkutil.sgml
+++ b/docs/tmpl/atkutil.sgml
@@ -14,6 +14,13 @@ The AtkUtility interface provides general purpose utility functions.
 
 </para>
 
+<!-- ##### STRUCT AtkUtil ##### -->
+<para>
+
+</para>
+
+@parent: 
+
 <!-- ##### ENUM AtkCoordType ##### -->
 <para>
 
@@ -55,6 +62,21 @@ The AtkUtility interface provides general purpose utility functions.
 @object: 
 
 
+<!-- ##### USER_FUNCTION AtkEventListener ##### -->
+<para>
+
+</para>
+
+@Param1: 
+
+
+<!-- ##### USER_FUNCTION AtkEventListenerInit ##### -->
+<para>
+
+</para>
+
+
+
 <!-- ##### FUNCTION atk_add_global_event_listener ##### -->
 <para>
 
@@ -73,6 +95,56 @@ The AtkUtility interface provides general purpose utility functions.
 @listener_id: 
 
 
+<!-- ##### STRUCT AtkKeyEventStruct ##### -->
+<para>
+
+</para>
+
+@type: 
+@state: 
+@keyval: 
+@length: 
+@string: 
+@keycode: 
+@timestamp: 
+
+<!-- ##### ENUM AtkKeyEventType ##### -->
+<para>
+
+</para>
+
+@ATK_KEY_EVENT_PRESS: 
+@ATK_KEY_EVENT_RELEASE: 
+@ATK_KEY_EVENT_LAST_DEFINED: 
+
+<!-- ##### USER_FUNCTION AtkKeySnoopFunc ##### -->
+<para>
+
+</para>
+
+@event: 
+@func_data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION atk_add_key_event_listener ##### -->
+<para>
+
+</para>
+
+@listener: 
+@data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION atk_remove_key_event_listener ##### -->
+<para>
+
+</para>
+
+@listener_id: 
+
+
 <!-- ##### FUNCTION atk_get_root ##### -->
 <para>