? additions
? files
? gtkdoc.patch
? removals
cvs server: Diffing .
Index: ChangeLog
===================================================================
RCS file: /cvs/gnome/conglomerate/src/ChangeLog,v
retrieving revision 1.596
diff -u -5 -r1.596 ChangeLog
--- ChangeLog	17 Mar 2004 11:30:21 -0000	1.596
+++ ChangeLog	17 Apr 2004 17:45:20 -0000
@@ -1,5 +1,11 @@
+2004-04-17  David Hoover <karma@deadmoose.com>
+
+	Changes to LOTS of files, adding gtk-doc style comments to most
+        functions. (Bug 123318) Lots are currently placeholder comments,
+        and will be filled in later.
+
 2004-03-17  Geert Stappers <stappers@stappers.nl>
 
 	* Makefile.am
 
 	Enabled useless, but harmless lines on cong-marshal.[ch] generation.
Index: cong-app.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-app.c,v
retrieving revision 1.30
diff -u -5 -r1.30 cong-app.c
--- cong-app.c	5 Mar 2004 17:57:14 -0000	1.30
+++ cong-app.c	17 Apr 2004 17:45:21 -0000
@@ -117,38 +117,61 @@
 
 static void 
 cong_app_private_insert_element_init (CongApp *app);
 
 /* Exported function definitions: */
+/**
+ * cong_app_singleton:
+ *
+ * TODO: Write me
+ */
 CongApp*
 cong_app_singleton (void)
 {
 	g_assert(the_singleton_app);
 
 	return the_singleton_app;
 }
 
+/**
+ * cong_app_construct_singleton:
+ * @argc:
+ * @argv:
+ *
+ * TODO: Write me
+ */
 void
 cong_app_construct_singleton (int   argc,
 			      char *argv[])
 {
 	g_assert(NULL == the_singleton_app);
 
 	the_singleton_app = cong_app_new(argc,
 					 argv);
 }
 
+/**
+ * cong_app_destroy_singleton:
+ *
+ * TODO: Write me
+ */
 void
 cong_app_destroy_singleton(void)
 {
 	g_assert(the_singleton_app);
 
 	cong_app_free(the_singleton_app);
 
 	the_singleton_app = NULL;
 }
 
+/**
+ * cong_app_post_init_hack:
+ * @app:
+ *
+ * TODO: Write me
+ */
 int
 cong_app_post_init_hack (CongApp *app)
 {
 	
 	/* Load all the displayspec (xds) files: */
@@ -272,10 +295,17 @@
 		g_free (atom_name);
 	}
 }
 #endif
 
+/**
+ * convert_ucs2_to_utf8:
+ * @data:
+ * @length:
+ *
+ * TODO: Write me
+ */
 gchar*
 convert_ucs2_to_utf8 (guchar *data,
 		      gint length)
 {
 	return g_utf16_to_utf8 ((const gunichar2 *)data,
@@ -283,10 +313,17 @@
 				NULL,
 				NULL,
 				NULL);
 }
 
+/**
+ * convert_utf8_string:
+ * @data:
+ * @length:
+ *
+ * TODO: Write me
+ */
 gchar*
 convert_utf8_string (guchar *data, 
 		     gint length)
 {
 	g_return_val_if_fail (data, NULL);
@@ -294,19 +331,35 @@
 	/* It should be a valid UTF-8 string; escape as necessary: */
 	return g_markup_escape_text ((const gchar *)data,
 				     (gssize)length);
 }
 
+/**
+ * convert_text_xml:
+ * @data:
+ * @length:
+ *
+ * This function is not currently implemented
+ *
+ * Returns: %NULL
+ */
 gchar*
 convert_text_xml (guchar *data, 
 		  gint length)
 {
 	g_return_val_if_fail (data, NULL);
 
 	return NULL;
 }
 
+/**
+ * convert_text_html:
+ * @data:
+ * @length:
+ *
+ * TODO: Write me
+ */
 gchar*
 convert_text_html (guchar *data, 
 		   gint length)
 {
 	g_return_val_if_fail (data, NULL);
@@ -318,28 +371,55 @@
 	/* Assume that it's valid UTF-8 HTML: */
 	return g_strndup (data, length);
 #endif
 }
 
+/**
+ * convert_text_plain:
+ * @data:
+ * @length:
+ *
+ * This function is not currently implemented
+ *
+ * Returns: %NULL
+ */
 gchar*
 convert_text_plain (guchar *data, 
 		    gint length)
 {
 	g_return_val_if_fail (data, NULL);
 
 	return NULL;
 }
 
+/**
+ * convert_application_xhtml_plus_xml:
+ * @data:
+ * @length:
+ *
+ * This function is not currently implemented
+ *
+ * Returns: %NULL
+ */
 gchar*
 convert_application_xhtml_plus_xml (guchar *data, 
 				    gint length)
 {
 	g_return_val_if_fail (data, NULL);
 
 	return NULL;
 }
 
+/**
+ * convert_application_rtf:
+ * @data:
+ * @length:
+ *
+ * This function is not currently implemented
+ *
+ * Returns: %NULL
+ */
 gchar*
 convert_application_rtf (guchar *data, 
 			 gint length)
 {
 	g_return_val_if_fail (data, NULL);
@@ -381,10 +461,18 @@
 	 */
 }
 #endif
 
 /* This is a simple copy-and-paste of gtk_clipboard_wait_for_targets, which was added to GTK in version 2.4: */
+/**
+ * cong_eel_gtk_clipboard_wait_for_targets:
+ * @clipboard:
+ * @targets:
+ * @n_targets:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_eel_gtk_clipboard_wait_for_targets (GtkClipboard  *clipboard, 
 					 GdkAtom      **targets,
 					 gint          *n_targets)
 {
@@ -433,10 +521,18 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_app_get_clipboard_xml_source:
+ * @app:
+ * @selection:
+ * @target_doc:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_app_get_clipboard_xml_source (CongApp *app,
 				   GdkAtom selection,
 				   CongDocument *target_doc)
 {
@@ -681,12 +777,19 @@
 
 		/* FIXME: reduce debug spew as well! */
 	}
 }
 
-
-
+/**
+ * cong_app_set_clipboard_from_xml_fragment:
+ * @app:
+ * @selection:
+ * @xml_fragment:
+ * @source_doc:
+ *
+ * TODO: Write me
+ */
 void
 cong_app_set_clipboard_from_xml_fragment (CongApp *app,
 					  GdkAtom selection,
 					  const gchar* xml_fragment,
 					  CongDocument *source_doc)
@@ -723,70 +826,111 @@
 	LOG_SELECTIONS2("Clipboard set to \"%s\"", xml_fragment);
 
 	/* emit signals? */
 }
 
+/**
+ * cong_app_get_gnome_program:
+ * @app:
+ *
+ * TODO: Write me
+ */
 GnomeProgram*
 cong_app_get_gnome_program (CongApp *app)
 {
 	g_return_val_if_fail (app, NULL);
 
 	return PRIVATE(app)->gnome_program;
 }
 
+/**
+ * cong_app_get_tooltips:
+ * @app:
+ *
+ * TODO: Write me
+ */
 GtkTooltips*
 cong_app_get_tooltips (CongApp *app)
 {
 	g_return_val_if_fail (app, NULL);
 
 	return PRIVATE(app)->tooltips;
 }
 
+/**
+ * cong_app_get_font:
+ * @app:
+ * @role:
+ *
+ * TODO: Write me
+ */
 CongFont*
 cong_app_get_font (CongApp *app,
 		   enum CongFontRole role)
 {
 	g_return_val_if_fail (app, NULL);
 	g_return_val_if_fail (role<CONG_FONT_ROLE_NUM, NULL);
 
 	return PRIVATE(app)->fonts[role];
 }
 
+/**
+ * cong_app_get_plugin_manager:
+ * @app:
+ *
+ * TODO: Write me
+ */
 CongPluginManager*
 cong_app_get_plugin_manager (CongApp *app)
 {
 	g_return_val_if_fail (app, NULL);
 
 	return PRIVATE(app)->plugin_manager;
 }
 
+/**
+ * cong_app_get_dispspec_registry:
+ * @app:
+ *
+ * TODO: Write me
+ */
 CongDispspecRegistry*
 cong_app_get_dispspec_registry (CongApp *app)
 {
 	g_return_val_if_fail (app, NULL);
 
 	return PRIVATE(app)->ds_registry;
 }
 
+/**
+ * cong_app_get_gconf_client:
+ * @app:
+ *
+ * TODO: Write me
+ */
 GConfClient*
 cong_app_get_gconf_client (CongApp *app)
 {
 	g_return_val_if_fail (app, NULL);
 
 	return PRIVATE(app)->gconf_client;
 }
 
+/**
+ * cong_app_get_language_list:
+ * @app:
+ *
+ * TODO: Write me
+ */
 const GList*
 cong_app_get_language_list (CongApp *app)
 {
 	g_return_val_if_fail (app, NULL);
 
 	return PRIVATE(app)->language_list;
 }
 
-
-
 /* Internal function definitions: */
 static CongApp*
 cong_app_new (int   argc,
 	      char *argv[])
 {
@@ -961,12 +1105,10 @@
 				     id,
 				     register_callback, 
 				     configure_callback);
 }
 
-
-
 static void 
 cong_app_private_load_plugins (CongApp *app)
 {
 	/* For the moment, there aren't any actual plugins; instead we fake it. */
 	register_plugin(app,"abiword",
@@ -1065,13 +1207,5 @@
 	col_to_gcol(&gcol, 0x00e0e0e0);
 	gdk_colormap_alloc_color(cong_gui_get_a_window()->style->colormap, &gcol, 0, 1);
 	gdk_gc_set_foreground(app->insert_element_gc, &gcol);
 #endif
 }
-
-
-
-
-
-
-
-
Index: cong-attribute-editor-cdata.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-attribute-editor-cdata.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-attribute-editor-cdata.c
--- cong-attribute-editor-cdata.c	3 Mar 2004 21:26:23 -0000	1.7
+++ cong-attribute-editor-cdata.c	17 Apr 2004 17:45:21 -0000
@@ -72,10 +72,21 @@
 cong_attribute_editor_cdata_instance_init (CongAttributeEditorCDATA *area)
 {
 	area->private = g_new0(CongAttributeEditorCDATADetails,1);
 }
 
+/**
+ * cong_attribute_editor_cdata_construct:
+ * @attribute_editor_cdata:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 CongAttributeEditor*
 cong_attribute_editor_cdata_construct (CongAttributeEditorCDATA *attribute_editor_cdata,
 				       CongDocument *doc,
 				       CongNodePtr node,
 				       xmlNs *ns_ptr,
@@ -139,10 +150,20 @@
 #endif
 
 	return CONG_ATTRIBUTE_EDITOR (attribute_editor_cdata);
 }
 
+/**
+ * cong_attribute_editor_cdata_new:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_attribute_editor_cdata_new (CongDocument *doc,
 				 CongNodePtr node,
 				 xmlNs *ns_ptr,
 				 const gchar *attribute_name,
Index: cong-attribute-editor-enumeration.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-attribute-editor-enumeration.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-attribute-editor-enumeration.c
--- cong-attribute-editor-enumeration.c	3 Mar 2004 21:26:23 -0000	1.9
+++ cong-attribute-editor-enumeration.c	17 Apr 2004 17:45:21 -0000
@@ -64,10 +64,21 @@
 cong_attribute_editor_enumeration_instance_init (CongAttributeEditorENUMERATION *area)
 {
 	area->private = g_new0(CongAttributeEditorENUMERATIONDetails,1);
 }
 
+/**
+ * cong_attribute_editor_enumeration_construct:
+ * @attribute_editor_enumeration:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 CongAttributeEditor*
 cong_attribute_editor_enumeration_construct (CongAttributeEditorENUMERATION *attribute_editor_enumeration,
 					     CongDocument *doc,
 					     CongNodePtr node,
 					     xmlNs *ns_ptr,
@@ -117,10 +128,20 @@
 
 	
 	return CONG_ATTRIBUTE_EDITOR (attribute_editor_enumeration);
 }
 
+/**
+ * cong_attribute_editor_enumeration_new:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_attribute_editor_enumeration_new (CongDocument *doc,
 				       CongNodePtr node,
 				       xmlNs *ns_ptr,
 				       const gchar *attribute_name,
Index: cong-attribute-editor.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-attribute-editor.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-attribute-editor.c
--- cong-attribute-editor.c	3 Mar 2004 21:26:23 -0000	1.9
+++ cong-attribute-editor.c	17 Apr 2004 17:45:21 -0000
@@ -100,10 +100,21 @@
 cong_attribute_editor_instance_init (CongAttributeEditor *attribute_editor)
 {
 	attribute_editor->private = g_new0(CongAttributeEditorDetails,1);
 }
 
+/**
+ * cong_attribute_editor_construct:
+ * @attribute_editor:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 CongAttributeEditor*
 cong_attribute_editor_construct (CongAttributeEditor *attribute_editor,
 				 CongDocument *doc,
 				 CongNodePtr node,
 				 xmlNs *ns_ptr,
@@ -132,60 +143,104 @@
 											      attribute_editor);
 	
 	return CONG_ATTRIBUTE_EDITOR (attribute_editor);
 }
 
+/**
+ * cong_attribute_editor_get_document:
+ * @attribute_editor:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_attribute_editor_get_document (CongAttributeEditor *attribute_editor)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_EDITOR(attribute_editor), NULL);
 
 	return PRIVATE(attribute_editor)->doc; 
 }
 
+/**
+ * cong_attribute_editor_get_node:
+ * @attribute_editor:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_attribute_editor_get_node (CongAttributeEditor *attribute_editor)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_EDITOR(attribute_editor), NULL);
 
 	return PRIVATE(attribute_editor)->node;
 }
 
+/**
+ * cong_attribute_editor_get_attribute:
+ * @attribute_editor:
+ *
+ * TODO: Write me
+ */
 xmlAttributePtr
 cong_attribute_editor_get_attribute (CongAttributeEditor *attribute_editor)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_EDITOR(attribute_editor), NULL);
 
 	return PRIVATE(attribute_editor)->attr;
 }
 
+/**
+ * cong_attribute_editor_get_ns:
+ * @attribute_editor:
+ *
+ * TODO: Write me
+ */
 xmlNs *
 cong_attribute_editor_get_ns (CongAttributeEditor *attribute_editor)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_EDITOR(attribute_editor), NULL);
 
 	return PRIVATE(attribute_editor)->ns_ptr;	
 }
 
+/**
+ * cong_attribute_editor_get_attribute_name:
+ * @attribute_editor:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_attribute_editor_get_attribute_name (CongAttributeEditor *attribute_editor)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_EDITOR(attribute_editor), NULL);
 
 	return PRIVATE(attribute_editor)->attribute_name;
 }
 
+/**
+ * cong_attribute_editor_get_attribute_value:
+ * @attribute_editor:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_attribute_editor_get_attribute_value (CongAttributeEditor *attribute_editor)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_EDITOR(attribute_editor), NULL);
 
 	return cong_node_get_attribute (PRIVATE(attribute_editor)->node, 
 					PRIVATE(attribute_editor)->ns_ptr,
 					PRIVATE(attribute_editor)->attribute_name);
 }
 
+/**
+ * cong_attribute_editor_new:
+ * @doc:
+ * @node:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_attribute_editor_new (CongDocument *doc,
 			   CongNodePtr node,
 			   xmlAttributePtr attr)
 {
@@ -252,10 +307,23 @@
 	/* FIXME: need to set up callbacks: when someone else modifies attrs, and when this widget modifies attr! Also need to set initial value! */
 
 	g_assert_not_reached();	
 }
 
+/**
+ * create_cdata_editor:
+ * @xml:
+ * @func_name:
+ * @name:
+ * @string1:
+ * @string2:
+ * @int1:
+ * @int2:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 create_cdata_editor (GladeXML *xml,
 		     gchar *func_name,
 		     gchar *name,
 		     gchar *string1,
@@ -293,10 +361,21 @@
 }
 
 CongDocument *global_glade_doc_ptr = NULL;
 CongNodePtr global_glade_node_ptr = NULL;
 
+/**
+ * cong_bind_radio_button:
+ * @radio_button:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attribute_value:
+ *
+ * TODO: Write me
+ */
 void
 cong_bind_radio_button (GtkRadioButton *radio_button,
 			CongDocument *doc,
 			CongNodePtr node,
 			xmlNs *ns_ptr,
@@ -312,11 +391,22 @@
 											     attribute_value);
 	bind_wrapper_to_widget (CONG_ATTRIBUTE_WRAPPER (wrapper),
 				GTK_WIDGET (radio_button));
 }
 
-
+/**
+ * cong_bind_check_button:
+ * @check_button:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attribute_value_unchecked:
+ * @attribute_value_checked:
+ *
+ * TODO: Write me
+ */
 void
 cong_bind_check_button (GtkCheckButton *check_button,
 			CongDocument *doc,
 			CongNodePtr node,
 			xmlNs *ns_ptr,
Index: cong-attribute-wrapper-check-button.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-attribute-wrapper-check-button.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-attribute-wrapper-check-button.c
--- cong-attribute-wrapper-check-button.c	3 Mar 2004 21:26:23 -0000	1.4
+++ cong-attribute-wrapper-check-button.c	17 Apr 2004 17:45:21 -0000
@@ -82,10 +82,24 @@
 cong_attribute_wrapper_check_button_instance_init (CongAttributeWrapperCheckButton *attribute_wrapper)
 {
 	attribute_wrapper->private = g_new0(CongAttributeWrapperCheckButtonDetails,1);
 }
 
+/**
+ * cong_attribute_wrapper_check_button_construct:
+ * @attribute_wrapper:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ * @check_button:
+ * @attribute_value_unchecked:
+ * @attribute_value_checked:
+ *
+ * TODO: Write me
+ */
 CongAttributeWrapperCheckButton*
 cong_attribute_wrapper_check_button_construct (CongAttributeWrapperCheckButton *attribute_wrapper,
 					       CongDocument *doc,
 					       CongNodePtr node,
 					       xmlNs *ns_ptr,
@@ -117,10 +131,23 @@
 	do_refresh (attribute_wrapper);
 	
 	return attribute_wrapper;
 }
 
+/**
+ * cong_attribute_wrapper_check_button_new:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ * @check_button:
+ * @attribute_value_unchecked:
+ * @attribute_value_checked:
+ *
+ * TODO: Write me
+ */
 CongAttributeWrapperCheckButton*
 cong_attribute_wrapper_check_button_new ( CongDocument *doc,
 					  CongNodePtr node,
 					  xmlNs *ns_ptr,
 					  const gchar *attribute_name,
Index: cong-attribute-wrapper-radio-button.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-attribute-wrapper-radio-button.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-attribute-wrapper-radio-button.c
--- cong-attribute-wrapper-radio-button.c	3 Mar 2004 21:26:23 -0000	1.4
+++ cong-attribute-wrapper-radio-button.c	17 Apr 2004 17:45:21 -0000
@@ -81,10 +81,23 @@
 cong_attribute_wrapper_radio_button_instance_init (CongAttributeWrapperRadioButton *attribute_wrapper)
 {
 	attribute_wrapper->private = g_new0(CongAttributeWrapperRadioButtonDetails,1);
 }
 
+/**
+ * cong_attribute_wrapper_radio_button_construct:
+ * @attribute_wrapper:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ * @radio_button:
+ * @attribute_value:
+ *
+ * TODO: Write me
+ */
 CongAttributeWrapperRadioButton*
 cong_attribute_wrapper_radio_button_construct (CongAttributeWrapperRadioButton *attribute_wrapper,
 					       CongDocument *doc,
 					       CongNodePtr node,
 					       xmlNs *ns_ptr,
@@ -113,10 +126,22 @@
 	do_refresh (attribute_wrapper);
 	
 	return attribute_wrapper;
 }
 
+/**
+ * cong_attribute_wrapper_radio_button_new:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ * @radio_button:
+ * @attribute_value:
+ *
+ * TODO: Write me
+ */
 CongAttributeWrapperRadioButton*
 cong_attribute_wrapper_radio_button_new ( CongDocument *doc,
 					  CongNodePtr node,
 					  xmlNs *ns_ptr,
 					  const gchar *attribute_name,
Index: cong-attribute-wrapper.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-attribute-wrapper.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-attribute-wrapper.c
--- cong-attribute-wrapper.c	3 Mar 2004 21:26:23 -0000	1.7
+++ cong-attribute-wrapper.c	17 Apr 2004 17:45:21 -0000
@@ -91,10 +91,21 @@
 cong_attribute_wrapper_instance_init (CongAttributeWrapper *attribute_wrapper)
 {
 	attribute_wrapper->private = g_new0(CongAttributeWrapperDetails,1);
 }
 
+/**
+ * cong_attribute_wrapper_construct:
+ * @attribute_wrapper:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @attribute_name:
+ * @attr:
+ *
+ * TODO: Write me
+ */
 CongAttributeWrapper*
 cong_attribute_wrapper_construct (CongAttributeWrapper *attribute_wrapper,
 				  CongDocument *doc,
 				  CongNodePtr node,
 				  xmlNs *ns_ptr,
@@ -123,60 +134,103 @@
 											      attribute_wrapper);
 	
 	return CONG_ATTRIBUTE_WRAPPER (attribute_wrapper);
 }
 
+/**
+ * cong_attribute_wrapper_get_document:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_attribute_wrapper_get_document (CongAttributeWrapper *attribute_wrapper)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_WRAPPER(attribute_wrapper), NULL);
 
 	return PRIVATE(attribute_wrapper)->doc; 
 }
 
+/**
+ * cong_attribute_wrapper_get_node:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_attribute_wrapper_get_node (CongAttributeWrapper *attribute_wrapper)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_WRAPPER(attribute_wrapper), NULL);
 
 	return PRIVATE(attribute_wrapper)->node;
 }
 
+/**
+ * cong_attribute_wrapper_get_attribute:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 xmlAttributePtr
 cong_attribute_wrapper_get_attribute (CongAttributeWrapper *attribute_wrapper)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_WRAPPER(attribute_wrapper), NULL);
 
 	return PRIVATE(attribute_wrapper)->attr;
 }
 
+/**
+ * cong_attribute_wrapper_get_ns:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 xmlNs *
 cong_attribute_wrapper_get_ns (CongAttributeWrapper *attribute_wrapper)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_WRAPPER(attribute_wrapper), NULL);
 
 	return PRIVATE(attribute_wrapper)->ns_ptr;	
 }
 
+/**
+ * cong_attribute_wrapper_get_attribute_name:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_attribute_wrapper_get_attribute_name (CongAttributeWrapper *attribute_wrapper)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_WRAPPER(attribute_wrapper), NULL);
 
 	return PRIVATE(attribute_wrapper)->attribute_name;
 }
 
+/**
+ * cong_attribute_wrapper_get_attribute_value:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_attribute_wrapper_get_attribute_value (CongAttributeWrapper *attribute_wrapper)
 {
 	g_return_val_if_fail (IS_CONG_ATTRIBUTE_WRAPPER(attribute_wrapper), NULL);
 
 	return cong_node_get_attribute (PRIVATE(attribute_wrapper)->node, 
 					PRIVATE(attribute_wrapper)->ns_ptr,
 					PRIVATE(attribute_wrapper)->attribute_name);
 }
 
+/**
+ * cong_attribute_wrapper_set_value:
+ * @attribute_wrapper:
+ * @new_value:
+ *
+ * TODO: Write me
+ */
 void
 cong_attribute_wrapper_set_value (CongAttributeWrapper *attribute_wrapper,
 				  const gchar *new_value)
 {
 	CongDocument *doc = cong_attribute_wrapper_get_document (CONG_ATTRIBUTE_WRAPPER(attribute_wrapper));
@@ -199,10 +253,16 @@
 					     new_value);
 	cong_document_end_command (doc,
 				   cmd);
 }
 
+/**
+ * cong_attribute_wrapper_remove_value:
+ * @attribute_wrapper:
+ *
+ * TODO: Write me
+ */
 void
 cong_attribute_wrapper_remove_value (CongAttributeWrapper *attribute_wrapper)
 {
 	CongDocument *doc = cong_attribute_wrapper_get_document (CONG_ATTRIBUTE_WRAPPER(attribute_wrapper));
 	CongNodePtr node = cong_attribute_wrapper_get_node (CONG_ATTRIBUTE_WRAPPER(attribute_wrapper));
Index: cong-command-history.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-command-history.c,v
retrieving revision 1.5
diff -u -5 -r1.5 cong-command-history.c
--- cong-command-history.c	6 Oct 2003 16:18:14 -0000	1.5
+++ cong-command-history.c	17 Apr 2004 17:45:21 -0000
@@ -73,22 +73,40 @@
 cong_command_history_instance_init (CongCommandHistory *history)
 {
 	history->private = g_new0(CongCommandHistoryDetails,1);
 }
 
+/**
+ * cong_command_history_construct:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 CongCommandHistory*
 cong_command_history_construct (CongCommandHistory *command_history)
 {
 	return command_history;
 }
 
+/**
+ * cong_command_history_new:
+ *
+ * TODO: Write me
+ */
 CongCommandHistory*
 cong_command_history_new (void)
 {
 	return cong_command_history_construct (CONG_COMMAND_HISTORY(g_object_new (CONG_COMMAND_HISTORY_TYPE, NULL)));
 }
 
+/**
+ * cong_command_history_add_command:
+ * @command_history:
+ * @command:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_history_add_command (CongCommandHistory *command_history,
 				  CongCommand *command)
 {
 	g_return_if_fail (IS_CONG_COMMAND_HISTORY(command_history));
@@ -112,26 +130,44 @@
 	}
 
 	emit_changed (command_history);
 }
 
+/**
+ * cong_command_history_can_undo:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_command_history_can_undo (CongCommandHistory *command_history)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND_HISTORY(command_history), FALSE);
 
 	return PRIVATE(command_history)->list_of_commands_to_undo!=NULL;
 }
 
+/**
+ * cong_command_history_can_redo:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_command_history_can_redo (CongCommandHistory *command_history)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND_HISTORY(command_history), FALSE);
 
 	return PRIVATE(command_history)->list_of_commands_to_redo!=NULL;
 }
 
+/**
+ * cong_command_history_undo:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_history_undo (CongCommandHistory *command_history)
 {
 	g_return_if_fail (IS_CONG_COMMAND_HISTORY(command_history));
 
@@ -155,10 +191,16 @@
 		g_message ("Nothing to undo");
 	}
 
 }
 
+/**
+ * cong_command_history_redo:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_history_redo (CongCommandHistory *command_history)
 {
 	g_return_if_fail (IS_CONG_COMMAND_HISTORY(command_history));
 
@@ -181,10 +223,16 @@
 	} else {
 		g_message ("Nothing to redo");
 	}
 }
 
+/**
+ * cong_command_history_get_next_undo_command:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 CongCommand*
 cong_command_history_get_next_undo_command (CongCommandHistory *command_history)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND_HISTORY(command_history), NULL);
 
@@ -193,10 +241,16 @@
 	} else {
 		return NULL;
 	} 
 }
 
+/**
+ * cong_command_history_get_next_redo_command:
+ * @command_history:
+ *
+ * TODO: Write me
+ */
 CongCommand*
 cong_command_history_get_next_redo_command (CongCommandHistory *command_history)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND_HISTORY(command_history), NULL);
 
Index: cong-command.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-command.c,v
retrieving revision 1.23
diff -u -5 -r1.23 cong-command.c
--- cong-command.c	3 Mar 2004 21:26:23 -0000	1.23
+++ cong-command.c	17 Apr 2004 17:45:21 -0000
@@ -82,10 +82,19 @@
 cong_command_instance_init (CongCommand *node)
 {
 	node->priv = g_new0(CongCommandDetails,1);
 }
 
+/**
+ * cong_command_construct:
+ * @command:
+ * @doc:
+ * @description:
+ * @consolidation_id:
+ *
+ * TODO: Write me
+ */
 CongCommand*
 cong_command_construct (CongCommand *command,
 			CongDocument *doc,
 			const gchar *description,
 			const gchar *consolidation_id)
@@ -99,10 +108,18 @@
 	PRIVATE(command)->doc_modified_before = cong_document_is_modified (doc);
 
 	return command;
 }
 
+/**
+ * cong_command_private_new:
+ * @doc:
+ * @description:
+ * @consolidation_id:
+ *
+ * TODO: Write me
+ */
 CongCommand*
 cong_command_private_new (CongDocument *doc,
 			  const gchar *description,
 			  const gchar *consolidation_id)
 {
@@ -110,34 +127,58 @@
 				       doc,
 				       description,
 				       consolidation_id);
 }
 
+/**
+ * cong_command_get_document:
+ * @command:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_command_get_document (CongCommand *command)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND(command), NULL);
 	
 	return PRIVATE(command)->doc;
 }
 
+/**
+ * cong_command_get_description:
+ * @command:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_command_get_description (CongCommand *command)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND(command), NULL);
 	
 	return PRIVATE(command)->description;
 }
 
+/**
+ * cong_command_get_consolidation_id:
+ * @command:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_command_get_consolidation_id (CongCommand *command)
 {
 	g_return_val_if_fail (IS_CONG_COMMAND(command), NULL);
 	
 	return PRIVATE(command)->consolidation_id;
 }
 
+/**
+ * cong_command_undo:
+ * @command:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_undo (CongCommand *command)
 {
 	GList *iter;
 	CongDocument* doc;
@@ -170,10 +211,16 @@
 				    PRIVATE(command)->doc_modified_before);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_redo:
+ * @command:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_redo (CongCommand *command)
 {
 	GList *iter;
 	CongDocument* doc;
@@ -201,10 +248,17 @@
 	}
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_merge:
+ * @dst:
+ * @src:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_merge (CongCommand *dst,
 		    CongCommand *src)
 {
 	g_return_if_fail (IS_CONG_COMMAND(dst));
@@ -225,10 +279,17 @@
 	return PRIVATE(cmd)->has_ever_been_undone;
 }
 
 
 /* Adding Atomic modifications: */
+/**
+ * cong_command_add_modification:
+ * @cmd:
+ * @modification:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_modification (CongCommand *cmd,
 			       CongModification *modification)
 {
 	g_return_if_fail (IS_CONG_COMMAND(cmd));
@@ -244,11 +305,17 @@
 			      modification,
 			      redo,
 			      (modification));
 }
 
-
+/**
+ * cong_command_add_node_make_orphan:
+ * @cmd:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_node_make_orphan (CongCommand *cmd,
 				   CongNodePtr node)
 {
 	CongModification *modification;
@@ -262,10 +329,18 @@
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 
 }
 
+/**
+ * cong_command_add_node_add_after:
+ * @cmd:
+ * @node:
+ * @older_sibling:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_node_add_after (CongCommand *cmd, 
 				 CongNodePtr node, 
 				 CongNodePtr older_sibling)
 {
@@ -279,11 +354,18 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
-
+/**
+ * cong_command_add_node_add_before:
+ * @cmd:
+ * @node:
+ * @younger_sibling:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_node_add_before (CongCommand *cmd, 
 				  CongNodePtr node, 
 				  CongNodePtr younger_sibling)
 {
@@ -297,10 +379,18 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
+/**
+ * cong_command_add_node_set_parent:
+ * @cmd:
+ * @node:
+ * @adoptive_parent:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_node_set_parent (CongCommand *cmd, 
 				  CongNodePtr node,
 				  CongNodePtr adoptive_parent)
 {
@@ -314,10 +404,18 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
+/**
+ * cong_command_add_node_set_text:
+ * @cmd:
+ * @node:
+ * @new_content:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_node_set_text (CongCommand *cmd, 
 				CongNodePtr node, 
 				const xmlChar *new_content)
 {
@@ -331,10 +429,20 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
+/**
+ * cong_command_add_node_set_attribute:
+ * @cmd:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ * @value:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_node_set_attribute (CongCommand *cmd, 
 				     CongNodePtr node, 
 				     xmlNs *ns_ptr,
 				     const xmlChar *name, 
@@ -352,10 +460,19 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
+/**
+ * cong_command_add_node_remove_attribute:
+ * @cmd:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_node_remove_attribute (CongCommand *cmd, 
 					CongNodePtr node, 
 					xmlNs *ns_ptr,
 					const xmlChar *name)
@@ -372,10 +489,18 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 	
+/**
+ * cong_command_add_selection_change:
+ * @cmd:
+ * @new_logical_start:
+ * @new_logical_end:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_selection_change (CongCommand *cmd,
 				   const CongLocation *new_logical_start,
 				   const CongLocation *new_logical_end)
 {
@@ -391,10 +516,17 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
+/**
+ * cong_command_add_cursor_change:
+ * @cmd:
+ * @new_location:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_cursor_change (CongCommand *cmd,
 				const CongLocation *new_location)
 {
 	CongModification *modification;
@@ -407,10 +539,17 @@
 	cong_command_add_modification (cmd,
 				       modification);
 	g_object_unref (G_OBJECT(modification));
 }
 
+/**
+ * cong_command_add_set_dtd_ptr:
+ * @cmd:
+ * @dtd_ptr:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_set_dtd_ptr (CongCommand *cmd,
 			      xmlDtdPtr dtd_ptr)
 {
 	CongModification *modification;
@@ -445,18 +584,32 @@
 #error
 	g_assert_not_reached();
 }
 #endif
 
+/**
+ * cong_command_add_node_free:
+ * @cmd:
+ * @node:
+ *
+ * This function is not currently implemented
+ */
 void
 cong_command_add_node_free (CongCommand *cmd,
 			    CongNodePtr node)
 {
 	/* FIXME: unwritten */
 }
 
 /* Adding Compound modifications: */
+/**
+ * cong_command_add_node_recursive_delete:
+ * @cmd:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_node_recursive_delete (CongCommand *cmd,
 					CongNodePtr node)
 {
 	CongDocument *doc;
@@ -501,18 +654,32 @@
 	cong_command_add_node_free (cmd, node);	
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_cursor_get_location:
+ * @cursor:
+ *
+ * TODO: Write me
+ */
 const CongLocation*
 cong_cursor_get_location (const CongCursor *cursor)
 {
 	g_return_val_if_fail (cursor, NULL);
 
 	return &cursor->location;
 }
 
+/**
+ * cong_command_for_each_location:
+ * @cmd:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_for_each_location (CongCommand *cmd, 
 				CongUpdateLocationCallback callback, 
 				gpointer user_data)
 {
@@ -634,10 +801,17 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_command_add_delete_range:
+ * @cmd:
+ * @range:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_delete_range (CongCommand *cmd,
 			       CongRange *range)
 {
 	CongDocument *doc;
@@ -778,10 +952,16 @@
 	}
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_add_delete_selection:
+ * @cmd:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_delete_selection (CongCommand *cmd)
 {
 	CongDocument *doc;
 	CongSelection *selection;
@@ -803,10 +983,17 @@
 	cong_command_add_nullify_selection (cmd);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_add_insert_text_at_cursor:
+ * @cmd:
+ * @string:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_insert_text_at_cursor (CongCommand *cmd, 
 					const gchar *string)
 {
 	CongDocument *doc;
@@ -858,10 +1045,16 @@
 					&new_cursor_loc);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_add_nullify_cursor:
+ * @cmd:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_nullify_cursor (CongCommand *cmd)
 {
 	CongDocument *doc;
 	CongLocation new_logical_loc;
@@ -874,10 +1067,16 @@
 
 	cong_command_add_cursor_change (cmd,
 					&new_logical_loc);
 }
 
+/**
+ * cong_command_add_nullify_selection:
+ * @cmd:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_nullify_selection (CongCommand *cmd)
 {
 	CongDocument *doc;
 	CongSelection *selection;
@@ -893,10 +1092,17 @@
 	cong_command_add_selection_change (cmd,
 					   &new_logical_loc,
 					   &new_logical_loc);	
 }
 
+/**
+ * cong_command_add_xml_frag_data_nice_split2:
+ * @cmd:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_command_add_xml_frag_data_nice_split2  (CongCommand *cmd, 
 					     const CongLocation *loc)
 {
 	CongDocument *doc;
@@ -1019,11 +1225,16 @@
 
 	/* Keep going: */
 	return FALSE;
 }
 
-
+/**
+ * cong_command_add_merge_adjacent_text_nodes:
+ * @cmd:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_merge_adjacent_text_nodes (CongCommand *cmd)
 {
 	CongDocument *doc;
 
@@ -1036,10 +1247,17 @@
 	cong_document_for_each_node (doc, merge_adjacent_text_callback, cmd);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_add_merge_adjacent_text_children_of_node:
+ * @cmd:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_merge_adjacent_text_children_of_node (CongCommand *cmd, 
 						       CongNodePtr node)
 {
 	CongDocument *doc;
@@ -1053,10 +1271,17 @@
 	cong_document_for_each_child_of_node (doc, node, merge_adjacent_text_callback, cmd);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_can_add_reparent_selection:
+ * @cmd:
+ * @new_parent:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_command_can_add_reparent_selection (CongCommand *cmd,
 					 CongNodePtr new_parent)
 {
 	CongSelection *selection = cong_document_get_selection (cong_command_get_document (cmd));
@@ -1073,10 +1298,17 @@
 	g_return_val_if_fail (new_parent, FALSE);
 
 	return TRUE;
 }
 
+/**
+ * cong_command_add_reparent_selection:
+ * @cmd:
+ * @new_parent:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_command_add_reparent_selection (CongCommand *cmd, 
 				     CongNodePtr new_parent)
 {
 	CongDocument *doc;
@@ -1253,10 +1485,19 @@
 
 	return FALSE;
 }
 
 /* Splits a data node in 3 and returns pointer to the middle one */
+/**
+ * cong_command_add_node_split3:
+ * @cmd:
+ * @node:
+ * @c0:
+ * @c1:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_command_add_node_split3 (CongCommand *cmd, 
 			      CongNodePtr node, 
 			      int c0, 
 			      int c1)
@@ -1317,10 +1558,17 @@
 	CONG_NODE_SELF_TEST(d2);
 
 	return(d2);
 }
 
+/**
+ * cong_command_add_remove_tag:
+ * @cmd:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void 
 cong_command_add_remove_tag (CongCommand *cmd,
 			     CongNodePtr node)
 {
 	CongDocument *doc;
@@ -1346,10 +1594,17 @@
 	cong_command_add_node_recursive_delete (cmd, node);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_command_add_set_cursor_to_first_text_descendant:
+ * @cmd:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_set_cursor_to_first_text_descendant (CongCommand *cmd,
 						      CongNodePtr node)
 {
 	CongDocument *doc;
@@ -1375,10 +1630,19 @@
 
 		cong_document_end_edit (doc);		
 	}
 }
 
+/**
+ * cong_command_add_set_external_dtd:
+ * @cmd:
+ * @root_element:
+ * @public_id:
+ * @system_id:
+ *
+ * TODO: Write me
+ */
 void
 cong_command_add_set_external_dtd (CongCommand *cmd,
 				   const gchar* root_element,
 				   const gchar* public_id,
 				   const gchar* system_id)
Index: cong-debug-log-view.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-debug-log-view.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-debug-log-view.c
--- cong-debug-log-view.c	3 Mar 2004 21:26:23 -0000	1.11
+++ cong-debug-log-view.c	17 Apr 2004 17:45:21 -0000
@@ -86,73 +86,151 @@
 					   node_id, 
 					   extra_info);
 }
 #endif
 
-void log_begin_edit (CongDebugLogViewDetails *details,
-		     gboolean before_event)
+/**
+ * log_begin_edit:
+ * @details:
+ * @before_event:
+ *
+ * TODO: Write me
+ */
+
+void 
+log_begin_edit (CongDebugLogViewDetails *details,
+		gboolean before_event)
 {
 	debug_log_view_details_add_message(details, "Begin edit", before_event, "", "");
 }
 
-void log_end_edit (CongDebugLogViewDetails *details,
-		   gboolean before_event)
+/**
+ * log_end_edit:
+ * @details:
+ * @before_event:
+ *
+ * TODO: Write me
+ */
+void 
+log_end_edit (CongDebugLogViewDetails *details,
+	      gboolean before_event)
 {
 	debug_log_view_details_add_message(details, "End edit", before_event, "", "");
 }
 
-void log_make_orphan (CongDebugLogViewDetails *details, 
-		      gboolean before_event, 
-		      CongNodePtr node)
+/**
+ * log_make_orphan:
+ * @details:
+ * @before_event:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+log_make_orphan (CongDebugLogViewDetails *details, 
+		 gboolean before_event, 
+		 CongNodePtr node)
 { 
 	debug_log_view_details_add_message(details, "Make orphan", before_event, "", "");
 }
 
-void log_add_after (CongDebugLogViewDetails *details, 
-		    gboolean before_event, 
-		    CongNodePtr node, 
-		    CongNodePtr older_sibling) 
+/**
+ * log_add_after:
+ * @details:
+ * @before_event:
+ * @node:
+ * @older_sibling:
+ *
+ * TODO: Write me
+ */
+void 
+log_add_after (CongDebugLogViewDetails *details, 
+	       gboolean before_event, 
+	       CongNodePtr node, 
+	       CongNodePtr older_sibling) 
 { 
 	debug_log_view_details_add_message(details, "Add node after existing child", before_event, "", "");
 }
 
-void log_add_before (CongDebugLogViewDetails *details, 
-		     gboolean before_event, 
-		     CongNodePtr node, 
-		     CongNodePtr younger_sibling) 
+/**
+ * log_add_before:
+ * @details:
+ * @before_event:
+ * @node:
+ * @younger_sibling:
+ *
+ * TODO: Write me
+ */
+void 
+log_add_before (CongDebugLogViewDetails *details, 
+		gboolean before_event, 
+		CongNodePtr node, 
+		CongNodePtr younger_sibling) 
 { 
 	debug_log_view_details_add_message(details, "Add node before existing child", before_event, "", "");
 }
 
-void log_set_parent (CongDebugLogViewDetails *details, 
-		     gboolean before_event, 
-		     CongNodePtr node, 
-		     CongNodePtr adoptive_parent) 
+/**
+ * log_set_parent:
+ * @details:
+ * @before_event:
+ * @node:
+ * @adoptive_parent:
+ *
+ * TODO: Write me
+ */
+void 
+log_set_parent (CongDebugLogViewDetails *details, 
+		gboolean before_event, 
+		CongNodePtr node, 
+		CongNodePtr adoptive_parent) 
 { 
 	debug_log_view_details_add_message(details, "Set parent", before_event, "", "");
 }
 
-void log_set_text (CongDebugLogViewDetails *details, 
-		   gboolean before_event, 
-		   CongNodePtr node, 
-		   const xmlChar *new_content)
+/**
+ * log_set_text:
+ * @details:
+ * @before_event:
+ * @node:
+ * @new_content:
+ *
+ * TODO: Write me
+ */
+void 
+log_set_text (CongDebugLogViewDetails *details, 
+	      gboolean before_event, 
+	      CongNodePtr node, 
+	      const xmlChar *new_content)
 { 
 	gchar *node_name = cong_node_get_path(node);
 	gchar *cleaned_text = cong_util_cleanup_text(new_content);
 
 	debug_log_view_details_add_message(details, "Set text", before_event, node_name, cleaned_text);
 
 	g_free (node_name);
 	g_free (cleaned_text);
 }
 
-void log_set_attribute (CongDebugLogViewDetails *details, 
-			gboolean before_event, 
-			CongNodePtr node, 
-			xmlNs *ns_ptr, 
-			const xmlChar *name, 
-			const xmlChar *value) 
+/**
+ * log_set_attribute:
+ * @details:
+ * @before_event:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ * @value:
+ *
+ * TODO: Write me
+ */
+void 
+log_set_attribute (CongDebugLogViewDetails *details, 
+		   gboolean before_event, 
+		   CongNodePtr node, 
+		   xmlNs *ns_ptr, 
+		   const xmlChar *name, 
+		   const xmlChar *value) 
 { 
 	gchar *qualified_name = cong_util_get_qualified_attribute_name(ns_ptr, name);
 	gchar *node_name = cong_node_get_path(node);
 	gchar *extra_info = g_strdup_printf("%s=\"%s\"", qualified_name, value);
 
@@ -161,15 +239,26 @@
 	g_free(qualified_name);
 	g_free(node_name);
 	g_free(extra_info);
 }
 
-void log_remove_attribute (CongDebugLogViewDetails *details, 
-			   gboolean before_event, 
-			   CongNodePtr node, 
-			   xmlNs *ns_ptr, 
-			   const xmlChar *name)
+/**
+ * log_remove_attribute:
+ * @details:
+ * @before_event:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ *
+ * TODO: Write me
+ */
+void 
+log_remove_attribute (CongDebugLogViewDetails *details, 
+		      gboolean before_event, 
+		      CongNodePtr node, 
+		      xmlNs *ns_ptr, 
+		      const xmlChar *name)
 { 
 	gchar *qualified_name = cong_util_get_qualified_attribute_name(ns_ptr, name);
 	gchar *node_name = cong_node_get_path(node);
 
 	debug_log_view_details_add_message(details, 
@@ -178,18 +267,34 @@
 
 	g_free(node_name);
 	g_free(qualified_name);
 }
 
-void log_selection_change (CongDebugLogViewDetails *details, 
-			   gboolean before_event) 
+/**
+ * log_selection_change:
+ * @details:
+ * @before_event:
+ *
+ * TODO: Write me
+ */
+void 
+log_selection_change (CongDebugLogViewDetails *details, 
+		      gboolean before_event) 
 { 
 	debug_log_view_details_add_message(details, "Selection change", before_event, "", "");
 }
 
-void log_cursor_change (CongDebugLogViewDetails *details, 
-			gboolean before_event)
+/**
+ * log_cursor_change:
+ * @details:
+ * @before_event:
+ *
+ * TODO: Write me
+ */
+void 
+log_cursor_change (CongDebugLogViewDetails *details, 
+		   gboolean before_event)
 { 
 	debug_log_view_details_add_message(details, "Cursor change", before_event, "", "");
 }	    
 
 
@@ -379,12 +484,17 @@
 	add_text_column(tree_view,
 			"Additional Info",
 			DEBUGLOGVIEW_COLUMN_EXTRA_INFO);
 
 }
-
-CongDebugLogViewDetails *make_window_etc()
+/**
+ * make_window_etc:
+ *
+ * TODO: Write me
+ */
+CongDebugLogViewDetails *
+make_window_etc(void)
 {
 	CongDebugLogViewDetails *details;
 
 	details = g_new0(CongDebugLogViewDetails,1);
 
@@ -405,11 +515,18 @@
 	gtk_widget_show(GTK_WIDGET(details->scrolled_window));
 
 	return details;
 }
 
-GtkWidget *cong_debug_message_log_view_new(CongDocument *doc)
+/**
+ * cong_debug_message_log_view_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_debug_message_log_view_new(CongDocument *doc)
 {
 	CongDebugLogViewDetails *details;
 	CongDebugLogView *view;
 
 	g_return_val_if_fail(doc, NULL);
@@ -647,13 +764,18 @@
 	CongDebugLogViewDetails *details = (CongDebugLogViewDetails*)user_data; 
 
 	log_cursor_change (details, FALSE);
 }
 
-
-
-GtkWidget *cong_debug_signal_log_view_new(CongDocument *doc)
+/**
+ * cong_debug_signal_log_view_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_debug_signal_log_view_new(CongDocument *doc)
 {
 	CongDebugLogViewDetails *details;
 
 	g_return_val_if_fail(doc, NULL);
 
Index: cong-dialog.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-dialog.c,v
retrieving revision 1.8
diff -u -5 -r1.8 cong-dialog.c
--- cong-dialog.c	18 Sep 2003 02:35:31 -0000	1.8
+++ cong-dialog.c	17 Apr 2004 17:45:21 -0000
@@ -27,11 +27,18 @@
 	GtkWidget *label;
 	GtkWidget *hbox;
 	GtkWidget *inner_vbox;
 };
 
-CongDialogContent *cong_dialog_content_new(gboolean within_notebook)
+/**
+ * cong_dialog_content_new:
+ * @within_notebook:
+ *
+ * TODO: Write me
+ */
+CongDialogContent *
+cong_dialog_content_new(gboolean within_notebook)
 {
 	CongDialogContent *content;
 
 	content = g_new0(CongDialogContent, 1);
 
@@ -45,18 +52,33 @@
 	gtk_widget_show (content->vbox);
 
 	return content;
 }
 
-GtkWidget *cong_dialog_content_get_widget(CongDialogContent *dialog_content)
+/**
+ * cong_dialog_content_get_widget:
+ * @dialog_content:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_dialog_content_get_widget(CongDialogContent *dialog_content)
 {
 	g_return_val_if_fail(dialog_content, NULL);
 
 	return dialog_content->vbox;	
 }
 
-CongDialogCategory *cong_dialog_content_add_category(CongDialogContent *dialog_content, const gchar *title)
+/**
+ * cong_dialog_content_add_category:
+ * @dialog_content:
+ * @title:
+ *
+ * TODO: Write me
+ */
+CongDialogCategory *
+cong_dialog_content_add_category(CongDialogContent *dialog_content, const gchar *title)
 {
 	CongDialogCategory *category;
 	gchar *markedup_title;
 	GtkWidget *spacer;
 
@@ -105,10 +127,19 @@
 	gtk_widget_show (category->inner_vbox);
 
 	return category;
 }
 
+/**
+ * cong_dialog_category_add_field:
+ * @category:
+ * @title:
+ * @widget:
+ * @expand:
+ *
+ * TODO: Write me
+ */
 void 
 cong_dialog_category_add_field (CongDialogCategory *category, 
 				const gchar *title, 
 				GtkWidget *widget,
 				gboolean expand)
@@ -136,10 +167,18 @@
 
 	gtk_widget_show (label);
 	gtk_widget_show (hbox);
 }
 
+/**
+ * cong_dialog_category_add_selflabelled_field:
+ * @category:
+ * @widget:
+ * @expand:
+ *
+ * TODO: Write me
+ */
 void 
 cong_dialog_category_add_selflabelled_field (CongDialogCategory *category, 
 					     GtkWidget *widget,
 					     gboolean expand)
 {
@@ -151,10 +190,18 @@
 			    expand,
 			    TRUE,
 			    0);
 }
 
+/**
+ * make_dialog_message:
+ * @primary_text:
+ * @secondary_text:
+ * @tertiary_text:
+ *
+ * TODO: Write me
+ */
 static gchar*
 make_dialog_message(const gchar* primary_text, 
 		    const gchar* secondary_text, 
 		    const gchar* tertiary_text)
 {
@@ -173,11 +220,19 @@
 			return g_strdup_printf("<span weight=\"bold\" size=\"larger\">%s</span>", primary_text);
 		}
 	}
 }
 
-
+/**
+ * cong_alert_content_new:
+ * @stock_icon:
+ * @primary_text:
+ * @secondary_text:
+ * @tertiary_text:
+ *
+ * TODO: Write me
+ */
 GtkWidget* 
 cong_alert_content_new(const gchar* stock_icon,
 		       const gchar* primary_text, 
 		       const gchar* secondary_text, 
 		       const gchar* tertiary_text)
@@ -212,13 +267,22 @@
 	g_free(msg);
 
 	return hbox1;
 }
 
-GtkDialog *cong_dialog_save_confirmation_alert_new(GtkWindow *parent, 
-						   const gchar *document_name,
-						   glong seconds_since_last_save_or_load)
+/**
+ * cong_dialog_save_confirmation_alert_new:
+ * @parent:
+ * @document_name:
+ * @seconds_since_last_save_or_load:
+ *
+ * TODO: Write me
+ */
+GtkDialog *
+cong_dialog_save_confirmation_alert_new(GtkWindow *parent, 
+					const gchar *document_name,
+					glong seconds_since_last_save_or_load)
 {
 	GtkWidget *dialog, *content;
 	gchar *primary_text, *secondary_text;
 	glong minutes;
 
@@ -268,14 +332,22 @@
 	gtk_widget_show_all(dialog);
 
 	return GTK_DIALOG(dialog);
 }
 
-
-GtkDialog *cong_dialog_revert_confirmation_alert_new(GtkWindow *parent, 
-						     const gchar *document_name,
-						     glong seconds_since_last_save_or_load)
+/**
+ * cong_dialog_revert_confirmation_alert_new:
+ * @parent:
+ * @document_name:
+ * @seconds_since_last_save_or_load:
+ *
+ * TODO: Write me
+ */
+GtkDialog *
+cong_dialog_revert_confirmation_alert_new(GtkWindow *parent, 
+					  const gchar *document_name,
+					  glong seconds_since_last_save_or_load)
 {
 	GtkWidget *dialog, *content;
 	gchar *primary_text, *secondary_text;
 	glong minutes;
 
@@ -322,12 +394,20 @@
 	gtk_widget_show_all(dialog);
 
 	return GTK_DIALOG(dialog);
 }
 
-GtkDialog *cong_dialog_information_alert_new(GtkWindow *parent, 
-					     const gchar *message)
+/**
+ * cong_dialog_information_alert_new:
+ * @parent:
+ * @message:
+ *
+ * TODO: Write me
+ */
+GtkDialog *
+cong_dialog_information_alert_new(GtkWindow *parent, 
+				  const gchar *message)
 {
 	GtkWidget *dialog, *content;
 
 	g_return_val_if_fail(message, NULL);
 
Index: cong-dispspec-element.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-dispspec-element.c,v
retrieving revision 1.19
diff -u -5 -r1.19 cong-dispspec-element.c
--- cong-dispspec-element.c	5 Mar 2004 01:36:15 -0000	1.19
+++ cong-dispspec-element.c	17 Apr 2004 17:45:22 -0000
@@ -86,10 +86,17 @@
 	} else {
 		return 0;
 	}
 }
 
+/**
+ * g_str_or_null_equal:
+ * @a:
+ * @b:
+ *
+ * TODO: Write me
+ */
 gboolean
 g_str_or_null_equal (gconstpointer a,
 		     gconstpointer b)
 {
 	if (a) {
@@ -123,10 +130,15 @@
 {
 	{"preserve", CONG_WHITESPACE_PRESERVE},
 	{"normalize", CONG_WHITESPACE_NORMALIZE}
 };
 
+/**
+ * gxx_callback_construct_dispspec_element:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 gxx_callback_construct_dispspec_element(void)
 {
 	CongDispspecElement *element = g_new0(CongDispspecElement,1);
 
@@ -190,10 +202,16 @@
 	/* pick one of the test colour tables based on a dodgy hashing of the source colour: */
 	col_to_gcol(dst, hacked_cols[(src->red>>8)%2][usage]);
 }
 #endif /* #if NEW_LOOK */
 
+/**
+ * generate_gc_for_col:
+ * @col:
+ *
+ * TODO: Write me
+ */
 GdkGC*
 generate_gc_for_col (const GdkColor *col)
 {
 	GdkGC *gc;
 
@@ -265,10 +283,19 @@
 }
 
 /* Exported functions: */
 
 /* Construction  */
+/**
+ * cong_dispspec_element_new:
+ * @ns_uri:
+ * @local_name:
+ * @type:
+ * @autogenerate_username:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_dispspec_element_new (const gchar* ns_uri, 
 			   const gchar* local_name, 
 			   enum CongElementType type,
 			   gboolean autogenerate_username)
@@ -312,10 +339,16 @@
 
 	return element;
 }
 
 /* Destruction  */
+/**
+ * cong_dispspec_element_destroy:
+ * @element:
+ *
+ * TODO: Write me
+ */
 void 
 cong_dispspec_element_destroy (CongDispspecElement *element)
 {
 	g_return_if_fail (element);
 
@@ -355,27 +388,44 @@
 
 	g_free (element);
 	/* FIXME:  do we need to remove from the list? */
 }
 
-
+/**
+ * cong_dispspec_element_get_ns_uri:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_get_ns_uri (CongDispspecElement *element)
 {
 	g_return_val_if_fail (element, NULL);
 
 	return element->ns_uri;
 }
 
+/**
+ * cong_dispspec_element_get_local_name:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_get_local_name(CongDispspecElement* element)
 {
 	g_return_val_if_fail (element, NULL);
 
 	return element->local_name;
 }
 
+/**
+ * cong_dispspec_element_username:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_username(CongDispspecElement* element)
 {
 	const gchar *result;
 	g_return_val_if_fail(element, NULL);
@@ -387,18 +437,30 @@
 	} else {
 		return element->local_name;
 	}
 }
 
+/**
+ * cong_dispspec_element_get_description:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_get_description(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element,NULL);
 
 	return find_best_string_for_language (element->hash_of_language_to_short_desc);
 }
 
+/**
+ * cong_dispspec_element_get_icon:
+ * @element:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf*
 cong_dispspec_element_get_icon(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, NULL);
 
@@ -406,10 +468,17 @@
 		g_object_ref(G_OBJECT(element->icon16));
 	}
 	return element->icon16;
 }
 
+/**
+ * cong_dispspec_element_get_value_for_key:
+ * @key:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_get_value_for_key (const gchar *key, 
 					 const CongDispspecElement *element)
 {
 	g_return_val_if_fail (element, NULL);
@@ -417,42 +486,72 @@
 
 	return g_hash_table_lookup (element->key_value_hash,
 				    key);
 }
 
+/**
+ * cong_dispspec_element_type:
+ * @element:
+ *
+ * TODO: Write me
+ */
 enum CongElementType
 cong_dispspec_element_type(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, CONG_ELEMENT_TYPE_UNKNOWN);
 
 	return element->type;
 }
 
+/**
+ * cong_dispspec_element_get_whitespace:
+ * @element:
+ *
+ * TODO: Write me
+ */
 enum CongWhitespaceHandling
 cong_dispspec_element_get_whitespace (CongDispspecElement *element)
 {
 	g_return_val_if_fail (element, CONG_WHITESPACE_NORMALIZE);
 
 	return element->whitespace;
 }
 
+/**
+ * cong_dispspec_element_set_whitespace:
+ * @element:
+ * @whitespace:
+ *
+ * TODO: Write me
+ */
 void
 cong_dispspec_element_set_whitespace (CongDispspecElement *element,
 				      enum CongWhitespaceHandling whitespace)
 {	
 	g_return_if_fail (element);
 
 	element->whitespace = whitespace;
 }
 
-
+/**
+ * cong_dispspec_element_collapseto:
+ * @element:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dispspec_element_collapseto(CongDispspecElement *element)
 {
 	return element->collapseto;
 }
 
+/**
+ * cong_dispspec_element_is_structural:
+ * @element:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dispspec_element_is_structural(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, FALSE);
 
@@ -461,10 +560,16 @@
 	} else {
 		return FALSE;
 	}
 }
 
+/**
+ * cong_dispspec_element_is_span:
+ * @element:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dispspec_element_is_span(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, FALSE);
 
@@ -474,54 +579,92 @@
 		return FALSE;
 	}
 }
 
 #if NEW_LOOK
+/**
+ * cong_dispspec_element_gc:
+ * @element:
+ * @usage:
+ *
+ * TODO: Write me
+ */
 GdkGC*
 cong_dispspec_element_gc(CongDispspecElement *element, enum CongDispspecGCUsage usage)
 {
 	g_return_val_if_fail(element, NULL);
 	g_return_val_if_fail(usage<CONG_DISPSPEC_GC_USAGE_NUM, NULL);
 
 	return element->gc_array[usage];
 }
 
+/**
+ * cong_dispspec_element_col:
+ * @element:
+ * @usage:
+ *
+ * TODO: Write me
+ */
 const GdkColor*
 cong_dispspec_element_col(CongDispspecElement *element, enum CongDispspecGCUsage usage)
 {
 	g_return_val_if_fail(element, NULL);
 	g_return_val_if_fail(usage<CONG_DISPSPEC_GC_USAGE_NUM, NULL);
 
 	return &element->col_array[usage];
 }
 
 #else
+/**
+ * cong_dispspec_element_gc:
+ * @element:
+ *
+ * TODO: Write me
+ */
 GdkGC*
 cong_dispspec_element_gc(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, NULL);
 
 	return element->gc;
 }
 
+/**
+ * cong_dispspec_element_col:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const GdkColor*
 cong_dispspec_element_col(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, NULL);
 
 	return &element->col;
 }
 #endif
 
+/**
+ * cong_dispspec_element_header_info:
+ * @element:
+ *
+ * TODO: Write me
+ */
 CongDispspecElementHeaderInfo*
 cong_dispspec_element_header_info(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, NULL);
 
 	return element->header_info;
 }
 
+/**
+ * cong_dispspec_element_header_info_get_xpath_expression:
+ * @header_info:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_dispspec_element_header_info_get_xpath_expression (CongDispspecElementHeaderInfo *header_info)
 {
 	g_return_val_if_fail (header_info, NULL);
 
@@ -532,11 +675,17 @@
 	} else {
 		return NULL;
 	}
 }
 
-
+/**
+ * cong_dispspec_element_get_title:
+ * @element:
+ * @x:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_dispspec_element_get_title(CongDispspecElement *element, CongNodePtr x)
 {
 #if 1
 	xmlXPathContextPtr ctxt;
@@ -627,10 +776,17 @@
 		return NULL;
 	}
 #endif
 }
 
+/**
+ * cong_dispspec_element_get_section_header_text:
+ * @element:
+ * @x:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_dispspec_element_get_section_header_text(CongDispspecElement *element, CongNodePtr x)
 {
 	g_return_val_if_fail(element,NULL);
 	g_return_val_if_fail(x,NULL);
@@ -653,10 +809,17 @@
 		/* printf("no header info for %s\n", cong_node_name(x)); */
 		return g_strdup(cong_dispspec_element_username(element));
 	}
 }
 
+/**
+ * cong_dispspec_element_get_font:
+ * @element:
+ * @role:
+ *
+ * TODO: Write me
+ */
 CongFont*
 cong_dispspec_element_get_font(CongDispspecElement *element, enum CongFontRole role)
 {
 	g_return_val_if_fail(element, NULL);
 	g_return_val_if_fail(role<CONG_FONT_ROLE_NUM, NULL);
@@ -664,26 +827,44 @@
 	/* fonts are currently a property of the app: */
 	return cong_app_get_font (cong_app_singleton(),
 				  role);
 }
 
+/**
+ * cong_dispspec_element_get_editor_service_id:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_get_editor_service_id(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, NULL);
 
 	return element->editor_service_id;
 }
 
+/**
+ * cong_dispspec_element_get_property_dialog_service_id:
+ * @element:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_element_get_property_dialog_service_id(CongDispspecElement *element)
 {
 	g_return_val_if_fail(element, NULL);
 
 	return element->property_dialog_service_id;
 }
 
+/**
+ * cong_dispspec_element_from_xml:
+ * @xml_element:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_dispspec_element_from_xml (xmlNodePtr xml_element)
 {
 	CongDispspecElement* element;
 
@@ -768,10 +949,17 @@
 	}
 
 	return element;
 }
 
+/**
+ * cong_dispspec_element_to_xml:
+ * @element:
+ * @xml_doc:
+ *
+ * TODO: Write me
+ */
 xmlNodePtr
 cong_dispspec_element_to_xml (const CongDispspecElement *element,
 			      xmlDocPtr xml_doc)
 {
 	CongNodePtr xml_node;
Index: cong-dispspec-registry.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-dispspec-registry.c,v
retrieving revision 1.23
diff -u -5 -r1.23 cong-dispspec-registry.c
--- cong-dispspec-registry.c	5 Mar 2004 14:27:56 -0000	1.23
+++ cong-dispspec-registry.c	17 Apr 2004 17:45:22 -0000
@@ -22,10 +22,20 @@
 {
 	CongDispspecRegistry* registry;
 	GnomeVFSURI* path_uri;
 };
 
+/**
+ * visit_func:
+ * @rel_path:
+ * @info:
+ * @recursing_will_loop:
+ * @data:
+ * @recurse:
+ *
+ * TODO: Write me
+ */
 gboolean
 visit_func(const gchar *rel_path,
 	   GnomeVFSFileInfo *info,
 	   gboolean recursing_will_loop,
 	   gpointer data,
@@ -66,10 +76,19 @@
 	
 	return TRUE;
 }
 
 /* Add all disspecs found in directory to an existing DispspecRegistry */
+/**
+ * cong_dispspec_registry_add_dir:
+ * @registry:
+ * @xds_directory:
+ * @toplevel_window:
+ * @raise_errors:
+ *
+ * TODO: Write me
+ */
 void
 cong_dispspec_registry_add_dir(CongDispspecRegistry *registry, const gchar *xds_directory, GtkWindow *toplevel_window, gboolean raise_errors)
 {
 	GnomeVFSResult vfs_result;
 	struct LoadingDetails details;
@@ -99,10 +118,17 @@
 	gnome_vfs_uri_unref(details.path_uri);
 }	
 
 /* Create a new DispspecRegistry.
    If a directory is specified, read disppsec files from it and insert them into registry.  If not, returned registry is empty. */
+/**
+ * cong_dispspec_registry_new:
+ * @xds_directory:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 CongDispspecRegistry*
 cong_dispspec_registry_new(const gchar* xds_directory, GtkWindow *toplevel_window)
 {
 	CongDispspecRegistry* registry;
 
@@ -113,43 +139,75 @@
 	}
 
 	return registry;
 }
 
+/**
+ * cong_dispspec_registry_free:
+ * @registry:
+ *
+ * This function is currently just a false assertion
+ */
 void
 cong_dispspec_registry_free(CongDispspecRegistry* registry)
 {
 	g_assert(0); /* for now */
 }
 
+/**
+ * cong_dispspec_registry_get_num:
+ * @registry:
+ *
+ * TODO: Write me
+ */
 unsigned int
 cong_dispspec_registry_get_num(CongDispspecRegistry* registry)
 {
 	g_return_val_if_fail(registry,0);
 
 	return registry->num;
 }
 
+/**
+ * cong_dispspec_registry_get:
+ * @registry:
+ * @i:
+ *
+ * TODO: Write me
+ */
 CongDispspec*
 cong_dispspec_registry_get(CongDispspecRegistry* registry, unsigned int i)
 {
 	g_return_val_if_fail(registry,NULL);
 	g_return_val_if_fail(i<registry->num,NULL);
 
 	return registry->array[i];
 }
 
+/**
+ * cong_dispspec_registry_add:
+ * @registry:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 void
 cong_dispspec_registry_add(CongDispspecRegistry* registry, CongDispspec* ds)
 {
 	registry->num++;
 
 	registry->array = g_realloc(registry->array, sizeof(CongDispspec*)*registry->num);
 
 	registry->array[registry->num-1]=ds;
 }
 
+/**
+ * cong_dispspec_registry_dump:
+ * @registry:
+ *
+ * TODO: Write me
+ */
 void
 cong_dispspec_registry_dump(CongDispspecRegistry* registry)
 {
 	int i;
 
@@ -183,10 +241,15 @@
 
 	return FALSE;
 }
 #endif
 
+/**
+ * cong_cell_renderer_simple_new:
+ *
+ * TODO: Write me
+ */
 GtkCellRenderer*
 cong_cell_renderer_simple_new (void)
 {
 	GtkCellRenderer* renderer = gtk_cell_renderer_text_new ();
 
@@ -303,21 +366,21 @@
 }
 #endif
 
 
 /**
- * cong_dispspec_registry_get_appropriate_dispspec
+ * cong_dispspec_registry_get_appropriate_dispspec:
  * @registry:
  * @xml_doc:
  * @filename_extension:
  * 
  * Routine to figure out an appropriate dispspec for use with this file.
  * Looks for a DTD; if found, it looks up the DTD in a mapping.
  * If this fails, it looks at the top-level tag and makes a guess, but asks the user for confirmation.
  * If this fails, it asks the user.
  * 
- * Returns:
+ * Returns: The appropriate dispspec for use with the file.
  */
 CongDispspec*
 cong_dispspec_registry_get_appropriate_dispspec (CongDispspecRegistry* registry, 
 						 xmlDocPtr xml_doc,
 						 const gchar *filename_extension)
Index: cong-dispspec.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-dispspec.c,v
retrieving revision 1.45
diff -u -5 -r1.45 cong-dispspec.c
--- cong-dispspec.c	5 Mar 2004 01:36:15 -0000	1.45
+++ cong-dispspec.c	17 Apr 2004 17:45:22 -0000
@@ -205,11 +205,17 @@
 }
 
 /* Exported functions: */
 
 /* Barebones constructor, used to implement other ones: */
-CongDispspec* cong_dispspec_new(void)
+/**
+ * cong_dispspec_new:
+ *
+ * TODO: Write me
+ */
+CongDispspec* 
+cong_dispspec_new(void)
 {
 	CongDispspec *dispspec;
 	
 	dispspec = g_new0 (CongDispspec, 1);
 	dispspec->search_tree = g_tree_new_full((GCompareDataFunc)key_compare_func,
@@ -219,11 +225,19 @@
 
 	return dispspec;
 }
 
 /* Constructors that use the standard format: */
-GnomeVFSResult cong_dispspec_new_from_xds_file(GnomeVFSURI *uri, CongDispspec** ds)
+/**
+ * cong_dispspec_new_from_xds_file:
+ * @uri:
+ * @ds:
+ *
+ * TODO: Write me
+ */
+GnomeVFSResult 
+cong_dispspec_new_from_xds_file(GnomeVFSURI *uri, CongDispspec** ds)
 {
 	char* buffer;
 	GnomeVFSFileSize size;
 	GnomeVFSResult vfs_result;
 
@@ -241,11 +255,19 @@
 	g_free (buffer);
 
 	return vfs_result;	
 }
 
-CongDispspec* cong_dispspec_new_from_xds_buffer(const char *buffer, size_t size)
+/**
+ * cong_dispspec_new_from_xds_buffer:
+ * @buffer:
+ * @size:
+ *
+ * TODO: Write me
+ */
+CongDispspec* 
+cong_dispspec_new_from_xds_buffer(const char *buffer, size_t size)
 {
 	CongDispspec* ds;
 
 	xmlDocPtr doc = xmlParseMemory(buffer, size);
 
@@ -261,13 +283,22 @@
 }
 
 
 
 /* Constructors that try to generate from another format: */
-CongDispspec* cong_dispspec_new_generate_from_dtd (xmlDtdPtr dtd, 
-						   const gchar *name, 
-						   const gchar *description)
+/**
+ * cong_dispspec_new_generate_from_dtd:
+ * @dtd:
+ * @name:
+ * @description:
+ *
+ * TODO: Write me
+ */
+CongDispspec* 
+cong_dispspec_new_generate_from_dtd (xmlDtdPtr dtd, 
+				     const gchar *name, 
+				     const gchar *description)
 {
 	CongDispspec *ds;
 
 	g_return_val_if_fail (dtd, NULL);
 
@@ -287,10 +318,17 @@
 	xmlHashScan (dtd->elements, element_callback_generate_dispspec_from_dtd, ds);
 
 	return ds;
 }
 
+/**
+ * cong_dispspec_new_generate_from_xml_file:
+ * @doc:
+ * @extension:
+ *
+ * TODO: Write me
+ */
 CongDispspec *
 cong_dispspec_new_generate_from_xml_file (xmlDocPtr doc,
 					  const gchar *extension)
 {
 	CongDispspec *dispspec;
@@ -306,11 +344,18 @@
 			 extension);
 
 	return dispspec;
 }
 
-void cong_dispspec_delete (CongDispspec *dispspec)
+/**
+ * cong_dispspec_delete:
+ * @dispspec:
+ *
+ * TODO: Write me
+ */
+void 
+cong_dispspec_delete (CongDispspec *dispspec)
 {
 	/* FIXME: is this causing heap corruption? */
 #if 0
 	CongDispspecElement *element;
 	CongDispspecElement *next;
@@ -337,11 +382,18 @@
 		g_object_unref (G_OBJECT(dispspec->icon));
 	}
 #endif
 }
 
-xmlDocPtr cong_dispspec_make_xml(CongDispspec *dispspec)
+/**
+ * cong_dispspec_make_xml:
+ * @dispspec:
+ *
+ * TODO: Write me
+ */
+xmlDocPtr 
+cong_dispspec_make_xml(CongDispspec *dispspec)
 {
 	xmlDocPtr xml_doc;
 	CongNodePtr root_node;
 
 	g_return_val_if_fail (dispspec, NULL);
@@ -395,10 +447,16 @@
 
 	return xml_doc;	
 }
 
 /* Data for the dispspec: */
+/**
+ * cong_dispspec_get_name:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_get_name (const CongDispspec *ds)
 {
 	g_return_val_if_fail(ds,NULL);
 
@@ -408,10 +466,16 @@
 		return _("unnamed");
 	}
 
 }
 
+/**
+ * cong_dispspec_get_description:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_get_description (const CongDispspec *ds)
 {
 	g_return_val_if_fail(ds,NULL);
 
@@ -420,18 +484,31 @@
 	} else {
 		return _("No description available.");
 	}
 }
 
+/**
+ * cong_dispspec_get_num_serialisation_formats:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 guint
 cong_dispspec_get_num_serialisation_formats (const CongDispspec *ds)
 {
 	g_return_val_if_fail (ds, 0);
 
 	return ds->num_serialisation_formats;
 }
 
+/**
+ * cong_dispspec_get_serialisation_format:
+ * @ds:
+ * @index:
+ *
+ * TODO: Write me
+ */
 const CongSerialisationFormat*
 cong_dispspec_get_serialisation_format (const CongDispspec *ds,
 					guint index)
 {
 	g_return_val_if_fail (ds, NULL);
@@ -440,10 +517,17 @@
 
 	return ds->serialisation_formats[index];
 }
 
 /* Returns NULL if it can't find a serialisation format with that extension */
+/**
+ * cong_dispspec_lookup_filename_extension:
+ * @ds:
+ * @extension:
+ *
+ * TODO: Write me
+ */
 const CongSerialisationFormat*
 cong_dispspec_lookup_filename_extension (const CongDispspec *ds,
 					 const gchar *extension)
 {
 	guint i;
@@ -460,30 +544,50 @@
 
 	return NULL;
 }
 
 /* Returns whether the dispspec uses that extension */
+/**
+ * cong_dispspec_matches_filename_extension:
+ * @ds:
+ * @extension:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dispspec_matches_filename_extension (const CongDispspec *ds,
 					  const gchar *extension)
 {
 	g_return_val_if_fail (ds, FALSE);
 
 	return (NULL!=cong_dispspec_lookup_filename_extension (ds,
 							       extension));
 }
 
+/**
+ * cong_dispspec_get_external_document_model:
+ * @ds:
+ * @model_type:
+ *
+ * TODO: Write me
+ */
 const CongExternalDocumentModel*
 cong_dispspec_get_external_document_model (const CongDispspec *ds,
 					   enum CongDocumentModelType model_type)
 {
 	g_return_val_if_fail(ds, NULL);
 	g_return_val_if_fail(model_type<NUM_CONG_DOCUMENT_MODEL_TYPES, NULL);
 	
 	return ds->document_models[model_type];
 }
 
+/**
+ * cong_dispspec_get_icon:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf*
 cong_dispspec_get_icon(const CongDispspec *ds)
 {
 	g_return_val_if_fail(ds, NULL);
 
@@ -492,10 +596,18 @@
 	}
 	return ds->icon;
 }
 
 /* Getting at elements within a dispspec */
+/**
+ * cong_dispspec_lookup_element:
+ * @ds:
+ * @ns_uri:
+ * @local_name:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_dispspec_lookup_element (const CongDispspec *ds, 
 			      const gchar* ns_uri, 
 			      const gchar* local_name)
 {
@@ -514,10 +626,17 @@
 	element =  g_tree_lookup (ds->search_tree, &key);
 
 	return element;
 }
 
+/**
+ * cong_dispspec_lookup_node:
+ * @ds:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_dispspec_lookup_node(const CongDispspec *ds, CongNodePtr node)
 {
 	g_return_val_if_fail(ds, NULL);
 	g_return_val_if_fail(node, NULL);
@@ -525,10 +644,18 @@
 	return cong_dispspec_lookup_element (ds, 
 					     cong_node_get_ns_uri(node), 
 					     cong_node_get_local_name(node));
 }
 
+/**
+ * cong_dispspec_type:
+ * @ds:
+ * @ns_uri:
+ * @local_name:
+ *
+ * TODO: Write me
+ */
 enum CongElementType
 cong_dispspec_type (CongDispspec *ds, 
 		    const gchar* ns_uri, 
 		    const gchar* local_name)
 {
@@ -541,10 +668,16 @@
 	}
 
 	return cong_dispspec_element_type(element);
 }
 
+/**
+ * cong_dispspec_get_first_element:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_dispspec_get_first_element(CongDispspec *ds)
 {
 	g_return_val_if_fail(ds, NULL);
 
@@ -553,10 +686,18 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_dispspec_for_each_element:
+ * @ds:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_dispspec_for_each_element (CongDispspec *ds, 
 				void
 				(*callback) (CongDispspec *ds,
 					     CongDispspecElement *ds_element,
@@ -575,12 +716,20 @@
 	}
 }
 
 
 /* Manipulating a dispspec: */
-void cong_dispspec_add_element (CongDispspec* ds, 
-				CongDispspecElement* element)
+/**
+ * cong_dispspec_add_element:
+ * @ds:
+ * @element:
+ *
+ * TODO: Write me
+ */
+void 
+cong_dispspec_add_element (CongDispspec* ds, 
+			   CongDispspecElement* element)
 {
 	struct SearchTreeKey *key;
 
 	g_return_if_fail(ds);
 	g_return_if_fail(element);
@@ -597,10 +746,16 @@
 	/* FIXME: does this leak? */
 
 	g_tree_insert(ds->search_tree, key, element);
 }
 
+/**
+ * cong_dispspec_get_num_elements:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 guint
 cong_dispspec_get_num_elements (CongDispspec *ds)
 {
 	guint count;
 	GList *iter;
@@ -614,10 +769,17 @@
 		count++;
 	}
 	return count;	
 }
 
+/**
+ * cong_dispspec_get_element:
+ * @ds:
+ * @index:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_dispspec_get_element (CongDispspec *ds,
 			   guint index)
 {
 	guint count;
@@ -651,23 +813,40 @@
 		return NULL;
 	}
 }
 #endif
 #else
-GdkGC *cong_dispspec_name_gc_get(CongDispspec *ds, CongNodePtr t, int tog)
+/**
+ * cong_dispspec_name_gc_get:
+ * @ds:
+ * @t:
+ * @tog:
+ *
+ * TODO: Write me
+ */
+GdkGC *
+cong_dispspec_name_gc_get(CongDispspec *ds, CongNodePtr t, int tog)
 {
 	CongDispspecElement* element = cong_dispspec_lookup_element(ds, cong_node_name(t));
 
 	if (element) {
 		return cong_dispspec_element_gc(element);
 	} else {
 		return NULL;
 	}
 }
 
-
-GdkGC *cong_dispspec_gc_get(CongDispspec *ds, CongNodePtr x, int tog)
+/**
+ * cong_dispspec_gc_get:
+ * @ds:
+ * @x:
+ * @tog:
+ *
+ * TODO: Write me
+ */
+GdkGC *
+cong_dispspec_gc_get(CongDispspec *ds, CongNodePtr x, int tog)
 {
 	CongDispspecElement* element = cong_dispspec_lookup_element(ds, xml_frag_name_nice(x));
 
 	if (element) {
 		return cong_dispspec_element_gc(element);
@@ -675,10 +854,17 @@
 		return NULL;
 	}
 }
 #endif
 
+/**
+ * cong_dispspec_name_get:
+ * @ds:
+ * @node:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_dispspec_name_get (CongDispspec *ds, 
 			CongNodePtr node)
 {
 	CongDispspecElement* element;
@@ -706,10 +892,18 @@
 	return(t->data);
 }
 #endif
 
 #if 1
+/**
+ * cong_dispspec_element_structural:
+ * @ds:
+ * @ns_uri:
+ * @name:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_dispspec_element_structural (CongDispspec *ds, 
 				  const gchar *ns_uri, 
 				  const char *name)
 {
@@ -720,11 +914,18 @@
 	}
 
 	return (CONG_ELEMENT_TYPE_STRUCTURAL == cong_dispspec_element_type(element));
 }
 
-
+/**
+ * cong_dispspec_element_collapse:
+ * @ds:
+ * @ns_uri:
+ * @name:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_dispspec_element_collapse (CongDispspec *ds, 
 				const gchar *ns_uri, 
 				const char *name)
 {
@@ -735,11 +936,18 @@
 	}
 	
 	return cong_dispspec_element_collapseto(element);
 }
 
-
+/**
+ * cong_dispspec_element_span:
+ * @ds:
+ * @ns_uri:
+ * @name:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dispspec_element_span (CongDispspec *ds, 
 			    const gchar *ns_uri, 
 			    const char *name)
 {
@@ -750,11 +958,18 @@
 	}
 
 	return (CONG_ELEMENT_TYPE_SPAN == cong_dispspec_element_type(element));
 }
 
-
+/**
+ * cong_dispspec_element_insert:
+ * @ds:
+ * @ns_uri:
+ * @name:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_dispspec_element_insert (CongDispspec *ds, 
 			      const gchar *ns_uri, 
 			      const char *name)
 {
@@ -1016,25 +1231,45 @@
 			return;
 		}
 	}
 }
 	
-void col_to_gcol(GdkColor *gcol, unsigned int col)
+/**
+ * col_to_gcol:
+ * @gcol:
+ * @col:
+ *
+ * TODO: Write me
+ */
+void 
+col_to_gcol(GdkColor *gcol, unsigned int col)
 {
   gcol->blue = (col << 8) & 0xff00;
   gcol->green = (col & 0xff00);
   gcol->red = (col >> 8) & 0xff00;
 }
 
+/**
+ * cong_external_document_model_get_public_id:
+ * @model:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_external_document_model_get_public_id (const CongExternalDocumentModel* model)
 {
 	g_return_val_if_fail (model, NULL);
 
 	return model->public_id;
 }
 
+/**
+ * cong_external_document_model_get_system_id:
+ * @model:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_external_document_model_get_system_id (const CongExternalDocumentModel* model)
 {
 	g_return_val_if_fail (model, NULL);
 
@@ -1363,11 +1598,16 @@
 		}
 	}
 	return NULL;
 }
 
-
+/**
+ * cong_dispspec_get_template:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 xmlNodePtr
 cong_dispspec_get_template(const CongDispspec *ds)
 {
 	return  ds->template;
 }
@@ -1401,10 +1641,17 @@
 					 iter,
 					 coverage_data);
 	}
 }
 
+/**
+ * cong_dispspec_calculate_coverage:
+ * @ds:
+ * @xml_doc:
+ *
+ * TODO: Write me
+ */
 gdouble
 cong_dispspec_calculate_coverage (const CongDispspec *ds,
 				  xmlDocPtr xml_doc)
 {
 	struct CoverageData coverage_data;
Index: cong-document-traversal.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-document-traversal.c,v
retrieving revision 1.5
diff -u -5 -r1.5 cong-document-traversal.c
--- cong-document-traversal.c	4 Feb 2004 16:24:21 -0000	1.5
+++ cong-document-traversal.c	17 Apr 2004 17:45:22 -0000
@@ -175,10 +175,17 @@
 cong_document_traversal_instance_init (CongDocumentTraversal *doc)
 {
 	doc->private = g_new0(CongDocumentTraversalDetails,1);
 }
 
+/**
+ * cong_document_traversal_construct:
+ * @doc_traversal:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongDocumentTraversal*
 cong_document_traversal_construct (CongDocumentTraversal *doc_traversal,
 				   CongDocument *doc)
 {
 	g_return_val_if_fail (IS_CONG_DOCUMENT_TRAVERSAL (doc_traversal), NULL);
@@ -201,35 +208,62 @@
 	g_signal_connect_after (G_OBJECT(doc), "node_set_parent", G_CALLBACK(on_signal_set_parent_notify_after), doc_traversal);
 
 	return doc_traversal;
 }
 
+/**
+ * cong_document_traversal_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongDocumentTraversal*
 cong_document_traversal_new (CongDocument *doc)
 {
 	return cong_document_traversal_construct (g_object_new (CONG_DOCUMENT_TRAVERSAL_TYPE, NULL),
 						  doc);
 }
 
+/**
+ * cong_document_traversal_get_document:
+ * @doc_traversal:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_document_traversal_get_document(CongDocumentTraversal *doc_traversal)
 {
 	g_return_val_if_fail (IS_CONG_DOCUMENT_TRAVERSAL(doc_traversal), NULL);
 
 	return PRIVATE(doc_traversal)->doc;
 }
 
+/**
+ * cong_document_traversal_get_root_traversal_node:
+ * @doc_traversal:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_document_traversal_get_root_traversal_node (CongDocumentTraversal *doc_traversal)
 {
 	g_return_val_if_fail (IS_CONG_DOCUMENT_TRAVERSAL(doc_traversal), NULL);
 	
 	return cong_document_traversal_get_traversal_node (doc_traversal,
 							   (xmlNodePtr)cong_document_get_xml (PRIVATE(doc_traversal)->doc),
 							   NULL);
 }
 
+/**
+ * cong_document_traversal_for_each_traversal_node:
+ * @doc_traversal:
+ * @xml_node:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_traversal_for_each_traversal_node (CongDocumentTraversal *doc_traversal,
 						 CongNodePtr xml_node,
 						 void (*callback) (CongDocumentTraversal *doc_traversal, 
 								   CongTraversalNode *traversal_node, 
@@ -251,10 +285,18 @@
 							   callback,
 							   user_data);
 	}
 }
 
+/**
+ * cong_document_traversal_get_traversal_node:
+ * @doc_traversal:
+ * @xml_node:
+ * @traversal_parent:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_document_traversal_get_traversal_node (CongDocumentTraversal *doc_traversal,
 					    CongNodePtr xml_node,
 					    CongTraversalNode *traversal_parent)
 {
@@ -286,10 +328,17 @@
 	CongTraversalNode **result = (CongTraversalNode**)user_data;
 
 	*result = CONG_TRAVERSAL_NODE (value);
 }
 
+/**
+ * cong_document_traversal_get_a_traversal_node:
+ * @doc_traversal:
+ * @xml_node:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_document_traversal_get_a_traversal_node (CongDocumentTraversal *doc_traversal,
 					      CongNodePtr xml_node)
 {
 	NodeMapping *node_mapping;
@@ -315,10 +364,16 @@
 		return NULL;
 	}	
 }
 
 /* Internal function definitions: */
+/**
+ * cong_node_mapping_new:
+ * @xml_node:
+ *
+ * TODO: Write me
+ */
 NodeMapping*
 cong_node_mapping_new (CongNodePtr xml_node)
 {
 	NodeMapping *mapping;
 
@@ -331,20 +386,34 @@
 										NULL);
 
 	return mapping;
 }
 
+/**
+ * cong_node_mapping_free:
+ * @mapping:
+ *
+ * TODO: Write me
+ */
 void
 cong_node_mapping_free (NodeMapping* mapping)
 {
 	g_assert(mapping);
 
 	g_hash_table_destroy ( mapping->hash_of_traversal_parent_to_traversal_node);
 
 	g_free (mapping);
 }
 
+/**
+ * cong_node_mapping_add_traversal_node:
+ * @mapping:
+ * @traversal_parent:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 void
 cong_node_mapping_add_traversal_node (NodeMapping* mapping,
 				      CongTraversalNode *traversal_parent,
 				      CongTraversalNode *traversal_node)
 {
@@ -357,10 +426,17 @@
 			     traversal_parent,
 			     traversal_node);
 	
 }
 
+/**
+ * cong_node_mapping_remove_traversal_node:
+ * @mapping:
+ * @traversal_parent:
+ *
+ * TODO: Write me
+ */
 void
 cong_node_mapping_remove_traversal_node (NodeMapping* mapping,
 					 CongTraversalNode *traversal_parent)
 {
 	g_assert(mapping);
@@ -388,10 +464,19 @@
 	foreach_data->outer_callback (foreach_data->doc_traversal,
 				      CONG_TRAVERSAL_NODE (value),
 				      foreach_data->outer_user_data);
 }
 
+/**
+ * cong_node_mapping_for_each_traversal_node:
+ * @node_mapping:
+ * @doc_traversal:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_node_mapping_for_each_traversal_node (NodeMapping* node_mapping,
 					   CongDocumentTraversal *doc_traversal,
 					   void (*callback) (CongDocumentTraversal *doc_traversal, CongTraversalNode *traversal_node, gpointer user_data),
 					   gpointer user_data)
@@ -688,10 +773,16 @@
 	
 	/* Call the parent method: */		
 	GNOME_CALL_PARENT (G_OBJECT_CLASS, dispose, (object));
 }
 
+/**
+ * should_have_traversal_node:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 should_have_traversal_node (CongNodePtr node)
 {
 	if (node->parent) {
 		return should_have_traversal_node (node->parent);
@@ -754,10 +845,11 @@
 	/* Create any traversal nodes: */
 	recursive_create_traversal_nodes_for_xml_node (doc_traversal,
 						       node);
 
 }
+
 static void on_signal_add_before_notify_after (CongDocument *doc, 
 					CongNodePtr node, 
 					CongNodePtr younger_sibling, 
 					gpointer user_data)
 {
@@ -768,10 +860,11 @@
 	recursive_create_traversal_nodes_for_xml_node (doc_traversal, 
 						       node);
 
 
 }
+
 static void on_signal_set_parent_notify_after (CongDocument *doc, 
 					CongNodePtr node, 
 					CongNodePtr adoptive_parent, 
 					gpointer user_data)
 {	
Index: cong-document.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-document.c,v
retrieving revision 1.89
diff -u -5 -r1.89 cong-document.c
--- cong-document.c	15 Mar 2004 14:08:46 -0000	1.89
+++ cong-document.c	17 Apr 2004 17:45:22 -0000
@@ -335,10 +335,19 @@
 		}
 	}
 }
 #endif
 
+/**
+ * cong_document_construct:
+ * @doc:
+ * @xml_doc:
+ * @ds:
+ * @url:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_document_construct (CongDocument *doc,
 			 xmlDocPtr xml_doc,
 			 CongDispspec *ds, 
 			 const gchar *url)
@@ -400,11 +409,18 @@
 	PRIVATE(doc)->traversal = cong_document_traversal_new (doc);
 
 	return doc;
 }
 
-
+/**
+ * cong_document_new_from_xmldoc:
+ * @xml_doc:
+ * @ds:
+ * @url:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_document_new_from_xmldoc (xmlDocPtr xml_doc,
 			       CongDispspec *ds, 
 			       const gchar *url)
 {
@@ -417,18 +433,30 @@
 					xml_doc,
 					ds,
 					url);
 }
 
+/**
+ * cong_document_get_xml:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 xmlDocPtr
 cong_document_get_xml(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
 	return PRIVATE(doc)->xml_doc;
 }
 
+/**
+ * cong_document_get_root:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_document_get_root(CongDocument *doc)
 {
 	CongNodePtr iter;
 
@@ -441,43 +469,74 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_document_get_traversal:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongDocumentTraversal*
 cong_document_get_traversal (CongDocument *doc)
 {
 	g_return_val_if_fail (IS_CONG_DOCUMENT (doc), NULL);
 	
 	return PRIVATE(doc)->traversal;
 }
 
+/**
+ * cong_document_get_root_traversal_node:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_document_get_root_traversal_node (CongDocument *doc)
 {
 	g_return_val_if_fail (IS_CONG_DOCUMENT (doc), NULL);
 
 	return cong_document_traversal_get_root_traversal_node (PRIVATE(doc)->traversal);
 }
 
+/**
+ * cong_document_get_dispspec:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongDispspec*
 cong_document_get_dispspec(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
 	return PRIVATE(doc)->ds;
 }
 
+/**
+ * cong_document_get_dispspec_element_for_node:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_document_get_dispspec_element_for_node(CongDocument *doc, CongNodePtr node)
 {
 	g_return_val_if_fail(doc, NULL);
 	g_return_val_if_fail(node, NULL);
 
 	return cong_dispspec_lookup_node(PRIVATE(doc)->ds, node);
 }
 
+/**
+ * cong_document_get_filename:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_document_get_filename(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
@@ -497,22 +556,35 @@
 	} else {
 		return g_strdup("(Untitled)");
 	}
 }
 
+/**
+ * cong_document_get_full_uri:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 gchar*
-cong_document_get_full_uri(CongDocument *doc) {
+cong_document_get_full_uri(CongDocument *doc) 
+{
 	g_return_val_if_fail(doc, NULL);
 
 	if (PRIVATE(doc)->url) {
 		return g_strdup(PRIVATE(doc)->url);
 	}
 	else {
 		return NULL;
 	}		    
 }
 
+/**
+ * cong_document_get_parent_uri:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_document_get_parent_uri(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
@@ -532,10 +604,16 @@
 	} else {
 		return g_strdup(".");
 	}
 }
 
+/**
+ * cong_document_get_dtd_public_identifier:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 const CongXMLChar*
 cong_document_get_dtd_public_identifier(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
@@ -546,10 +624,17 @@
 	}
 
 	return PRIVATE(doc)->xml_doc->extSubset->ExternalID;
 }
 
+/**
+ * cong_document_get_xml_ns:
+ * @doc:
+ * @ns_uri:
+ *
+ * TODO: Write me
+ */
 xmlNsPtr
 cong_document_get_xml_ns (CongDocument *doc, 
 			  const gchar* ns_uri)
 {
 	xmlNsPtr ns;
@@ -562,10 +647,18 @@
 				ns_uri);
 
 	return ns;
 }
 
+/**
+ * cong_document_save:
+ * @doc:
+ * @filename:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_save(CongDocument *doc, 
 		   const char* filename, 
 		   GtkWindow *toplevel_window)
 {
@@ -604,18 +697,31 @@
 	g_get_current_time(&PRIVATE(doc)->time_of_last_save);
 
 	gnome_vfs_uri_unref(file_uri);
 }
 
+/**
+ * cong_document_is_modified:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_document_is_modified(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, FALSE);
 
 	return PRIVATE(doc)->modified;
 }
 
+/**
+ * cong_document_set_modified:
+ * @doc:
+ * @modified:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_set_modified(CongDocument *doc, gboolean modified)
 {
 	g_return_if_fail(doc);
 
@@ -628,20 +734,34 @@
 			cong_primary_window_update_title(PRIVATE(doc)->primary_window);
 		}
 	}
 }
 
+/**
+ * cong_document_set_primary_window:
+ * @doc:
+ * @window:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_set_primary_window(CongDocument *doc, CongPrimaryWindow *window)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(window);
 
 	g_assert(PRIVATE(doc)->primary_window==NULL);
 	PRIVATE(doc)->primary_window = window;
 }
 
+/**
+ * cong_document_set_url:
+ * @doc:
+ * @url:
+ *
+ * TODO: Write me
+ */
 void 
 cong_document_set_url(CongDocument *doc, const gchar *url) 
 {
 	g_return_if_fail (IS_CONG_DOCUMENT (doc));
 	g_return_if_fail (url);
@@ -649,10 +769,16 @@
 	g_signal_emit (G_OBJECT(doc),
 		       signals[SET_URL], 0,
 		       url);
 }
 
+/**
+ * cong_document_get_seconds_since_last_save_or_load:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 glong
 cong_document_get_seconds_since_last_save_or_load(const CongDocument *doc)
 {
 	GTimeVal current_time;
 
@@ -661,11 +787,17 @@
 	g_get_current_time(&current_time);
 
 	return current_time.tv_sec - PRIVATE(doc)->time_of_last_save.tv_sec;
 }
 
-
+/**
+ * cong_document_get_node_name:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_document_get_node_name (CongDocument *doc, 
 			     CongNodePtr node)
 {
 
@@ -769,11 +901,16 @@
 	((int*)user_data)++;
 
 	return FALSE;		
 }
 
-
+/**
+ * cong_document_get_num_nodes:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 guint
 cong_document_get_num_nodes (CongDocument *doc)
 {
 	g_return_val_if_fail(doc, 0);
 
@@ -787,30 +924,52 @@
 	
 	return PRIVATE(doc)->num_nodes;
 	
 }
 
+/**
+ * cong_document_node_ref:
+ * @doc:
+ * @node:
+ *
+ * This function is not currently implemented
+ */
 void 
 cong_document_node_ref (CongDocument *doc,
 			CongNodePtr node)
 {
 	g_return_if_fail (IS_CONG_DOCUMENT (doc));
 	g_return_if_fail (node);
 
 	/* unwritten */
 }
 
+/**
+ * cong_document_node_unref:
+ * @doc:
+ * @node:
+ *
+ * This function is not currently implemented
+ */
 void 
 cong_document_node_unref (CongDocument *doc,
 			  CongNodePtr node)
 {
 	g_return_if_fail (IS_CONG_DOCUMENT (doc));
 	g_return_if_fail (node);
 
 	/* unwritten */
 }
 
+/**
+ * cong_document_set_with_ref:
+ * @doc:
+ * @node_ptr:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_set_with_ref (CongDocument *doc,
 			    CongNodePtr *node_ptr,
 			    CongNodePtr node)
 {
@@ -829,10 +988,18 @@
 	}
 	
 	*node_ptr = node;
 }
 
+/**
+ * cong_document_begin_command:
+ * @doc:
+ * @description:
+ * @consolidation_id:
+ *
+ * TODO: Write me
+ */
 CongCommand*
 cong_document_begin_command (CongDocument *doc,
 			     const gchar *description,
 			     const gchar *consolidation_id)
 {
@@ -878,10 +1045,17 @@
 	}
 	
 	return NULL;
 }
 
+/**
+ * cong_document_end_command:
+ * @doc:
+ * @cmd:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_end_command (CongDocument *doc,
 			   CongCommand *cmd)
 {
 	CongCommand *cmd_to_merge_into;
@@ -911,11 +1085,18 @@
 
 	g_object_unref (G_OBJECT (cmd));
 }
 
 /* Public MVC hooks: */
-void cong_document_begin_edit (CongDocument *doc)
+/**
+ * cong_document_begin_edit:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_begin_edit (CongDocument *doc)
 {
 	g_return_if_fail (doc);
 
 	PRIVATE(doc)->edit_depth++;
 
@@ -927,11 +1108,18 @@
 			       signals[BEGIN_EDIT], 0);
 			       
 	}
 }
 
-void cong_document_end_edit (CongDocument *doc)
+/**
+ * cong_document_end_edit:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_end_edit (CongDocument *doc)
 {
 	g_return_if_fail (doc);
 
 	g_assert(PRIVATE(doc)->edit_depth>0 && "If this assertion fails, then there is a mismatched pair of begin/end edit calls on the document");
 
@@ -944,19 +1132,33 @@
 		g_signal_emit (G_OBJECT(doc),
 			       signals[END_EDIT], 0);
 	}
 }
 
-gboolean cong_document_is_within_edit(CongDocument *doc)
+/**
+ * cong_document_is_within_edit:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_document_is_within_edit(CongDocument *doc)
 {
 	g_return_val_if_fail (doc, FALSE);
 
 	return (PRIVATE(doc)->edit_depth>0);
 }
 
-
-void cong_document_private_node_make_orphan(CongDocument *doc, CongNodePtr node)
+/**
+ * cong_document_private_node_make_orphan:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_make_orphan(CongDocument *doc, CongNodePtr node)
 {
 #if DEBUG_MVC
 	g_message("cong_document_private_node_make_orphan");
 #endif
 
@@ -968,11 +1170,20 @@
 			       signals[NODE_MAKE_ORPHAN], 0,
 			       node);
 	}
 }
 
-void cong_document_private_node_add_after(CongDocument *doc, CongNodePtr node, CongNodePtr older_sibling)
+/**
+ * cong_document_private_node_add_after:
+ * @doc:
+ * @node:
+ * @older_sibling:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_add_after(CongDocument *doc, CongNodePtr node, CongNodePtr older_sibling)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
 
 	#if DEBUG_MVC
@@ -986,11 +1197,20 @@
 		       signals[NODE_ADD_AFTER], 0,
 		       node,
 		       older_sibling);
 }
 
-void cong_document_private_node_add_before(CongDocument *doc, CongNodePtr node, CongNodePtr younger_sibling)
+/**
+ * cong_document_private_node_add_before:
+ * @doc:
+ * @node:
+ * @younger_sibling:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_add_before(CongDocument *doc, CongNodePtr node, CongNodePtr younger_sibling)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
 
 	#if DEBUG_MVC
@@ -1004,11 +1224,20 @@
 		       signals[NODE_ADD_BEFORE], 0,
 		       node,
 		       younger_sibling);
 }
 
-void cong_document_private_node_set_parent(CongDocument *doc, CongNodePtr node, CongNodePtr adoptive_parent)
+/**
+ * cong_document_private_node_set_parent:
+ * @doc:
+ * @node:
+ * @adoptive_parent:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_set_parent(CongDocument *doc, CongNodePtr node, CongNodePtr adoptive_parent)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
 
 	#if DEBUG_MVC
@@ -1022,11 +1251,20 @@
 		       signals[NODE_SET_PARENT], 0,
 		       node,
 		       adoptive_parent);
 }
 
-void cong_document_private_node_set_text(CongDocument *doc, CongNodePtr node, const xmlChar *new_content)
+/**
+ * cong_document_private_node_set_text:
+ * @doc:
+ * @node:
+ * @new_content:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_set_text(CongDocument *doc, CongNodePtr node, const xmlChar *new_content)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
 	g_return_if_fail(new_content);
 
@@ -1041,15 +1279,26 @@
 		       signals[NODE_SET_TEXT], 0,
 		       node,
 		       new_content);
 }
 
-void cong_document_private_node_set_attribute(CongDocument *doc, 
-					      CongNodePtr node, 
-					      xmlNs *ns_ptr,
-					      const xmlChar *name, 
-					      const xmlChar *value)
+/**
+ * cong_document_private_node_set_attribute:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ * @value:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_set_attribute(CongDocument *doc, 
+					 CongNodePtr node, 
+					 xmlNs *ns_ptr,
+					 const xmlChar *name, 
+					 const xmlChar *value)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
 	g_return_if_fail(name);
 	g_return_if_fail(value);
@@ -1067,14 +1316,24 @@
 		       ns_ptr,
 		       name,
 		       value);
 }
 
-void cong_document_private_node_remove_attribute(CongDocument *doc, 
-						 CongNodePtr node, 
-						 xmlNs *ns_ptr,
-						 const xmlChar *name)
+/**
+ * cong_document_private_node_remove_attribute:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_node_remove_attribute(CongDocument *doc, 
+					    CongNodePtr node, 
+					    xmlNs *ns_ptr,
+					    const xmlChar *name)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
 	g_return_if_fail(name);
 
@@ -1090,11 +1349,18 @@
 		       node,
 		       ns_ptr,
 		       name);
 }
 
-void cong_document_private_on_selection_change(CongDocument *doc)
+/**
+ * cong_document_private_on_selection_change:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_on_selection_change(CongDocument *doc)
 {
 	GList *iter;
 
 	g_return_if_fail(doc);
 
@@ -1117,11 +1383,18 @@
 			view->klass->on_selection_change(view);
 		}
 	}
 }
 
-void cong_document_private_on_cursor_change(CongDocument *doc)
+/**
+ * cong_document_private_on_cursor_change:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_private_on_cursor_change(CongDocument *doc)
 {
 	GList *iter;
 
 	g_return_if_fail(doc);
 
@@ -1146,10 +1419,17 @@
 			view->klass->on_cursor_change(view);
 		}
 	}
 }
 
+/**
+ * cong_document_private_set_dtd_ptr:
+ * @doc:
+ * @dtd_ptr:
+ *
+ * TODO: Write me
+ */
 void 
 cong_document_private_set_dtd_ptr (CongDocument *doc,
 				   xmlDtdPtr dtd_ptr)
 {
 	g_return_if_fail(doc);
@@ -1169,44 +1449,78 @@
 		       signals[SET_DTD_PTR], 0,
 		       dtd_ptr);
 }
 /* end of MVC user hooks */
 
-
-void cong_document_register_view(CongDocument *doc, CongView *view)
+/**
+ * cong_document_register_view:
+ * @doc:
+ * @view:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_register_view(CongDocument *doc, CongView *view)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(view);
 
 	PRIVATE(doc)->views = g_list_prepend(PRIVATE(doc)->views, view);
 	g_object_ref (G_OBJECT(doc));
 }
 
-void cong_document_unregister_view(CongDocument *doc, CongView *view)
+/**
+ * cong_document_unregister_view:
+ * @doc:
+ * @view:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_unregister_view(CongDocument *doc, CongView *view)
 {
 	g_return_if_fail(doc);
 	g_return_if_fail(view);
 
 	PRIVATE(doc)->views = g_list_remove(PRIVATE(doc)->views, view); 
 	g_object_unref (G_OBJECT(doc));
 }
 
-
-CongCursor* cong_document_get_cursor(CongDocument *doc)
+/**
+ * cong_document_get_cursor:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+CongCursor* 
+cong_document_get_cursor(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
 	return &PRIVATE(doc)->cursor;
 }
 
-CongSelection* cong_document_get_selection(CongDocument *doc)
+/**
+ * cong_document_get_selection:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+CongSelection* 
+cong_document_get_selection(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
 	return PRIVATE(doc)->selection;
 }
 
+/**
+ * cong_document_get_selected_node:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_document_get_selected_node (CongDocument *doc)
 {
 	CongLocation *start, *end;
 
@@ -1223,10 +1537,17 @@
 
 	return NULL;
 }
 
 
+/**
+ * cong_document_get_language_for_node:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 PangoLanguage*
 cong_document_get_language_for_node(CongDocument *doc, 
 				    CongNodePtr node)
 {
 	g_return_val_if_fail(doc, NULL);
@@ -1262,10 +1583,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_document_for_each_node:
+ * @doc:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_document_for_each_node (CongDocument *doc, 
 			     CongDocumentRecursionCallback callback, 
 			     gpointer user_data)
 {
@@ -1277,10 +1606,19 @@
 						    callback, 
 						    user_data, 
 						    0);
 }
 
+/**
+ * cong_document_for_each_child_of_node:
+ * @doc:
+ * @parent:
+ * @callback:
+ * @callback_data:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_document_for_each_child_of_node (CongDocument *doc, 
 				      CongNodePtr parent, 
 				      CongDocumentRecursionCallback callback, 
 				      gpointer callback_data)
@@ -1298,10 +1636,17 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_document_make_nodes_from_source_fragment:
+ * @doc:
+ * @source_fragment:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_document_make_nodes_from_source_fragment (CongDocument *doc, 
 					       const gchar *source_fragment)
 {
 	gchar *fake_document;
@@ -1337,10 +1682,17 @@
 	
 	return result;
 
 }
 
+/**
+ * cong_document_get_dtd_element:
+ * @cong_doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 xmlElementPtr 
 cong_document_get_dtd_element (CongDocument *cong_doc, 
 			       CongNodePtr node)
 {
 	xmlDocPtr doc;
@@ -1409,19 +1761,30 @@
 	}
 
 	return elemDecl;
 }
 
+/**
+ * cong_document_get_command_history:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongCommandHistory*
 cong_document_get_command_history (CongDocument *doc)
 {
 	g_return_val_if_fail (IS_CONG_DOCUMENT(doc), NULL);
 
 	return PRIVATE(doc)->history;
 }
 
-
+/**
+ * cong_document_undo:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_undo (CongDocument *doc)
 {
 	g_return_if_fail (IS_CONG_DOCUMENT(doc));
 
@@ -1430,10 +1793,16 @@
 #endif
 
 	cong_command_history_undo (PRIVATE(doc)->history);
 }
 
+/**
+ * cong_document_redo:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_redo (CongDocument *doc)
 {
 	g_return_if_fail (IS_CONG_DOCUMENT(doc));
 
@@ -1442,10 +1811,17 @@
 #endif
 
 	cong_command_history_redo (PRIVATE(doc)->history);
 }
 
+/**
+ * cong_document_select_node:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_select_node (CongDocument *doc,
 			   CongNodePtr node)
 {	
 	g_return_if_fail (IS_CONG_DOCUMENT (doc));
@@ -1492,10 +1868,17 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_document_node_can_be_deleted:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_document_node_can_be_deleted (CongDocument *doc,
 				   CongNodePtr node)
 {
 	CongCursor* cursor;
@@ -1523,10 +1906,16 @@
 
 	/* Passed all tests; it's save to delete this node: */
 	return TRUE; 
 }
 
+/**
+ * cong_document_can_paste:
+ * @doc:
+ *
+ * Returns: %TRUE
+ */
 gboolean
 cong_document_can_paste(CongDocument *doc)
 {
 	return TRUE;
 	/* FIXMEPCS: conditions? */
Index: cong-dom-view.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-dom-view.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-dom-view.c
--- cong-dom-view.c	8 Mar 2004 09:14:08 -0000	1.11
+++ cong-dom-view.c	17 Apr 2004 17:45:22 -0000
@@ -48,11 +48,18 @@
 
 static gchar*
 get_text_for_node(CongNodePtr node);
 
 /* Exported function implementations: */
-GtkWidget *cong_dom_view_new (CongDocument *doc)
+/**
+ * cong_dom_view_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_dom_view_new (CongDocument *doc)
 {
 	CongTreeView *cong_tree_view;
 	GtkScrolledWindow *scrolled_window;
 
 	g_return_val_if_fail(doc, NULL);
@@ -133,10 +140,16 @@
 	g_free(cleaned);
 
 	return result;
 }
 
+/**
+ * cong_ui_get_colour_string:
+ * @type:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_ui_get_colour_string(enum CongNodeType type)
 {
 	/* FIXME: this should be linked to the theme and/or the GtkSourceView settings */
 
@@ -314,6 +327,5 @@
 	}
 
 	return (text);
 	
 }
-
Index: cong-dtd.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-dtd.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-dtd.c
--- cong-dtd.c	4 Mar 2004 20:39:24 -0000	1.7
+++ cong-dtd.c	17 Apr 2004 17:45:22 -0000
@@ -38,10 +38,18 @@
 element_callback_marshall (void *payload, 
 			   void *data,
 			   xmlChar * name);
 
 /* Exported function definitions: */
+/**
+ * cong_dtd_for_each_element:
+ * @dtd:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_dtd_for_each_element (xmlDtdPtr dtd,
 			   CongDtdElementCallback callback,
 			   gpointer user_data)
 {
@@ -54,13 +62,20 @@
 	marshall.user_data = user_data;
 
 	xmlHashScan (dtd->elements, 
 		     element_callback_marshall, 
 		     &marshall);
-
 }
 
+/**
+ * cong_dtd_for_each_attribute:
+ * @dtd_element:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void 
 cong_dtd_for_each_attribute (xmlElementPtr dtd_element,
 			     CongDtdAttributeCallback callback,
 			     gpointer user_data)
 {
@@ -74,11 +89,16 @@
 			     attr,
 			     user_data);
 	}
 }
 
-
+/**
+ * cong_dtd_element_guess_dispspec_type:
+ * @element:
+ *
+ * TODO: Write me
+ */
 enum CongElementType
 cong_dtd_element_guess_dispspec_type (xmlElementPtr element)
 {
 	g_return_val_if_fail (element, CONG_ELEMENT_TYPE_UNKNOWN);
 
@@ -90,10 +110,16 @@
 	{
 		return CONG_ELEMENT_TYPE_STRUCTURAL;
 	}
 }
 
+/**
+ * cong_dtd_element_content_can_contain_pcdata:
+ * @content:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dtd_element_content_can_contain_pcdata (xmlElementContentPtr content)
 {
 	g_return_val_if_fail (content, FALSE);
   
@@ -117,10 +143,17 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_dtd_element_get_element_for_node:
+ * @dtd:
+ * @xml_node:
+ *
+ * TODO: Write me
+ */
 xmlElementPtr
 cong_dtd_element_get_element_for_node (xmlDtdPtr dtd,
 				       xmlNodePtr xml_node)
 {
 	g_return_val_if_fail (dtd, NULL);
@@ -131,10 +164,17 @@
 	/* FIXME: doesn't handle namespaces yet: */
 	return xmlGetDtdElementDesc (dtd,
 				     xml_node->name);
 }
 
+/**
+ * cong_dtd_content_model_node_is_element:
+ * @content:
+ * @dtd_element:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dtd_content_model_node_is_element (xmlElementContentPtr content,
 					xmlElementPtr dtd_element)
 {
 	g_return_val_if_fail (content, FALSE);
@@ -178,10 +218,17 @@
 		/* FIXME: ought to terminate search here! */
 	}
 }
 
 
+/**
+ * cong_dtd_get_element_for_content:
+ * @dtd:
+ * @content:
+ *
+ * TODO: Write me
+ */
 xmlElementPtr 
 cong_dtd_get_element_for_content (xmlDtdPtr dtd,
 				  xmlElementContentPtr content)
 {
 	g_return_val_if_fail (dtd, NULL);
@@ -258,10 +305,19 @@
 		visit_element_references_for_content_subtree (dtd_element->content,
 							      cb_data);
 	}
 }
 
+/**
+ * cong_dtd_for_each_reference_to_element:
+ * @dtd:
+ * @dtd_element:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_dtd_for_each_reference_to_element (xmlDtdPtr dtd,
 					xmlElementPtr dtd_element,
 					CongDtdElementReferenceCallback callback,
 					gpointer user_data)
@@ -280,11 +336,10 @@
 	cong_dtd_for_each_element (dtd,
 				   element_callback_visit_cross_references,
 				   &cb_data);
 }
 
-
 static void
 element_reference_callback_count (xmlDtdPtr dtd,
 				  xmlElementPtr dtd_element,
 				  xmlElementContentPtr content,
 				  gpointer user_data)
@@ -292,10 +347,17 @@
 	guint *count = (guint *)user_data;
 
 	(*count)++;
 }
 
+/**
+ * cong_dtd_count_references_to_element:
+ * @dtd:
+ * @dtd_element:
+ *
+ * TODO: Write me
+ */
 guint
 cong_dtd_count_references_to_element (xmlDtdPtr dtd,
 				      xmlElementPtr dtd_element)
 {
 	guint result = 0;
@@ -319,10 +381,16 @@
 
 		*list_ptr = g_list_append (*list_ptr, dtd_element);
 	}
 }
 
+/**
+ * cong_dtd_guess_start_elements:
+ * @dtd:
+ *
+ * TODO: Write me
+ */
 GList*
 cong_dtd_guess_start_elements (xmlDtdPtr dtd)
 {
 	GList *list = NULL;
 
Index: cong-edit-find-and-replace.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-edit-find-and-replace.c,v
retrieving revision 1.6
diff -u -5 -r1.6 cong-edit-find-and-replace.c
--- cong-edit-find-and-replace.c	5 Mar 2004 14:27:56 -0000	1.6
+++ cong-edit-find-and-replace.c	17 Apr 2004 17:45:23 -0000
@@ -27,11 +27,10 @@
 			CongFindDialogDetails *dialog_details);
 
 
 /**
  * cong_document_find:
- *
  * @doc: the #CongDocument for which the find dialog is to be run
  *
  * Opens the Find dialog for this #CongDocument
  *
  */
@@ -66,26 +65,44 @@
 			  "destroy",
 			  G_CALLBACK (on_find_dialog_destroy),
 			  dialog_details);
 }
 
+/**
+ * cong_document_find_next:
+ * @doc:
+ *
+ * This function is not currently implemented
+ */
 void
 cong_document_find_next (CongDocument *doc)
 {
 	g_return_if_fail (IS_CONG_DOCUMENT (doc));
 
 	CONG_DO_UNIMPLEMENTED_DIALOG (NULL, "Find Next");
 }
 
+/**
+ * cong_document_find_prev:
+ * @doc:
+ *
+ * This function is not currently implemented
+ */
 void
 cong_document_find_prev (CongDocument *doc)
 {
 	g_return_if_fail (IS_CONG_DOCUMENT (doc));
 
 	CONG_DO_UNIMPLEMENTED_DIALOG (NULL, "Find Previous");
 }
 
+/**
+ * cong_document_replace:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_replace (CongDocument *doc)
 {
 	GladeXML *xml;
 	GtkDialog *dialog;
@@ -109,10 +126,18 @@
 	gboolean match_case;
 
 	/* might add a filter like Only Text Nodes vs Only Comments vs Both */
 };
 
+/**
+ * cong_util_strstr_with_case:
+ * @haystack:
+ * @needle:
+ * @match_case:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_util_strstr_with_case (const gchar *haystack,
 			    const gchar *needle,
 			    gboolean match_case)
 {
Index: cong-edit-preferences.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-edit-preferences.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-edit-preferences.c
--- cong-edit-preferences.c	5 Mar 2004 14:27:56 -0000	1.3
+++ cong-edit-preferences.c	17 Apr 2004 17:45:23 -0000
@@ -41,16 +41,15 @@
 static gboolean
 on_preferences_dialog_destroy (GtkWidget *widget,
 			       CongPreferencesDialogDetails *dialog_details);
 
 
-
 /**
  * cong_ui_hook_edit_preferences:
+ * @toplevel_window:
  *
  * Opens the Preferences dialog for Conglomerate
- *
  */
 void
 cong_ui_hook_edit_preferences (GtkWindow *toplevel_window)
 {
 	GtkDialog *dialog;
Index: cong-editor-area-bin.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-bin.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-editor-area-bin.c
--- cong-editor-area-bin.c	27 Aug 2003 18:07:12 -0000	1.9
+++ cong-editor-area-bin.c	17 Apr 2004 17:45:23 -0000
@@ -84,20 +84,33 @@
 {
 	area_bin->private = g_new0(CongEditorAreaBinDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_bin_construct:
+ * @area_bin:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_bin_construct (CongEditorAreaBin *area_bin,
 				CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_container_construct (CONG_EDITOR_AREA_CONTAINER(area_bin),
 					      editor_widget);
 
 	return CONG_EDITOR_AREA (area_bin);
 }
 
+/**
+ * cong_editor_area_bin_new:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_bin_new (CongEditorWidget3 *editor_widget)
 {
 #if DEBUG_EDITOR_AREA_LIFETIMES
 	g_message("cong_editor_area_bin_new");
@@ -106,10 +119,16 @@
 	return cong_editor_area_bin_construct
 		(g_object_new (CONG_EDITOR_AREA_BIN_TYPE, NULL),
 		 editor_widget);
 }
 
+/**
+ * cong_editor_area_bin_get_child:
+ * @area_bin:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_bin_get_child  (CongEditorAreaBin *area_bin)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA_BIN(area_bin), NULL);
 
Index: cong-editor-area-border.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-border.c,v
retrieving revision 1.5
diff -u -5 -r1.5 cong-editor-area-border.c
--- cong-editor-area-border.c	8 Aug 2003 17:16:48 -0000	1.5
+++ cong-editor-area-border.c	17 Apr 2004 17:45:23 -0000
@@ -65,10 +65,21 @@
 {
 	area_border->private = g_new0(CongEditorAreaBorderDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_border_construct:
+ * @area_border:
+ * @editor_widget:
+ * @left_pixels:
+ * @right_pixels:
+ * @top_pixels:
+ * @bottom_pixels:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_border_construct (CongEditorAreaBorder *area_border,
 				   CongEditorWidget3 *editor_widget,
 				   guint left_pixels,
 				   guint right_pixels,
@@ -84,10 +95,20 @@
 	PRIVATE(area_border)->bottom_pixels = bottom_pixels;
 	
 	return CONG_EDITOR_AREA (area_border);
 }
 
+/**
+ * cong_editor_area_border_new:
+ * @editor_widget:
+ * @left_pixels:
+ * @right_pixels:
+ * @top_pixels:
+ * @bottom_pixels:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_border_new (CongEditorWidget3 *editor_widget,
 			     guint left_pixels,
 			     guint right_pixels,
 			     guint top_pixels,
Index: cong-editor-area-composer.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-composer.c,v
retrieving revision 1.12
diff -u -5 -r1.12 cong-editor-area-composer.c
--- cong-editor-area-composer.c	4 Feb 2004 16:24:21 -0000	1.12
+++ cong-editor-area-composer.c	17 Apr 2004 17:45:23 -0000
@@ -106,10 +106,19 @@
 {
 	area_composer->private = g_new0(CongEditorAreaComposerDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_composer_construct:
+ * @area_composer:
+ * @editor_widget:
+ * @orientation:
+ * @spacing:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_composer_construct (CongEditorAreaComposer *area_composer,
 				     CongEditorWidget3 *editor_widget,
 				     GtkOrientation orientation,
 				     guint spacing)
@@ -121,10 +130,18 @@
 	PRIVATE(area_composer)->spacing = spacing;
 
 	return CONG_EDITOR_AREA (area_composer);
 }
 
+/**
+ * cong_editor_area_composer_new:
+ * @editor_widget:
+ * @orientation:
+ * @spacing:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_composer_new (CongEditorWidget3 *editor_widget,
 			       GtkOrientation orientation,
 			       guint spacing)
 {
@@ -137,10 +154,20 @@
 		 editor_widget,
 		 orientation,
 		 spacing);
 }
 
+/**
+ * cong_editor_area_composer_pack_start:
+ * @area_composer:
+ * @child:
+ * @expand:
+ * @fill:
+ * @extra_padding:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_composer_pack_start (CongEditorAreaComposer *area_composer,
 				      CongEditorArea *child,
 				      gboolean expand,
 				      gboolean fill,
@@ -170,10 +197,20 @@
 					       CONG_EDITOR_AREA(area_composer));
 
 	cong_editor_area_container_children_changed ( CONG_EDITOR_AREA_CONTAINER(area_composer));
 }
 
+/**
+ * cong_editor_area_composer_pack_end:
+ * @area_composer:
+ * @child:
+ * @expand:
+ * @fill:
+ * @extra_padding:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_composer_pack_end (CongEditorAreaComposer *area_composer,
 				    CongEditorArea *child,
 				    gboolean expand,
 				    gboolean fill,
@@ -223,10 +260,21 @@
 
 	return (a_details->child) - (b_details->child);
 }
 #endif
 
+/**
+ * cong_editor_area_composer_pack_after:
+ * @area_composer:
+ * @new_child:
+ * @ooh_relative_to:
+ * @expand:
+ * @fill:
+ * @extra_padding:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_composer_pack_after (CongEditorAreaComposer *area_composer,
 				      CongEditorArea *new_child,
 				      CongEditorArea *ooh_relative_to,
 				      gboolean expand,
@@ -272,10 +320,20 @@
 					       CONG_EDITOR_AREA(area_composer));
 
 	cong_editor_area_container_children_changed ( CONG_EDITOR_AREA_CONTAINER(area_composer));
 }
 
+/**
+ * cong_editor_area_composer_set_child_packing:
+ * @area_composer:
+ * @child:
+ * @expand:
+ * @fill:
+ * @extra_padding:
+ *
+ * TODO: Write me
+ */
 void 
 cong_editor_area_composer_set_child_packing (CongEditorAreaComposer *area_composer,
 					     CongEditorArea *child,
 					     gboolean expand,
 					     gboolean fill,
Index: cong-editor-area-container.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-container.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-editor-area-container.c
--- cong-editor-area-container.c	4 Feb 2004 16:24:21 -0000	1.7
+++ cong-editor-area-container.c	17 Apr 2004 17:45:23 -0000
@@ -107,20 +107,34 @@
 {
 	area_container->private = g_new0(CongEditorAreaContainerDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_container_construct:
+ * @area_container:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_container_construct (CongEditorAreaContainer *area_container,
 				      CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_construct (CONG_EDITOR_AREA(area_container),
 				    editor_widget);
 
 	return CONG_EDITOR_AREA (area_container);
 }
 
+/**
+ * cong_editor_area_container_add_child:
+ * @area_container:
+ * @child:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_container_add_child ( CongEditorAreaContainer *area_container,
 				       CongEditorArea *child)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA(area_container));
@@ -136,10 +150,18 @@
 			      (area_container, child));
 
 	cong_editor_area_container_children_changed ( area_container);
 }
 
+/**
+ * cong_editor_area_container_add_child_after:
+ * @area_container:
+ * @new_child:
+ * @relative_to:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_container_add_child_after ( CongEditorAreaContainer *area_container,
 					     CongEditorArea *new_child,
 					     CongEditorArea *relative_to)
 {
@@ -157,10 +179,17 @@
 			      (area_container, new_child, relative_to));
 
 	cong_editor_area_container_children_changed ( area_container);
 }
 
+/**
+ * cong_editor_area_container_remove_child:
+ * @area_container:
+ * @child:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_container_remove_child ( CongEditorAreaContainer *area_container,
 					  CongEditorArea *child)
 {
 	g_return_if_fail (area_container);
@@ -182,10 +211,16 @@
 			      (area_container, child));
 
 	cong_editor_area_container_children_changed ( area_container );
 }
 
+/**
+ * cong_editor_area_remove_all_children:
+ * @area_container:
+ *
+ * TODO: Write me
+ */
 void 
 cong_editor_area_remove_all_children ( CongEditorAreaContainer *area_container)
 {
 	g_return_if_fail (area_container);
 
@@ -195,10 +230,16 @@
 			      (area_container));
 
 	cong_editor_area_container_children_changed ( area_container );
 }
 
+/**
+ * cong_editor_area_container_children_changed:
+ * @area_container:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_container_children_changed ( CongEditorAreaContainer *area_container)
 {
 	g_signal_emit (G_OBJECT(area_container),
 		       signals[CHILDREN_CHANGED], 0);
@@ -206,10 +247,17 @@
 	cong_editor_area_flush_requisition_cache (CONG_EDITOR_AREA(area_container), GTK_ORIENTATION_HORIZONTAL);
 	cong_editor_area_flush_requisition_cache (CONG_EDITOR_AREA(area_container), GTK_ORIENTATION_VERTICAL);
 }
 
 /* Protected:  For implementing subclasses */
+/**
+ * cong_editor_area_container_protected_postprocess_add_non_internal_child:
+ * @area_container:
+ * @child:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_container_protected_postprocess_add_non_internal_child (CongEditorAreaContainer *area_container,
 									 CongEditorArea *child)
 {
 	g_return_if_fail ( IS_CONG_EDITOR_AREA_CONTAINER(area_container));
Index: cong-editor-area-entity-decl.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-entity-decl.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-area-entity-decl.c
--- cong-editor-area-entity-decl.c	19 Dec 2003 18:48:17 -0000	1.4
+++ cong-editor-area-entity-decl.c	17 Apr 2004 17:45:23 -0000
@@ -95,10 +95,18 @@
 	area_entity_decl->private = g_new0(CongEditorAreaEntityDeclDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_entity_decl_construct:
+ * @area_entity_decl:
+ * @editor_widget:
+ * @text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_entity_decl_construct (CongEditorAreaEntityDecl *area_entity_decl,
 					   CongEditorWidget3 *editor_widget,
 					   const gchar *text)
 {
@@ -146,10 +154,17 @@
 					       CONG_EDITOR_AREA (area_entity_decl));
 
 	return CONG_EDITOR_AREA (area_entity_decl);
 }
 
+/**
+ * cong_editor_area_entity_decl_new:
+ * @editor_widget:
+ * @text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_entity_decl_new (CongEditorWidget3 *editor_widget,
 				  const gchar *text)
 
 {
Index: cong-editor-area-entity-ref.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-entity-ref.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-area-entity-ref.c
--- cong-editor-area-entity-ref.c	19 Dec 2003 18:48:17 -0000	1.4
+++ cong-editor-area-entity-ref.c	17 Apr 2004 17:45:23 -0000
@@ -95,10 +95,18 @@
 	area_entity_ref->private = g_new0(CongEditorAreaEntityRefDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_entity_ref_construct:
+ * @area_entity_ref:
+ * @editor_widget:
+ * @text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_entity_ref_construct (CongEditorAreaEntityRef *area_entity_ref,
 				       CongEditorWidget3 *editor_widget,
 				       const gchar *text)
 {
@@ -146,10 +154,17 @@
 					       CONG_EDITOR_AREA (area_entity_ref));
 
 	return CONG_EDITOR_AREA (area_entity_ref);
 }
 
+/**
+ * cong_editor_area_entity_ref_new:
+ * @editor_widget:
+ * @text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_entity_ref_new (CongEditorWidget3 *editor_widget,
 				  const gchar *text)
 
 {
Index: cong-editor-area-expander.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-expander.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-area-expander.c
--- cong-editor-area-expander.c	4 Feb 2004 16:24:21 -0000	1.4
+++ cong-editor-area-expander.c	17 Apr 2004 17:45:23 -0000
@@ -108,11 +108,16 @@
 							  editor_area);
 
 	return TRUE;
 }
 
-
+/**
+ * cong_editor_area_connect_motion_notify_prelight:
+ * @area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_connect_motion_notify_prelight (CongEditorArea *area)
 {
 	g_signal_connect (G_OBJECT(area),
 			  "motion_notify_event",
@@ -120,10 +125,18 @@
 			  NULL);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_expander_construct:
+ * @area_expander:
+ * @editor_widget:
+ * @expanded:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_expander_construct (CongEditorAreaExpander *area_expander,
 				     CongEditorWidget3 *editor_widget,
 				     gboolean expanded)
 {
@@ -142,20 +155,33 @@
 	cong_editor_area_connect_motion_notify_prelight (CONG_EDITOR_AREA(area_expander));
 
 	return CONG_EDITOR_AREA (area_expander);
 }
 
+/**
+ * cong_editor_area_expander_new:
+ * @editor_widget:
+ * @expanded:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_expander_new (CongEditorWidget3 *editor_widget,
 			       gboolean expanded)
 {
 	return cong_editor_area_expander_construct
 		(g_object_new (CONG_EDITOR_AREA_EXPANDER_TYPE, NULL),
 		 editor_widget,
 		 expanded);
 }
 
+/**
+ * cong_editor_area_expander_get_state:
+ * @area_expander:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_expander_get_state (CongEditorAreaExpander *area_expander)
 {
 	return PRIVATE (area_expander)->target_state;
 }
@@ -232,10 +258,16 @@
 	} else {
 		return FALSE;
 	}
 }
 
+/**
+ * on_timeout:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 gint
 on_timeout (gpointer user_data)
 {
 	CongEditorAreaExpander *area_expander = CONG_EDITOR_AREA_EXPANDER (user_data);
 
Index: cong-editor-area-flow-holder-blocks.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-flow-holder-blocks.c,v
retrieving revision 1.14
diff -u -5 -r1.14 cong-editor-area-flow-holder-blocks.c
--- cong-editor-area-flow-holder-blocks.c	4 Feb 2004 16:24:21 -0000	1.14
+++ cong-editor-area-flow-holder-blocks.c	17 Apr 2004 17:45:23 -0000
@@ -91,10 +91,17 @@
 {
 	area_flow_holder_blocks->private = g_new0(CongEditorAreaFlowHolderBlocksDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_flow_holder_blocks_construct:
+ * @area_flow_holder_blocks:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_blocks_construct (CongEditorAreaFlowHolderBlocks *area_flow_holder_blocks,
 					CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_flow_holder_construct (CONG_EDITOR_AREA_FLOW_HOLDER(area_flow_holder_blocks),
@@ -113,10 +120,16 @@
 					       CONG_EDITOR_AREA (area_flow_holder_blocks));
 
 	return CONG_EDITOR_AREA (area_flow_holder_blocks);
 }
 
+/**
+ * cong_editor_area_flow_holder_blocks_new:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_blocks_new (CongEditorWidget3 *editor_widget)
 {
 #if DEBUG_EDITOR_AREA_LIFETIMES
 	g_message("cong_editor_area_flow_holder_blocks_new");
@@ -125,10 +138,17 @@
 	return cong_editor_area_flow_holder_blocks_construct
 		(g_object_new (CONG_EDITOR_AREA_FLOW_HOLDER_BLOCKS_TYPE, NULL),
 		 editor_widget);
 }
 
+/**
+ * cong_editor_area_flow_holder_get_child_flow_holder_for_node:
+ * @area_flow_holder_blocks:
+ * @doc_node:
+ *
+ * TODO: Write me
+ */
 CongEditorAreaFlowHolder*
 cong_editor_area_flow_holder_get_child_flow_holder_for_node (CongEditorAreaFlowHolderBlocks *area_flow_holder_blocks,
 							     CongNodePtr doc_node)
 {
 	g_return_val_if_fail (area_flow_holder_blocks, NULL);
Index: cong-editor-area-flow-holder-inlines.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-flow-holder-inlines.c,v
retrieving revision 1.13
diff -u -5 -r1.13 cong-editor-area-flow-holder-inlines.c
--- cong-editor-area-flow-holder-inlines.c	19 Dec 2003 18:48:17 -0000	1.13
+++ cong-editor-area-flow-holder-inlines.c	17 Apr 2004 17:45:23 -0000
@@ -115,10 +115,17 @@
 {
 	area_flow_holder_inlines->private = g_new0(CongEditorAreaFlowHolderInlinesDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_flow_holder_inlines_construct:
+ * @area_flow_holder_inlines:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_inlines_construct (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines,
 					CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_flow_holder_construct (CONG_EDITOR_AREA_FLOW_HOLDER(area_flow_holder_inlines),
@@ -140,10 +147,16 @@
 					       CONG_EDITOR_AREA (area_flow_holder_inlines));
 
 	return CONG_EDITOR_AREA (area_flow_holder_inlines);
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_new:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_inlines_new (CongEditorWidget3 *editor_widget)
 {
 #if DEBUG_EDITOR_AREA_LIFETIMES
 	g_message("cong_editor_area_flow_holder_inlines_new");
@@ -152,22 +165,40 @@
 	return cong_editor_area_flow_holder_inlines_construct
 		(g_object_new (CONG_EDITOR_AREA_FLOW_HOLDER_INLINES_TYPE, NULL),
 		 editor_widget);
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_get_current_line:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 CongEditorAreaLine*
 cong_editor_area_flow_holder_inlines_get_current_line (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	return PRIVATE(area_flow_holder_inlines)->last_line;
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_get_line_width:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_flow_holder_inlines_get_line_width (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	return PRIVATE(area_flow_holder_inlines)->last_width;
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_get_current_indent:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_flow_holder_inlines_get_current_indent (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	CongEditorAreaLine* line = cong_editor_area_flow_holder_inlines_get_current_line (area_flow_holder_inlines);
 
@@ -176,20 +207,32 @@
 	} else {
 		return 0;
 	}
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_destroy_lines:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_flow_holder_inlines_destroy_lines (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA_FLOW_HOLDER_INLINES(area_flow_holder_inlines));
 
 	cong_editor_area_remove_all_children ( CONG_EDITOR_AREA_CONTAINER(PRIVATE(area_flow_holder_inlines)->line_composer));
 	PRIVATE(area_flow_holder_inlines)->last_line = NULL;
 }
 
 
+/**
+ * cong_editor_area_flow_holder_inlines_insert_line:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 CongEditorAreaLine*
 cong_editor_area_flow_holder_inlines_insert_line (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	CongEditorAreaLine* new_line = CONG_EDITOR_AREA_LINE( cong_editor_area_line_new (cong_editor_area_get_widget (CONG_EDITOR_AREA(area_flow_holder_inlines)),
 											 PRIVATE(area_flow_holder_inlines)->last_width)
@@ -205,10 +248,16 @@
 	PRIVATE(area_flow_holder_inlines)->last_line = new_line;
 
 	return new_line;
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_reflow_required:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_flow_holder_inlines_reflow_required (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	CongDocument *doc ;
 #if 1
@@ -249,10 +298,16 @@
 		}
 	}
 #endif
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_get_first_node:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_area_flow_holder_inlines_get_first_node (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	GList *iter = g_list_first(PRIVATE(area_flow_holder_inlines)->list_of_editor_nodes);
 
@@ -261,10 +316,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_editor_area_flow_holder_inlines_get_final_node:
+ * @area_flow_holder_inlines:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_area_flow_holder_inlines_get_final_node (CongEditorAreaFlowHolderInlines *area_flow_holder_inlines)
 {
 	GList *iter = g_list_last(PRIVATE(area_flow_holder_inlines)->list_of_editor_nodes);
 
Index: cong-editor-area-flow-holder-single.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-flow-holder-single.c,v
retrieving revision 1.5
diff -u -5 -r1.5 cong-editor-area-flow-holder-single.c
--- cong-editor-area-flow-holder-single.c	4 Feb 2004 16:24:21 -0000	1.5
+++ cong-editor-area-flow-holder-single.c	17 Apr 2004 17:45:23 -0000
@@ -90,10 +90,17 @@
 {
 	area_flow_holder_single->private = g_new0(CongEditorAreaFlowHolderSingleDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_flow_holder_single_construct:
+ * @area_flow_holder_single:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_single_construct (CongEditorAreaFlowHolderSingle *area_flow_holder_single,
 					CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_flow_holder_construct (CONG_EDITOR_AREA_FLOW_HOLDER(area_flow_holder_single),
@@ -108,10 +115,16 @@
 					       CONG_EDITOR_AREA (area_flow_holder_single));
 
 	return CONG_EDITOR_AREA (area_flow_holder_single);
 }
 
+/**
+ * cong_editor_area_flow_holder_single_new:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_single_new (CongEditorWidget3 *editor_widget)
 {
 #if DEBUG_EDITOR_AREA_LIFETIMES
 	g_message("cong_editor_area_flow_holder_single_new");
@@ -209,10 +222,17 @@
 
 	PRIVATE(area_flow_holder_single)->single_editor_node = NULL;
 	PRIVATE(area_flow_holder_single)->single_editor_area = NULL;
 }
 
+/**
+ * cong_editor_widget_create_child_policy_for_node_with_single_area:
+ * @editor_node:
+ * @editor_area:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_widget_create_child_policy_for_node_with_single_area(CongEditorNode *editor_node,
 								 CongEditorArea *editor_area)
 {
 	if (IS_CONG_EDITOR_AREA_CONTAINER(editor_area) ) {
Index: cong-editor-area-flow-holder.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-flow-holder.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-area-flow-holder.c
--- cong-editor-area-flow-holder.c	4 Feb 2004 16:24:21 -0000	1.4
+++ cong-editor-area-flow-holder.c	17 Apr 2004 17:45:23 -0000
@@ -70,20 +70,34 @@
 {
 	area_flow_holder->private = g_new0(CongEditorAreaFlowHolderDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_flow_holder_construct:
+ * @area_flow_holder:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_flow_holder_construct (CongEditorAreaFlowHolder *area_flow_holder,
 					CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_construct (CONG_EDITOR_AREA(area_flow_holder),
 				    editor_widget);
 
 	return CONG_EDITOR_AREA (area_flow_holder);
 }
 
+/**
+ * cong_editor_area_flow_holder_insert_areas_for_node:
+ * @area_flow_holder:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_area_flow_holder_insert_areas_for_node (CongEditorAreaFlowHolder *area_flow_holder,
 						    CongEditorNode *editor_node)
 {
 	return CONG_EEL_CALL_METHOD_WITH_RETURN_VALUE (CONG_EDITOR_AREA_FLOW_HOLDER_CLASS,
@@ -91,20 +105,34 @@
 						       insert_areas_for_node, 
 						       (area_flow_holder, editor_node));
 
 }
 
+/**
+ * cong_editor_area_flow_holder_remove_areas_for_node:
+ * @area_flow_holder:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_flow_holder_remove_areas_for_node (CongEditorAreaFlowHolder *area_flow_holder,
 						    CongEditorNode *editor_node)
 {
 	CONG_EEL_CALL_METHOD (CONG_EDITOR_AREA_FLOW_HOLDER_CLASS,
 			      area_flow_holder,
 			      remove_areas_for_node, 
 			      (area_flow_holder, editor_node));
 }
 
+/**
+ * cong_editor_area_flow_holder_manufacture:
+ * @area_flow_holder:
+ * @flow_type:
+ *
+ * TODO: Write me
+ */
 CongEditorAreaFlowHolder*
 cong_editor_area_flow_holder_manufacture (CongEditorWidget3 *editor_widget,
 					  enum CongFlowType flow_type)
 {
 	switch (flow_type) {
Index: cong-editor-area-labelled.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-labelled.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-area-labelled.c
--- cong-editor-area-labelled.c	19 Dec 2003 18:48:17 -0000	1.4
+++ cong-editor-area-labelled.c	17 Apr 2004 17:45:23 -0000
@@ -90,10 +90,18 @@
 	area_labelled->private = g_new0(CongEditorAreaLabelledDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_labelled_construct:
+ * @area_labelled:
+ * @editor_widget:
+ * @label:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_labelled_construct (CongEditorAreaLabelled *area_labelled,
 				     CongEditorWidget3 *editor_widget,
 				     CongEditorArea *label)
 {
@@ -128,10 +136,17 @@
 					       CONG_EDITOR_AREA (area_labelled));
 
 	return CONG_EDITOR_AREA (area_labelled);
 }
 
+/**
+ * cong_editor_area_labelled_new:
+ * @editor_widget:
+ * @label:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_labelled_new (CongEditorWidget3 *editor_widget,
 			       CongEditorArea *label)
 
 {
@@ -143,10 +158,17 @@
 		(g_object_new (CONG_EDITOR_AREA_LABELLED_TYPE, NULL),
 		 editor_widget,
 		 label);
 }
 
+/**
+ * cong_editor_area_labelled_set_label:
+ * @area_labelled:
+ * @label:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_labelled_set_label (CongEditorAreaLabelled *area_labelled,
 				     CongEditorArea *label)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA_LABELLED (area_labelled));
Index: cong-editor-area-line.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-line.c,v
retrieving revision 1.6
diff -u -5 -r1.6 cong-editor-area-line.c
--- cong-editor-area-line.c	19 Dec 2003 18:48:17 -0000	1.6
+++ cong-editor-area-line.c	17 Apr 2004 17:45:23 -0000
@@ -86,10 +86,18 @@
 {
 	line->private = g_new0(CongEditorAreaLineDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_line_construct:
+ * @line:
+ * @editor_widget:
+ * @width_limit:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_line_construct (CongEditorAreaLine *line,
 				 CongEditorWidget3 *editor_widget,
 				 gint width_limit)
 {
@@ -107,11 +115,17 @@
 	cong_editor_area_protected_set_parent (CONG_EDITOR_AREA (PRIVATE(line)->outer_compose),
 					       CONG_EDITOR_AREA (line));
 
 	return CONG_EDITOR_AREA (line);
 }
-
+/**
+ * cong_editor_area_line_new:
+ * @editor_widget:
+ * @width_limit:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_line_new (CongEditorWidget3 *editor_widget,
 			   gint width_limit)
 
 {
@@ -123,28 +137,46 @@
 		(g_object_new (CONG_EDITOR_AREA_LINE_TYPE, NULL),
 		 editor_widget,
 		 width_limit);
 }
 
+/**
+ * cong_editor_area_line_get_width_limit:
+ * @area_line:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_line_get_width_limit (CongEditorAreaLine *area_line)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA_LINE (area_line), 0);
 
 	return PRIVATE(area_line)->width_limit;
 }
 
+/**
+ * cong_editor_area_line_get_width_used:
+ * @area_line:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_line_get_width_used (CongEditorAreaLine *area_line)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA_LINE (area_line), 0);
 
 	/* Get the delegated requisition: */
 	return  cong_editor_area_get_requisition_width (CONG_EDITOR_AREA(PRIVATE(area_line)->outer_compose),
 							PRIVATE(area_line)->width_limit);
 }
 
+/**
+ * cong_editor_area_line_get_width_free:
+ * @area_line:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_line_get_width_free (CongEditorAreaLine *area_line)
 {
 	gint width_limit;
 	gint width_used;
Index: cong-editor-area-pixbuf.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-pixbuf.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-editor-area-pixbuf.c
--- cong-editor-area-pixbuf.c	22 Oct 2003 09:55:09 -0000	1.7
+++ cong-editor-area-pixbuf.c	17 Apr 2004 17:45:23 -0000
@@ -74,10 +74,18 @@
 {
 	area_pixbuf->private = g_new0(CongEditorAreaPixbufDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_pixbuf_construct:
+ * @area_pixbuf:
+ * @editor_widget:
+ * @pixbuf:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_pixbuf_construct (CongEditorAreaPixbuf *area_pixbuf,
 				   CongEditorWidget3 *editor_widget,
 				   GdkPixbuf *pixbuf)
 {
@@ -93,10 +101,17 @@
 	PRIVATE(area_pixbuf)->pixbuf_size[GTK_ORIENTATION_VERTICAL] = gdk_pixbuf_get_height(pixbuf);
 
 	return CONG_EDITOR_AREA (area_pixbuf);
 }
 
+/**
+ * cong_editor_area_pixbuf_new:
+ * @editor_widget:
+ * @pixbuf:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_pixbuf_new (CongEditorWidget3 *editor_widget,
 			     GdkPixbuf *pixbuf)
 {
 	return cong_editor_area_pixbuf_construct
@@ -138,10 +153,16 @@
 	CongEditorAreaPixbuf *area_pixbuf = CONG_EDITOR_AREA_PIXBUF(area);
 
 	return PRIVATE(area_pixbuf)->pixbuf_size[orientation];
 }
 
+/**
+ * get_pixbuf:
+ * @area_pixbuf:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf*
 get_pixbuf (CongEditorAreaPixbuf *area_pixbuf)
 {
 	GtkStateType state = cong_editor_area_get_state (CONG_EDITOR_AREA (area_pixbuf));
 
@@ -152,10 +173,17 @@
 	}
 
 	return PRIVATE(area_pixbuf)->pixbuf_states[state];
 }
 
+/**
+ * generate_pixbuf_for_state:
+ * @normal_pixbuf:
+ * @state:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf*
 generate_pixbuf_for_state (GdkPixbuf *normal_pixbuf,
 			   GtkStateType state)
 {
 	g_return_val_if_fail (normal_pixbuf, NULL);
Index: cong-editor-area-spacer.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-spacer.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-area-spacer.c
--- cong-editor-area-spacer.c	27 Jul 2003 21:52:04 -0000	1.4
+++ cong-editor-area-spacer.c	17 Apr 2004 17:45:23 -0000
@@ -75,10 +75,18 @@
 	PRIVATE(area_spacer)->spacing = spacing;
 
 	return CONG_EDITOR_AREA (area_spacer);
 }
 
+/**
+ * cong_editor_area_spacer_new:
+ * @editor_widget:
+ * @orientation:
+ * @spacing:
+ *
+ * Returns: the new #CongEditorArea
+ */
 CongEditorArea*
 cong_editor_area_spacer_new (CongEditorWidget3 *editor_widget,
 			     GtkOrientation orientation,
 			     guint spacing)
 {
@@ -92,10 +100,18 @@
 		 orientation,
 		 spacing);
 }
 
 /* Method implementation definitions: */
+/**
+ * calc_requisition:
+ * @area:
+ * @orientation:
+ * @width_hint:
+ *
+ * TODO: Write me
+ */
 static gint
 calc_requisition (CongEditorArea *area, 
 		  GtkOrientation orientation,
 		  int width_hint)
 {
Index: cong-editor-area-span-tag.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-span-tag.c,v
retrieving revision 1.16
diff -u -5 -r1.16 cong-editor-area-span-tag.c
--- cong-editor-area-span-tag.c	4 Feb 2004 16:24:21 -0000	1.16
+++ cong-editor-area-span-tag.c	17 Apr 2004 17:45:23 -0000
@@ -103,10 +103,22 @@
 	area_span_tag->private = g_new0(CongEditorAreaSpanTagDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_span_tag_construct:
+ * @area_span_tag:
+ * @editor_widget:
+ * @ds_element:
+ * @pixbuf:
+ * @text:
+ * @is_at_start:
+ * @is_at_end:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_span_tag_construct (CongEditorAreaSpanTag *area_span_tag,
 				     CongEditorWidget3 *editor_widget,
 				     CongDispspecElement *ds_element,
 				     GdkPixbuf *pixbuf,
@@ -153,10 +165,21 @@
 
 
 	return CONG_EDITOR_AREA (area_span_tag);
 }
 
+/**
+ * cong_editor_area_span_tag_new:
+ * @editor_widget:
+ * @ds_element:
+ * @pixbuf:
+ * @text:
+ * @is_at_start:
+ * @is_at_end:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_span_tag_new (CongEditorWidget3 *editor_widget,
 			       CongDispspecElement *ds_element,
 			       GdkPixbuf *pixbuf,
 			       const gchar *text,
Index: cong-editor-area-structural-tag.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-structural-tag.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-editor-area-structural-tag.c
--- cong-editor-area-structural-tag.c	4 Feb 2004 16:24:21 -0000	1.11
+++ cong-editor-area-structural-tag.c	17 Apr 2004 17:45:23 -0000
@@ -119,10 +119,20 @@
 	area_structural_tag->private = g_new0(CongEditorAreaStructuralTagDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_structural_tag_construct:
+ * @area_structural_tag:
+ * @editor_widget:
+ * @ds_element:
+ * @pixbuf:
+ * @text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_structural_tag_construct (CongEditorAreaStructuralTag *area_structural_tag,
 					   CongEditorWidget3 *editor_widget,
 					   CongDispspecElement *ds_element,
 					   GdkPixbuf *pixbuf,
@@ -143,16 +153,24 @@
 	PRIVATE(area_structural_tag)->ds_element = ds_element;
 
 	return CONG_EDITOR_AREA (area_structural_tag);
 }
 
+/**
+ * cong_editor_area_structural_tag_new:
+ * @editor_widget:
+ * @ds_element:
+ * @pixbuf:
+ * @text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_structural_tag_new (CongEditorWidget3 *editor_widget,
 				     CongDispspecElement *ds_element,
 				     GdkPixbuf *pixbuf,
 				     const gchar *text)
-
 {
 #if DEBUG_EDITOR_AREA_LIFETIMES
 	g_message("cong_editor_area_structural_tag_new(%s)", text);
 #endif
 
Index: cong-editor-area-structural.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-structural.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-editor-area-structural.c
--- cong-editor-area-structural.c	19 Dec 2003 18:48:17 -0000	1.7
+++ cong-editor-area-structural.c	17 Apr 2004 17:45:23 -0000
@@ -116,10 +116,23 @@
 	area_structural->private = g_new0(CongEditorAreaStructuralDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_structural_construct:
+ * @area_structural:
+ * @editor_widget:
+ * @pixbuf:
+ * @text:
+ * @col_bold:
+ * @col_dim:
+ * @col_background:
+ * @col_text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_structural_construct (CongEditorAreaStructural *area_structural,
 				       CongEditorWidget3 *editor_widget,
 				       GdkPixbuf *pixbuf,
 				       const gchar *text,
@@ -251,10 +264,22 @@
 
 
 	return CONG_EDITOR_AREA (area_structural);
 }
 
+/**
+ * cong_editor_area_structural_new:
+ * @editor_widget:
+ * @pixbuf:
+ * @text:
+ * @col_bold:
+ * @col_dim:
+ * @col_background:
+ * @col_text:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_structural_new (CongEditorWidget3 *editor_widget,
 				 GdkPixbuf *pixbuf,
 				 const gchar *text,
 				 const GdkColor *col_bold,
Index: cong-editor-area-text-comment.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-text-comment.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-editor-area-text-comment.c
--- cong-editor-area-text-comment.c	11 Feb 2004 15:54:23 -0000	1.3
+++ cong-editor-area-text-comment.c	17 Apr 2004 17:45:23 -0000
@@ -84,10 +84,21 @@
 {
 	area_text_comment->private = g_new0(CongEditorAreaTextCommentDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_text_comment_construct:
+ * @area_text_comment:
+ * @editor_widget:
+ * @font:
+ * @fg_col:
+ * @text_comment:
+ * @use_markup:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_text_comment_construct (CongEditorAreaTextComment *area_text_comment,
 					 CongEditorWidget3 *editor_widget,
 					 CongFont *font,
 					 const GdkColor *fg_col,
@@ -118,10 +129,20 @@
 			       &color);
 
 	return CONG_EDITOR_AREA (area_text_comment);
 }
 
+/**
+ * cong_editor_area_text_comment_new:
+ * @editor_widget:
+ * @font:
+ * @fg_col:
+ * @text_comment:
+ * @use_markup:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_text_comment_new (CongEditorWidget3 *editor_widget,
 			   CongFont *font,
 			   const GdkColor *fg_col,
 			   const gchar *text_comment,
Index: cong-editor-area-text-fragment.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-text-fragment.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-editor-area-text-fragment.c
--- cong-editor-area-text-fragment.c	22 Oct 2003 11:40:26 -0000	1.9
+++ cong-editor-area-text-fragment.c	17 Apr 2004 17:45:23 -0000
@@ -80,10 +80,21 @@
 {
 	area_text_fragment->private = g_new0(CongEditorAreaTextFragmentDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_text_fragment_construct:
+ * @area_text_fragment:
+ * @editor_widget:
+ * @editor_node_text:
+ * @pango_layout:
+ * @line_index:
+ * @baseline:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_text_fragment_construct (CongEditorAreaTextFragment *area_text_fragment,
 					  CongEditorWidget3 *editor_widget,
 					  CongEditorNodeText *editor_node_text,
 					  PangoLayout *pango_layout,
@@ -107,10 +118,20 @@
 	gdk_cursor_unref (cursor);
 
 	return CONG_EDITOR_AREA (area_text_fragment);
 }
 
+/**
+ * cong_editor_area_text_fragment_new:
+ * @editor_widget:
+ * @editor_node_text:
+ * @pango_layout:
+ * @line_index:
+ * @baseline:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_text_fragment_new (CongEditorWidget3 *editor_widget,
 				    CongEditorNodeText *editor_node_text,
 				    PangoLayout *pango_layout,
 				    guint line_index,
@@ -127,10 +148,16 @@
 		 pango_layout,
 		 line_index,
 		 baseline);
 }
 
+/**
+ * cong_editor_area_text_get_pango_layout_line:
+ * @area_text_fragment:
+ *
+ * TODO: Write me
+ */
 PangoLayoutLine*
 cong_editor_area_text_get_pango_layout_line (CongEditorAreaTextFragment *area_text_fragment)
 {
 	PangoLayoutLine* line;
 
@@ -140,19 +167,33 @@
 				      PRIVATE(area_text_fragment)->line_index);
 
 	return line;
 }
 
-
+/**
+ * cong_editor_area_text_fragment_is_final_line:
+ * @area_text_fragment:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_text_fragment_is_final_line (CongEditorAreaTextFragment *area_text_fragment)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA_TEXT_FRAGMENT(area_text_fragment), FALSE);
 	
 	return ((PRIVATE(area_text_fragment)->line_index+1) == pango_layout_get_line_count (PRIVATE(area_text_fragment)->pango_layout));
 }
 
+/**
+ * cong_editor_area_text_fragment_x_to_index:
+ * @area_text_fragment:
+ * @x:
+ * @index_:
+ * @trailing:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_text_fragment_x_to_index (CongEditorAreaTextFragment *area_text_fragment,
 					   int x,
 					   int *index_,
 					   int *trailing)
Index: cong-editor-area-text.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-text.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-editor-area-text.c
--- cong-editor-area-text.c	11 Feb 2004 15:54:23 -0000	1.11
+++ cong-editor-area-text.c	17 Apr 2004 17:45:23 -0000
@@ -74,10 +74,21 @@
 {
 	area_text->private = g_new0(CongEditorAreaTextDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_text_construct:
+ * @area_text:
+ * @editor_widget:
+ * @font:
+ * @fg_col:
+ * @text:
+ * @use_markup:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_text_construct (CongEditorAreaText *area_text,
 				 CongEditorWidget3 *editor_widget,
 				 CongFont *font,
 				 const GdkColor *fg_col,
@@ -119,11 +130,20 @@
 					  cong_font_get_pango_description(PRIVATE(area_text)->font));
 
 
 	return CONG_EDITOR_AREA (area_text);
 }
-
+/**
+ * cong_editor_area_text_new:
+ * @editor_widget:
+ * @font:
+ * @fg_col:
+ * @text:
+ * @use_markup:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_text_new (CongEditorWidget3 *editor_widget,
 			   CongFont *font,
 			   const GdkColor *fg_col,
 			   const gchar *text,
@@ -140,10 +160,17 @@
 		 fg_col,
 		 text,
 		 use_markup);
 }
 
+/**
+ * cong_editor_area_text_set_text:
+ * @area_text:
+ * @text:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_text_set_text (CongEditorAreaText *area_text,
 				const gchar *text)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA_TEXT(area_text));
@@ -156,10 +183,17 @@
 	cong_editor_area_queue_redraw (CONG_EDITOR_AREA(area_text));
 	cong_editor_area_flush_requisition_cache (CONG_EDITOR_AREA(area_text), GTK_ORIENTATION_HORIZONTAL);
 	cong_editor_area_flush_requisition_cache (CONG_EDITOR_AREA(area_text), GTK_ORIENTATION_VERTICAL);
 }
 
+/**
+ * cong_editor_area_text_set_markup:
+ * @area_text:
+ * @markup:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_text_set_markup (CongEditorAreaText *area_text,
 				  const gchar *markup)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA_TEXT(area_text));
@@ -172,20 +206,37 @@
 	cong_editor_area_queue_redraw (CONG_EDITOR_AREA(area_text));
 	cong_editor_area_flush_requisition_cache (CONG_EDITOR_AREA(area_text), GTK_ORIENTATION_HORIZONTAL);
 	cong_editor_area_flush_requisition_cache (CONG_EDITOR_AREA(area_text), GTK_ORIENTATION_VERTICAL);
 }
 
+/**
+ * cong_editor_area_text_get_single_line_requisition:
+ * @area_text:
+ * @orientation:
+ *
+ * TODO: Write me
+ */
 gint 
 cong_editor_area_text_get_single_line_requisition (CongEditorAreaText *area_text,
 						   GtkOrientation orientation)
 {
 	/* Bit hackish: use a REALLY BIG width to try to prevent wrapping: */
 	return cong_editor_area_get_requisition (CONG_EDITOR_AREA(area_text),
 						 orientation,
 						 10000);
 }
 
+/**
+ * cong_editor_area_text_xy_to_index:
+ * @area_text:
+ * @x:
+ * @y:
+ * @index_:
+ * @trailing:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_text_xy_to_index (CongEditorAreaText *area_text,
 				   int x,
 				   int y,
 				   int *index_,
Index: cong-editor-area-underline.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-underline.c,v
retrieving revision 1.5
diff -u -5 -r1.5 cong-editor-area-underline.c
--- cong-editor-area-underline.c	11 Feb 2004 15:54:23 -0000	1.5
+++ cong-editor-area-underline.c	17 Apr 2004 17:45:23 -0000
@@ -67,10 +67,18 @@
 {
 	area_underline->private = g_new0(CongEditorAreaUnderlineDetails,1);
 }
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_underline_construct:
+ * @area_underline:
+ * @editor_widget:
+ * @style:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_underline_construct (CongEditorAreaUnderline *area_underline,
 				      CongEditorWidget3 *editor_widget,
 				      enum CongEditorAreaUnderlineStyle style)
 {
@@ -83,10 +91,17 @@
 	PRIVATE(area_underline)->gc = gdk_gc_new(cong_gui_get_a_window()->window);;
 
 	return CONG_EDITOR_AREA (area_underline);
 }
 
+/**
+ * cong_editor_area_underline_new:
+ * @editor_widget:
+ * @style:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_underline_new (CongEditorWidget3 *editor_widget,
 				enum CongEditorAreaUnderlineStyle style)
 {
 	return cong_editor_area_underline_construct
Index: cong-editor-area-unknown-tag.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area-unknown-tag.c,v
retrieving revision 1.10
diff -u -5 -r1.10 cong-editor-area-unknown-tag.c
--- cong-editor-area-unknown-tag.c	20 Oct 2003 16:09:17 -0000	1.10
+++ cong-editor-area-unknown-tag.c	17 Apr 2004 17:45:23 -0000
@@ -91,10 +91,18 @@
 
 const gchar*
 cong_ui_get_colour_string(enum CongNodeType type);
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_unknown_tag_construct:
+ * @area_unknown_tag:
+ * @editor_widget:
+ * @tagname:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_unknown_tag_construct (CongEditorAreaUnknownTag *area_unknown_tag,
 					CongEditorWidget3 *editor_widget,
 					const gchar *tagname)
 {
@@ -163,10 +171,17 @@
 					       CONG_EDITOR_AREA (area_unknown_tag));
 
 	return CONG_EDITOR_AREA (area_unknown_tag);
 }
 
+/**
+ * cong_editor_area_unknown_tag_new:
+ * @editor_widget:
+ * @tagname:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_unknown_tag_new (CongEditorWidget3 *editor_widget,
 				  const gchar *tagname)
 
 {
Index: cong-editor-area.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-area.c,v
retrieving revision 1.22
diff -u -5 -r1.22 cong-editor-area.c
--- cong-editor-area.c	11 Feb 2004 15:54:23 -0000	1.22
+++ cong-editor-area.c	17 Apr 2004 17:45:24 -0000
@@ -205,10 +205,17 @@
 cong_editor_area_instance_init (CongEditorArea *area)
 {
 	area->private = g_new0(CongEditorAreaDetails,1);
 }
 
+/**
+ * cong_editor_area_construct:
+ * @area:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_construct (CongEditorArea *area,
 			    CongEditorWidget3* editor_widget)
 {
 	PRIVATE(area)->editor_widget = editor_widget;
@@ -228,57 +235,97 @@
 	PRIVATE(area)->needs_recursive_allocation = TRUE;
 
 	return area;
 }
 
-
+/**
+ * cong_editor_area_get_widget:
+ * @area:
+ *
+ * TODO: Write me
+ */
 CongEditorWidget3*
 cong_editor_area_get_widget (CongEditorArea *area)
 {
 	g_return_val_if_fail (area, NULL);
 
 	return PRIVATE(area)->editor_widget;
 }
 
+/**
+ * cong_editor_area_get_document:
+ * @area:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_editor_area_get_document (CongEditorArea *area)
 {
 	g_return_val_if_fail (area, NULL);
 
 	return cong_editor_widget3_get_document (cong_editor_area_get_widget (area));
 }
 
-
+/**
+ * cong_editor_area_is_hidden:
+ * @area:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_editor_area_is_hidden (CongEditorArea *area)
 {
 	return PRIVATE(area)->is_hidden;
 }
 
-
+/**
+ * cong_editor_area_show:
+ * @area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_show (CongEditorArea *area)
 {
 	PRIVATE(area)->is_hidden = FALSE;
 	/* FIXME: do we need to emit any events? */
 }
 
+/**
+ * cong_editor_area_hide:
+ * @area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_hide (CongEditorArea *area)
 {
 	PRIVATE(area)->is_hidden = TRUE;
 	/* FIXME: do we need to emit any events? */
 }
 
+/**
+ * cong_editor_area_get_state:
+ * @area:
+ *
+ * TODO: Write me
+ */
 GtkStateType
 cong_editor_area_get_state (CongEditorArea *area)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA(area), GTK_STATE_NORMAL);
 
 	return PRIVATE(area)->state;
 }
 
+/**
+ * cong_editor_area_set_state:
+ * @area:
+ * @state:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_set_state (CongEditorArea *area,
 			    GtkStateType state)
 {
 	if (PRIVATE(area)->state != state) {
@@ -289,10 +336,16 @@
 
 		cong_editor_area_queue_redraw (area);
 	}
 }
 
+/**
+ * cong_editor_area_get_cursor:
+ * @area:
+ *
+ * TODO: Write me
+ */
 GdkCursor*
 cong_editor_area_get_cursor (CongEditorArea *area)
 {
 	if ( PRIVATE (area)->cursor) {
 		gdk_cursor_ref (PRIVATE (area)->cursor);
@@ -300,10 +353,17 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_editor_area_set_cursor:
+ * @area:
+ * @cursor:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_set_cursor (CongEditorArea *area,
 			     GdkCursor *cursor)
 {
 	if (PRIVATE (area)->cursor != cursor) {
@@ -317,22 +377,34 @@
 
 		PRIVATE (area)->cursor = cursor;
 	}
 }
 
-
 #if 1
+/**
+ * cong_editor_area_get_window_coords:
+ * @area:
+ *
+ * TODO: Write me
+ */
 const GdkRectangle*
 cong_editor_area_get_window_coords (CongEditorArea *area)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA(area), NULL);
 
 	return &PRIVATE(area)->window_area;
 }
 #endif
 
-
+/**
+ * cong_editor_area_get_requisition:
+ * @area:
+ * @orientation:
+ * @width_hint:
+ *
+ * TODO: Write me
+ */
 guint
 cong_editor_area_get_requisition (CongEditorArea *area,
 				  GtkOrientation orientation,
 				  int width_hint)
 {
@@ -374,29 +446,50 @@
 	}
 
 	return cache->last_calculated_requisition;
 }
 
+/**
+ * cong_editor_area_get_requisition_width:
+ * @area:
+ * @width_hint:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_get_requisition_width (CongEditorArea *area,
 					int width_hint)
 {
 	return cong_editor_area_get_requisition (area,
 						 GTK_ORIENTATION_HORIZONTAL,
 						 width_hint);
 
 }
 
+/**
+ * cong_editor_area_get_requisition_height:
+ * @area:
+ * @width_hint:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_get_requisition_height (CongEditorArea *area,
 					 int width_hint)
 {
 	return cong_editor_area_get_requisition (area,
 						 GTK_ORIENTATION_VERTICAL,
 						 width_hint);
 }
 
+/**
+ * cong_editor_area_get_cached_requisition:
+ * @area:
+ * @orientation:
+ *
+ * TODO: Write me
+ */
 gint
 cong_editor_area_get_cached_requisition (CongEditorArea *area,
 					 GtkOrientation orientation)
 {
 	RequisitionCache *cache;
@@ -406,11 +499,10 @@
 	cache = &PRIVATE(area)->requisition_cache[orientation];
 
 	return cache->last_calculated_requisition;
 }
 
-
 #if 0
 void 
 cong_editor_area_set_requisition (CongEditorArea *area,
 				  gint width,
 				  gint height)
@@ -420,10 +512,17 @@
 	PRIVATE(area)->requisition.width = width;
 	PRIVATE(area)->requisition.height = height;
 }
 #endif
 
+/**
+ * cong_editor_area_debug_render_area:
+ * @area:
+ * @gc:
+ *
+ * TODO: Write me
+ */
 void 
 cong_editor_area_debug_render_area (CongEditorArea *area,
 				    GdkGC *gc)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA(area));
@@ -436,10 +535,16 @@
 			    PRIVATE(area)->window_area.y,
 			    PRIVATE(area)->window_area.width-1,
 			    PRIVATE(area)->window_area.height-1);
 }
 
+/**
+ * cong_editor_area_debug_render_state:
+ * @area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_debug_render_state (CongEditorArea *area)
 {
 	switch (cong_editor_area_get_state (area)) {
 	default: break;
@@ -470,10 +575,16 @@
 
 }
 
 
 /* CongEditorArea methods: */
+/**
+ * cong_editor_area_get_parent:
+ * @area:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_get_parent (CongEditorArea *area)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_AREA(area), NULL);
 
@@ -488,10 +599,17 @@
 					   (const GdkRectangle*)user_data);
 
 	return FALSE;
 }
 
+/**
+ * cong_editor_area_recursive_render:
+ * @area:
+ * @widget_rect:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_recursive_render (CongEditorArea *area,
 				   const GdkRectangle *widget_rect)
 {
 	GdkRectangle intersected_area;
@@ -537,10 +655,17 @@
 
 
 	}
 }
 
+/**
+ * cong_editor_area_on_button_press:
+ * @editor_area:
+ * @event:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_on_button_press (CongEditorArea *editor_area, 
 				  GdkEventButton *event)
 {
 	gboolean result;
@@ -554,10 +679,17 @@
 		       &result);
 
 	return result;
 }
 
+/**
+ * cong_editor_area_on_motion_notify:
+ * @editor_area:
+ * @event:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_on_motion_notify (CongEditorArea *editor_area, 
 				   GdkEventMotion *event)
 {
 	gboolean result;
@@ -571,10 +703,17 @@
 		       &result);
 
 	return result;
 }
 
+/**
+ * cong_editor_area_on_key_press:
+ * @editor_area:
+ * @event:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_on_key_press (CongEditorArea *editor_area, 
 			       GdkEventKey *event)
 {
 	gboolean result;
@@ -588,10 +727,18 @@
 		       &result);
 
 	return result;
 }
 
+/**
+ * cong_editor_area_calc_requisition:
+ * @editor_area:
+ * @orientation:
+ * @width_hint:
+ *
+ * TODO: Write me
+ */
 guint
 cong_editor_area_calc_requisition (CongEditorArea *editor_area, 
 				   GtkOrientation orientation,
 				   int width_hint)
 {
@@ -601,10 +748,20 @@
 						       editor_area,
 						       calc_requisition, 
 						       (editor_area, orientation, width_hint));
 }
 
+/**
+ * cong_editor_area_set_allocation:
+ * @editor_area:
+ * @x:
+ * @y:
+ * @width:
+ * @height:
+ *
+ * TODO: Write me
+ */
 void 
 cong_editor_area_set_allocation (CongEditorArea *editor_area,
 				 gint x,
 				 gint y,
 				 gint width,
@@ -652,11 +809,16 @@
 		
 		cong_editor_area_queue_redraw (editor_area);
 	}
 }
 
-
+/**
+ * cong_editor_area_queue_redraw:
+ * @editor_area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_queue_redraw (CongEditorArea *editor_area)
 {
 	const GdkRectangle *rect;
 	
@@ -669,10 +831,17 @@
 				    rect->y,
 				    rect->width,
 				    rect->height);
 }
 
+/**
+ * cong_editor_area_flush_requisition_cache:
+ * @editor_area:
+ * @orientation:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_flush_requisition_cache (CongEditorArea *editor_area,
 					  GtkOrientation orientation)
 {
 	RequisitionCache *cache;
@@ -696,10 +865,18 @@
 			       signals[FLUSH_REQUISITION_CACHE], 0,
 			       orientation);
 	}
 }
 
+/**
+ * cong_editor_area_for_all:
+ * @editor_area:
+ * @func:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_for_all (CongEditorArea *editor_area, 
 			  CongEditorAreaCallbackFunc func, 
 			  gpointer user_data)
 {
@@ -775,10 +952,18 @@
 					 for_all_recurse, 
 					 &rec_data);
 }
 #endif
 
+/**
+ * cong_editor_area_covers_xy:
+ * @editor_area:
+ * @x:
+ * @y:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_area_covers_xy (CongEditorArea *editor_area, 
 			    gint x,
 			    gint y)
 {
@@ -802,10 +987,18 @@
 					   search->x,
 					   search->y);	
 }
 
 /* Function gets immediate child (either "internal" or "non-internal") at the coords, if any: */
+/**
+ * cong_editor_area_get_immediate_child_at:
+ * @area:
+ * @x:
+ * @y:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_get_immediate_child_at (CongEditorArea *area,
 					 gint x,
 					 gint y)
 {
@@ -816,10 +1009,19 @@
 
 	return cong_editor_area_for_all (area, 
 					 is_area_at_xy,
 					 &search);
 }
+
+/**
+ * cong_editor_area_get_deepest_child_at:
+ * @area:
+ * @x:
+ * @y:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_get_deepest_child_at (CongEditorArea *area,
 				       gint x,
 				       gint y)
 {
@@ -847,19 +1049,32 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_editor_area_get_gdk_window:
+ * @editor_area:
+ *
+ * TODO: Write me
+ */
 GdkWindow*
 cong_editor_area_get_gdk_window(CongEditorArea *editor_area)
 {
 	g_return_val_if_fail (editor_area, NULL);
 
 	return GTK_WIDGET(cong_editor_area_get_widget (editor_area))->window;
 }
 
 /* Associate the editor area with a particular editor node: */
+/**
+ * cong_editor_area_connect_node_signals:
+ * @area:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_connect_node_signals (CongEditorArea *area,
 				       CongEditorNode *editor_node)
 {
 	CongDocument *doc;
@@ -888,10 +1103,17 @@
 								       G_CALLBACK(on_signal_is_selected_changed_for_area_with_node),
 								       area);
 }
 
 /* Protected stuff: */
+/**
+ * cong_editor_area_protected_postprocess_add_internal_child:
+ * @area:
+ * @internal_child:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_protected_postprocess_add_internal_child (CongEditorArea *area,
 							   CongEditorArea *internal_child)
 {
 	g_return_if_fail ( IS_CONG_EDITOR_AREA(area));
@@ -901,10 +1123,17 @@
 			  "flush_requisition_cache",
 			  G_CALLBACK(on_child_flush_requisition_cache),
 			  area);
 }
 
+/**
+ * cong_editor_area_protected_set_parent:
+ * @area:
+ * @parent:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_protected_set_parent (CongEditorArea *area,
 				       CongEditorArea *parent)
 {
 	g_return_if_fail ( IS_CONG_EDITOR_AREA(area));
Index: cong-editor-child-policy-flow-holder.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-child-policy-flow-holder.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-editor-child-policy-flow-holder.c
--- cong-editor-child-policy-flow-holder.c	27 Jul 2003 23:59:32 -0000	1.1
+++ cong-editor-child-policy-flow-holder.c	17 Apr 2004 17:45:24 -0000
@@ -63,10 +63,18 @@
 cong_editor_child_policy_flow_holder_instance_init (CongEditorChildPolicyFlowHolder *child_policy_flow_holder)
 {
 	child_policy_flow_holder->private = g_new0(CongEditorChildPolicyFlowHolderDetails,1);
 }
 
+/**
+ * cong_editor_child_policy_flow_holder_construct:
+ * @child_policy_flow_holder:
+ * @editor_node:
+ * @flow_holder:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_child_policy_flow_holder_construct (CongEditorChildPolicyFlowHolder *child_policy_flow_holder,
 						CongEditorNode *editor_node,
 						CongEditorAreaFlowHolder *flow_holder)
 {
@@ -76,10 +84,17 @@
 	PRIVATE(child_policy_flow_holder)->area_flow_holder = flow_holder;
 
 	return CONG_EDITOR_CHILD_POLICY(child_policy_flow_holder);
 }
 
+/**
+ * cong_editor_child_policy_flow_holder_new:
+ * @editor_node:
+ * @flow_holder:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_child_policy_flow_holder_new (CongEditorNode *editor_node,
 					  CongEditorAreaFlowHolder *flow_holder)
 {
 #if DEBUG_EDITOR_CHILD_POLICY_LIFETIMES
Index: cong-editor-child-policy-inline.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-child-policy-inline.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-editor-child-policy-inline.c
--- cong-editor-child-policy-inline.c	1 Aug 2003 18:05:58 -0000	1.1
+++ cong-editor-child-policy-inline.c	17 Apr 2004 17:45:24 -0000
@@ -63,10 +63,18 @@
 cong_editor_child_policy_inline_instance_init (CongEditorChildPolicyInline *child_policy_inline)
 {
 	child_policy_inline->private = g_new0(CongEditorChildPolicyInlineDetails,1);
 }
 
+/**
+ * cong_editor_child_policy_inline_construct:
+ * @child_policy_inline:
+ * @editor_node:
+ * @inlines:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_child_policy_inline_construct (CongEditorChildPolicyInline *child_policy_inline,
 					   CongEditorNode *editor_node,
 					   CongEditorAreaFlowHolderInlines *inlines)
 {
@@ -76,10 +84,17 @@
 	PRIVATE(child_policy_inline)->area_inlines = inlines;
 
 	return CONG_EDITOR_CHILD_POLICY(child_policy_inline);
 }
 
+/**
+ * cong_editor_child_policy_inline_new:
+ * @editor_node:
+ * @inlines:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_child_policy_inline_new (CongEditorNode *editor_node,
 				     CongEditorAreaFlowHolderInlines *inlines)
 {
 #if DEBUG_EDITOR_CHILD_POLICY_LIFETIMES
@@ -97,10 +112,17 @@
 		 inlines);
 }
 
 
 /* Whenever children are added or removed, we need to regenerate the lines of the flow_holder_inline */
+/**
+ * insert_areas_for_node:
+ * @child_policy:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 static CongEditorChildPolicy* 
 insert_areas_for_node (CongEditorChildPolicy *child_policy,
 		       CongEditorNode *editor_node)
 {
 	CongEditorChildPolicyInline *child_policy_inline = CONG_EDITOR_CHILD_POLICY_INLINE(child_policy);
@@ -110,10 +132,17 @@
 	/* Return a clone: */
 	return cong_editor_child_policy_inline_new ( editor_node,
 						     PRIVATE(child_policy_inline)->area_inlines);
 }
 
+/**
+ * remove_areas_for_node:
+ * @child_policy:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 static void 
 remove_areas_for_node (CongEditorChildPolicy *child_policy,
 		       CongEditorNode *editor_node)
 {
 	CongEditorChildPolicyInline *child_policy_inline = CONG_EDITOR_CHILD_POLICY_INLINE(child_policy);
Index: cong-editor-child-policy.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-child-policy.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-editor-child-policy.c
--- cong-editor-child-policy.c	20 Oct 2003 12:09:51 -0000	1.3
+++ cong-editor-child-policy.c	17 Apr 2004 17:45:24 -0000
@@ -69,10 +69,16 @@
 
 	return child_policy;
 }
 
 
+/**
+ * cong_editor_child_policy_get_node:
+ * @child_policy:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_child_policy_get_node (CongEditorChildPolicy *child_policy)
 {
 	g_return_val_if_fail (child_policy, NULL);
 
@@ -87,10 +93,17 @@
 
 	return PRIVATE(child_policy)->editor_widget;
 }
 #endif
 
+/**
+ * cong_editor_child_policy_insert_areas_for_node:
+ * @child_policy:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy* 
 cong_editor_child_policy_insert_areas_for_node (CongEditorChildPolicy *child_policy,
 						CongEditorNode *node)
 {
 	g_return_val_if_fail (child_policy, NULL);
@@ -100,10 +113,17 @@
 						       child_policy,
 						       insert_areas_for_node, 
 						       (child_policy, node));
 }
 
+/**
+ * cong_editor_child_policy_remove_areas_for_node:
+ * @child_policy:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void 
 cong_editor_child_policy_remove_areas_for_node (CongEditorChildPolicy *child_policy,
 						CongEditorNode *node)
 {
 	g_return_if_fail (child_policy);
Index: cong-editor-line-fragments.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-line-fragments.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-editor-line-fragments.c
--- cong-editor-line-fragments.c	1 Aug 2003 18:05:58 -0000	1.1
+++ cong-editor-line-fragments.c	17 Apr 2004 17:45:24 -0000
@@ -55,23 +55,41 @@
 cong_editor_line_fragments_construct (CongEditorLineFragments *line_fragments)
 {
 	return line_fragments;
 }
 
+/**
+ * cong_editor_line_fragments_new:
+ *
+ * Returns: a new #CongEditorLineFragments
+ */
 CongEditorLineFragments*
 cong_editor_line_fragments_new (void)
 {
 	return cong_editor_line_fragments_construct
 		(g_object_new (CONG_EDITOR_LINE_FRAGMENTS_TYPE, NULL));
 }
 
+/**
+ * cong_editor_line_fragments_get_area_list:
+ * @line_fragments:
+ *
+ * TODO: Write me
+ */
 GList*
 cong_editor_line_fragments_get_area_list (CongEditorLineFragments *line_fragments)
 {
 	return PRIVATE(line_fragments)->list_of_areas;
 }
 
+/**
+ * cong_editor_line_fragments_add_area:
+ * @line_fragments:
+ * @area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_line_fragments_add_area (CongEditorLineFragments *line_fragments,
 				     CongEditorArea *area)
 {
 	PRIVATE(line_fragments)->list_of_areas = g_list_append (PRIVATE(line_fragments)->list_of_areas,
Index: cong-editor-node-comment.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-comment.c,v
retrieving revision 1.8
diff -u -5 -r1.8 cong-editor-node-comment.c
--- cong-editor-node-comment.c	4 Feb 2004 16:24:21 -0000	1.8
+++ cong-editor-node-comment.c	17 Apr 2004 17:45:24 -0000
@@ -89,10 +89,18 @@
 cong_editor_node_comment_instance_init (CongEditorNodeComment *node_comment)
 {
 	node_comment->private = g_new0(CongEditorNodeCommentDetails,1);
 }
 
+/**
+ * cong_editor_node_comment_construct:
+ * @editor_node_comment:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeComment*
 cong_editor_node_comment_construct (CongEditorNodeComment *editor_node_comment,
 				    CongEditorWidget3* editor_widget,
 				    CongTraversalNode *traversal_node)
 {
@@ -105,10 +113,17 @@
 									NULL);
 
 	return editor_node_comment;
 }
 
+/**
+ * cong_editor_node_comment_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_comment_new (CongEditorWidget3 *widget,
 			      CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
Index: cong-editor-node-document.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-document.c,v
retrieving revision 1.7
diff -u -5 -r1.7 cong-editor-node-document.c
--- cong-editor-node-document.c	16 Dec 2003 17:27:17 -0000	1.7
+++ cong-editor-node-document.c	17 Apr 2004 17:45:24 -0000
@@ -58,10 +58,18 @@
 cong_editor_node_document_instance_init (CongEditorNodeDocument *node_document)
 {
 	node_document->private = g_new0(CongEditorNodeDocumentDetails,1);
 }
 
+/**
+ * cong_editor_node_document_construct:
+ * @editor_node_document:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeDocument*
 cong_editor_node_document_construct (CongEditorNodeDocument *editor_node_document,
 				     CongEditorWidget3* editor_widget,
 				     CongTraversalNode *traversal_node)
 {
@@ -69,10 +77,17 @@
 				    editor_widget,
 				    traversal_node);	
 	return editor_node_document;
 }
 
+/**
+ * cong_editor_node_document_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_document_new (CongEditorWidget3 *widget,
 			       CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -82,10 +97,16 @@
 								      widget,
 								      traversal_node)
 				 );
 }
 
+/**
+ * generate_block_area:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 static CongEditorArea*
 generate_block_area (CongEditorNode *editor_node)
 {
 	CongEditorArea *new_area;
 
Index: cong-editor-node-dtd.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-dtd.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-editor-node-dtd.c
--- cong-editor-node-dtd.c	16 Dec 2003 17:27:17 -0000	1.3
+++ cong-editor-node-dtd.c	17 Apr 2004 17:45:24 -0000
@@ -58,10 +58,18 @@
 cong_editor_node_dtd_instance_init (CongEditorNodeDtd *node_dtd)
 {
 	node_dtd->private = g_new0(CongEditorNodeDtdDetails,1);
 }
 
+/**
+ * cong_editor_node_dtd_construct:
+ * @editor_node_dtd:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeDtd*
 cong_editor_node_dtd_construct (CongEditorNodeDtd *editor_node_dtd,
 				CongEditorWidget3* editor_widget,
 				CongTraversalNode *traversal_node)
 {
@@ -69,10 +77,17 @@
 				    editor_widget,
 				    traversal_node);	
 	return editor_node_dtd;
 }
 
+/**
+ * cong_editor_node_dtd_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_dtd_new (CongEditorWidget3 *widget,
 			  CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -82,10 +97,16 @@
 								 widget,
 								 traversal_node)
 				 );
 }
 
+/**
+ * generate_block_area:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 static CongEditorArea*
 generate_block_area (CongEditorNode *editor_node)
 {
 	CongEditorArea *new_area;
 
Index: cong-editor-node-element-span.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-element-span.c,v
retrieving revision 1.13
diff -u -5 -r1.13 cong-editor-node-element-span.c
--- cong-editor-node-element-span.c	18 Feb 2004 11:28:17 -0000	1.13
+++ cong-editor-node-element-span.c	17 Apr 2004 17:45:24 -0000
@@ -77,10 +77,18 @@
 cong_editor_node_element_span_instance_init (CongEditorNodeElementSpan *node_element_span)
 {
 	node_element_span->private = g_new0(CongEditorNodeElementSpanDetails,1);
 }
 
+/**
+ * cong_editor_node_element_span_construct:
+ * @editor_node_element_span:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElementSpan*
 cong_editor_node_element_span_construct (CongEditorNodeElementSpan *editor_node_element_span,
 					 CongEditorWidget3* editor_widget,
 					 CongTraversalNode *traversal_node)
 {
@@ -89,10 +97,17 @@
 					    traversal_node);
 
 	return editor_node_element_span;
 }
 
+/**
+ * cong_editor_node_element_span_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_element_span_new (CongEditorWidget3* widget,
 				   CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
Index: cong-editor-node-element-structural.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-element-structural.c,v
retrieving revision 1.10
diff -u -5 -r1.10 cong-editor-node-element-structural.c
--- cong-editor-node-element-structural.c	16 Dec 2003 17:27:17 -0000	1.10
+++ cong-editor-node-element-structural.c	17 Apr 2004 17:45:24 -0000
@@ -61,10 +61,18 @@
 cong_editor_node_element_structural_instance_init (CongEditorNodeElementStructural *node_element_structural)
 {
 	node_element_structural->private = g_new0(CongEditorNodeElementStructuralDetails,1);
 }
 
+/**
+ * cong_editor_node_element_structural_construct:
+ * @editor_node_element_structural:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElementStructural*
 cong_editor_node_element_structural_construct (CongEditorNodeElementStructural *editor_node_element_structural,
 					       CongEditorWidget3* editor_widget,
 					       CongTraversalNode *traversal_node)
 {
@@ -73,10 +81,17 @@
 					    traversal_node);
 
 	return editor_node_element_structural;
 }
 
+/**
+ * cong_editor_node_element_structural_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_element_structural_new (CongEditorWidget3* widget,
 					 CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
Index: cong-editor-node-element-unknown.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-element-unknown.c,v
retrieving revision 1.8
diff -u -5 -r1.8 cong-editor-node-element-unknown.c
--- cong-editor-node-element-unknown.c	16 Dec 2003 17:27:17 -0000	1.8
+++ cong-editor-node-element-unknown.c	17 Apr 2004 17:45:24 -0000
@@ -57,10 +57,18 @@
 cong_editor_node_element_unknown_instance_init (CongEditorNodeElementUnknown *node_element_unknown)
 {
 	node_element_unknown->private = g_new0(CongEditorNodeElementUnknownDetails,1);
 }
 
+/**
+ * cong_editor_node_element_unknown_construct:
+ * @editor_node_element_unknown:
+ * @editor_widget:
+ * @traversal_node:
+ * 
+ * TODO: Write me
+ */
 CongEditorNodeElementUnknown*
 cong_editor_node_element_unknown_construct (CongEditorNodeElementUnknown *editor_node_element_unknown,
 					    CongEditorWidget3* editor_widget,
 					    CongTraversalNode *traversal_node)
 {
@@ -69,10 +77,17 @@
 					    traversal_node);
 
 	return editor_node_element_unknown;
 }
 
+/**
+ * cong_editor_node_element_unknown_new:
+ * @widget:
+ * @traversal_node:
+ * 
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_element_unknown_new (CongEditorWidget3* widget,
 				      CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -83,11 +98,16 @@
 				 (g_object_new (CONG_EDITOR_NODE_ELEMENT_UNKNOWN_TYPE, NULL),
 				  widget,
 				  traversal_node));
 }
 
-
+/**
+ * generate_block_area:
+ * @editor_node:
+ * 
+ * TODO: Write me
+ */
 static CongEditorArea*
 generate_block_area (CongEditorNode *editor_node)
 {
 	CongEditorArea *new_area;
 
Index: cong-editor-node-element.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-element.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-editor-node-element.c
--- cong-editor-node-element.c	16 Dec 2003 17:27:17 -0000	1.3
+++ cong-editor-node-element.c	17 Apr 2004 17:45:24 -0000
@@ -50,10 +50,18 @@
 cong_editor_node_element_instance_init (CongEditorNodeElement *node_element)
 {
 	node_element->private = g_new0(CongEditorNodeElementDetails,1);
 }
 
+/**
+ * cong_editor_node_element_construct:
+ * @editor_node_element:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElement*
 cong_editor_node_element_construct (CongEditorNodeElement *editor_node_element,
 				    CongEditorWidget3* editor_widget,
 				    CongTraversalNode *traversal_node)
 {
@@ -62,10 +70,16 @@
 				    traversal_node);
 
 	return editor_node_element;
 }
 
+/**
+ * cong_editor_node_element_get_dispspec_element:
+ * @editor_node_element:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_editor_node_element_get_dispspec_element (CongEditorNodeElement *editor_node_element)
 {
 	CongDocument *doc;
 	CongDispspecElement *ds_element;
Index: cong-editor-node-entity-decl.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-entity-decl.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-editor-node-entity-decl.c
--- cong-editor-node-entity-decl.c	16 Dec 2003 17:27:17 -0000	1.4
+++ cong-editor-node-entity-decl.c	17 Apr 2004 17:45:24 -0000
@@ -59,10 +59,18 @@
 cong_editor_node_entity_decl_instance_init (CongEditorNodeEntityDecl *node_entity_decl)
 {
 	node_entity_decl->private = g_new0(CongEditorNodeEntityDeclDetails,1);
 }
 
+/**
+ * cong_editor_node_entity_decl_construct:
+ * @editor_node_entity_decl:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeEntityDecl*
 cong_editor_node_entity_decl_construct (CongEditorNodeEntityDecl *editor_node_entity_decl,
 					CongEditorWidget3* editor_widget,
 					CongTraversalNode *traversal_node)
 {
@@ -70,10 +78,17 @@
 				    editor_widget,
 				    traversal_node);	
 	return editor_node_entity_decl;
 }
 
+/**
+ * cong_editor_node_entity_decl_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_entity_decl_new (CongEditorWidget3 *widget,
 				  CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -83,10 +98,16 @@
 									 widget,
 									 traversal_node)
 				 );
 }
 
+/**
+ * generate_block_area:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 static CongEditorArea*
 generate_block_area (CongEditorNode *editor_node)
 {
 	CongEditorArea *new_area;
 	gchar *title;
Index: cong-editor-node-entity-ref.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-entity-ref.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-editor-node-entity-ref.c
--- cong-editor-node-entity-ref.c	16 Dec 2003 17:27:17 -0000	1.3
+++ cong-editor-node-entity-ref.c	17 Apr 2004 17:45:24 -0000
@@ -59,10 +59,18 @@
 cong_editor_node_entity_ref_instance_init (CongEditorNodeEntityRef *node_entity_ref)
 {
 	node_entity_ref->private = g_new0(CongEditorNodeEntityRefDetails,1);
 }
 
+/**
+ * cong_editor_node_entity_ref_construct:
+ * @editor_node_entity_ref:
+ * @editor_widget:
+ * @traversal_node:
+ * 
+ * TODO: Write me
+ */
 CongEditorNodeEntityRef*
 cong_editor_node_entity_ref_construct (CongEditorNodeEntityRef *editor_node_entity_ref,
 				       CongEditorWidget3 *editor_widget,
 				       CongTraversalNode *traversal_node)
 {
@@ -70,10 +78,17 @@
 				    editor_widget,
 				    traversal_node);	
 	return editor_node_entity_ref;
 }
 
+/**
+ * cong_editor_node_entity_ref_new:
+ * @widget:
+ * @traversal_node:
+ * 
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_entity_ref_new (CongEditorWidget3 *widget,
 				 CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -83,10 +98,16 @@
 									 widget,
 									 traversal_node)
 				 );
 }
 
+/**
+ * generate_block_area:
+ * @editor_node:
+ * 
+ * TODO: Write me
+ */
 static CongEditorArea*
 generate_block_area (CongEditorNode *editor_node)
 {
 	CongEditorArea *new_area;
 	gchar *title;
Index: cong-editor-node-text.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-text.c,v
retrieving revision 1.42
diff -u -5 -r1.42 cong-editor-node-text.c
--- cong-editor-node-text.c	11 Feb 2004 15:54:23 -0000	1.42
+++ cong-editor-node-text.c	17 Apr 2004 17:45:24 -0000
@@ -197,10 +197,18 @@
 	editor_node_text->private = NULL;
 	
 	G_OBJECT_CLASS (parent_class)->finalize (object);
 }
 
+/**
+ * cong_editor_node_text_construct:
+ * @editor_node_text:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeText*
 cong_editor_node_text_construct (CongEditorNodeText *editor_node_text,
 				 CongEditorWidget3* editor_widget,
 				 CongTraversalNode *traversal_node)
 {
@@ -265,11 +273,17 @@
 				     PRIVATE(editor_node_text)->handler_id_selection_change);	
 
 	GNOME_CALL_PARENT (G_OBJECT_CLASS, dispose, (object));
 }
 
-
+/**
+ * cong_editor_node_text_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_text_new (CongEditorWidget3 *widget,
 			   CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -280,20 +294,36 @@
 								  widget,
 								  traversal_node)
 				 );
 }
 
+/**
+ * cong_editor_node_text_convert_original_byte_offset_to_stripped:
+ * @editor_node_text:
+ * @original_byte_offset:
+ * @stripped_byte_offset:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_node_text_convert_original_byte_offset_to_stripped (CongEditorNodeText *editor_node_text,
 								int original_byte_offset,
 								int *stripped_byte_offset)
 {
 	return cong_text_cache_convert_original_byte_offset_to_stripped (PRIVATE(editor_node_text)->text_cache,
 									 original_byte_offset,
 									 stripped_byte_offset);
 }
 
+/**
+ * cong_eel_pango_layout_calc_up:
+ * @layout:
+ * @input_index:
+ * @output_index:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_eel_pango_layout_calc_up (PangoLayout *layout,
 			       int input_index,
 			       int *output_index)
 {
@@ -331,10 +361,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_eel_pango_layout_calc_down:
+ * @layout:
+ * @input_index:
+ * @output_index:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_eel_pango_layout_calc_down (PangoLayout *layout,
 				 int input_index,
 				 int *output_index)
 {
@@ -369,10 +407,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_editor_node_text_calc_up:
+ * @editor_node_text:
+ * @input_byte_offset:
+ * @output_byte_offset:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_node_text_calc_up (CongEditorNodeText *editor_node_text,
 			       int input_byte_offset,
 			       int* output_byte_offset)
 {
@@ -399,10 +445,18 @@
 									 result_stripped_byte_offset,
 									 output_byte_offset);
 
 }
 
+/**
+ * cong_editor_node_text_calc_down:
+ * @editor_node_text:
+ * @input_byte_offset:
+ * @output_byte_offset:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_node_text_calc_down (CongEditorNodeText *editor_node_text,
 				 int input_byte_offset,
 				 int* output_byte_offset)
 {
@@ -479,10 +533,18 @@
 				      gint *output);
 gboolean
 cong_selection_get_end_byte_offset (CongSelection *selection, 
 				    CongNodePtr node,
 				    gint *output);
+/**
+ * cong_selection_get_start_byte_offset:
+ * @selection:
+ * @node:
+ * @output:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_selection_get_start_byte_offset (CongSelection *selection, 
 				      CongNodePtr node,
 				      gint *output)
 {
@@ -530,10 +592,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_selection_get_end_byte_offset:
+ * @selection:
+ * @node:
+ * @output:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_selection_get_end_byte_offset (CongSelection *selection, 
 				    CongNodePtr node,
 				    gint *output)
 {
@@ -583,10 +653,18 @@
 	}
 
 }
 #endif
 
+/**
+ * generate_line_areas_recursive:
+ * @editor_node:
+ * @line_width:
+ * @initial_indent:
+ *
+ * TODO: Write me
+ */
 static CongEditorLineFragments*
 generate_line_areas_recursive (CongEditorNode *editor_node,
 			       gint line_width,
 			       gint initial_indent)
 {
@@ -1549,6 +1627,5 @@
 
 #if 0
 	pango_attr_list_unref (attr_list);
 #endif
 }
-
Index: cong-editor-node-unimplemented.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node-unimplemented.c,v
retrieving revision 1.10
diff -u -5 -r1.10 cong-editor-node-unimplemented.c
--- cong-editor-node-unimplemented.c	16 Dec 2003 17:27:17 -0000	1.10
+++ cong-editor-node-unimplemented.c	17 Apr 2004 17:45:24 -0000
@@ -58,10 +58,19 @@
 cong_editor_node_unimplemented_instance_init (CongEditorNodeUnimplemented *node_unimplemented)
 {
 	node_unimplemented->private = g_new0(CongEditorNodeUnimplementedDetails,1);
 }
 
+/**
+ * cong_editor_node_unimplemented_construct:
+ * @editor_node_unimplemented:
+ * @editor_widget:
+ * @traversal_node:
+ * @description:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeUnimplemented*
 cong_editor_node_unimplemented_construct (CongEditorNodeUnimplemented *editor_node_unimplemented,
 					  CongEditorWidget3* editor_widget,
 					  CongTraversalNode *traversal_node,
 					  const gchar *description)
@@ -73,10 +82,18 @@
 	PRIVATE(editor_node_unimplemented)->description = g_strdup(description);
 
 	return editor_node_unimplemented;
 }
 
+/**
+ * cong_editor_node_unimplemented_new:
+ * @editor_widget:
+ * @traversal_node:
+ * @description:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_unimplemented_new (CongEditorWidget3 *widget,
 				    CongTraversalNode *traversal_node,
 				    const gchar *description)
 {
@@ -88,11 +105,16 @@
 									   traversal_node,
 									   description)
 				 );
 }
 
-
+/**
+ * generate_block_area:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 static CongEditorArea*
 generate_block_area (CongEditorNode *editor_node)
 {
 	CongEditorNodeUnimplemented *editor_node_unimplemented = CONG_EDITOR_NODE_UNIMPLEMENTED(editor_node);
 	CongEditorArea *new_area;
Index: cong-editor-node.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-node.c,v
retrieving revision 1.24
diff -u -5 -r1.24 cong-editor-node.c
--- cong-editor-node.c	3 Feb 2004 16:01:22 -0000	1.24
+++ cong-editor-node.c	17 Apr 2004 17:45:24 -0000
@@ -120,10 +120,18 @@
 cong_editor_node_instance_init (CongEditorNode *node)
 {
 	node->priv = g_new0(CongEditorNodeDetails,1);
 }
 
+/**
+ * cong_editor_node_construct:
+ * @editor_node:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_construct (CongEditorNode *editor_node,
 			    CongEditorWidget3* editor_widget,
 			    CongTraversalNode *traversal_node)
 {
@@ -131,10 +139,17 @@
 	PRIVATE(editor_node)->traversal_node = traversal_node;
 
 	return editor_node;
 }
 
+/**
+ * cong_editor_node_manufacture:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_manufacture (CongEditorWidget3* widget,
 			      CongTraversalNode *traversal_node)
 {
 	CongDocument *doc;
@@ -284,44 +299,72 @@
 								   cong_node_type_description (type));
 		}
 	}
 }
 
-
-
+/**
+ * cong_editor_node_get_widget:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorWidget3*
 cong_editor_node_get_widget (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE (editor_node), NULL);
 
 	return PRIVATE(editor_node)->widget;
 }
 
+/**
+ * cong_editor_node_get_document:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_editor_node_get_document (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE (editor_node), NULL);
 	
 	return cong_editor_widget3_get_document( cong_editor_node_get_widget(editor_node));
 }
 
+/**
+ * cong_editor_node_get_node:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_editor_node_get_node (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE (editor_node), NULL);
 
 	return cong_traversal_node_get_node (PRIVATE(editor_node)->traversal_node);
 }
 
+/**
+ * cong_editor_node_get_traversal_node:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_editor_node_get_traversal_node (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE (editor_node), NULL);
 
 	return PRIVATE(editor_node)->traversal_node;	
 }
 
+/**
+ * cong_editor_node_get_traversal_parent:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_get_traversal_parent (CongEditorNode *editor_node)
 {
 	CongTraversalNode *traversal_node_parent;
 
@@ -331,18 +374,31 @@
 
 	return cong_editor_widget3_get_editor_node_for_traversal_node (PRIVATE(editor_node)->widget,
 								       traversal_node_parent);
 }
 
+/**
+ * cong_editor_node_is_selected:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_node_is_selected (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE(editor_node), FALSE);
 
 	return PRIVATE(editor_node)->is_selected;	
 }
 
+/**
+ * cong_editor_node_private_set_selected:
+ * @editor_node:
+ * @is_selected:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_node_private_set_selected (CongEditorNode *editor_node,
 				       gboolean is_selected)
 {
 	g_return_if_fail (IS_CONG_EDITOR_NODE(editor_node));
@@ -353,11 +409,16 @@
 		g_signal_emit (G_OBJECT(editor_node),
 			       signals[IS_SELECTED_CHANGED], 0);
 	}	
 }
 
-
+/**
+ * cong_editor_node_generate_block_area:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_node_generate_block_area (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE (editor_node), NULL);
 
@@ -367,10 +428,18 @@
 						       editor_node,
 						       generate_block_area, 
 						       (editor_node));
 }
 
+/**
+ * cong_editor_node_generate_line_areas_recursive:
+ * @editor_node:
+ * @line_width:
+ * @initial_indent:
+ *
+ * TODO: Write me
+ */
 CongEditorLineFragments*
 cong_editor_node_generate_line_areas_recursive (CongEditorNode *editor_node,
 						gint line_width,
 						gint initial_indent)
 {
@@ -387,19 +456,31 @@
 						       editor_node,
 						       generate_line_areas_recursive, 
 						       (editor_node, line_width, initial_indent));
 }
 
+/**
+ * cong_editor_node_line_regeneration_required:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_node_line_regeneration_required (CongEditorNode *editor_node)
 {
 	g_return_if_fail (editor_node);
 
 	g_signal_emit (G_OBJECT(editor_node),
 		       signals[LINE_REGENERATION_REQUIRED], 0);
 }
 
+/**
+ * cong_editor_node_get_flow_type:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 enum CongFlowType
 cong_editor_node_get_flow_type (CongEditorNode *editor_node)
 {
 	enum CongFlowType flow_type;
 		
@@ -423,10 +504,16 @@
 	
 	return flow_type;
 }
 
 #if 1
+/**
+ * cong_editor_node_is_referenced_entity_decl:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_node_is_referenced_entity_decl (CongEditorNode *editor_node)
 {
 	CongTraversalNode *traversal_node;
 
@@ -435,10 +522,16 @@
 	traversal_node = cong_editor_node_get_traversal_node (editor_node);
 
 	return cong_traversal_node_is_referenced_entity_decl (traversal_node);
 }
 
+/**
+ * cong_editor_node_get_prev:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_get_prev (CongEditorNode *editor_node)
 {
 	CongTraversalNode *traversal_node;
 	CongTraversalNode *traversal_node_prev;
@@ -468,10 +561,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_editor_node_get_next:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_get_next (CongEditorNode *editor_node)
 {
 	CongTraversalNode *traversal_node;
 	CongTraversalNode *traversal_node_next;
@@ -500,10 +599,16 @@
 	} else {
 		return NULL;
 	}
 }
 #else
+/**
+ * cong_editor_node_is_referenced_entity_decl:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_node_is_referenced_entity_decl (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE(editor_node), FALSE);
 
@@ -515,10 +620,16 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_editor_node_get_prev:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_get_prev (CongEditorNode *editor_node)
 {
 	CongNodePtr other_doc_node;
 
@@ -539,10 +650,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_editor_node_get_next:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_get_next (CongEditorNode *editor_node)
 {
 	CongNodePtr other_doc_node;
 
@@ -563,35 +680,61 @@
 		return NULL;
 	}
 }
 #endif
 
+/**
+ * cong_editor_node_get_child_policy:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_node_get_child_policy (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE(editor_node), NULL);
 
 	return PRIVATE(editor_node)->child_policy;
 }
 
+/**
+ * cong_editor_node_set_child_policy:
+ * @editor_node:
+ * @child_policy:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_node_set_child_policy (CongEditorNode *editor_node,
 				   CongEditorChildPolicy *child_policy)
 {
 	g_return_if_fail (IS_CONG_EDITOR_NODE(editor_node));
 
 	PRIVATE(editor_node)->child_policy = child_policy;
 }
 
+/**
+ * cong_editor_node_get_parents_child_policy:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_node_get_parents_child_policy (CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE(editor_node), NULL);
 
 	return PRIVATE(editor_node)->parents_child_policy;
 }
 
+/**
+ * cong_editor_node_set_parents_child_policy:
+ * @editor_node:
+ * @child_policy:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_node_set_parents_child_policy (CongEditorNode *editor_node,
 					   CongEditorChildPolicy *child_policy)
 {
 	g_return_if_fail (IS_CONG_EDITOR_NODE(editor_node));
Index: cong-editor-widget3.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-editor-widget3.c,v
retrieving revision 1.57
diff -u -5 -r1.57 cong-editor-widget3.c
--- cong-editor-widget3.c	11 Feb 2004 15:54:23 -0000	1.57
+++ cong-editor-widget3.c	17 Apr 2004 17:45:25 -0000
@@ -267,11 +267,17 @@
 cong_editor_widget3_instance_init (CongEditorWidget3 *widget)
 {
 	widget->private = g_new0(CongEditorWidget3Details,1);
 }
 
-/* Disconnects all signals from instance that have the supplied user_data as the closure data; returns the number disconnected: */
+/**
+ * cong_eel_disconnect_all_with_data:
+ * @instance: The instance owning the signal handler to be found
+ * @user_data: The closure data of the handler's closure
+ *
+ * Returns: The number of signals disconnected
+ */
 guint
 cong_eel_disconnect_all_with_data (gpointer instance,
 				   gpointer user_data)
 {
 	guint count = 0;
@@ -295,10 +301,17 @@
 			return count;
 		}
 	}
 }
 
+/**
+ * cong_editor_widget3_construct:
+ * @editor_widget:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongEditorWidget3*
 cong_editor_widget3_construct (CongEditorWidget3 *editor_widget,
 			       CongDocument *doc)
 {
 	PRIVATE(editor_widget)->doc = doc;
@@ -412,27 +425,48 @@
 	}
 
 	return editor_widget;
 }
 
-GtkWidget* cong_editor_widget3_new(CongDocument *doc)
+/**
+ * cong_editor_widget3_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_editor_widget3_new(CongDocument *doc)
 {
 	g_return_val_if_fail(doc, NULL);
 
 	return GTK_WIDGET( cong_editor_widget3_construct (g_object_new (CONG_EDITOR_WIDGET3_TYPE, NULL),
 							  doc)
 			   );
 }
 
-CongDocument *cong_editor_widget3_get_document(CongEditorWidget3 *editor_widget)
+/**
+ * cong_editor_widget3_get_document:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
+CongDocument *
+cong_editor_widget3_get_document(CongEditorWidget3 *editor_widget)
 {
 	g_return_val_if_fail(editor_widget, NULL);
 
 	return PRIVATE(editor_widget)->doc;
 }
 
-CongDispspec *cong_editor_widget_get_dispspec(CongEditorWidget3 *editor_widget)
+/**
+ * cong_editor_widget_get_dispspec:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
+CongDispspec *
+cong_editor_widget_get_dispspec(CongEditorWidget3 *editor_widget)
 {
 	g_return_val_if_fail(editor_widget, NULL);
 
 	return cong_document_get_dispspec(PRIVATE(editor_widget)->doc);
 }
@@ -461,10 +495,17 @@
 	gtk_widget_queue_draw(GTK_WIDGET(editor_widget));
 #endif
 }
 #endif
 
+/**
+ * cong_editor_widget3_get_editor_node_for_traversal_node:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_widget3_get_editor_node_for_traversal_node (CongEditorWidget3 *editor_widget,
 							CongTraversalNode *traversal_node)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_WIDGET3 (editor_widget), NULL);
@@ -500,10 +541,19 @@
 					  editor_node,
 					  tmp_struct->user_data);
 	
 }
 
+/**
+ * cong_editor_widget3_for_each_editor_node:
+ * @editor_widget:
+ * @xml_node:
+ * @editor_node_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_widget3_for_each_editor_node (CongEditorWidget3 *editor_widget,
 					  CongNodePtr xml_node,
 					  CongEditorNodeCallback editor_node_callback,
 					  gpointer user_data)
@@ -522,10 +572,17 @@
 							 xml_node,
 							 for_each_editor_node_cb,
 							 &tmp_struct);
 }
 
+/**
+ * cong_editor_widget3_get_an_editor_node:
+ * @editor_widget:
+ * @xml_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_widget3_get_an_editor_node (CongEditorWidget3 *editor_widget,
 					CongNodePtr xml_node)
 {
 	CongTraversalNode *traversal_node;
@@ -542,18 +599,31 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_editor_widget3_get_prehighlight_editor_area:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_widget3_get_prehighlight_editor_area (CongEditorWidget3 *editor_widget)
 {
 	g_return_val_if_fail (editor_widget, NULL);
 	
 	return PRIVATE (editor_widget)->prehighlight_area;
 }
 
+/**
+ * cong_editor_widget3_set_prehighlight_editor_area:
+ * @editor_widget:
+ * @editor_area:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_widget3_set_prehighlight_editor_area (CongEditorWidget3 *editor_widget,
 						  CongEditorArea* editor_area)
 {
 	GdkCursor *new_cursor = NULL;
@@ -591,40 +661,65 @@
 	if (new_cursor) {
 		gdk_cursor_unref (new_cursor);
 	}
 }
 
-
+/**
+ * cong_editor_widget3_get_test_gc:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 GdkGC*
 cong_editor_widget3_get_test_gc (CongEditorWidget3 *editor_widget)
 {
 	g_return_val_if_fail (editor_widget, NULL);
 
 	return PRIVATE(editor_widget)->test_gc;
 }
 
-
+/**
+ * cong_editor_widget3_get_area_at:
+ * @editor_widget:
+ * @x:
+ * @y:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_widget3_get_area_at (CongEditorWidget3 *editor_widget,
 				 gint x,
 				 gint y)
 {
 	return cong_editor_area_get_deepest_child_at (PRIVATE(editor_widget)->root_area, 
 						      x,
 						      y);
 }
 
+/**
+ * cong_flow_type_get_debug_string:
+ * @flow_type:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_flow_type_get_debug_string(enum CongFlowType flow_type)
 {
 	switch (flow_type) {
 	default: g_assert_not_reached();
 	case CONG_FLOW_TYPE_BLOCK: return "FLOW_TYPE_BLOCK";
 	case CONG_FLOW_TYPE_INLINE: return "FLOW_TYPE_INLINE";
 	}
 }
 
+/**
+ * cong_editor_widget3_add_popup_items:
+ * @editor_widget:
+ * @menu:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_widget3_add_popup_items (CongEditorWidget3 *editor_widget,
 				     GtkMenu *menu)
 {
 	GtkWidget *submenu_item;
@@ -642,10 +737,19 @@
 
 	gtk_widget_show (submenu_item);
 	gtk_widget_show (submenu_menu);
 }
 
+/**
+ * cong_editor_widget3_get_preedit_data:
+ * @editor_widget:
+ * @output_string:
+ * @output_pango_attr_list:
+ * @output_cursor_pos:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_widget3_get_preedit_data (CongEditorWidget3 *editor_widget,
 				      gchar **output_string, 
 				      PangoAttrList **output_pango_attr_list,
 				      gint *output_cursor_pos)
@@ -1538,10 +1642,16 @@
 	recursive_add_editor_nodes (editor_widget,
 				    cong_document_get_root_traversal_node (doc));
        	/* FIXME: Also need to do the opposite when widget is destroyed */
 }
 
+/**
+ * cong_editor_widget3_node_should_have_editor_node:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_editor_widget3_node_should_have_editor_node (CongNodePtr node)
 {
 	g_return_val_if_fail (node, FALSE);
 
@@ -1692,10 +1802,18 @@
 	return CONG_EDITOR_CHILD_POLICY(g_hash_table_lookup (PRIVATE(widget)->hash_of_editor_node_to_child_policy,
 							     editor_node));
 #endif
 	
 }
+
+/**
+ * cong_editor_widget3_get_parents_child_policy_for_editor_node:
+ * @widget:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorChildPolicy*
 cong_editor_widget3_get_parents_child_policy_for_editor_node (CongEditorWidget3 *widget,
 							      CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (widget, NULL);
@@ -1708,10 +1826,18 @@
 							     editor_node));
 #endif
 	
 }
 #else
+
+/**
+ * cong_editor_widget3_get_primary_area_for_editor_node:
+ * @widget:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_widget3_get_primary_area_for_editor_node (CongEditorWidget3 *widget,
 						      CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (widget, NULL);
@@ -1719,10 +1845,17 @@
 
 	return CONG_EDITOR_AREA(g_hash_table_lookup (PRIVATE(widget)->hash_of_editor_node_to_primary_area,
 						     editor_node));
 }
 
+/**
+ * cong_editor_widget3_get_parent_flow_holder_for_editor_node:
+ * @widget:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorAreaFlowHolder*
 cong_editor_widget3_get_parent_flow_holder_for_editor_node (CongEditorWidget3 *widget,
 							    CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (widget, NULL);
@@ -1730,10 +1863,17 @@
 
 	return CONG_EDITOR_AREA_FLOW_HOLDER(g_hash_table_lookup (PRIVATE(widget)->hash_of_editor_node_to_parent_flow_holder,
 								 editor_node));
 }
 
+/**
+ * cong_editor_widget3_get_child_flow_holder_for_editor_node:
+ * @widget:
+ * @editor_node:
+ *
+ * TODO: Write me
+ */
 CongEditorAreaFlowHolder*
 cong_editor_widget3_get_child_flow_holder_for_editor_node (CongEditorWidget3 *widget,
 							   CongEditorNode *editor_node)
 {
 	g_return_val_if_fail (widget, NULL);
Index: cong-eel-graphic-effects.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-eel-graphic-effects.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-eel-graphic-effects.c
--- cong-eel-graphic-effects.c	22 Oct 2003 11:41:22 -0000	1.2
+++ cong-eel-graphic-effects.c	17 Apr 2004 17:45:25 -0000
@@ -76,10 +76,16 @@
 		new_value = 255;
 	}
 	return (guchar) new_value;
 }
 
+/**
+ * eel_create_spotlight_pixbuf:
+ * @src:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf *
 eel_create_spotlight_pixbuf (GdkPixbuf* src)
 {
 	GdkPixbuf *dest;
 	int i, j;
@@ -122,10 +128,18 @@
 
 /* the following routine was stolen from the panel to darken a pixbuf, by manipulating the saturation */
 
 /* saturation is 0-255, darken is 0-255 */
 
+/**
+ * eel_create_darkened_pixbuf:
+ * @src:
+ * @saturation:
+ * @darken:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf *
 eel_create_darkened_pixbuf (GdkPixbuf *src, int saturation, int darken)
 {
 	gint i, j;
 	gint width, height, src_row_stride, dest_row_stride;
@@ -175,11 +189,19 @@
 	}
 	return dest;
 }
 
 /* this routine colorizes the passed-in pixbuf by multiplying each pixel with the passed in color */
-
+/**
+ * eel_create_colorized_pixbuf:
+ * @src:
+ * @red_value:
+ * @green_value:
+ * @blue_value:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf *
 eel_create_colorized_pixbuf (GdkPixbuf *src,
 				  int red_value,
 				  int green_value,
 				  int blue_value)
@@ -255,10 +277,23 @@
 		remaining_height -= slab_height;
 		v_offset += slab_height; 
 	}
 }
 
+/**
+ * eel_stretch_frame_image:
+ * @frame_image:
+ * @left_offset:
+ * @top_offset:
+ * @right_offset:
+ * @bottom_offset:
+ * @dest_width:
+ * @dest_height:
+ * @fill_flag:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf *
 eel_stretch_frame_image (GdkPixbuf *frame_image, int left_offset, int top_offset, int right_offset, int bottom_offset,
 				int dest_width, int dest_height, gboolean fill_flag)
 {
 	GdkPixbuf *result_pixbuf;
@@ -310,12 +345,22 @@
 	draw_frame_column (frame_image, target_height, target_frame_height, frame_width - right_offset, dest_width - right_offset, result_pixbuf, top_offset, right_offset);
 	
 	return result_pixbuf;
 }
 
-
 /* draw an arbitrary frame around an image, with the result passed back in a newly allocated pixbuf */
+/**
+ * eel_embed_image_in_frame:
+ * @source_image:
+ * @frame_image:
+ * @left_offset:
+ * @top_offset:
+ * @right_offset:
+ * @bottom_offset:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf *
 eel_embed_image_in_frame (GdkPixbuf *source_image, GdkPixbuf *frame_image, int left_offset, int top_offset, int right_offset, int bottom_offset)
 {
 	GdkPixbuf *result_pixbuf;
 	int source_width, source_height;
@@ -339,11 +384,16 @@
 
 /* this routine takes the source pixbuf and returns a new one that's semi-transparent, by
    clearing every other pixel's alpha value in a checkerboard grip.  We have to do the
    checkerboard instead of reducing the alpha since it will be turned into an alpha-less
    gdkpixmap and mask for the actual dragging */
-
+/**
+ * eel_make_semi_transparent:
+ * @src:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf *
 eel_make_semi_transparent (GdkPixbuf *src)
 {
 	gint i, j, temp_alpha;
 	gint width, height, has_alpha, src_row_stride, dst_row_stride;
@@ -396,6 +446,5 @@
 		start_alpha_value = ~start_alpha_value;
 	}
 	
 	return dest_pixbuf;
 }
-
Index: cong-eel.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-eel.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-eel.c
--- cong-eel.c	11 Feb 2004 15:54:23 -0000	1.11
+++ cong-eel.c	17 Apr 2004 17:45:25 -0000
@@ -9,11 +9,17 @@
 
 #include "global.h"
 #include "cong-eel.h"
 #include "cong-ui-hooks.h"
 
-
+/**
+ * cong_eel_log_ref_count:
+ * @name:
+ * @obj:
+ *
+ * TODO: Write me
+ */
 void 
 cong_eel_log_ref_count (const gchar *name, 
 			GObject *obj)
 {
 #if 0
@@ -22,10 +28,20 @@
 		  obj->ref_count,
 		  G_OBJECT_CLASS_NAME(G_OBJECT_GET_CLASS(obj)));
 #endif
 }
 
+/**
+ * cong_eel_rectangle_construct:
+ * @rectangle:
+ * @x:
+ * @y:
+ * @w:
+ * @h:
+ *
+ * TODO: Write me
+ */
 void            
 cong_eel_rectangle_construct (GdkRectangle  *rectangle,
 			      gint                  x,
 			      gint                  y,
 			      gint                  w,
@@ -36,19 +52,34 @@
 	rectangle->y = y;
 	rectangle->width = w;
 	rectangle->height = h;
 }
 
+/**
+ * cong_eel_pango_layout_line_get_text:
+ * @layout_line:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_eel_pango_layout_line_get_text (PangoLayoutLine *layout_line)
 {
 	g_return_val_if_fail (layout_line, NULL);
 
 	return g_strndup (pango_layout_get_text (layout_line->layout) + layout_line->start_index, 
 			  layout_line->length);
 }
 
+/**
+ * cong_eel_rgb_to_gdk_color:
+ * @color:
+ * @r:
+ * @g:
+ * @b:
+ *
+ * TODO: Write me
+ */
 void
 cong_eel_rgb_to_gdk_color (GdkColor             *color,
 			   guchar               r,
 			   guchar               g,
 			   guchar               b)
@@ -73,11 +104,11 @@
  * cong_eel_rectangle_contains:
  * @rectangle: Rectangle possibly containing a point.
  * @x: X coordinate of a point.
  * @y: Y coordinate of a point.
  *
- * Retun TRUE if point is contained inside a rectangle
+ * Returns: %TRUE if point is contained inside a rectangle, %FALSE otherwise
  */
 gboolean
 cong_eel_rectangle_contains (const GdkRectangle *rectangle, 
 			     int x, 
 			     int y)
@@ -85,11 +116,18 @@
 	g_return_val_if_fail (rectangle != NULL, FALSE);
 	return rectangle->x <= x && rectangle->x + rectangle->width >= x
 		&& rectangle->y <= y && rectangle->y + rectangle->height >= y;
 }
 
-
+/**
+ * cong_eel_rgb16_to_rgb:
+ * @r:
+ * @g:
+ * @b:
+ *
+ * TODO: Write me
+ */
 guint32
 cong_eel_rgb16_to_rgb (gushort r, gushort g, gushort b)
 {
 	guint32 result;
 
@@ -120,18 +158,24 @@
  * @color: a gdk_rgb style value.
  *
  * Converts from a gdk_rgb value style to a string color spec.
  * The gdk_rgb color alpha channel is ignored.
  * 
- * Return value: a newly allocated color spec.
+ * Returns: a newly allocated color spec.
  */
 char *
 cong_eel_gdk_rgb_to_color_spec (const guint32 color)
 {
 	return g_strdup_printf ("#%06X", (guint) (color & 0xFFFFFF));
 }
 
+/**
+ * cong_eel_option_menu_get_selected_menu_item:
+ * @option_menu:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_eel_option_menu_get_selected_menu_item(GtkOptionMenu *option_menu)
 {
 	gint selected_index;
 	GList *list_of_menu_items;
@@ -155,11 +199,12 @@
 
 	return selected_menu_item;
 
 }
 
-static gchar* cong_eel_utf8_capitalise(const gchar *str)
+static gchar* 
+cong_eel_utf8_capitalise(const gchar *str)
 {
 	gchar *result;
 	gunichar*   unichar;
 
 	g_return_val_if_fail (str, NULL);
@@ -186,19 +231,27 @@
  * FIXME:  Probably should convert everything to lower case as well on output
  * FIXME:  To be really smart, we could try to spot acronyms and fully capitalise them...  would require a dictionary though.
  * 
  * Returns:
  */
-static gchar** split_xmlname(const gchar *xml_name)
+static gchar** 
+split_xmlname(const gchar *xml_name)
 {
 	/* FIXME: is this really UTF-8 safe? */
 	return g_strsplit (xml_name,
 			   "-",
 			   0);
 }
 
-gchar *cong_eel_prettify_xml_name_with_header_capitalisation(const gchar *xml_name)
+/**
+ * cong_eel_prettify_xml_name_with_header_capitalisation:
+ * @xml_name:
+ *
+ * TODO: Write me
+ */
+gchar *
+cong_eel_prettify_xml_name_with_header_capitalisation(const gchar *xml_name)
 {
 	gchar *result = NULL;
 	gchar** string_array;
 	gchar** iter;
 
@@ -216,11 +269,18 @@
 	g_strfreev(string_array);
 
 	return result;
 }
 
-gchar *cong_eel_prettify_xml_name_with_sentence_capitalisation(const gchar *xml_name)
+/**
+ * cong_eel_prettify_xml_name_with_sentence_capitalisation:
+ * @xml_name:
+ *
+ * TODO: Write me
+ */
+gchar *
+cong_eel_prettify_xml_name_with_sentence_capitalisation(const gchar *xml_name)
 {
 	gchar *result = NULL;
 	gchar** string_array;
 	gchar** iter;
 
@@ -242,12 +302,19 @@
 	g_strfreev(string_array);
 
 	return result;
 }
 
-/* Routine that sets a string ptr to point to a new value, and frees the old value (if any) */
-void cong_eel_set_string(gchar **string, gchar *value)
+/**
+ * cong_eel_set_string:
+ * @string: a string
+ * @value: a new value for the string
+ *
+ * Sets a @string to @value, freeing the old value (if any)
+ */
+void 
+cong_eel_set_string(gchar **string, gchar *value)
 {
 	gchar *old_value;
 
 	g_return_if_fail (string);
 
@@ -258,10 +325,27 @@
 	if (old_value) {
 		g_free (old_value);
 	}
 }
 
+/**
+ * cong_eel_draw_pixbuf:
+ * @drawable:
+ * @gc:
+ * @pixbuf:
+ * @src_x:
+ * @src_y:
+ * @dest_x:
+ * @dest_y:
+ * @width:
+ * @height:
+ * @dither:
+ * @x_dither:
+ * @y_dither:
+ *
+ * TODO: Write me
+ */
 void 
 cong_eel_draw_pixbuf (GdkDrawable *drawable,
 		      GdkGC *gc,
 		      GdkPixbuf *pixbuf,
 		      gint src_x,
Index: cong-enum-mapping.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-enum-mapping.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-enum-mapping.c
--- cong-enum-mapping.c	8 Sep 2003 14:34:56 -0000	1.2
+++ cong-enum-mapping.c	17 Apr 2004 17:45:25 -0000
@@ -23,10 +23,19 @@
  */
 
 #include "global.h"
 #include "cong-enum-mapping.h"
 
+/**
+ * cong_enum_mapping_lookup:
+ * @enum_mapping:
+ * @num_values:
+ * @text_value:
+ * @default_value:
+ *
+ * TODO: Write me
+ */
 guint
 cong_enum_mapping_lookup (const CongEnumMapping *enum_mapping,
 			  guint num_values,
 			  const gchar *text_value,
 			  guint default_value)
@@ -47,10 +56,18 @@
 
 	/* Unrecognised value: */
 	return default_value;	
 }
 
+/**
+ * cong_enum_mapping_lookup_string:
+ * @enum_mapping:
+ * @num_values:
+ * @value:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_enum_mapping_lookup_string (const CongEnumMapping *enum_mapping,
 				 guint num_values,
 				 guint value)
 {
Index: cong-error-dialog.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-error-dialog.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-error-dialog.c
--- cong-error-dialog.c	8 Mar 2004 09:14:08 -0000	1.11
+++ cong-error-dialog.c	17 Apr 2004 17:45:25 -0000
@@ -15,10 +15,16 @@
 #include "cong-dialog.h"
 #include "cong-error-dialog.h"
 
 #define CONVENIENCE_BUTTON_ID (0)
 
+/**
+ * cong_error_dialog_run:
+ * @dialog:
+ *
+ * TODO: Write me
+ */
 void
 cong_error_dialog_run(GtkDialog* dialog)
 {
 	gint result = gtk_dialog_run(dialog);
 	
@@ -42,18 +48,32 @@
 		}
 		break;
 	}
 }
 
+/**
+ * cong_error_dialog_do:
+ * @dialog:
+ *
+ * TODO: Write me
+ */
 void
 cong_error_dialog_do(GtkDialog* dialog)
 {
 	cong_error_dialog_run(dialog);
 	gtk_widget_destroy(GTK_WIDGET(dialog));
 }
 
-
+/**
+ * cong_error_dialog_new:
+ * @parent_window:
+ * @what_failed:
+ * @why_failed:
+ * @suggestions:
+ *
+ * TODO: Write me
+ */
 GtkDialog* 
 cong_error_dialog_new(GtkWindow *parent_window,
 		      const gchar* what_failed, 
 		      const gchar* why_failed, 
 		      const gchar* suggestions)
@@ -100,10 +120,22 @@
 
 	return GTK_DIALOG(dialog1);
 
 }
 
+/**
+ * cong_error_dialog_new_with_convenience:
+ * @parent_window:
+ * @what_failed:
+ * @why_failed:
+ * @suggestions:
+ * @convenience_label:
+ * @convenience_action:
+ * @convenience_data:
+ *
+ * TODO: Write me
+ */
 GtkDialog* 
 cong_error_dialog_new_with_convenience(GtkWindow *parent_window,
 				       const gchar* what_failed, 
 				       const gchar* why_failed, 
 				       const gchar* suggestions,
@@ -167,10 +199,19 @@
 	g_object_set_data(G_OBJECT(dialog),"convenience-data",convenience_data);
 
 	return GTK_DIALOG(dialog);
 }
 
+/**
+ * cong_error_dialog_new_from_unimplemented_feature:
+ * @parent_window:
+ * @what_failed:
+ * @filename:
+ * @linenum:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_unimplemented_feature(GtkWindow *parent_window,
 						 const gchar* what_failed, 
 						 const char* filename, 
 						 int linenum)
@@ -187,10 +228,21 @@
 	g_free(suggestion);
 
 	return dialog;
 }
 
+/**
+ * cong_error_dialog_new_from_unimplemented_feature_with_bugzilla_id:
+ * @parent_window:
+ * @what_failed:
+ * @filename:
+ * @linenum:
+ * @bugzilla_url:
+ * @bugzilla_id:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_unimplemented_feature_with_bugzilla_id(GtkWindow *parent_window,
 								  const gchar* what_failed, 
 								  const char* filename, 
 								  int linenum,
@@ -227,10 +279,19 @@
 
 
 /**
  * Routine to manufacture an error dialog for when some arbitrary operation fails but you have a GError available to you
  */
+/**
+ * cong_error_dialog_new_from_gerror:
+ * @toplevel_window:
+ * @what_failed:
+ * @details:
+ * @error:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_gerror(GtkWindow *toplevel_window,
 				  const gchar *what_failed,
 				  const char *details,
 				  GError *error)
@@ -269,10 +330,20 @@
 	/* FIXME: this will leak the details dialog */
 
 	return dialog;
 }
 
+/**
+ * cong_error_dialog_new_from_shell_command_failure_with_command_line:
+ * @parent_window:
+ * @what_failed:
+ * @exit_status:
+ * @standard_error:
+ * @command_line:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_shell_command_failure_with_command_line(GtkWindow *parent_window,
 								   const gchar *what_failed,
 								   gint exit_status,
 								   const gchar *standard_error,
@@ -335,10 +406,20 @@
 	gtk_widget_show_all(GTK_WIDGET(dialog));
 
 	return dialog;
 }
 
+/**
+ * cong_error_dialog_new_from_shell_command_failure_with_argv:
+ * @parent_window:
+ * @what_failed:
+ * @exit_status:
+ * @standard_error:
+ * @argv:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_shell_command_failure_with_argv(GtkWindow *parent_window,
 							   const gchar *what_failed,
 							   gint exit_status,
 							   const gchar *standard_error,
@@ -359,8 +440,6 @@
 										    standard_error,
 										    command_line);
 	g_free(command_line);
 
 	return dialog;
-		
-	
 }
Index: cong-error-file-open.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-error-file-open.c,v
retrieving revision 1.12
diff -u -5 -r1.12 cong-error-file-open.c
--- cong-error-file-open.c	13 Oct 2003 10:59:16 -0000	1.12
+++ cong-error-file-open.c	17 Apr 2004 17:45:25 -0000
@@ -17,10 +17,18 @@
 #include "cong-error-dialog.h"
 #include "cong-util.h"
 
 #include "cong-vfs.h"
 
+/**
+ * cong_error_split_filename:
+ * @filename:
+ * @filename_alone:
+ * @path:
+ *
+ * TODO: Write me
+ */
 void
 cong_error_split_filename(const gchar* filename, gchar** filename_alone, gchar** path)
 {
 	g_return_if_fail(filename);
 	g_return_if_fail(filename_alone);
@@ -30,10 +38,15 @@
 
 	*filename_alone=g_strdup("fubar.xml");
 	*path=g_strdup("/some_location/some_subdir");
 }
 
+/**
+ * cong_error_get_appname:
+ *
+ * Returns: a string containing "Conglomerate"
+ */
 gchar* 
 cong_error_get_appname(void)
 {
 	return g_strdup("Conglomerate");
 }
@@ -55,10 +68,17 @@
 							    "FIXME",
 							    "FIXME") );
 	}
 }
 
+/**
+ * cong_error_what_failed_on_file_open_failure:
+ * @string_uri:
+ * @transient:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_error_what_failed_on_file_open_failure (const gchar *string_uri, 
 					     gboolean transient)
 {
 	gchar* app_name;
@@ -90,10 +110,20 @@
 	g_free(app_name);	
 
 	return what_failed;
 }
 
+/**
+ * cong_error_dialog_new_from_file_open_failure:
+ * @parent_window:
+ * @string_uri:
+ * @transient:
+ * @why_failed:
+ * @suggestions:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_file_open_failure(GtkWindow *parent_window,
 					     const gchar* string_uri, 
 					     gboolean transient, 
 					     const gchar* why_failed, 
@@ -118,10 +148,23 @@
 	g_free(what_failed);
 	
 	return dialog;
 }
 
+/**
+ * cong_error_dialog_new_from_file_open_failure_with_convenience:
+ * @parent_window:
+ * @string_uri:
+ * @transient:
+ * @why_failed:
+ * @suggestions:
+ * @convenience_label:
+ * @convenience_action:
+ * @convenience_data:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_file_open_failure_with_convenience(GtkWindow *parent_window,
 							      const gchar *string_uri, 
 							      gboolean transient, 
 							      const gchar* why_failed, 
@@ -151,10 +194,18 @@
 	g_free(what_failed);
 	
 	return dialog;
 }
 
+/**
+ * cong_error_dialog_new_from_file_open_failure_with_vfs_result:
+ * @parent_window:
+ * @string_uri:
+ * @vfs_result:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_file_open_failure_with_vfs_result(GtkWindow *parent_window,
 							     const gchar *string_uri, 
 							     GnomeVFSResult vfs_result)
 {
@@ -415,10 +466,20 @@
 	GtkWidget *details_dialog = data;
 	gtk_dialog_run(GTK_DIALOG(details_dialog));
 	gtk_widget_destroy(details_dialog);
 }
 
+/**
+ * cong_error_dialog_new_from_file_operation_failure:
+ * @parent_window:
+ * @what_failed:
+ * @string_uri:
+ * @vfs_result:
+ * @technical_details:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_file_operation_failure(GtkWindow *parent_window,
 						  const gchar *what_failed,
 						  const gchar *string_uri, 
 						  GnomeVFSResult vfs_result, 
Index: cong-error-file-save.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-error-file-save.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-error-file-save.c
--- cong-error-file-save.c	13 Oct 2003 10:59:16 -0000	1.11
+++ cong-error-file-save.c	17 Apr 2004 17:45:25 -0000
@@ -16,10 +16,19 @@
 #include "cong-error-dialog.h"
 #include "cong-util.h"
 #include "cong-vfs.h"
 
 /* FIXME: i18n! */
+/**
+ * cong_error_dialog_new_from_file_save_failure:
+ * @parent_window:
+ * @string_uri:
+ * @vfs_result:
+ * @file_size:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_from_file_save_failure(GtkWindow *parent_window, 
 					     const gchar* string_uri, 
 					     GnomeVFSResult vfs_result, 
 					     const GnomeVFSFileSize* file_size)
@@ -367,7 +376,6 @@
 	g_free(app_name);
 
 	g_assert(dialog);
 
 	return dialog;
-
 }
Index: cong-error-tests.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-error-tests.c,v
retrieving revision 1.8
diff -u -5 -r1.8 cong-error-tests.c
--- cong-error-tests.c	13 Oct 2003 10:59:16 -0000	1.8
+++ cong-error-tests.c	17 Apr 2004 17:45:25 -0000
@@ -3,13 +3,22 @@
 #include <gtk/gtk.h>
 
 #include "global.h"
 #include "cong-error-dialog.h"
 
-void cong_error_test_file_ops(GtkWindow *parent_window, 
-			      const gchar* filename,
-			      GnomeVFSResult vfs_result)
+/**
+ * cong_error_test_file_ops:
+ * @parent_window:
+ * @filename:
+ * @vfs_result:
+ *
+ * TODO: Write me
+ */
+void 
+cong_error_test_file_ops(GtkWindow *parent_window, 
+			 const gchar* filename,
+			 GnomeVFSResult vfs_result)
 {
 	GtkDialog* dialog;
 
 	GnomeVFSFileSize file_size = 5*1024*1024; /* 5 megabytes, for a test */
 
@@ -34,11 +43,18 @@
 								   _("This dialog was generated by the automated testing routine"));
 	cong_error_dialog_run(GTK_DIALOG(dialog));		
 	gtk_widget_destroy(GTK_WIDGET(dialog));
 }
 
-void cong_error_tests(GtkWindow *parent_window)
+/**
+ * cong_error_tests:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_error_tests(GtkWindow *parent_window)
 {
 	int i;
 	for (i=(int)GNOME_VFS_ERROR_NOT_FOUND;i<(int)GNOME_VFS_NUM_ERRORS;i++) {
 
 		#define TEST_URI ("file:///home/david/test.xml")
Index: cong-file-export.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-export.c,v
retrieving revision 1.18
diff -u -5 -r1.18 cong-file-export.c
--- cong-file-export.c	8 Mar 2004 09:23:49 -0000	1.18
+++ cong-file-export.c	17 Apr 2004 17:45:25 -0000
@@ -313,11 +313,17 @@
 			  dialog_details);
 
 	return dialog;
 }
 
-
+/**
+ * cong_ui_hook_file_export:
+ * @doc:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_file_export (CongDocument *doc,
 			  GtkWindow *toplevel_window)
 {
 	GtkWidget *dialog;
Index: cong-file-import.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-import.c,v
retrieving revision 1.17
diff -u -5 -r1.17 cong-file-import.c
--- cong-file-import.c	5 Mar 2004 14:27:56 -0000	1.17
+++ cong-file-import.c	17 Apr 2004 17:45:25 -0000
@@ -59,10 +59,16 @@
 	if (cong_importer_supports_mime_type(importer, data->mime_type) ) {
 		*data->list_head = g_list_append(*data->list_head, importer);
 	}
 }
 
+/**
+ * cong_ui_hook_file_import:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_file_import (GtkWindow *toplevel_window)
 {
 	gchar *filename;
 
@@ -147,10 +153,19 @@
 		g_free(filename);
 	}
 
 }
 
+/**
+ * cong_file_import_dialog_run:
+ * @toplevel_window:
+ * @filename:
+ * @mime_type:
+ * @list_of_valid_importers:
+ *
+ * TODO: Write me
+ */
 CongServiceImporter*
 cong_file_import_dialog_run (GtkWindow *toplevel_window,
 			     const gchar *filename,
 			     const gchar* mime_type,
 			     GList *list_of_valid_importers)
Index: cong-file-new.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-new.c,v
retrieving revision 1.14
diff -u -5 -r1.14 cong-file-new.c
--- cong-file-new.c	22 Feb 2004 17:01:41 -0000	1.14
+++ cong-file-new.c	17 Apr 2004 17:45:25 -0000
@@ -98,38 +98,66 @@
 	if (pixbuf) {
 		g_object_unref (pixbuf);
 	}
 }
 
-gboolean first_page_of_factory_back(GnomeDruidPage *druidpage,
-				    GtkWidget *widget,
-				    gpointer user_data)
+/**
+ * first_page_of_factory_back:
+ * @druidpage:
+ * @widget:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+first_page_of_factory_back(GnomeDruidPage *druidpage,
+			   GtkWidget *widget,
+			   gpointer user_data)
 {
 	CongNewFileAssistant *assistant = user_data;
 
 	gnome_druid_set_page(GNOME_DRUID(assistant->druid), GNOME_DRUID_PAGE(assistant->second_page));
 
 	return TRUE;
 }
 
-gboolean last_page_of_factory_next(GnomeDruidPage *druidpage,
-				   GtkWidget *widget,
-				   gpointer user_data)
+/**
+ * last_page_of_factory_next:
+ * @druidpage:
+ * @widget:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+last_page_of_factory_next(GnomeDruidPage *druidpage,
+			  GtkWidget *widget,
+			  gpointer user_data)
 {
 	CongNewFileAssistant *assistant = user_data;
 
 	/* Store page, so that the final page's back button takes us back here: */
 	assistant->previous_page = druidpage;
 	gnome_druid_set_page(GNOME_DRUID(assistant->druid), GNOME_DRUID_PAGE(assistant->final_page));
 
 	return TRUE;
 }
 
-GnomeDruidPageStandard *cong_new_file_assistant_new_page(CongNewFileAssistant *assistant, 
-							 CongServiceDocumentFactory *document_factory, 
-							 gboolean is_first_of_factory,
-							 gboolean is_last_of_factory)
+/**
+ * cong_new_file_assistant_new_page:
+ * @assistant:
+ * @document_factory:
+ * @is_first_of_factory:
+ * @is_last_of_factory:
+ *
+ * TODO: Write me
+ */
+GnomeDruidPageStandard *
+cong_new_file_assistant_new_page(CongNewFileAssistant *assistant, 
+				 CongServiceDocumentFactory *document_factory, 
+				 gboolean is_first_of_factory,
+				 gboolean is_last_of_factory)
 {
 	GnomeDruidPageStandard *page;
 	gchar *title;
 
 	g_return_val_if_fail(assistant, NULL);
@@ -161,27 +189,51 @@
 	}
 
 	return page;
 }
 
-void cong_new_file_assistant_set_page(CongNewFileAssistant *assistant, GnomeDruidPage *page)
+/**
+ * cong_new_file_assistant_set_page:
+ * @assistant:
+ * @page:
+ *
+ * TODO: Write me
+ */
+void 
+cong_new_file_assistant_set_page(CongNewFileAssistant *assistant, GnomeDruidPage *page)
 {
 	g_return_if_fail(assistant);
 	g_return_if_fail(page);
 
 
 	gnome_druid_set_page(GNOME_DRUID(assistant->druid), page);
 	
 }
 
-GtkWindow *cong_new_file_assistant_get_toplevel(CongNewFileAssistant *assistant)
+/**
+ * cong_new_file_assistant_get_toplevel:
+ * @assistant:
+ *
+ * TODO: Write me
+ */
+GtkWindow *
+cong_new_file_assistant_get_toplevel(CongNewFileAssistant *assistant)
 {
 	g_return_val_if_fail (assistant, NULL);
 
 	return GTK_WINDOW(assistant->window);
 }
 
+/**
+ * cong_new_file_assistant_set_data_for_factory:
+ * @assistant:
+ * @document_factory:
+ * @factory_data:
+ * @free_func:
+ *
+ * TODO: Write me
+ */
 void
 cong_new_file_assistant_set_data_for_factory (CongNewFileAssistant *assistant,
 					      CongServiceDocumentFactory *document_factory,
 					      gpointer factory_data,
 					      void (*free_func) (gpointer factory_data))
@@ -206,10 +258,17 @@
 
 	per_factory_data->data = factory_data;
 	per_factory_data->free_func = free_func;
 }
 
+/**
+ * cong_new_file_assistant_get_data_for_factory:
+ * @assistant:
+ * @document_factory:
+ *
+ * TODO: Write me
+ */
 gpointer
 cong_new_file_assistant_get_data_for_factory (CongNewFileAssistant *assistant,
 					      CongServiceDocumentFactory *document_factory)
 {
 	PerFactoryData *per_factory_data;
@@ -240,11 +299,18 @@
 			    NEWDOCTYPELIST_FACTORY_COLUMN, factory,
 			    -1);
 
 }
 
-GtkWidget *make_type_selection_widget(CongNewFileAssistant *assistant)
+/**
+ * make_type_selection_widget:
+ * @assistant:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+make_type_selection_widget(CongNewFileAssistant *assistant)
 {
 	/* FIXME:  didn't work very well when I added a scrolled window */
 #if 0
 	GtkWidget *scrolled_window;
 #endif
@@ -305,13 +371,22 @@
 	gtk_widget_show(scrolled_window);
 	return scrolled_window;
 #endif
 }
 
-void second_page_prepare(GnomeDruidPage *druidpage,
-			 GtkWidget *widget,
-			 gpointer user_data)
+/**
+ * second_page_prepare:
+ * @druidpage:
+ * @widget:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+second_page_prepare(GnomeDruidPage *druidpage,
+		    GtkWidget *widget,
+		    gpointer user_data)
 {
 	CongNewFileAssistant *assistant = user_data;
 
 #if DEBUG_FILE_NEW_ASSISTANT
 	g_message("second_page_prepare");
@@ -323,13 +398,22 @@
 					  TRUE, /* gboolean cancel_sensitive, */
 					  TRUE); /* gboolean help_sensitive */
 
 }
 
-gboolean second_page_next(GnomeDruidPage *druidpage,
-			  GtkWidget *widget,
-			  gpointer user_data)
+/**
+ * second_page_next:
+ * @druidpage:
+ * @widget:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+second_page_next(GnomeDruidPage *druidpage,
+		 GtkWidget *widget,
+		 gpointer user_data)
 {
 	CongNewFileAssistant *assistant = user_data;
 	GtkTreeSelection* tree_selection;
 	GtkTreeModel *tree_model;
 	GtkTreeIter iter;
@@ -383,25 +467,43 @@
 		return TRUE;
 	}
 
 }
 
-gboolean final_page_back(GnomeDruidPage *druidpage,
-			 GtkWidget *widget,
-			 gpointer user_data)
+/**
+ * final_page_back:
+ * @druidpage:
+ * @widget:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+final_page_back(GnomeDruidPage *druidpage,
+		GtkWidget *widget,
+		gpointer user_data)
 {
 	CongNewFileAssistant *assistant = user_data;
 
 	/* go back to the stored previous page: */
 	gnome_druid_set_page(GNOME_DRUID(assistant->druid), GNOME_DRUID_PAGE(assistant->previous_page));
 
 	return TRUE;
 }
 
-gboolean final_page_finish(GnomeDruidPage *druidpage,
-			   GtkWidget *widget,
-			   gpointer user_data)
+/**
+ * final_page_finish:
+ * @druidpage:
+ * @widget:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+final_page_finish(GnomeDruidPage *druidpage,
+		  GtkWidget *widget,
+		  gpointer user_data)
 {
 	CongNewFileAssistant *assistant = user_data;
 	GtkTreeSelection* tree_selection;
 	GtkTreeModel *tree_model;
 	GtkTreeIter iter;
@@ -434,11 +536,10 @@
 
 	} else {
 		g_warning("No selected factory");
 	}
 
-
 	return TRUE;
 }
 
 static void
 add_pages_for_factory_callback (CongServiceDocumentFactory *factory, 
@@ -458,11 +559,18 @@
 
 	/* Invoke the callback to create pages: */
 	cong_document_factory_invoke_page_creation_callback(factory, assistant);
 }
 
-void new_document(GtkWindow *parent_window)
+/**
+ * new_document:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+void 
+new_document(GtkWindow *parent_window)
 {
 	CongNewFileAssistant *assistant;
 
 	assistant = g_new0(CongNewFileAssistant,1);
 
@@ -550,11 +658,20 @@
 	CONG_DO_UNIMPLEMENTED_DIALOG("The selected menu item has not yet been implemented.");
 #endif
 
 	/* FIXME:  need to sort out memory leaks */
 }
-gint toolbar_callback_new(GtkWidget *widget, gpointer data)
+
+/**
+ * toolbar_callback_new:
+ * @widget:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_new(GtkWidget *widget, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 
 	new_document(cong_primary_window_get_toplevel(primary_window));
 
Index: cong-file-open.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-open.c,v
retrieving revision 1.16
diff -u -5 -r1.16 cong-file-open.c
--- cong-file-open.c	23 Nov 2003 20:57:06 -0000	1.16
+++ cong-file-open.c	17 Apr 2004 17:45:25 -0000
@@ -21,11 +21,18 @@
 	xmlDocPtr doc;
 	CongDispspec *ds;
 	const gchar *filename_extension;
 };
 
-void force_load(gpointer data)
+/**
+ * force_load:
+ * @data:
+ *
+ * TODO: Write me
+ */
+void 
+force_load(gpointer data)
 {
 	struct force_dialog *the_dlg = (struct force_dialog*)data;
 
 	g_assert(the_dlg);
 	g_assert(the_dlg->doc);
@@ -35,10 +42,19 @@
 								the_dlg->filename_extension);
 
 	g_assert(the_dlg->ds);
 }
 
+/**
+ * query_for_forced_dispspec:
+ * @what_failed:
+ * @doc:
+ * @parent_window:
+ * @filename_extension:
+ *
+ * TODO: Write me
+ */
 CongDispspec* 
 query_for_forced_dispspec (gchar *what_failed, 
 			   xmlDocPtr doc, 
 			   GtkWindow *parent_window,
 			   const gchar *filename_extension)
@@ -68,10 +84,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * get_filename_extension:
+ * @uri:
+ *
+ * TODO: Write me
+ */
 gchar*
 get_filename_extension (const GnomeVFSURI *uri)
 {
 	gchar *result = NULL;
 	gchar *short_name;
@@ -90,10 +112,17 @@
 	g_free (short_name);
 
 	return result;
 }
 
+/**
+ * open_document_do:
+ * @doc_name:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void 
 open_document_do (const gchar* doc_name, 
 		  GtkWindow *parent_window)
 {
 	CongDispspec *ds;
@@ -156,13 +185,18 @@
 	cong_primary_window_new(cong_doc);
 	g_object_unref( G_OBJECT(cong_doc));
 
 }
 
-
-
-void open_document(GtkWindow *parent_window)
+/**
+ * open_document:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+void 
+open_document(GtkWindow *parent_window)
 {
 	char *doc_name;
 
 	g_return_if_fail(parent_window);
 	
@@ -178,11 +212,19 @@
 	open_document_do(doc_name, parent_window);
 
 	g_free(doc_name);
 }
 
-gint toolbar_callback_open(GtkWidget *widget, gpointer data)
+/**
+ * toolbar_callback_open:
+ * @widget:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_open(GtkWidget *widget, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 
 	open_document(cong_primary_window_get_toplevel(primary_window));
 
Index: cong-file-print.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-print.c,v
retrieving revision 1.11
diff -u -5 -r1.11 cong-file-print.c
--- cong-file-print.c	11 Feb 2004 17:35:56 -0000	1.11
+++ cong-file-print.c	17 Apr 2004 17:45:26 -0000
@@ -341,19 +341,33 @@
 	gtk_widget_destroy(dialog);
 	g_free(dialog_details);
 }
 
 
+/**
+ * cong_ui_hook_file_print_preview:
+ * @doc:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_file_print_preview (CongDocument *doc,
 				 GtkWindow *toplevel_window)
 {
 	do_ui_file_print(doc,
 			 toplevel_window,
 			 TRUE);
 }
 
+/**
+ * cong_ui_hook_file_print:
+ * @doc:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_file_print (CongDocument *doc,
 			 GtkWindow *toplevel_window)
 {
 	do_ui_file_print(doc,
Index: cong-file-properties.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-properties.c,v
retrieving revision 1.16
diff -u -5 -r1.16 cong-file-properties.c
--- cong-file-properties.c	8 Mar 2004 09:23:49 -0000	1.16
+++ cong-file-properties.c	17 Apr 2004 17:45:26 -0000
@@ -199,10 +199,17 @@
 					      _("_Add a DTD"));
 		}
 	}	
 }
 
+/**
+ * cong_file_properties_dialog_new:
+ * @doc:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_file_properties_dialog_new (CongDocument *doc, 
 				 GtkWindow *parent_window)
 {
 	xmlDocPtr xml_doc;
Index: cong-file-save.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-file-save.c,v
retrieving revision 1.6
diff -u -5 -r1.6 cong-file-save.c
--- cong-file-save.c	11 Feb 2004 15:54:23 -0000	1.6
+++ cong-file-save.c	17 Apr 2004 17:45:26 -0000
@@ -30,19 +30,35 @@
 #include "cong-document.h"
 #include "cong-primary-window.h"
 #include "cong-file-selection.h"
 #include "cong-ui-hooks.h"
 
-gint toolbar_callback_save(GtkWidget *w, gpointer data)
+/**
+ * toolbar_callback_save:
+ * @w:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_save(GtkWidget *w, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	return save_document(doc, cong_primary_window_get_toplevel(primary_window));
 }
 
-gint save_document_as(CongDocument *doc, GtkWindow *parent_window)
+/**
+ * save_document_as:
+ * @doc:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+gint 
+save_document_as(CongDocument *doc, GtkWindow *parent_window)
 {
 	char *current_doc_name;
 	char *new_doc_name;
 
 	g_return_val_if_fail(doc, FALSE);
@@ -68,11 +84,19 @@
 	g_free(new_doc_name);
 	
 	return TRUE;
 }
 
-gint save_document(CongDocument *doc, GtkWindow *parent_window) 
+/**
+ * save_document:
+ * @doc:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+gint 
+save_document(CongDocument *doc, GtkWindow *parent_window) 
 {
 	gchar *doc_name;
 
 	g_return_val_if_fail(doc, FALSE);
 
Index: cong-font.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-font.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-font.c
--- cong-font.c	4 Feb 2004 16:24:21 -0000	1.9
+++ cong-font.c	17 Apr 2004 17:45:26 -0000
@@ -32,10 +32,18 @@
 	PangoFontDescription *font_desc;
 	PangoFont *pango_font;
 	PangoLayout *pango_layout;
 };
 
+/**
+ * cong_font_load:
+ * @font_name: The name of the font to load
+ *
+ * Loads a font named @font_name
+ *
+ * Returns: The #CongFont
+ */
 CongFont*
 cong_font_load(const gchar *font_name)
 {
 	CongFont *font;
 	g_return_val_if_fail(font_name, NULL);
@@ -58,16 +66,31 @@
 	pango_layout_set_width(font->pango_layout,-1);
 
 	return font;	
 }
 
+/**
+ * cong_font_delete:
+ * @font: a #CongFont
+ *
+ * Unimplemented
+ */
 void
 cong_font_delete(CongFont *font)
 {
 	g_assert(0); /* unimplemented */
 }
 
+/**
+ * cong_font_get_height:
+ * @font: a #CongFont
+ * @text: a string to render
+ *
+ * Computes the height, in pixels, of @text rendered in @font.
+ * 
+ * Returns: height, in pixels, of @text rendered in @font
+ */
 gint
 cong_font_get_height(CongFont *font,
 		     const gchar *text) 
 {
 	gint result;
@@ -85,18 +108,35 @@
 				    &result);
 	
 	return result;
 }
 
+/**
+ * cong_font_get_pango_description:
+ * @font: a #CongFont
+ *
+ * Returns: the #PangoFontDescription for @font
+ */
 PangoFontDescription*
 cong_font_get_pango_description(CongFont *font)
 {
 	g_return_val_if_fail(font,NULL);
 
 	return font->font_desc;	
 }
 
+/**
+ * cong_font_draw_string_slow:
+ * @drawable: a #GdkDrawable
+ * @font: a #CongFont
+ * @gc: a #GdkGC
+ * @text: a string
+ * @x: a #gint
+ * @y: a #gint
+ *
+ * TODO: Write me
+ */
 void
 cong_font_draw_string_slow(GdkDrawable *drawable,
 			   CongFont *font, 
 			   GdkGC *gc,
 			   const gchar *text,
@@ -146,10 +186,17 @@
 			x, 
 			adjusted_y,
 			font->pango_layout);
 }
 
+/**
+ * cong_font_string_width_slow:
+ * @font: a #CongFont
+ * @text: the string to be rendered
+ *
+ * Returns: The width, in pixels, of @text rendered in @font
+ */
 gint
 cong_font_string_width_slow(CongFont *font, 
 			    const gchar *text)
 {
 	gint result;
Index: cong-graph.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-graph.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-graph.c
--- cong-graph.c	14 May 2003 12:00:43 -0000	1.1
+++ cong-graph.c	17 Apr 2004 17:45:26 -0000
@@ -13,54 +13,101 @@
 const CongDependencyNodeClass klass_pure_dependency = {
 	cong_dependency_node_from_file_is_up_to_date,
 	NULL
 };
 
-CongDependencyNode *cong_dependency_node_new_from_file(GnomeVFSURI *uri)
+/**
+ * cong_dependency_node_new_from_file:
+ * @uri:
+ *
+ * TODO: Write me
+ *
+ * Returns: the new #CongDependencyNode
+ */
+CongDependencyNode *
+cong_dependency_node_new_from_file(GnomeVFSURI *uri)
 {
 	CongDependencyNodeFromFile *node;
 
 	node = g_new0(CongDependencyNodeFromFile,1);
 
 	construct_dependency_node_from_file(node, &klass_pure_dependency, uri);
 
 	return CONG_DEPENDENCY_NODE(node);
 }
 
-void construct_dependency_node_from_file(CongDependencyNodeFromFile *node, const CongDependencyNodeClass *klass, GnomeVFSURI *uri)
+/**
+ * construct_dependency_node_from_file:
+ * @node:
+ * @klass
+ * @uri:
+ * 
+ * TODO: Write me
+ */
+void 
+construct_dependency_node_from_file(CongDependencyNodeFromFile *node, const CongDependencyNodeClass *klass, GnomeVFSURI *uri)
 {
 	node->base.klass = klass;
 	node->base.debug_name = gnome_vfs_uri_to_string(uri, GNOME_VFS_URI_HIDE_PASSWORD);	
 	
 	node->uri = uri;
 	gnome_vfs_uri_ref(uri);
 }
 
-void cong_dependency_node_add_dependency(CongDependencyNode *downstream, CongDependencyNode *upstream)
+/**
+ * cong_dependency_node_add_dependency:
+ * @downstream:
+ * @upstream:
+
+ * TODO: Write me
+ */
+void 
+cong_dependency_node_add_dependency(CongDependencyNode *downstream, CongDependencyNode *upstream)
 {
 	g_return_if_fail(downstream);
 	g_return_if_fail(upstream);
 
 	downstream->list_of_upstream = g_list_append(downstream->list_of_upstream, upstream);
 	upstream->list_of_downstream = g_list_append(upstream->list_of_downstream, downstream);
 }
 
-CongDependencyGraph *cong_dependency_graph_new(void)
+/**
+ * cong_dependency_graph_new:
+ *
+ * Returns: a new #CongDependencyGraph
+ */
+CongDependencyGraph *
+cong_dependency_graph_new(void)
 {
 	return g_new0(CongDependencyGraph,1);
 }
 
-void cong_dependency_graph_add_ultimate_node(CongDependencyGraph *graph, CongDependencyNode *node)
+/**
+ * cong_dependency_graph_add_ultimate_node:
+ * @graph:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_dependency_graph_add_ultimate_node(CongDependencyGraph *graph, CongDependencyNode *node)
 {
 	g_return_if_fail(graph);
 	g_return_if_fail(node);
 
 	graph->list_of_ultimate_targets = g_list_append(graph->list_of_ultimate_targets, node);
 }
 
-
-static gboolean brute_force_build(CongDependencyNode* node, GError **error)
+/**
+ * brute_force_build:
+ * @node:
+ * @error:
+ *
+ * TODO: Write me
+ */
+static gboolean 
+brute_force_build(CongDependencyNode* node, GError **error)
 {
 	GList *iter;
 
 	g_return_val_if_fail (node, FALSE);
 	g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
@@ -87,11 +134,21 @@
 	}
 
 	return TRUE;	
 }
 
-gboolean cong_dependency_graph_process(CongDependencyGraph *graph, GError **error)
+/**
+ * cong_dependency_graph_process:
+ * @graph:
+ * @error:
+ *
+ * TODO: Write me
+ *
+ * Returns:
+ */
+gboolean 
+cong_dependency_graph_process(CongDependencyGraph *graph, GError **error)
 {
 	GList *iter;
 
 	g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
 	g_return_val_if_fail (graph, FALSE);
@@ -105,10 +162,19 @@
 	}	
 
 	return TRUE;
 }
 
-gboolean cong_dependency_node_from_file_is_up_to_date(CongDependencyNode *target)
+/**
+ * cong_dependency_node_from_file_is_up_to_date:
+ * @target: a #CongDependencyNode
+ *
+ * This function is not currently implemented.
+ *
+ * Returns: FALSE
+ */
+gboolean
+cong_dependency_node_from_file_is_up_to_date(CongDependencyNode *target)
 {
 	return FALSE; /* for now */
 }
 
Index: cong-location.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-location.c,v
retrieving revision 1.39
diff -u -5 -r1.39 cong-location.c
--- cong-location.c	3 Mar 2004 21:26:23 -0000	1.39
+++ cong-location.c	17 Apr 2004 17:45:26 -0000
@@ -9,10 +9,16 @@
 #include "cong-error-dialog.h"
 #include "cong-util.h"
 #include "cong-command.h"
 
  
+/**
+ * cong_location_is_valid:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_location_is_valid(const CongLocation *loc)
 {
 	enum CongNodeType type;
 	
@@ -47,19 +53,32 @@
 			}			
 		}
 	}
 }
 
+/**
+ * cong_location_nullify:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_nullify(CongLocation *loc)
 {
 	g_return_if_fail(loc != NULL);
 	
 	loc->node=NULL;
 	loc->byte_offset=CONG_LOCATION_BYTE_OFFSET_NULL_NODE; /* for good measure */
 }
 
+/**
+ * cong_location_set_to_start_of_node:
+ * @loc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_set_to_start_of_node(CongLocation *loc, CongNodePtr node)
 {
 	g_return_if_fail(loc != NULL);
 	g_return_if_fail(node != NULL);
@@ -76,10 +95,17 @@
 			loc->byte_offset = 0;
 			break;
 	}
 }
 
+/**
+ * cong_location_set_to_end_of_node:
+ * @loc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_set_to_end_of_node(CongLocation *loc, CongNodePtr node)
 {
 	g_return_if_fail(loc != NULL);
 	g_return_if_fail(node != NULL);
@@ -96,10 +122,18 @@
 			loc->byte_offset = strlen (node->content);
 			break;
 	}
 }
 
+/**
+ * cong_location_set_node_and_byte_offset:
+ * @loc:
+ * @node:
+ * @offset:
+ *
+ * TODO: Write me
+ */
 void 
 cong_location_set_node_and_byte_offset(CongLocation *loc, CongNodePtr node, int offset)
 {
 	g_return_if_fail(loc != NULL);
 	g_assert(node);
@@ -115,10 +149,18 @@
 	loc->byte_offset=offset;
 
 	g_assert(cong_location_is_valid(loc));
 }
 
+/**
+ * cong_location_set_node_and_char_offset:
+ * @loc:
+ * @node:
+ * @char_offset:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_set_node_and_char_offset(CongLocation *loc, CongNodePtr node, glong char_offset)
 {
 	gchar *result_pos;
 
@@ -138,20 +180,31 @@
 	loc->byte_offset = result_pos - (gchar*)node->content;
 
 	g_assert(cong_location_is_valid(loc));
 }
 
-
-
-
-gboolean cong_location_exists(const CongLocation *loc)
+/**
+ * cong_location_exists:
+ * @loc:
+ * 
+ * TODO: Write me
+ */
+gboolean 
+cong_location_exists(const CongLocation *loc)
 {
 	g_return_val_if_fail(loc != NULL, FALSE);
 	
 	return (loc->node!=NULL);
 }
 
+/**
+ * cong_location_equals:
+ * @loc0:
+ * @loc1:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_location_equals(const CongLocation *loc0, const CongLocation *loc1)
 {
 	g_return_val_if_fail(loc0 != NULL, FALSE);
 	g_return_val_if_fail(loc1 != NULL, FALSE);
@@ -166,42 +219,65 @@
 	}
 
 	return FALSE;	
 }
 
-
+/**
+ * cong_location_node_type:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 enum CongNodeType
 cong_location_node_type(const CongLocation *loc)
 {
 	g_return_val_if_fail(loc, CONG_NODE_TYPE_UNKNOWN);
 	g_return_val_if_fail(loc->node, CONG_NODE_TYPE_UNKNOWN);
 
 	return cong_node_type(loc->node);
 }
 
-gunichar cong_location_get_unichar(const CongLocation *loc)
+/**
+ * cong_location_get_unichar:
+ * @loc:
+ *
+ * TODO: Write me
+ */
+gunichar 
+cong_location_get_unichar(const CongLocation *loc)
 {
 	g_return_val_if_fail(loc != NULL, '\0');
 	g_return_val_if_fail(loc->node != NULL, '\0');
 	g_return_val_if_fail(cong_location_node_type(loc) == CONG_NODE_TYPE_TEXT, '\0');
 	
 	return g_utf8_get_char(xml_frag_data_nice(loc->node) + loc->byte_offset);
 }
 
+/**
+ * cong_location_get_utf7_pointer:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_location_get_utf8_pointer(const CongLocation *loc)
 {
 	g_return_val_if_fail(loc, NULL);
 
 	g_assert(0); /* unimplemented */
 
 	return NULL;
 }
 
-/*
-  Are both ELEMENT nodes of the same tag type?
-*/
+/**
+ * cong_node_is_same_tag:
+ * @n1: a #CongNodePtr
+ * @n2: a #CongNodePtr
+ *
+ * Returns: %TRUE if both element nodes are of the same tag type,
+ * %FALSE otherwise.
+ */
 gboolean
 cong_node_is_same_tag (CongNodePtr n1, 
 		       CongNodePtr n2)
 {
 	g_return_val_if_fail (n1, FALSE);
@@ -218,10 +294,17 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_node_is_pure_whitespace_text_node:
+ * @node: a #CongNodePtr
+ *
+ * Returns: %TRUE if @node is a text node and is entirely whitespace,
+ * returns %FALSE otherwise.
+ */
 gboolean
 cong_node_is_pure_whitespace_text_node (CongNodePtr node)
 {
 	g_return_val_if_fail (node, FALSE);
 
@@ -232,10 +315,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * merge_tags:
+ * @cmd:
+ * @predator:
+ * @victim:
+ *
+ * TODO: Write me
+ */
 static void
 merge_tags (CongCommand *cmd,
 	    CongNodePtr predator,
 	    CongNodePtr victim)
 {
@@ -270,10 +361,17 @@
 						victim);
 
 	cong_document_end_edit (doc);
 }
 
+/**
+ * handle_tag_merging:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 static void
 handle_tag_merging (CongDocument *doc,
 		    CongNodePtr node)
 {			
 	g_assert (CONG_NODE_TYPE_ELEMENT == cong_node_type(node));
@@ -319,10 +417,17 @@
 		}
 	}
 
 }
 
+/**
+ * cong_location_del_next_char:
+ * @doc:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_del_next_char (CongDocument *doc, 
 			     const CongLocation *loc)
 {
 	g_return_if_fail(cong_location_exists(loc));
@@ -382,60 +487,106 @@
 			}
 		}
 	}
 }
 
+/**
+ * cong_location_xml_frag_prev:
+ * @loc: a #CongLocation
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_location_xml_frag_prev(const CongLocation *loc)
 {
 	return cong_node_prev(loc->node);
 }
 
+/**
+ * cong_location_xml_frag_next:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_location_xml_frag_next(const CongLocation *loc)
 {
 	return cong_node_next(loc->node);
 }
 
+/**
+ * cong_location_node:
+ * @loc:
+ * 
+ * TODO: Write me
+ */
 CongNodePtr
 cong_location_node(const CongLocation *loc)
 {
 	return loc->node;
 }
 
+/**
+ * cong_location_parent:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_location_parent(const CongLocation *loc)
 {
 	g_return_val_if_fail(loc != NULL, NULL);
 	g_return_val_if_fail(loc->node != NULL, NULL);
 
 	return loc->node->parent;
 }
 
-
+/**
+ * cong_location_copy:
+ * @dst:
+ * @src:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_copy(CongLocation *dst, const CongLocation *src)
 {
 	g_return_if_fail(dst != NULL);
 	g_return_if_fail(src != NULL);
 	
 	*dst = *src;
 }
 
+/**
+ * is_valid_cusor_node:
+ * @node:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 static gboolean
 is_valid_cursor_node (CongNodePtr node,
 		      gpointer user_data)
 {
 	g_return_val_if_fail (node, FALSE);
 	g_return_val_if_fail (user_data, FALSE); /* user_data is a CongDispspec */
 
 	return cong_node_is_valid_cursor_location (node);
 }
 
-gboolean cong_location_calc_prev_char(const CongLocation *input_loc, 
-				      CongDispspec *dispspec,
-				      CongLocation *output_loc)
+/**
+ * cong_location_calc_prev_char:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_prev_char(const CongLocation *input_loc, 
+			     CongDispspec *dispspec,
+			     CongLocation *output_loc)
 {
 	CongNodePtr n;
 
 #ifndef RELEASE	
 	printf("<- [curs]\n");
@@ -478,12 +629,20 @@
 	} else {
 		return FALSE;
 	}
 }
 
-
-gboolean cong_location_calc_next_char(const CongLocation *input_loc,
+/**
+ * cong_location_calc_next_char:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_next_char(const CongLocation *input_loc,
 				      CongDispspec *dispspec,
 				      CongLocation *output_loc)
 {
 	CongNodePtr n;
 
@@ -530,14 +689,24 @@
 
 	/* No next node found. */
 	return FALSE;
 }
 
-static void make_pango_log_attr_for_node(CongDocument *doc,
-					 CongNodePtr node,
-					 PangoLogAttr **pango_log_attrs,
-					 int *attrs_len)
+/**
+ * make_pango_log_attr_for_node:
+ * @doc:
+ * @node:
+ * @pango_log_attrs:
+ * @attrs_len:
+ *
+ * TODO: Write me
+ */
+static void 
+make_pango_log_attr_for_node(CongDocument *doc,
+			     CongNodePtr node,
+			     PangoLogAttr **pango_log_attrs,
+			     int *attrs_len)
 {
 	PangoLanguage *language;
 
 	g_return_if_fail(doc);
 	g_return_if_fail(node);
@@ -558,13 +727,22 @@
 			    *pango_log_attrs,
 			    *attrs_len);
 
 }
 
-gboolean cong_location_calc_prev_word(const CongLocation *input_loc, 
-				      CongDocument *doc,
-				      CongLocation *output_loc)
+/**
+ * cong_location_calc_prev_word:
+ * @input_loc:
+ * @doc:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_prev_word(const CongLocation *input_loc, 
+			     CongDocument *doc,
+			     CongLocation *output_loc)
 {
 	PangoLogAttr *pango_log_attr=NULL;
 	int attrs_len=0;
 
 	g_return_val_if_fail(input_loc, FALSE);
@@ -609,13 +787,22 @@
 	} else {
 		return FALSE;
 	}
 }
 
-gboolean cong_location_calc_next_word(const CongLocation *input_loc, 
-				      CongDocument *doc,
-				      CongLocation *output_loc)
+/**
+ * cong_location_calc_next_word:
+ * @input_loc:
+ * @doc:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_next_word(const CongLocation *input_loc, 
+			     CongDocument *doc,
+			     CongLocation *output_loc)
 {
 	PangoLogAttr *pango_log_attr=NULL;
 	int attrs_len=0;
 
 	g_return_val_if_fail(input_loc, FALSE);
@@ -657,10 +844,16 @@
 	} else {
 		return FALSE;
 	}
 }
 
+/**
+ * get_root_node:
+ * @node:
+ *
+ * TODO: Write me
+ */
 static CongNodePtr
 get_root_node (CongNodePtr node)
 {
 	g_assert (node);
 
@@ -669,10 +862,17 @@
 	}
 
 	return node;
 }
 
+/**
+ * get_enclosing_structural_element:
+ * @node:
+ * @dispspec:
+ *
+ * TODO: Write me
+ */
 static CongNodePtr
 get_enclosing_structural_element (CongNodePtr node,
 				  const CongDispspec *dispspec)
 {
 	g_assert (node);
@@ -703,13 +903,22 @@
 
 	/* Not found: */
 	return NULL;
 }
 
-gboolean cong_location_calc_document_start(const CongLocation *input_loc, 
-					   CongDispspec *dispspec,
-					   CongLocation *output_loc)
+/**
+ * cong_location_calc_document_start:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_document_start(const CongLocation *input_loc, 
+				  CongDispspec *dispspec,
+				  CongLocation *output_loc)
 {
 	CongNodePtr root_node;
 
 	g_return_val_if_fail(input_loc, FALSE);
 	g_return_val_if_fail(dispspec, FALSE);
@@ -726,13 +935,23 @@
 		}
 	}
 
 	return FALSE;
 }
-gboolean cong_location_calc_line_start(const CongLocation *input_loc, 
-				      CongDispspec *dispspec,
-				      CongLocation *output_loc)
+
+/**
+ * cong_location_calc_line_start:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_line_start(const CongLocation *input_loc, 
+			      CongDispspec *dispspec,
+			      CongLocation *output_loc)
 {
 	CongNodePtr enclosing_structural_element;
 
 	g_return_val_if_fail(input_loc, FALSE);
 	g_return_val_if_fail(dispspec, FALSE);
@@ -754,13 +973,22 @@
 	}
 
 	return FALSE;
 }
 
-gboolean cong_location_calc_document_end(const CongLocation *input_loc, 
-					 CongDispspec *dispspec,
-					 CongLocation *output_loc)
+/**
+ * cong_location_calc_document_end:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_document_end(const CongLocation *input_loc, 
+				CongDispspec *dispspec,
+				CongLocation *output_loc)
 {
 	CongNodePtr root_node;
 
 	g_return_val_if_fail(input_loc, FALSE);
 	g_return_val_if_fail(dispspec, FALSE);
@@ -778,13 +1006,22 @@
 	}
 
 	return FALSE;
 }
 
-gboolean cong_location_calc_line_end(const CongLocation *input_loc, 
-				     CongDispspec *dispspec,
-				     CongLocation *output_loc)
+/**
+ * cong_location_calc_line_end:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_line_end(const CongLocation *input_loc, 
+			    CongDispspec *dispspec,
+			    CongLocation *output_loc)
 {
 	CongNodePtr enclosing_structural_element;
 
 	g_return_val_if_fail(input_loc, FALSE);
 	g_return_val_if_fail(dispspec, FALSE);
@@ -806,36 +1043,63 @@
 	}
 
 	return FALSE;
 }
 
-gboolean cong_location_calc_prev_page(const CongLocation *input_loc, 
-				      CongDispspec *dispspec,
-				      CongLocation *output_loc)
+/**
+ * cong_location_calc_prev_page:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_prev_page(const CongLocation *input_loc, 
+			     CongDispspec *dispspec,
+			     CongLocation *output_loc)
 {
 	g_return_val_if_fail(input_loc, FALSE);
 	g_return_val_if_fail(dispspec, FALSE);
 	g_return_val_if_fail(output_loc, FALSE);
 
 	CONG_DO_UNIMPLEMENTED_DIALOG(NULL, _("Calculating previous page"));
 
 	return FALSE;
 }
 
-gboolean cong_location_calc_next_page(const CongLocation *input_loc, 
-				      CongDispspec *dispspec,
-				      CongLocation *output_loc)
+/**
+ * cong_location_calc_next_page:
+ * @input_loc:
+ * @dispspec:
+ * @output_loc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_location_calc_next_page(const CongLocation *input_loc, 
+			     CongDispspec *dispspec,
+			     CongLocation *output_loc)
 {
 	g_return_val_if_fail(input_loc, FALSE);
 	g_return_val_if_fail(dispspec, FALSE);
 	g_return_val_if_fail(output_loc, FALSE);
 
 	CONG_DO_UNIMPLEMENTED_DIALOG(NULL, _("Calculating next page"));
 
 	return FALSE;
 }
 
+/**
+ * cong_location_calc_word_extent:
+ * @input_loc:
+ * @doc:
+ * @output_start_of_word:
+ * @output_end_of_word:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_location_calc_word_extent(const CongLocation *input_loc, 
 			       CongDocument *doc,
 			       CongLocation *output_start_of_word, 
 			       CongLocation *output_end_of_word)
@@ -924,10 +1188,18 @@
 {
 #error
 }
 #endif
 
+/**
+ * cong_location_copy_with_ref:
+ * @doc:
+ * @dst:
+ * @src:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_copy_with_ref (CongDocument *doc, 
 			     CongLocation *dst,
 			     const CongLocation *src)
 {
@@ -944,10 +1216,17 @@
 	if (old_node) {
 		cong_document_node_unref (doc, old_node);
 	}
 }
 
+/**
+ * cong_location_nullify_with_ref:
+ * @doc:
+ * @loc:
+ *
+ * TODO: Write me
+ */
 void
 cong_location_nullify_with_ref (CongDocument *doc, 
 				CongLocation *loc)
 {
 	if (loc->node) {
Index: cong-menus.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-menus.c,v
retrieving revision 1.57
diff -u -5 -r1.57 cong-menus.c
--- cong-menus.c	5 Mar 2004 14:27:56 -0000	1.57
+++ cong-menus.c	17 Apr 2004 17:45:26 -0000
@@ -68,11 +68,18 @@
 extern char *ilogo_xpm[];
 
 #define ENABLE_DEBUG_MENU 0
 #define ENABLE_UNIMPLEMENTED_MENUS 1
 
-GtkWidget* make_uneditable_text(const gchar* text)
+/**
+ * make_uneditable_text:
+ * @text:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+make_uneditable_text(const gchar* text)
 {
 #if 1
 	GtkWidget *widget = gtk_label_new(text);
 	gtk_label_set_justify(GTK_LABEL(widget), GTK_JUSTIFY_LEFT);
 	gtk_label_set_line_wrap(GTK_LABEL(widget), TRUE);
@@ -88,13 +95,22 @@
 }
 
 
 
 /* Handy routines for implementing menu callbacks: */
-void unimplemented_menu_item(gpointer callback_data,
-			     guint callback_action,
-			     GtkWidget *widget)
+/**
+ * unimplemented_menu_item:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+unimplemented_menu_item(gpointer callback_data,
+			guint callback_action,
+			GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	CONG_DO_UNIMPLEMENTED_DIALOG(cong_primary_window_get_toplevel(primary_window), 
 				     _("The selected menu item has not yet been implemented."));
 }
@@ -399,25 +415,48 @@
 	cong_ui_hook_edit_preferences (cong_primary_window_get_toplevel (primary_window));
 }
 
 /* Callbacks for "Debug" menu: */
 #if ENABLE_DEBUG_MENU
-void debug_error(CongPrimaryWindow *primary_window)
+/**
+ * debug_error:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+void 
+debug_error(CongPrimaryWindow *primary_window)
 {
 	cong_error_tests(cong_primary_window_get_toplevel(primary_window));
 }
 
-void menu_callback_debug_error(gpointer callback_data,
-			       guint callback_action,
-			       GtkWidget *widget)
+/**
+ * menu_callback_debug_error:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_error(gpointer callback_data,
+			  guint callback_action,
+			  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	debug_error(primary_window); 
 }
 
-void open_preview_window_for_doc(xmlDocPtr doc)
+/**
+ * open_preview_window_for_doc:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+open_preview_window_for_doc(xmlDocPtr doc)
 {
 #if 1
 	/* Save it to a temp file and invoke user's favourite browser: */
 	g_assert(0);
 #else
@@ -432,12 +471,20 @@
 
 	html_view_set_document(HTML_VIEW(html_view), html_document);
 #endif
 }
 
-void open_transformed_window_for_doc(xmlDocPtr doc, 
-				     GtkWindow *parent_window)
+/**
+ * open_transformed_window_for_doc:
+ * @doc:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+void 
+open_transformed_window_for_doc(xmlDocPtr doc, 
+				GtkWindow *parent_window)
 {
 	/* Hackish test: */
 
 	CongDispspec *ds;
 	CongDocument *cong_doc;
@@ -470,13 +517,20 @@
 	cong_primary_window_new(cong_doc);
 
 	g_object_unref(G_OBJECT(cong_doc));
 }
 
-
-void debug_transform(CongPrimaryWindow *primary_window,
-		    const gchar *stylesheet_filename)
+/**
+ * debug_transform:
+ * @primary_window:
+ * @stylesheet_filename:
+ *
+ * TODO: Write me
+ */
+void 
+debug_transform(CongPrimaryWindow *primary_window,
+		const gchar *stylesheet_filename)
 {
 	CongDocument *doc;
 
 	/* Hackish test of libxslt */
 	xsltStylesheetPtr xsl;
@@ -563,47 +617,96 @@
 #define DOCBOOK_TO_XHTML_STYLESHEET_FILE ("xhtml/docbook.xsl")
 #define DOCBOOK_TO_HTML_HELP_STYLESHEET_FILE ("htmlhelp/htmlhelp.xsl")
 #define DOCBOOK_TO_JAVAHELP_STYLESHEET_FILE ("javahelp/javahelp.xsl")
 #define DOCBOOK_TO_FO_STYLESHEET_FILE ("fo/docbook.xsl")
 
-void menu_callback_debug_transform_docbook_to_html(gpointer callback_data,
+/**
+ * menu_callback_debug_transform_docbook_to_html:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_transform_docbook_to_html(gpointer callback_data,
 				  guint callback_action,
 				  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	debug_transform (primary_window,
 			 DOCBOOK_TO_HTML_STYLESHEET_FILE);
 }
-void menu_callback_debug_transform_docbook_to_xhtml(gpointer callback_data,
+
+/**
+ * menu_callback_debug_transform_docbook_to_xhtml:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_transform_docbook_to_xhtml(gpointer callback_data,
 						  guint callback_action,
 						  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	debug_transform (primary_window,
 			 DOCBOOK_TO_XHTML_STYLESHEET_FILE);
 }
-void menu_callback_debug_transform_docbook_to_html_help(gpointer callback_data,
+
+/**
+ * menu_callback_debug_transform_docbook_to_html_help:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_transform_docbook_to_html_help(gpointer callback_data,
 						  guint callback_action,
 						  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	debug_transform (primary_window,
 			 DOCBOOK_TO_HTML_HELP_STYLESHEET_FILE);
 }
-void menu_callback_debug_transform_docbook_to_javahelp(gpointer callback_data,
+
+/**
+ * menu_callback_debug_transform_docbook_to_javahelp:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_transform_docbook_to_javahelp(gpointer callback_data,
 						  guint callback_action,
 						  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	debug_transform (primary_window,
 			 DOCBOOK_TO_JAVAHELP_STYLESHEET_FILE);
 }
-void menu_callback_debug_transform_docbook_to_fo(gpointer callback_data,
+
+/**
+ * menu_callback_debug_transform_docbook_to_fo:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_transform_docbook_to_fo(gpointer callback_data,
 				  guint callback_action,
 				  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
@@ -630,13 +733,14 @@
 	gnome_print_stroke (gpc);
 
 	gnome_print_showpage (gpc);
 }
 
-void menu_callback_debug_preview_fo(gpointer callback_data,
-				  guint callback_action,
-				  GtkWidget *widget)
+void 
+menu_callback_debug_preview_fo(gpointer callback_data,
+			       guint callback_action,
+                               GtkWidget *widget)
 {
 	/* Open a GnomePrint preview */
 	xmlDocPtr xml_doc;
 	GnomePrintMaster *gpm;
 	GnomePrintContext *gpc;
@@ -675,11 +779,20 @@
 	preview_widget = gnome_print_master_preview_new (gpm, _("Print Preview"));
 	gtk_widget_show(preview_widget);
 }
 #endif /* #if PRINT_TESTS */
 
-void my_hash_scanner(void *payload, void *data, xmlChar *name)
+/**
+ * my_hash_scanner:
+ * @payload:
+ * @data:
+ * @name:
+ *
+ * TODO: Write me
+ */
+void 
+my_hash_scanner(void *payload, void *data, xmlChar *name)
 {
 	g_message("got name \"%s\"", name);
 }
 
 #if 0
@@ -700,11 +813,18 @@
 
 	}
 }
 #endif
 
-gchar *get_enumeration_details(xmlEnumerationPtr enum_ptr)
+/**
+ * get_enumeration_details:
+ * @enum_ptr:
+ *
+ * TODO: Write me
+ */
+gchar *
+get_enumeration_details(xmlEnumerationPtr enum_ptr)
 {
 	gchar *temp, *temp2;
 	temp = g_strdup("(");
 
 	while (enum_ptr) {
@@ -718,11 +838,18 @@
 	temp2 = g_strdup_printf("%s )", temp);
 	g_free(temp);
 	return temp2;
 }
 
-gchar *get_attribute_debug_details(xmlAttributePtr attr)
+/**
+ * get_attribute_debug_details:
+ * @attr:
+ *
+ * TODO: Write me
+ */
+gchar *
+get_attribute_debug_details(xmlAttributePtr attr)
 {
 	gchar *type_str = NULL;
 	g_assert(attr);
 
 	switch (attr->atype) {
@@ -782,11 +909,20 @@
     xmlEnumerationPtr       tree;       /* or the enumeration tree if any */
 #endif
 
 }
 
-void element_hash_scanner(void *payload, void *data, xmlChar *name)
+/**
+ * element_hash_scanner:
+ * @payload:
+ * @data:
+ * @name:
+ *
+ * TODO: Write me
+ */
+void 
+element_hash_scanner(void *payload, void *data, xmlChar *name)
 {
 	xmlElementPtr element = payload;
 	xmlAttributePtr attr;
 
 	g_message("got element <%s>", name);
@@ -798,16 +934,32 @@
 		g_message("attribute \"%s\": %s",attr->name, details);
 		g_free(details);
 	}
 }
 
-void entity_hash_scanner(void *payload, void *data, xmlChar *name)
+/**
+ * entity_hash_scanner:
+ * @payload:
+ * @data:
+ * @name:
+ *
+ * TODO: Write me
+ */
+void 
+entity_hash_scanner(void *payload, void *data, xmlChar *name)
 {
 	g_message("got entity \"%s\"", name);
 }
 
-void debug_log_dtd(xmlDtdPtr dtd)
+/**
+ * debug_log_dtd:
+ * @dtd:
+ *
+ * TODO: Write me
+ */
+void 
+debug_log_dtd(xmlDtdPtr dtd)
 {
 	g_message("Name \"%s\"\n", dtd->name);
 	g_message("ExternalID:\"%s\"\n", dtd->ExternalID);
 	g_message("SystemID:\"%s\"\n", dtd->SystemID);
 
@@ -843,13 +995,22 @@
 		    my_hash_scanner,
 		    NULL);
 #endif
 }
 
-void menu_callback_debug_dtd(gpointer callback_data,
-			    guint callback_action,
-			    GtkWidget *widget)
+/**
+ * menu_callback_debug_dtd:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_dtd(gpointer callback_data,
+			guint callback_action,
+			GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	CongDocument *doc;
 	xmlDocPtr xml_doc;
 
@@ -873,11 +1034,18 @@
 	} else {
 		g_message("No exterior subset\n");
 	}
 }
 
-GtkWidget *test_dialog_new(GtkWindow *parent_window)
+/**
+ * test_dialog_new:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+test_dialog_new(GtkWindow *parent_window)
 {
 	GtkWidget *dialog;
 	GtkWidget *tabs;
 	CongDialogContent *basic_content;
 	CongDialogCategory *general_category;
@@ -943,13 +1111,22 @@
 	gtk_widget_show_all(dialog);
 
 	return dialog;
 }
 
-void menu_callback_debug_dialog(gpointer callback_data,
-				guint callback_action,
-				GtkWidget *widget)
+/**
+ * menu_callback_debug_dialog:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_dialog(gpointer callback_data,
+			   guint callback_action,
+			   GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	GtkWidget *dialog = test_dialog_new(cong_primary_window_get_toplevel(primary_window));
 
@@ -973,14 +1150,22 @@
 	cong_progress_checklist_complete_stage(debug_data->progress_checklist);
 
 	return TRUE;
 }
 
-
-void menu_callback_debug_progress_checklist(gpointer callback_data,
-					    guint callback_action,
-					    GtkWidget *widget)
+/**
+ * menu_callback_debug_progress_checklist:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_progress_checklist(gpointer callback_data,
+				       guint callback_action,
+				       GtkWidget *widget)
 {
 	struct debug_progress_checklist debug_data;
 	CongPrimaryWindow *primary_window = callback_data;
 	int i;
 
@@ -1021,49 +1206,84 @@
 				    400);
 
 	gtk_widget_show(GTK_WIDGET(window));
 }
 
-
-void menu_callback_debug_document_message_log(gpointer callback_data,
-					      guint callback_action,
-					      GtkWidget *widget)
+/**
+ * menu_callback_debug_document_message_log:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_document_message_log(gpointer callback_data,
+					 guint callback_action,
+					 GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	make_debug_log_window (primary_window,
 			       cong_debug_message_log_view_new(doc),
 			       _("Message Log - Conglomerate"));
 }
 
-void menu_callback_debug_document_signal_log(gpointer callback_data,
-					      guint callback_action,
-					      GtkWidget *widget)
+/**
+ * menu_callback_debug_document_signal_log:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_document_signal_log(gpointer callback_data,
+					guint callback_action,
+					GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	make_debug_log_window (primary_window,
 			       cong_debug_signal_log_view_new(doc),
 			       _("Signal Log - Conglomerate"));
 }
 
-void menu_callback_debug_information_alert(gpointer callback_data,
-					   guint callback_action,
-					   GtkWidget *widget)
+/**
+ * menu_callback_debug_information_alert:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_information_alert(gpointer callback_data,
+				      guint callback_action,
+				      GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	GtkDialog *dialog = cong_dialog_information_alert_new(cong_primary_window_get_toplevel(primary_window),
 							      "This is a test information alert.  Hopefully it complies with the GNOME HIG.");
 	gtk_dialog_run(dialog);
 	gtk_widget_destroy(GTK_WIDGET(dialog));
 }
 
-void menu_callback_debug_glade_test(gpointer callback_data,
-					   guint callback_action,
-					   GtkWidget *widget)
+/**
+ * menu_callback_debug_glade_test:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_glade_test(gpointer callback_data,
+			       guint callback_action,
+			       GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 
 	gchar* glade_filename = gnome_program_locate_file(cong_app_get_gnome_program (cong_app_singleton()),
 							  GNOME_FILE_DOMAIN_APP_DATADIR,
@@ -1189,13 +1409,22 @@
 #else
 	return g_strdup("foo<some-random-unknown-tag>Hello world</some-random-unknown-tag>bar");
 #endif
 }
 
-void menu_callback_debug_insert_xml_fragment(gpointer callback_data,
-					     guint callback_action,
-					     GtkWidget *widget)
+/**
+ * menu_callback_debug_insert_xml_fragment:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_insert_xml_fragment(gpointer callback_data,
+					guint callback_action,
+					GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 	gchar *source_fragment;
 	g_assert(doc);
@@ -1208,13 +1437,22 @@
 				       source_fragment);
 	
 	g_free(source_fragment);
 }
 
-void menu_callback_debug_command_test (gpointer callback_data,
-				       guint callback_action,
-				       GtkWidget *widget)
+/**
+ * menu_callback_debug_command_test:
+ * @callback_data:
+ * @callback_action:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+menu_callback_debug_command_test (gpointer callback_data,
+				  guint callback_action,
+				  GtkWidget *widget)
 {
 	CongPrimaryWindow *primary_window = callback_data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	CongCommand* cmd = cong_document_begin_command (doc,
@@ -1495,12 +1733,20 @@
 	CongRange *range = cong_selection_get_ordered_range(selection);
 	gtk_widget_set_sensitive (cut,
 				  cong_range_can_be_cut (range));
 }
 
-void cong_menus_create_items(GtkItemFactory *item_factory, 
-			     CongPrimaryWindow *primary_window)
+/**
+ * cong_menus_create_items:
+ * @item_factory:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_menus_create_items(GtkItemFactory *item_factory, 
+			CongPrimaryWindow *primary_window)
 {
 	g_return_if_fail(item_factory);
 	g_return_if_fail(primary_window);
 
 	if (cong_primary_window_get_document(primary_window)) {
Index: cong-modification-cursor-change.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-modification-cursor-change.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-modification-cursor-change.c
--- cong-modification-cursor-change.c	13 Dec 2003 17:46:39 -0000	1.4
+++ cong-modification-cursor-change.c	17 Apr 2004 17:45:26 -0000
@@ -73,10 +73,18 @@
 cong_modification_cursor_change_instance_init (CongModificationCursorChange *node)
 {
 	node->private = g_new0(CongModificationCursorChangeDetails,1);
 }
 
+/**
+ * cong_modification_cursor_change_construct:
+ * @modification_cursor_change:
+ * @doc:
+ * @new_location:
+ *
+ * TODO: Write me
+ */
 CongModificationCursorChange*
 cong_modification_cursor_change_construct (CongModificationCursorChange *modification_cursor_change,
 					      CongDocument *doc,
 					      const CongLocation *new_location)
 {
@@ -92,19 +100,32 @@
 	cong_location_copy_with_ref (doc, &PRIVATE(modification_cursor_change)->new_location, new_location);
 
 	return modification_cursor_change;
 }
 
+/**
+ * cong_modification_cursor_change_new:
+ * @doc:
+ * @new_location:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_modification_cursor_change_new (CongDocument *doc,
 				     const CongLocation *new_location)
 {
 	return CONG_MODIFICATION(cong_modification_cursor_change_construct (CONG_MODIFICATION_CURSOR_CHANGE(g_object_new (CONG_MODIFICATION_CURSOR_CHANGE_TYPE, NULL)),
 									    doc,
 									    new_location));
 }
 
+/**
+ * finalize:
+ * @object:
+ *
+ * TODO: Write me
+ */
 void
 finalize (GObject *object)
 {
 	CongModificationCursorChange *modification_cursor_change = CONG_MODIFICATION_CURSOR_CHANGE (object);
 
Index: cong-modification-selection-change.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-modification-selection-change.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-modification-selection-change.c
--- cong-modification-selection-change.c	30 Dec 2003 23:17:41 -0000	1.4
+++ cong-modification-selection-change.c	17 Apr 2004 17:45:26 -0000
@@ -75,10 +75,19 @@
 cong_modification_selection_change_instance_init (CongModificationSelectionChange *node)
 {
 	node->private = g_new0(CongModificationSelectionChangeDetails,1);
 }
 
+/**
+ * cong_modification_selection_change_construct:
+ * @modification_selection_change:
+ * @doc:
+ * @new_logical_start:
+ * @new_logical_end:
+ *
+ * TODO: Write me
+ */
 CongModificationSelectionChange*
 cong_modification_selection_change_construct (CongModificationSelectionChange *modification_selection_change,
 					      CongDocument *doc,
 					      const CongLocation *new_logical_start,
 					      const CongLocation *new_logical_end)
@@ -98,10 +107,18 @@
 	cong_location_copy_with_ref (doc, &PRIVATE(modification_selection_change)->new_logical_end, new_logical_end);
 
 	return modification_selection_change;
 }
 
+/**
+ * cong_modification_selection_change_new:
+ * @doc:
+ * @new_logical_start:
+ * @new_logical_end:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_modification_selection_change_new (CongDocument *doc,
 					const CongLocation *new_logical_start,
 					const CongLocation *new_logical_end)
 {
@@ -109,10 +126,16 @@
 									       doc,
 									       new_logical_start,
 									       new_logical_end));
 }
 
+/**
+ * finalize:
+ * @object:
+ *
+ * TODO: Write me
+ */
 void
 finalize (GObject *object)
 {
 	CongModificationSelectionChange *modification_selection_change = CONG_MODIFICATION_SELECTION_CHANGE (object);
 
Index: cong-modification-set-dtd-ptr.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-modification-set-dtd-ptr.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-modification-set-dtd-ptr.c
--- cong-modification-set-dtd-ptr.c	4 Feb 2004 16:24:21 -0000	1.4
+++ cong-modification-set-dtd-ptr.c	17 Apr 2004 17:45:26 -0000
@@ -72,10 +72,18 @@
 cong_modification_set_dtd_ptr_instance_init (CongModificationSetDtdPtr *node)
 {
 	node->private = g_new0(CongModificationSetDtdPtrDetails,1);
 }
 
+/**
+ * cong_modification_set_dtd_ptr_construct:
+ * @modification_set_dtd_ptr:
+ * @doc:
+ * @dtd_ptr:
+ *
+ * TODO: Write me
+ */
 CongModificationSetDtdPtr*
 cong_modification_set_dtd_ptr_construct (CongModificationSetDtdPtr *modification_set_dtd_ptr,
 					 CongDocument *doc,
 					 xmlDtdPtr dtd_ptr)
 {
@@ -90,19 +98,32 @@
 				    (CongNodePtr)dtd_ptr);
 
 	return modification_set_dtd_ptr;
 }
 
+/**
+ * cong_modification_set_dtd_ptr_new:
+ * @doc:
+ * @dtd_ptr:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_modification_set_dtd_ptr_new (CongDocument *doc,
 					 xmlDtdPtr dtd_ptr)
 {
 	return CONG_MODIFICATION(cong_modification_set_dtd_ptr_construct (CONG_MODIFICATION_SET_DTD_PTR(g_object_new (CONG_MODIFICATION_SET_DTD_PTR_TYPE, NULL)),
 									  doc,
 									  dtd_ptr));
 }
 
+/**
+ * finalize:
+ * @object:
+ *
+ * TODO: Write me
+ */
 void
 finalize (GObject *object)
 {
 	CongModificationSetDtdPtr *modification_set_dtd_ptr = CONG_MODIFICATION_SET_DTD_PTR (object);
 
Index: cong-modification.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-modification.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-modification.c
--- cong-modification.c	11 Jan 2004 04:35:21 -0000	1.2
+++ cong-modification.c	17 Apr 2004 17:45:26 -0000
@@ -63,26 +63,44 @@
 	PRIVATE(modification)->doc = doc;
 
 	return modification;
 }
 
+/**
+ * cong_modification_get_document:
+ * @modification:
+ * 
+ * TODO: Write me
+ */
 CongDocument*
 cong_modification_get_document (CongModification *modification)
 {
 	g_return_val_if_fail (IS_CONG_MODIFICATION(modification), NULL);
 	
 	return PRIVATE(modification)->doc;
 }
 
+/**
+ * cong_modification_undo:
+ * @modification:
+ * 
+ * TODO: Write me
+ */
 void
 cong_modification_undo (CongModification *modification)
 {
 	g_return_if_fail (IS_CONG_MODIFICATION(modification));
 
 	g_message ("cong_modification_undo()");
 }
 
+/**
+ * cong_modification_redo:
+ * @modification:
+ * 
+ * TODO: Write me
+ */
 void
 cong_modification_redo (CongModification *modification)
 {
 	g_return_if_fail (IS_CONG_MODIFICATION(modification));
 
Index: cong-node-modification-add-after.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-add-after.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-node-modification-add-after.c
--- cong-node-modification-add-after.c	3 Oct 2003 15:02:31 -0000	1.4
+++ cong-node-modification-add-after.c	17 Apr 2004 17:45:26 -0000
@@ -73,10 +73,19 @@
 cong_node_modification_add_after_instance_init (CongNodeModificationAddAfter *node)
 {
 	node->private = g_new0(CongNodeModificationAddAfterDetails,1);
 }
 
+/**
+ * cong_node_modification_add_after_construct:
+ * @node_modification_add_after:
+ * @doc:
+ * @node:
+ * @older_sibling:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationAddAfter*
 cong_node_modification_add_after_construct (CongNodeModificationAddAfter *node_modification_add_after,
 					    CongDocument *doc,
 					    CongNodePtr node,
 					    CongNodePtr older_sibling)
@@ -103,10 +112,18 @@
 	}
 
 	return node_modification_add_after;
 }
 
+/**
+ * cong_node_modification_add_after_new:
+ * @doc:
+ * @node:
+ * @older_sibling:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_add_after_new (CongDocument *doc,
 				      CongNodePtr node,
 				      CongNodePtr older_sibling)
 {
Index: cong-node-modification-add-before.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-add-before.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-node-modification-add-before.c
--- cong-node-modification-add-before.c	3 Oct 2003 15:02:31 -0000	1.4
+++ cong-node-modification-add-before.c	17 Apr 2004 17:45:26 -0000
@@ -73,10 +73,19 @@
 cong_node_modification_add_before_instance_init (CongNodeModificationAddBefore *node)
 {
 	node->private = g_new0(CongNodeModificationAddBeforeDetails,1);
 }
 
+/**
+ * cong_node_modification_add_before_construct:
+ * @node_modification_add_before:
+ * @doc:
+ * @node:
+ * @younger_sibling:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationAddBefore*
 cong_node_modification_add_before_construct (CongNodeModificationAddBefore *node_modification_add_before,
 					     CongDocument *doc,
 					     CongNodePtr node,
 					     CongNodePtr younger_sibling)
@@ -103,10 +112,18 @@
 	}
 
 	return node_modification_add_before;
 }
 
+/**
+ * cong_node_modification_add_before_new:
+ * @doc:
+ * @node:
+ * @younger_sibling:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_add_before_new (CongDocument *doc,
 				      CongNodePtr node,
 				      CongNodePtr younger_sibling)
 {
Index: cong-node-modification-make-orphan.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-make-orphan.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-node-modification-make-orphan.c
--- cong-node-modification-make-orphan.c	3 Oct 2003 15:02:31 -0000	1.4
+++ cong-node-modification-make-orphan.c	17 Apr 2004 17:45:26 -0000
@@ -69,10 +69,18 @@
 cong_node_modification_make_orphan_instance_init (CongNodeModificationMakeOrphan *node)
 {
 	node->private = g_new0(CongNodeModificationMakeOrphanDetails,1);
 }
 
+/**
+ * cong_node_modification_make_orphan_construct:
+ * @node_modification_make_orphan:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationMakeOrphan*
 cong_node_modification_make_orphan_construct (CongNodeModificationMakeOrphan *node_modification_make_orphan,
 					      CongDocument *doc,
 					      CongNodePtr node)
 {
@@ -95,10 +103,17 @@
 	}
 
 	return node_modification_make_orphan;
 }
 
+/**
+ * cong_node_modification_make_orphan_new:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_make_orphan_new (CongDocument *doc,
 					CongNodePtr node)
 {
 	return CONG_MODIFICATION(cong_node_modification_make_orphan_construct (CONG_NODE_MODIFICATION_MAKE_ORPHAN(g_object_new (CONG_NODE_MODIFICATION_MAKE_ORPHAN_TYPE, NULL)),
@@ -202,6 +217,5 @@
 	cong_document_end_edit (doc);
 
 	g_assert (node->next == NULL);
 	g_assert (node->parent == NULL);
 }
-
Index: cong-node-modification-remove-attribute.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-remove-attribute.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-node-modification-remove-attribute.c
--- cong-node-modification-remove-attribute.c	3 Mar 2004 21:26:23 -0000	1.4
+++ cong-node-modification-remove-attribute.c	17 Apr 2004 17:45:26 -0000
@@ -69,10 +69,20 @@
 cong_node_modification_remove_attribute_instance_init (CongNodeModificationRemoveAttribute *node)
 {
 	node->private = g_new0(CongNodeModificationRemoveAttributeDetails,1);
 }
 
+/**
+ * cong_node_modification_remove_attribute_construct:
+ * @node_modification_remove_attribute:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationRemoveAttribute*
 cong_node_modification_remove_attribute_construct (CongNodeModificationRemoveAttribute *node_modification_remove_attribute,
 						   CongDocument *doc,
 						   CongNodePtr node,
 						   xmlNs *ns_ptr,
@@ -94,10 +104,19 @@
 	private->old_value = cong_node_get_attribute (node, ns_ptr, name);
 
 	return node_modification_remove_attribute;
 }
 
+/**
+ * cong_node_modification_remove_attribute_new:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_remove_attribute_new (CongDocument *doc,
 					     CongNodePtr node,
 					     xmlNs *ns_ptr,
 					     const gchar *name)
@@ -207,6 +226,5 @@
 							     private->name);
 	}
 	
 	cong_document_end_edit (doc);
 }
-
Index: cong-node-modification-set-attribute.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-set-attribute.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-node-modification-set-attribute.c
--- cong-node-modification-set-attribute.c	3 Mar 2004 21:26:23 -0000	1.4
+++ cong-node-modification-set-attribute.c	17 Apr 2004 17:45:26 -0000
@@ -70,10 +70,21 @@
 cong_node_modification_set_attribute_instance_init (CongNodeModificationSetAttribute *node)
 {
 	node->private = g_new0(CongNodeModificationSetAttributeDetails,1);
 }
 
+/**
+ * cong_node_modification_set_attribute_construct:
+ * @node_modification_set_attribute:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ * @value:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationSetAttribute*
 cong_node_modification_set_attribute_construct (CongNodeModificationSetAttribute *node_modification_set_attribute,
 						CongDocument *doc,
 						CongNodePtr node,
 						xmlNs *ns_ptr,
@@ -98,10 +109,20 @@
 	private->old_value = cong_node_get_attribute (node, ns_ptr, name);
 
 	return node_modification_set_attribute;
 }
 
+/**
+ * cong_node_modification_set_attribute_new:
+ * @doc:
+ * @node:
+ * @ns_ptr:
+ * @name:
+ * @value:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_set_attribute_new (CongDocument *doc,
 					  CongNodePtr node,
 					  xmlNs *ns_ptr,
 					  const xmlChar *name, 
@@ -221,6 +242,5 @@
 						  private->name,
 						  private->value);
 	
 	cong_document_end_edit (doc);
 }
-
Index: cong-node-modification-set-parent.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-set-parent.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-node-modification-set-parent.c
--- cong-node-modification-set-parent.c	3 Oct 2003 15:02:31 -0000	1.4
+++ cong-node-modification-set-parent.c	17 Apr 2004 17:45:26 -0000
@@ -72,10 +72,19 @@
 cong_node_modification_set_parent_instance_init (CongNodeModificationSetParent *node)
 {
 	node->private = g_new0(CongNodeModificationSetParentDetails,1);
 }
 
+/**
+ * cong_node_modification_set_parent_construct:
+ * @node_modification_set_parent:
+ * @doc:
+ * @node:
+ * @new_parent:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationSetParent*
 cong_node_modification_set_parent_construct (CongNodeModificationSetParent *node_modification_set_parent,
 					     CongDocument *doc,
 					     CongNodePtr node,
 					     CongNodePtr new_parent)
@@ -97,10 +106,18 @@
 	}
 
 	return node_modification_set_parent;
 }
 
+/**
+ * cong_node_modification_set_parent_new:
+ * @doc:
+ * @node:
+ * @new_parent:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_set_parent_new (CongDocument *doc,
 				       CongNodePtr node,
 				       CongNodePtr new_parent)
 {
@@ -200,6 +217,5 @@
 	cong_document_end_edit (doc);
 
 	g_assert (node->next == NULL);
 	g_assert (node->parent == PRIVATE(node_modification_set_parent)->new_parent);
 }
-
Index: cong-node-modification-set-text.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification-set-text.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-node-modification-set-text.c
--- cong-node-modification-set-text.c	2 Oct 2003 00:30:58 -0000	1.3
+++ cong-node-modification-set-text.c	17 Apr 2004 17:45:26 -0000
@@ -71,10 +71,19 @@
 cong_node_modification_set_text_instance_init (CongNodeModificationSetText *node)
 {
 	node->private = g_new0(CongNodeModificationSetTextDetails,1);
 }
 
+/**
+ * cong_node_modification_set_text_construct:
+ * @node_modification_set_text:
+ * @doc:
+ * @node:
+ * @new_content:
+ *
+ * TODO: Write me
+ */
 CongNodeModificationSetText*
 cong_node_modification_set_text_construct (CongNodeModificationSetText *node_modification_set_text,
 					   CongDocument *doc,
 					   CongNodePtr node,
 					   const gchar *new_content)
@@ -87,10 +96,18 @@
 	PRIVATE (node_modification_set_text)->new_content = g_strdup (new_content);
 
 	return node_modification_set_text;
 }
 
+/**
+ * cong_node_modification_set_text_new:
+ * @doc:
+ * @node:
+ * @new_content:
+ *
+ * TODO: Write me
+ */
 CongModification*
 cong_node_modification_set_text_new (CongDocument *doc,
 				     CongNodePtr node,
 				     const gchar *new_content)
 {
@@ -168,6 +185,5 @@
 	cong_document_private_node_set_text (doc,
 					     node,
 					     PRIVATE (node_modification_set_text)->new_content);
 	cong_document_end_edit (doc);
 }
-
Index: cong-node-modification.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-modification.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-node-modification.c
--- cong-node-modification.c	29 Sep 2003 23:27:10 -0000	1.1
+++ cong-node-modification.c	17 Apr 2004 17:45:26 -0000
@@ -49,10 +49,18 @@
 cong_node_modification_instance_init (CongNodeModification *node)
 {
 	node->private = g_new0(CongNodeModificationDetails,1);
 }
 
+/**
+ * cong_node_modification_construct:
+ * @node_modification:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongNodeModification*
 cong_node_modification_construct (CongNodeModification *node_modification,
 				  CongDocument *doc,
 				  CongNodePtr node)
 {
@@ -65,10 +73,16 @@
 				node);
 
 	return node_modification;
 }
 
+/**
+ * cong_node_modification_get_node:
+ * @node_modification:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_modification_get_node (CongNodeModification *node_modification)
 {
 	g_return_val_if_fail (IS_CONG_NODE_MODIFICATION (node_modification), NULL);
 
Index: cong-node-properties-dialog.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node-properties-dialog.c,v
retrieving revision 1.24
diff -u -5 -r1.24 cong-node-properties-dialog.c
--- cong-node-properties-dialog.c	3 Mar 2004 21:26:23 -0000	1.24
+++ cong-node-properties-dialog.c	17 Apr 2004 17:45:27 -0000
@@ -225,13 +225,20 @@
 
 static void on_cursor_change(CongView *view)
 {
 }
 
-
-void init_view_xpath_view(CongAdvancedNodePropertiesView *view,
-			  struct XPathView* xpath_view)
+/**
+ * init_view_xpath_view:
+ * @view:
+ * @xpath_view:
+ *
+ * TODO: Write me
+ */
+void 
+init_view_xpath_view(CongAdvancedNodePropertiesView *view,
+		     struct XPathView* xpath_view)
 {
 	gchar *xpath;
 
 	g_assert(view);
 	g_assert(xpath_view);
@@ -523,10 +530,16 @@
 		gtk_widget_set_sensitive(view->raw_attr.delete_button, gtk_tree_selection_get_selected (treeselection, NULL, NULL));
 	}
 	
 }
 
+/**
+ * init_view_namespace:
+ * @view:
+ *
+ * TODO: Write me
+ */
 void 
 init_view_namespace (CongAdvancedNodePropertiesView *view)
 {
 	CongDialogCategory *category;
 	GtkWidget *label;
@@ -550,13 +563,20 @@
 	cong_dialog_category_add_selflabelled_field (category, 
 						     label,
 						     TRUE);
 }
 
-
-void init_view_raw_attr(CongAdvancedNodePropertiesView *view,
-			struct RawAttr* raw_attr)
+/**
+ * init_view_raw_attr:
+ * @view:
+ * @raw_attr:
+ *
+ * TODO: Write me
+ */
+void 
+init_view_raw_attr(CongAdvancedNodePropertiesView *view,
+		   struct RawAttr* raw_attr)
 {
 	/* FIXME: use libglade for this... */
 	GtkWidget *vbox = gtk_vbox_new(FALSE, 6);
 	GtkWidget *hbox = gtk_hbox_new(FALSE, 6);
 
@@ -634,10 +654,16 @@
 	gtk_widget_show(vbox);
 
 	cong_dialog_category_add_selflabelled_field(raw_attr->category, vbox, TRUE);
 }
 
+/**
+ * cong_util_get_tag_string_for_node:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_util_get_tag_string_for_node (CongNodePtr node)
 {
 #if 0
 	if (node->xmlns) {
@@ -646,10 +672,16 @@
 #else
 	return g_strdup_printf("<%s>", node->name); /* for now */
 #endif
 }
 
+/**
+ * cong_util_get_tag_string_for_node_escaped:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_util_get_tag_string_for_node_escaped (CongNodePtr node)
 {
 	gchar *unescaped = cong_util_get_tag_string_for_node (node);
 	gchar *result = g_markup_escape_text (unescaped,
@@ -920,11 +952,16 @@
 		break;
 	}
 
 }
 
-
+/**
+ * make_tree_model_for_element_model:
+ * @xml_element:
+ *
+ * TODO: Write me
+ */
 GtkTreeModel*
 make_tree_model_for_element_model (xmlElementPtr xml_element)
 {  
 	GtkTreeStore *store;
 	GtkTreeIter root_iter;
@@ -947,10 +984,16 @@
 	}
 
 	return GTK_TREE_MODEL (store);
 }
 
+/**
+ * make_widget_for_element_model:
+ * @xml_element:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 make_widget_for_element_model (xmlElementPtr xml_element)
 {
 	GtkWidget *tree;
 	GtkTreeModel *tree_model;
@@ -1017,10 +1060,18 @@
 	cong_dialog_category_add_selflabelled_field (category,
 						     scrolled_window,
 						     TRUE);
 }
 
+/**
+ * cong_node_properties_dtd_new:
+ * @doc:
+ * @node:
+ * @within_notebook:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_node_properties_dtd_new (CongDocument *doc, 
 			      CongNodePtr node,
 			      gboolean within_notebook)
 {	
@@ -1050,10 +1101,18 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_node_properties_dialog_advanced_new:
+ * @doc:
+ * @node:
+ * @within_notebook:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_node_properties_dialog_advanced_new(CongDocument *doc, 
 					 CongNodePtr node,
 					 gboolean within_notebook)
 {
@@ -1095,13 +1154,22 @@
 	gtk_widget_show (widget);
 
 	return widget;
 }
 
-void cong_ui_append_advanced_node_properties_page(GtkNotebook *notebook,
-						  CongDocument *doc, 
-						  CongNodePtr node)
+/**
+ * cong_ui_append_advanced_node_properties_page:
+ * @notebook:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_ui_append_advanced_node_properties_page(GtkNotebook *notebook,
+					     CongDocument *doc, 
+					     CongNodePtr node)
 {
 	GtkWidget* dtd_page;
 
 	g_return_if_fail(notebook);
 	g_return_if_fail(doc);
@@ -1124,10 +1192,18 @@
 									  TRUE),
 				 gtk_label_new(_("Advanced"))
 				 );
 }
 
+/**
+ * cong_node_properties_dialog_new:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_node_properties_dialog_new (CongDocument *doc, 
 				 CongNodePtr node, 
 				 GtkWindow *parent_window)
 {
@@ -1214,14 +1290,12 @@
 					    TRUE, 
 					    0);
 		}
 
 		g_signal_connect_swapped (G_OBJECT (dialog), 
-					  "response", 
-					  G_CALLBACK (gtk_widget_destroy),
+					  "response", G_CALLBACK (gtk_widget_destroy),
 					  GTK_OBJECT (dialog));
 
 
 		return GTK_WIDGET(dialog);
 	}
 }
-
Index: cong-node.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-node.c,v
retrieving revision 1.23
diff -u -5 -r1.23 cong-node.c
--- cong-node.c	3 Mar 2004 21:26:23 -0000	1.23
+++ cong-node.c	17 Apr 2004 17:45:27 -0000
@@ -42,40 +42,75 @@
 /* Internal types: */
 
 /* Internal function declarations: */
 
 /* Exported function definitions: */
-CongNodePtr cong_node_prev(CongNodePtr node)
+/**
+ * cong_node_prev:
+ * @node:
+ *
+ * TODO: Write me
+ */
+CongNodePtr 
+cong_node_prev(CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 
 	return node->prev;	
 }
 
-CongNodePtr cong_node_next(CongNodePtr node)
+/**
+ * cong_node_next:
+ * @node:
+ *
+ * TODO: Write me
+ */
+CongNodePtr 
+cong_node_next(CongNodePtr node)
 {
 	g_assert(node);
 	g_return_val_if_fail(node, NULL);
 
 	return node->next;
 }
 
-CongNodePtr cong_node_first_child(CongNodePtr node)
+/**
+ * cong_node_first_child:
+ * @node:
+ *
+ * TODO: Write me
+ */
+CongNodePtr 
+cong_node_first_child(CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 
 	return node->children;
 }
 
-CongNodePtr cong_node_parent(CongNodePtr node)
+/**
+ * cong_node_parent:
+ * @node:
+ *
+ * TODO: Write me
+ */
+CongNodePtr 
+cong_node_parent(CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 
 	return node->parent;
 }
 
-enum CongNodeType cong_node_type(CongNodePtr node)
+/**
+ * cong_node_type:
+ * @node:
+ *
+ * TODO: Write me
+ */
+enum CongNodeType 
+cong_node_type(CongNodePtr node)
 {
 	g_return_val_if_fail(node, CONG_NODE_TYPE_UNKNOWN);
 
 	switch (node->type) {
 
@@ -127,10 +162,18 @@
 		return CONG_NODE_TYPE_UNKNOWN;
 	}
 
 }
 
+/**
+ * cong_node_is_element:
+ * @node:
+ * @ns_uri:
+ * @local_name:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_node_is_element (CongNodePtr node, 
 		      const gchar *ns_uri,
 		      const gchar *local_name)
 {
@@ -148,10 +191,20 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_node_is_element_from_set:
+ * @node:
+ * @ns_uri:
+ * @local_name_array:
+ * @num_local_names:
+ * @output_index:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_node_is_element_from_set (CongNodePtr node, 
 			       const gchar *ns_uri,
 			       const gchar **local_name_array,
 			       guint num_local_names,
@@ -184,19 +237,30 @@
 
 	return FALSE;
 	
 }
 
-
+/**
+ * cong_node_get_ns:
+ * @node:
+ *
+ * TODO: Write me
+ */
 xmlNsPtr
 cong_node_get_ns (CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 	
 	return node->ns;
 }
 
+/**
+ * cong_node_get_ns_uri:
+ * @node:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_node_get_ns_uri (CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 	
@@ -205,10 +269,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_node_get_ns_prefix:
+ * @node:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_node_get_ns_prefix (CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 	
@@ -217,19 +287,31 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_node_get_local_name:
+ * @node:
+ *
+ * TODO: Write me
+ */
 const gchar* 
 cong_node_get_local_name (CongNodePtr node)
 {
 	g_return_val_if_fail (node, NULL);
 	g_return_val_if_fail (node->type==XML_ELEMENT_NODE, NULL);
 
 	return node->name;
 }
 
+/**
+ * cong_node_get_qualified_name:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_node_get_qualified_name (CongNodePtr node)
 {
 	g_return_val_if_fail (node, NULL);
 	g_return_val_if_fail (node->type==XML_ELEMENT_NODE, NULL);
@@ -241,19 +323,33 @@
 	} else {
 		return g_strdup (cong_node_get_local_name (node));
 	}	
 }
 
+/**
+ * cong_node_get_ns_for_uri:
+ * @node:
+ * @ns_uri:
+ *
+ * TODO: Write me
+ */
 xmlNsPtr
 cong_node_get_ns_for_uri (CongNodePtr node, 
 			  const gchar *ns_uri)
 {
 	return xmlSearchNsByHref (node->doc,
 				  node,
 				  ns_uri);
 }
 
+/**
+ * cong_node_get_ns_for_prefix:
+ * @node:
+ * @prefix:
+ *
+ * TODO: Write me
+ */
 xmlNsPtr
 cong_node_get_ns_for_prefix (CongNodePtr node, 
 			     const gchar *prefix)
 {
 	g_return_val_if_fail (node, NULL);
@@ -262,13 +358,22 @@
 	return xmlSearchNs (node->doc,
 			    node, /* FIXME: is this correct? */
 			    prefix);
 }
 
-xmlNsPtr cong_node_get_attr_ns(CongNodePtr node, 
-			       const char *qualified_name, 
-			       const char **output_name)
+/**
+ * cong_node_get_attr_ns:
+ * @node:
+ * @qualified_name:
+ * @output_name:
+ *
+ * TODO: Write me
+ */
+xmlNsPtr 
+cong_node_get_attr_ns(CongNodePtr node, 
+		      const char *qualified_name, 
+		      const char **output_name)
 {
 	g_return_val_if_fail(node != NULL, NULL);
 	g_return_val_if_fail(qualified_name != NULL, NULL);
 	g_return_val_if_fail(output_name != NULL, NULL);
 
@@ -297,18 +402,32 @@
 		return ns;
 	}	
 }
 
 /* Method for getting an XPath to the node: */
-gchar *cong_node_get_path(CongNodePtr node)
+/**
+ * cong_node_get_path:
+ * @node:
+ *
+ * TODO: Write me
+ */
+gchar *
+cong_node_get_path(CongNodePtr node)
 {
 	g_return_val_if_fail(node, NULL);
 
 	return xmlGetNodePath(node);
 }
 
-gchar *cong_node_debug_description(CongNodePtr node)
+/**
+ * cong_node_debug_description:
+ * @node:
+ *
+ * TODO: Write me
+ */
+gchar *
+cong_node_debug_description(CongNodePtr node)
 {
 	gchar *result = NULL; 
 	gchar *xpath;
 	gchar *cleaned_text = NULL; 
 
@@ -406,24 +525,38 @@
 	"CONG_NODE_TYPE_NAMESPACE_DECL",
 	"CONG_NODE_TYPE_XINCLUDE_START",
 	"CONG_NODE_TYPE_XINCLUDE_END"
 };
 	
-
-
-const gchar *cong_node_type_description(enum CongNodeType node_type)
+/**
+ * cong_node_type_description:
+ * @node_type:
+ *
+ * TODO: Write me
+ */
+const gchar *
+cong_node_type_description(enum CongNodeType node_type)
 {
 	g_return_val_if_fail(node_type<CONG_NODE_TYPE_NUM,"(invalid type)");
 
 	return node_type_names[node_type];
 
 }
 
 /* Methods for accessing attribute values: */
-CongXMLChar* cong_node_get_attribute(CongNodePtr node,
-				     xmlNs* ns_ptr, 
-				     const CongXMLChar* local_attribute_name)
+/**
+ * cong_node_get_attribute:
+ * @node:
+ * @ns_ptr:
+ * @local_attribute_name:
+ *
+ * TODO: Write me
+ */
+CongXMLChar* 
+cong_node_get_attribute(CongNodePtr node,
+			xmlNs* ns_ptr, 
+			const CongXMLChar* local_attribute_name)
 {
 	g_return_val_if_fail(node, NULL);
 	g_return_val_if_fail(local_attribute_name, NULL);
 	
 	if(ns_ptr == NULL) {
@@ -431,13 +564,22 @@
 	} else {
 		return xmlGetNsProp(node, local_attribute_name, ns_ptr->href);
 	}
 }
 
-gboolean cong_node_has_attribute(CongNodePtr node,
-				 xmlNs* ns_ptr, 
-				 const CongXMLChar* local_attribute_name)
+/**
+ * cong_node_has_attribute:
+ * @node:
+ * @ns_ptr:
+ * @local_attribute_name:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_node_has_attribute(CongNodePtr node,
+			xmlNs* ns_ptr, 
+			const CongXMLChar* local_attribute_name)
 {
 	g_return_val_if_fail(node, FALSE);
 	g_return_val_if_fail(local_attribute_name, FALSE);
 	
 	if(ns_ptr == NULL) {
@@ -460,11 +602,18 @@
 	} else {		
 		return xmlHasNsProp(node, local_attribute_name, ns_ptr->href) != NULL;
 	}
 }
 
-void cong_node_self_test(CongNodePtr node)
+/**
+ * cong_node_self_test:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_self_test(CongNodePtr node)
 {
 	CongNodePtr iter;
 
 	g_return_if_fail(node);
 
@@ -558,11 +707,18 @@
 		}
 		g_assert(iter==node);
 	}
 }
 
-void cong_node_self_test_recursive(CongNodePtr node)
+/**
+ * cong_node_self_test_recursive:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_self_test_recursive(CongNodePtr node)
 {
 
 	g_return_if_fail(node);
 
 	cong_node_self_test(node);
@@ -576,20 +732,34 @@
 			cong_node_self_test_recursive(iter);
 		}
 	}
 }
 
-int cong_node_get_length(CongNodePtr node)
+/**
+ * cong_node_get_length:
+ * @node:
+ *
+ * TODO: Write me
+ */
+int 
+cong_node_get_length(CongNodePtr node)
 {
 	/* get length of content; does not include the zero terminator */
 	g_return_val_if_fail( (cong_node_type(node) == CONG_NODE_TYPE_TEXT) || (cong_node_type(node) == CONG_NODE_TYPE_COMMENT), 0);
 
 	return xmlStrlen(node->content);
 	
 }
 
-gboolean cong_node_should_recurse(CongNodePtr node)
+/**
+ * cong_node_should_recurse:
+ * @node:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_node_should_recurse(CongNodePtr node)
 {
 	g_return_val_if_fail(node, FALSE);
 
 	switch (node->type) {
 	default: g_assert_not_reached();
@@ -623,10 +793,18 @@
 		return TRUE;
 	}
 }
 
 /* Construction: */
+/**
+ * cong_node_new_element:
+ * @xml_ns:
+ * @local_name:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_new_element (xmlNsPtr xml_ns, 
 		       const gchar *local_name, 
 		       CongDocument *doc)
 {
@@ -638,10 +816,17 @@
 			      xml_ns,
 			      local_name, 
 			      NULL); /* FIXME: audit the character types here */
 }
 
+/**
+ * cong_node_new_element_from_dispspec:
+ * @element:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_node_new_element_from_dispspec (CongDispspecElement *element, 
 				     CongDocument *doc)
 {
 	xmlNsPtr xml_ns;
@@ -656,17 +841,32 @@
 			      xml_ns,
 			      cong_dispspec_element_get_local_name (element), 
 			      NULL);
 }
 
+/**
+ * cong_node_new_text:
+ * @text:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_new_text (const char *text, 
 		    CongDocument *doc)
 {
 	return cong_node_new_text_len(text, strlen(text),doc);
 }
 
+/**
+ * cong_node_new_text_len:
+ * @text:
+ * @len:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_new_text_len (const char *text, 
 			int len, 
 			CongDocument *doc)
 {
@@ -676,17 +876,30 @@
 	return xmlNewDocTextLen(cong_document_get_xml(doc), text, len); /* FIXME: audit the character types here */
 }
 
 /* Destruction: (the node has to have been unlinked from the tree already): */
 
-void cong_node_free(CongNodePtr node)
+/**
+ * cong_node_free:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_free(CongNodePtr node)
 {
 	g_return_if_fail(node);
 
 	xmlFreeNode(node);
 }
 
+/**
+ * cong_node_generate_source:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_node_generate_source (CongNodePtr node)
 {
 	xmlBufferPtr xml_buffer;
 	gchar *result;
@@ -716,10 +929,16 @@
 	xmlBufferFree (xml_buffer);
 
 	return result;
 }
 
+/**
+ * cong_node_generate_child_source:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_node_generate_child_source (CongNodePtr node)
 {
 	xmlBufferPtr xml_buffer;
 	gchar *result;
@@ -762,11 +981,17 @@
 	xmlBufferFree (xml_buffer);
 
 	return result;	
 }
 
-
+/**
+ * cong_node_generate_source_from_byte_offset:
+ * @node:
+ * @start_byte_offset:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_node_generate_source_from_byte_offset (CongNodePtr node,
 					    int start_byte_offset)
 {
 	if (node->content) {
@@ -782,10 +1007,17 @@
 }
 
 /* Generate XML source from TEXT and COMMENT nodes as a UTF8 string, up to the byte offset into the UTF-8: 
    FIXME: specify the end-point more precisely
  */
+/**
+ * cong_node_generate_source_up_to_byte_offset:
+ * @node:
+ * @end_byte_offset:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_node_generate_source_up_to_byte_offset (CongNodePtr node,
 					     int end_byte_offset)
 {
 	if (node->content) {
@@ -801,10 +1033,18 @@
 }
 
 /* Generate XML source from TEXT and COMMENT nodes as a UTF8 string, between the given byte offset into the UTF-8: 
    FIXME: specify the end-point more precisely
  */
+/**
+ * cong_node_generate_source_between_byte_offsets:
+ * @node:
+ * @start_byte_offset:
+ * @end_byte_offset:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_node_generate_source_between_byte_offsets (CongNodePtr node,
 						int start_byte_offset,
 						int end_byte_offset)
 {
@@ -845,10 +1085,17 @@
 	g_free (clipped_content);
 
 	return result;
 }
 
+/**
+ * cong_node_recursive_set_doc:
+ * @node:
+ * @xml_doc:
+ *
+ * TODO: Write me
+ */
 void
 cong_node_recursive_set_doc(CongNodePtr node, xmlDocPtr xml_doc)
 {
 	CongNodePtr iter;
 
@@ -857,11 +1104,18 @@
 	for (iter = node->children; iter; iter=iter->next) {
 		cong_node_recursive_set_doc(iter, xml_doc);
 	}
 }
 
-CongNodePtr cong_node_recursive_dup(CongNodePtr node)
+/**
+ * cong_node_recursive_dup:
+ * @node:
+ *
+ * TODO: Write me
+ */
+CongNodePtr 
+cong_node_recursive_dup(CongNodePtr node)
 {
 	CongNodePtr new_node = xmlCopyNode(node, TRUE);
 
 	/* Unfortunately, this doesn't preserve the doc ptrs, so we must reconstruct these: */
 	cong_node_recursive_set_doc(new_node, node->doc);
@@ -869,10 +1123,17 @@
 	/* FIXME: this is an evil hack, and this whole function should be deprecated */
 
 	return new_node;
 }
 
+/**
+ * cong_node_is_descendant_of:
+ * @node:
+ * @potential_ancestor:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_node_is_descendant_of (CongNodePtr node,
 			    CongNodePtr potential_ancestor)
 {
 	g_return_val_if_fail (node, FALSE);
@@ -933,11 +1194,18 @@
 		update_entities (node->parent);
 	}
 }
 
 /* Tree manipulation: */
-void cong_node_private_make_orphan(CongNodePtr node)
+/**
+ * cong_node_private_make_orphan:
+ * @node:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_make_orphan(CongNodePtr node)
 {
 	CongNodePtr former_parent;
 	CongNodePtr former_prev;
 	CongNodePtr former_next;
 
@@ -1022,11 +1290,19 @@
 			CONG_NODE_SELF_TEST(former_next);
 		}
 	}
 }
 
-void cong_node_private_add_after(CongNodePtr node, CongNodePtr older_sibling)
+/**
+ * cong_node_private_add_after:
+ * @node:
+ * @older_sibling:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_add_after(CongNodePtr node, CongNodePtr older_sibling)
 {
 	LOG_NODE_PRIVATE_MODIFICATION("cong_node_private_add_after");
 
 	g_return_if_fail(node);
 	g_return_if_fail(older_sibling);
@@ -1077,11 +1353,19 @@
 	xmlAddNextSibling(older_sibling, node);
 #endif
 
 }
 
-void cong_node_private_add_before(CongNodePtr node, CongNodePtr younger_sibling)
+/**
+ * cong_node_private_add_before:
+ * @node:
+ * @younger_sibling:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_add_before(CongNodePtr node, CongNodePtr younger_sibling)
 {
 	LOG_NODE_PRIVATE_MODIFICATION("cong_node_private_add_before");
 
 	g_return_if_fail(node);
 	g_return_if_fail(younger_sibling);
@@ -1133,11 +1417,19 @@
 	xmlAddPrevSibling(younger_sibling, node);
 #endif
 
 }
 
-void cong_node_private_set_parent(CongNodePtr node, CongNodePtr adoptive_parent)
+/**
+ * cong_node_private_set_parent:
+ * @node:
+ * @adoptive_parent:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_set_parent(CongNodePtr node, CongNodePtr adoptive_parent)
 {
 	LOG_NODE_PRIVATE_MODIFICATION("cong_node_private_set_parent");
 
 	g_return_if_fail(node);
 	g_return_if_fail(adoptive_parent);
@@ -1174,11 +1466,19 @@
 	xmlAddChild(adoptive_parent, node);
 #endif
 
 }
 
-void cong_node_private_set_text(CongNodePtr node, const xmlChar *new_content)
+/**
+ * cong_node_private_set_text:
+ * @node:
+ * @new_content:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_set_text(CongNodePtr node, const xmlChar *new_content)
 {
 	LOG_NODE_PRIVATE_MODIFICATION("cong_node_private_set_text");
 
 	g_return_if_fail(node);
 	g_return_if_fail(new_content);
@@ -1186,14 +1486,24 @@
 	xmlNodeSetContent(node, new_content);
 
 	update_entities (node);
 }
 
-void cong_node_private_set_attribute(CongNodePtr node,
-				     xmlNs *ns_ptr, 
-				     const xmlChar *local_attribute_name,
-				     const xmlChar *value)
+/**
+ * cong_node_private_set_attribute:
+ * @node:
+ * @ns_ptr:
+ * @local_attribute_name:
+ * @value:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_set_attribute(CongNodePtr node,
+				xmlNs *ns_ptr, 
+				const xmlChar *local_attribute_name,
+				const xmlChar *value)
 {
 	LOG_NODE_PRIVATE_MODIFICATION("cong_node_private_set_attribute");
 
 	g_return_if_fail(node);
 	g_return_if_fail(local_attribute_name);
@@ -1205,13 +1515,22 @@
 		xmlSetNsProp(node, ns_ptr, local_attribute_name, value);
 
 	update_entities (node);
 }
 
-void cong_node_private_remove_attribute(CongNodePtr node, 
-					xmlNs *ns_ptr,
-					const xmlChar *local_attribute_name)
+/**
+ * cong_node_private_remove_attribute:
+ * @node:
+ * @ns_ptr:
+ * @local_attribute_name:
+ *
+ * TODO: Write me
+ */
+void 
+cong_node_private_remove_attribute(CongNodePtr node, 
+				   xmlNs *ns_ptr,
+				   const xmlChar *local_attribute_name)
 {
 	LOG_NODE_PRIVATE_MODIFICATION("cong_node_private_remove_attribute");
 
 	g_return_if_fail(node);
 	g_return_if_fail(local_attribute_name);
@@ -1223,10 +1542,18 @@
 
 	update_entities (node);
 }
 
 /* Utilities: */
+/**
+ * cong_node_get_child_by_name:
+ * @node:
+ * @ns_uri:
+ * @local_name:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_get_child_by_name (CongNodePtr node, 
 			     const gchar *ns_uri, 
 			     const gchar *local_name)
 {
@@ -1242,10 +1569,16 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_node_get_first_text_node_descendant:
+ * @node:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_get_first_text_node_descendant (CongNodePtr node)
 {
 	g_return_val_if_fail (node, NULL);
 
@@ -1264,10 +1597,17 @@
 
 		return NULL;
 	}
 }
 
+/**
+ * cong_node_get_whitespace_handling:
+ * @doc:
+ * @text_node:
+ *
+ * TODO: Write me
+ */
 enum CongWhitespaceHandling
 cong_node_get_whitespace_handling (CongDocument *doc,
 				   CongNodePtr text_node)
 {
 	g_return_val_if_fail (doc, CONG_WHITESPACE_NORMALIZE);
@@ -1283,10 +1623,16 @@
 	}
 	
 	return CONG_WHITESPACE_NORMALIZE;
 }
 
+/**
+ * cong_node_should_be_visible_in_editor:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_node_should_be_visible_in_editor (CongNodePtr node)
 {
 	g_return_val_if_fail (node, FALSE);
 
@@ -1320,10 +1666,16 @@
 	} else {
 		return TRUE;
 	}
 }
 
+/**
+ * cong_node_is_valid_cursor_location:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_node_is_valid_cursor_location (CongNodePtr node)
 {
 	g_return_val_if_fail (node, FALSE);
 
@@ -1336,18 +1688,30 @@
 		/* Eventually allow comment editing: */		
 		return FALSE;
 	}
 }
 
+/**
+ * cong_node_supports_byte_offsets:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_node_supports_byte_offsets (CongNodePtr node)
 {
 	g_return_val_if_fail (node, FALSE);
 	
 	return ((node->type == XML_TEXT_NODE)||(node->type == XML_COMMENT_NODE));
 }
 
+/**
+ * cong_node_can_be_cut:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_node_can_be_cut (CongNodePtr node)
 {
 	g_return_val_if_fail (node, FALSE);
 
@@ -1370,17 +1734,30 @@
 	case CONG_NODE_TYPE_COMMENT:
 		return TRUE;
 	}
 }
 
+/**
+ * cong_node_can_be_copied:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_node_can_be_copied (CongNodePtr node)
 {
 	/* FIXME: should be different conditions (fix after 0.8.0) */
 	return cong_node_can_be_cut(node);
 }
 
+/**
+ * cong_node_get_deepest_common_parent:
+ * @n0:
+ * @n1:
+ *
+ * TODO: Write me
+ */
 CongNodePtr 
 cong_node_get_deepest_common_parent (CongNodePtr n0, 
 				     CongNodePtr n1)
 {
 	CongNodePtr iter0, iter1;
@@ -1398,10 +1775,17 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_node_get_ordering:
+ * @n0:
+ * @n1:
+ *
+ * TODO: Write me
+ */
 int 
 cong_node_get_ordering (CongNodePtr n0,
 			CongNodePtr n1)
 {
 	CongNodePtr deepest_common_parent;
@@ -1461,10 +1845,18 @@
 			}
 		}
 	}
 }
 
+/**
+ * cong_node_calc_first_node_in_subtree_satisfying:
+ * @node:
+ * @predicate:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_node_calc_first_node_in_subtree_satisfying (CongNodePtr node,
 						 CongNodePredicate predicate,
 						 gpointer user_data)
 {
@@ -1491,10 +1883,18 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_node_calc_final_node_in_subtree_satisfying:
+ * @node:
+ * @predicate:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_node_calc_final_node_in_subtree_satisfying (CongNodePtr node, 
 						 CongNodePredicate predicate,
 						 gpointer user_data)
 {
@@ -1521,10 +1921,18 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_node_calc_prev_node_satisfying:
+ * @node:
+ * @predicate:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_node_calc_prev_node_satisfying (CongNodePtr node, 
 				     CongNodePredicate predicate,
 				     gpointer user_data)
 {
@@ -1558,10 +1966,18 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_node_calc_next_node_satisfying:
+ * @node:
+ * @predicate:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_node_calc_next_node_satisfying (CongNodePtr node,
 				     CongNodePredicate predicate,
 				     gpointer user_data)
 {
@@ -1592,9 +2008,5 @@
 		}
 	} else {
 		return NULL;
 	}
 }
-
-
-/* Internal function definitions: */
-
Index: cong-overview-view.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-overview-view.c,v
retrieving revision 1.8
diff -u -5 -r1.8 cong-overview-view.c
--- cong-overview-view.c	7 Feb 2004 01:01:31 -0000	1.8
+++ cong-overview-view.c	17 Apr 2004 17:45:27 -0000
@@ -63,10 +63,16 @@
 	CongDocument *doc;
 	gulong sigid_set_url;
 };
 
 /* Exported function implementations: */
+/**
+ * cong_overview_view_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongTreeView*
 cong_overview_view_new (CongDocument *doc)
 {
 	CongOverviewDetails *overview_details;
 
@@ -269,10 +275,18 @@
 		}
 		break;
 	}
 }
 
+/**
+ * pixbuf_callback:
+ * @cong_tree_view:
+ * @node:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf* pixbuf_callback (CongTreeView *cong_tree_view,
 			    CongNodePtr node,
 			    gpointer user_data)
 {
 	enum CongNodeType node_type;
Index: cong-parser-error.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-parser-error.c,v
retrieving revision 1.8
diff -u -5 -r1.8 cong-parser-error.c
--- cong-parser-error.c	4 Feb 2004 16:24:21 -0000	1.8
+++ cong-parser-error.c	17 Apr 2004 17:45:27 -0000
@@ -16,11 +16,21 @@
 #include "cong-util.h"
 #include "cong-vfs.h"
 
 #include <libxml/catalog.h>
 
-void cong_parser_result_add_issue(CongParserResult *result, enum CongIssueType type, int linenum, gchar *description)
+/**
+ * cong_parser_result_add_issue:
+ * @result:
+ * @type:
+ * @linenum:
+ * @description:
+ *
+ * TODO: Write me
+ */
+void 
+cong_parser_result_add_issue(CongParserResult *result, enum CongIssueType type, int linenum, gchar *description)
 {
 	CongParserIssue *issue;
 
 	g_return_if_fail(result);
 	g_return_if_fail(description);
@@ -39,11 +49,21 @@
 #include <libxml/tree.h>
 #include <libxml/parserInternals.h>
 
 CongParserResult *global_parser_result=NULL;
 
-void on_issue(CongParserResult *result, enum CongIssueType type, xmlParserCtxtPtr ctxt, gchar* description)
+/**
+ * on_issue:
+ * @result:
+ * @type:
+ * @ctxt:
+ * @description:
+ *
+ * TODO: Write me
+ */
+void 
+on_issue(CongParserResult *result, enum CongIssueType type, xmlParserCtxtPtr ctxt, gchar* description)
 {
 	g_return_if_fail(description);
 
 	if (ctxt != NULL) {
 		xmlParserInputPtr input = ctxt->input;
@@ -58,11 +78,20 @@
 			cong_parser_result_add_issue(result, type, -1, description);
 		}		
 	}
 }
 
-void on_sax_error(void *ctx, const char *msg, ...)
+/**
+ * on_sax_error:
+ * @ctx:
+ * @msg:
+ * @...: FIXME: Check how gtk-doc wants to handle var-args
+ *
+ * TODO: Write me
+ */
+void 
+on_sax_error(void *ctx, const char *msg, ...)
 {
 	gchar *str;
 	printf("on_sax_error\n");
 
 	g_assert(global_parser_result);
@@ -72,11 +101,20 @@
 	on_issue(global_parser_result, CONG_ISSUE_ERROR, ctx, str);
 
 	g_free(str);
 }
 
-void on_sax_warning(void *ctx, const char *msg, ...)
+/**
+ * on_sax_warning:
+ * @ctx:
+ * @msg:
+ * @...: FIXME: Check how gtk-doc wants to handle var args
+ *
+ * TODO: Write me
+ */
+void 
+on_sax_warning(void *ctx, const char *msg, ...)
 {
 	gchar *str;
 	printf("on_sax_warning\n");
 
 	g_assert(global_parser_result);
@@ -109,15 +147,24 @@
 #endif
 	GtkWidget *text_view;
 } CongErrorReport;
 
 /* The "row-activated" signal */
-
-void  on_row_activated(GtkTreeView *treeview,
-		       GtkTreePath *arg1,
-		       GtkTreeViewColumn *arg2,
-		       gpointer user_data)
+/**
+ * on_row_activated:
+ * @treeview:
+ * @arg1:
+ * @arg2:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void  
+on_row_activated(GtkTreeView *treeview,
+                 GtkTreePath *arg1,
+                 GtkTreeViewColumn *arg2,
+                 gpointer user_data)
 {
 	CongErrorReport *report = (CongErrorReport*)user_data;
 	GtkTreeIter tree_iter;
 	GtkTextIter text_iter;
 
@@ -147,11 +194,18 @@
 
 enum {
 	CONG_PARSER_ERROR_RESPONSE_RETRY = 1
 };
 
-GtkDialog *cong_parser_result_dialog_new(CongParserResult *parser_result)
+/**
+ * cong_parser_result_dialog_new:
+ * @parser_result:
+ *
+ * TODO: Write me
+ */
+GtkDialog *
+cong_parser_result_dialog_new(CongParserResult *parser_result)
 {
 	GtkWidget *dialog;
 	gchar *title, *filename;
 	GtkWidget *text_view;
 #ifdef ENABLE_GTKSOURCEVIEW
@@ -304,21 +358,35 @@
 	gtk_widget_show_all(dialog);
 
 	return GTK_DIALOG(dialog);
 }
 
-void on_parser_error_details(gpointer data)
+/**
+ * on_parser_error_details:
+ * @data:
+ *
+ * TODO: Write me
+ */
+void 
+on_parser_error_details(gpointer data)
 {
 	GtkDialog * dialog;
 
 	g_message("on_parser_error_details");
 
 	dialog = cong_parser_result_dialog_new((CongParserResult*)data);
 	gtk_dialog_run(GTK_DIALOG(dialog));
 	gtk_widget_destroy(GTK_WIDGET(dialog));
 }
 
+/**
+ * cong_error_dialog_new_file_open_failed_from_parser_error:
+ * @string_uri:
+ * @parser_result:
+ *
+ * TODO: Write me
+ */
 GtkDialog*
 cong_error_dialog_new_file_open_failed_from_parser_error (const gchar* string_uri, 
 							  CongParserResult *parser_result)
 {
 	GtkDialog* dialog = NULL;
@@ -342,10 +410,19 @@
 	g_free(app_name);
 
 	return dialog;
 }
 
+/**
+ * cong_ui_parse_buffer:
+ * @buffer:
+ * @size:
+ * @string_uri:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 xmlDocPtr 
 cong_ui_parse_buffer (const char* buffer,
 		      GnomeVFSFileSize size, 
 		      const gchar *string_uri,
 		      GtkWindow *parent_window)
@@ -397,10 +474,17 @@
 #endif
 
 	
 }
 
+/**
+ * cong_parse_from_filename:
+ * @string_uri:
+ * @parser_result:
+ *
+ * TODO: Write me
+ */
 xmlParserCtxtPtr
 cong_parse_from_filename (const gchar* string_uri,
 			  CongParserResult *parser_result)
 {
 	xmlParserCtxtPtr ctxt;
@@ -427,10 +511,18 @@
 	global_parser_result = NULL;		
 
 	return ctxt;
 }
 
+/**
+ * cong_parse_from_memory:
+ * @buffer:
+ * @size:
+ * @parser_result:
+ *
+ * TODO: Write me
+ */
 xmlParserCtxtPtr
 cong_parse_from_memory (const char* buffer, 
 			GnomeVFSFileSize size,
 			CongParserResult *parser_result)
 {
Index: cong-plugin-manager.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-plugin-manager.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-plugin-manager.c
--- cong-plugin-manager.c	20 Feb 2004 13:51:53 -0000	1.2
+++ cong-plugin-manager.c	17 Apr 2004 17:45:27 -0000
@@ -30,19 +30,34 @@
 {
 	GList *list_of_plugin; /* ptrs of type CongPlugin */
 };
 
 /* Implementation of CongPluginManager: */
-CongPluginManager *cong_plugin_manager_new(void)
+/**
+ * cong_plugin_manager_new:
+ *
+ * Returns: a new #CongPluginManager
+ */
+CongPluginManager *
+cong_plugin_manager_new(void)
 {
 	CongPluginManager *manager;
 
 	manager = g_new0 (CongPluginManager,1);
 	
 	return manager;
 }
 
+/**
+ * cong_plugin_manager_register:
+ * @plugin_manager:
+ * @plugin_id:
+ * @register_callback:
+ * @configure_callback:
+ *
+ * TODO: Write me
+ */
 CongPlugin*
 cong_plugin_manager_register (CongPluginManager *plugin_manager,
 			      const gchar *plugin_id,
 			      CongPluginCallbackRegister register_callback,
 			      CongPluginCallbackConfigure configure_callback)
@@ -64,10 +79,18 @@
 							plugin);
 
 	return plugin;
 }
 
+/**
+ * cong_plugin_manager_for_each_plugin:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_plugin_manager_for_each_plugin (CongPluginManager *plugin_manager, 
 				     void 
 				     (*callback) (CongPlugin *plugin, 
 						  gpointer user_data),
@@ -82,10 +105,18 @@
 		(*callback) (CONG_PLUGIN (iter->data),
 			     user_data);
 	}
 }
 
+/**
+ * cong_plugin_manager_for_each_document_factory:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void 
 cong_plugin_manager_for_each_document_factory (CongPluginManager *plugin_manager, 
 					       void 
 					       (*callback) (CongServiceDocumentFactory *factory, 
 							    gpointer user_data), 
@@ -98,10 +129,18 @@
 	for (iter=plugin_manager->list_of_plugin; iter; iter = iter->next) {
 		cong_plugin_for_each_document_factory(iter->data, callback, user_data);
 	}
 }
 
+/**
+ * cong_plugin_manager_for_each_importer:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void 
 cong_plugin_manager_for_each_importer (CongPluginManager *plugin_manager, 
 				       void 
 				       (*callback) (CongServiceImporter *importer, 
 						    gpointer user_data), 
@@ -114,10 +153,18 @@
 	for (iter=plugin_manager->list_of_plugin; iter; iter = iter->next) {
 		cong_plugin_for_each_importer(iter->data, callback, user_data);
 	}
 }
 
+/**
+ * cong_plugin_manager_for_each_exporter:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void 
 cong_plugin_manager_for_each_exporter (CongPluginManager *plugin_manager, 
 				       void 
 				       (*callback) (CongServiceExporter *exporter, 
 						    gpointer user_data), 
@@ -132,11 +179,20 @@
 	}
 }
 
 
 #if ENABLE_PRINTING
-void cong_plugin_manager_for_each_print_method (CongPluginManager *plugin_manager, 
+/**
+ * cong_plugin_manager_for_each_print_method:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_manager_for_each_print_method (CongPluginManager *plugin_manager, 
 						void 
 						(*callback) (CongServicePrintMethod *print_method, 
 							     gpointer user_data), 
 						gpointer user_data)
 {
@@ -148,32 +204,57 @@
 		cong_plugin_for_each_print_method(iter->data, callback, user_data);
 	}
 }
 #endif
 
-void cong_plugin_manager_for_each_doc_tool(CongPluginManager *plugin_manager, void (*callback)(CongServiceDocTool *tool, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_manager_for_each_doc_tool:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_manager_for_each_doc_tool(CongPluginManager *plugin_manager, void (*callback)(CongServiceDocTool *tool, gpointer user_data), gpointer user_data)
 {
 	GList *iter;
 	g_return_if_fail (plugin_manager);
 	g_return_if_fail (callback);
 
 	for (iter=plugin_manager->list_of_plugin; iter; iter = iter->next) {
 		cong_plugin_for_each_doc_tool(iter->data, callback, user_data);
 	}
 }
 
-void cong_plugin_manager_for_each_node_tool(CongPluginManager *plugin_manager, void (*callback)(CongServiceNodeTool *tool, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_manager_for_each_node_tool:
+ * @plugin_manager:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_manager_for_each_node_tool(CongPluginManager *plugin_manager, void (*callback)(CongServiceNodeTool *tool, gpointer user_data), gpointer user_data)
 {
 	GList *iter;
 	g_return_if_fail (plugin_manager);
 	g_return_if_fail (callback);
 
 	for (iter=plugin_manager->list_of_plugin; iter; iter = iter->next) {
 		cong_plugin_for_each_node_tool(iter->data, callback, user_data);
 	}
 }
 
+/**
+ * cong_plugin_manager_locate_custom_property_dialog_by_id:
+ * @plugin_manager:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongServiceNodePropertyDialog*
 cong_plugin_manager_locate_custom_property_dialog_by_id (CongPluginManager *plugin_manager, 
 							 const gchar *service_id)
 {
 	GList *plugin_iter;
@@ -190,10 +271,17 @@
 	}
 
 	return NULL;
 }
 
+/**
+ * cong_plugin_manager_locate_editor_node_factory_by_id:
+ * @plugin_manager:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongServiceEditorNodeFactory*
 cong_plugin_manager_locate_editor_node_factory_by_id (CongPluginManager *plugin_manager,
 						      const gchar *service_id)
 {
 	GList *plugin_iter;
@@ -209,6 +297,5 @@
 		}
 	}
 	
 	return NULL;
 }
-
Index: cong-plugin.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-plugin.c,v
retrieving revision 1.39
diff -u -5 -r1.39 cong-plugin.c
--- cong-plugin.c	20 Feb 2004 13:51:53 -0000	1.39
+++ cong-plugin.c	17 Apr 2004 17:45:27 -0000
@@ -85,10 +85,19 @@
 #endif
 
 
 
 /* Implementation of CongPlugin: */
+/**
+ * cong_plugin_construct:
+ * @plugin:
+ * @plugin_id:
+ * @register_callback:
+ * @configure_callback:
+ *
+ * TODO: Write me
+ */
 CongPlugin*
 cong_plugin_construct (CongPlugin *plugin,
 		       const gchar *plugin_id,
 		       CongPluginCallbackRegister register_callback,
 		       CongPluginCallbackConfigure configure_callback)
@@ -104,10 +113,17 @@
 	(*register_callback)(plugin);
 
 	return plugin;
 }
 
+/**
+ * cong_plugin_add_service:
+ * @plugin:
+ * @service:
+ *
+ * TODO: Write me
+ */
 void
 cong_plugin_add_service (CongPlugin *plugin,
 			 CongService *service)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
@@ -116,11 +132,18 @@
 	/* Add to plugin's list: */
 	PRIVATE (plugin)->list_of_service = g_list_append (PRIVATE (plugin)->list_of_service, 
 							   service);
 }
 
-
+/**
+ * cong_plugin_for_each_service:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_plugin_for_each_service (CongPlugin *plugin, 
 			      void 
 			      (*callback) (CongService *service,
 					   gpointer user_data),
@@ -130,10 +153,19 @@
 	g_return_if_fail (callback);
 
 	g_list_foreach(PRIVATE(plugin)->list_of_service, (GFunc)callback, user_data);	
 }
 
+/**
+ * cong_plugin_for_each_service_of_type:
+ * @plugin:
+ * @type:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 cong_plugin_for_each_service_of_type (CongPlugin *plugin, 
 				      GType type,
 				      void 
 				      (*callback) (CongService *service,
@@ -152,10 +184,18 @@
 				    user_data);
 		}
 	}
 }
 
+/**
+ * cong_plugin_locate_service_by_id:
+ * @plugin:
+ * @type:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongService*
 cong_plugin_locate_service_by_id (CongPlugin *plugin, 
 				  GType type,
 				  const gchar *service_id)
 {
@@ -181,11 +221,20 @@
 
 typedef void
 (CongServiceCallback) (CongService *service,
 		       gpointer user_data);
 
-void cong_plugin_for_each_document_factory(CongPlugin *plugin, void (*callback)(CongServiceDocumentFactory *factory, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_for_each_document_factory:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_for_each_document_factory(CongPlugin *plugin, void (*callback)(CongServiceDocumentFactory *factory, gpointer user_data), gpointer user_data)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
 	g_return_if_fail (callback);
 
 #if 1
@@ -196,11 +245,20 @@
 #else
 	g_list_foreach(PRIVATE(plugin)->list_of_document_factory, (GFunc)callback, user_data);
 #endif
 }
 
-void cong_plugin_for_each_importer(CongPlugin *plugin, void (*callback)(CongServiceImporter *importer, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_for_each_importer:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_for_each_importer(CongPlugin *plugin, void (*callback)(CongServiceImporter *importer, gpointer user_data), gpointer user_data)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
 	g_return_if_fail (callback);
 
 #if 1
@@ -211,11 +269,20 @@
 #else
 	g_list_foreach(PRIVATE (plugin)->list_of_importer, (GFunc)callback, user_data);
 #endif
 }
 
-void cong_plugin_for_each_exporter(CongPlugin *plugin, void (*callback)(CongServiceExporter *exporter, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_for_each_exporter:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_for_each_exporter(CongPlugin *plugin, void (*callback)(CongServiceExporter *exporter, gpointer user_data), gpointer user_data)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
 	g_return_if_fail (callback);
 
 #if 1
@@ -227,11 +294,20 @@
 	g_list_foreach(PRIVATE (plugin)->list_of_exporter, (GFunc)callback, user_data);
 #endif
 }
 
 #if ENABLE_PRINTING
-void cong_plugin_for_each_print_method(CongPlugin *plugin, void (*callback)(CongServicePrintMethod *print_method, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_for_each_print_method:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_for_each_print_method(CongPlugin *plugin, void (*callback)(CongServicePrintMethod *print_method, gpointer user_data), gpointer user_data)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
 	g_return_if_fail (callback);
 
 #if 1
@@ -243,11 +319,20 @@
 	g_list_foreach(PRIVATE (plugin)->list_of_print_method, (GFunc)callback, user_data);
 #endif
 }
 #endif
 
-void cong_plugin_for_each_doc_tool(CongPlugin *plugin, void (*callback)(CongServiceDocTool *doc_tool, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_for_each_doc_tool:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_for_each_doc_tool(CongPlugin *plugin, void (*callback)(CongServiceDocTool *doc_tool, gpointer user_data), gpointer user_data)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
 	g_return_if_fail (callback);
 
 #if 1
@@ -258,11 +343,20 @@
 #else
 	g_list_foreach(PRIVATE (plugin)->list_of_doc_tool, (GFunc)callback, user_data);
 #endif
 }
 
-void cong_plugin_for_each_node_tool(CongPlugin *plugin, void (*callback)(CongServiceNodeTool *node_tool, gpointer user_data), gpointer user_data)
+/**
+ * cong_plugin_for_each_node_tool:
+ * @plugin:
+ * @callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+cong_plugin_for_each_node_tool(CongPlugin *plugin, void (*callback)(CongServiceNodeTool *node_tool, gpointer user_data), gpointer user_data)
 {
 	g_return_if_fail (IS_CONG_PLUGIN (plugin));
 	g_return_if_fail (callback);
 
 #if 1
@@ -275,10 +369,17 @@
 #endif
 }
 
 
 #if 1
+/**
+ * cong_plugin_locate_custom_property_dialog_by_id:
+ * @plugin:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongServiceNodePropertyDialog*
 cong_plugin_locate_custom_property_dialog_by_id (CongPlugin *plugin, 
 						 const gchar *service_id)
 {	
 	CongService *service;
@@ -295,10 +396,17 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_plugin_locate_editor_node_factory_by_id:
+ * @plugin:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongServiceEditorNodeFactory*
 cong_plugin_locate_editor_node_factory_by_id (CongPlugin *plugin,
 					      const gchar *service_id)
 {
 	CongService *service;
@@ -316,10 +424,17 @@
 		return NULL;
 	}
 
 }
 #else
+/**
+ * cong_plugin_locate_custom_property_dialog_by_id:
+ * @plugin:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongServiceNodePropertyDialog*
 cong_plugin_locate_custom_property_dialog_by_id (CongPlugin *plugin, 
 						 const gchar *service_id)
 {	
 	GList *dialog_iter;
@@ -336,10 +451,17 @@
 	}
 	
 	return NULL;
 }
 
+/**
+ * cong_plugin_locate_editor_node_factory_by_id:
+ * @plugin:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongServiceEditorNodeFactory*
 cong_plugin_locate_editor_node_factory_by_id (CongPlugin *plugin,
 					      const gchar *service_id)
 {
 	GList *factory_iter;
@@ -357,39 +479,65 @@
 
 	return NULL;
 }
 #endif
 
+/**
+ * cong_plugin_get_id:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 const gchar* 
 cong_plugin_get_id (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), NULL);
 
 	return PRIVATE (plugin)->plugin_id;
 }
 
-gchar* cong_plugin_get_gconf_namespace(CongPlugin *plugin)
+/**
+ * cong_plugin_get_gconf_namespace:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gchar* 
+cong_plugin_get_gconf_namespace(CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), NULL);
 
 	g_assert(PRIVATE (plugin)->plugin_id);
 
 	return g_strdup_printf( (CONG_GCONF_PATH "plugins/%s"), PRIVATE (plugin)->plugin_id);
 }
 
-gchar* cong_plugin_get_gconf_key(CongPlugin *plugin, const gchar *local_part)
+/**
+ * cong_plugin_get_gconf_key:
+ * @plugin:
+ * @local_part:
+ *
+ * TODO: Write me
+ */
+gchar* 
+cong_plugin_get_gconf_key(CongPlugin *plugin, const gchar *local_part)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), NULL);
 	g_return_val_if_fail (local_part, NULL);
 
 	g_assert(PRIVATE (plugin)->plugin_id);
 
 	return g_strdup_printf( (CONG_GCONF_PATH "plugins/%s/%s"), PRIVATE (plugin)->plugin_id, local_part);
 }
 
-
-
+/**
+ * cong_ui_new_document_from_manufactured_xml:
+ * @xml_doc:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_ui_new_document_from_manufactured_xml(xmlDocPtr xml_doc,
 					   GtkWindow *parent_window)
 {
 	CongDocument *cong_doc;
@@ -422,10 +570,17 @@
 	g_object_unref(G_OBJECT(cong_doc));
 
 	return cong_doc;
 }
 
+/**
+ * cong_ui_new_document_from_imported_xml:
+ * @xml_doc:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_ui_new_document_from_imported_xml(xmlDocPtr xml_doc,
 				       GtkWindow *parent_window)
 {
 	CongDocument *cong_doc;
@@ -458,13 +613,22 @@
 	g_object_unref(G_OBJECT(cong_doc));
 
 	return cong_doc;
 }
 
-xmlDocPtr cong_ui_transform_doc(CongDocument *doc,
-				const gchar *stylesheet_filename,
-				GtkWindow *toplevel_window)
+/**
+ * cong_ui_transform_doc:
+ * @doc:
+ * @stylesheet_filename:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+xmlDocPtr 
+cong_ui_transform_doc(CongDocument *doc,
+		      const gchar *stylesheet_filename,
+		      GtkWindow *toplevel_window)
 {
 	xsltStylesheetPtr xsl;
 	xmlDocPtr input_clone;
 	xmlDocPtr result;
 
@@ -513,14 +677,24 @@
 	xsltFreeStylesheet(xsl);
 
 	return result;
 }
 
-void cong_ui_transform_doc_to_uri(CongDocument *doc,
-				  const gchar *stylesheet_filename,
-				  const gchar *string_uri,
-				  GtkWindow *toplevel_window)
+/**
+ * cong_ui_transform_doc_to_uri:
+ * @doc:
+ * @stylesheet_filename:
+ * @string_uri:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_ui_transform_doc_to_uri(CongDocument *doc,
+			     const gchar *stylesheet_filename,
+			     const gchar *string_uri,
+			     GtkWindow *toplevel_window)
 {
 	xmlDocPtr doc_ptr;
 	GnomeVFSURI *vfs_uri;
 	GnomeVFSResult vfs_result;
 	GnomeVFSFileSize file_size;
@@ -557,14 +731,24 @@
 		xmlFreeDoc(doc_ptr);
 	}
 }
 
 /* Handy methods for "Import" methods; doing the necessary UI hooks: */
-gboolean cong_ui_load_imported_file_content(const gchar *string_uri,
-					    char** buffer,
-					    GnomeVFSFileSize* size,
-					    GtkWindow *parent_window)
+/**
+ * cong_ui_load_imported_file_content:
+ * @string_uri:
+ * @buffer:
+ * @size:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_ui_load_imported_file_content(const gchar *string_uri,
+				   char** buffer,
+				   GnomeVFSFileSize* size,
+				   GtkWindow *parent_window)
 {
 	GnomeVFSResult vfs_result;
 
 	g_return_val_if_fail (string_uri, FALSE);
 	g_return_val_if_fail (buffer, FALSE);
@@ -586,12 +770,24 @@
 	g_assert(*buffer);
 
 	return TRUE;
 }
 
-
 /* Registration methods for various services: */
+/**
+ * cong_plugin_register_document_factory:
+ * @plugin:
+ * @name:
+ * @description:
+ * @id:
+ * @page_creation_callback:
+ * @action_callback:
+ * @icon:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceDocumentFactory*
 cong_plugin_register_document_factory (CongPlugin *plugin, 
 				       const gchar *name, 
 				       const gchar *description,
 				       const gchar *id,
@@ -623,10 +819,25 @@
 				 CONG_SERVICE (factory));
 
 	return factory;
 }
 
+/**
+ * cong_plugin_register_doc_tool:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @menu_text:
+ * @tooltip_text:
+ * @tooltip_further_text:
+ * @doc_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceDocTool*
 cong_plugin_register_doc_tool (CongPlugin *plugin,
 			       const gchar *name, 
 			       const gchar *description,
 			       const gchar *service_id,
@@ -660,10 +871,25 @@
 
 	return tool;
 
 }
 
+/**
+ * cong_plugin_register_node_tool:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @menu_text:
+ * @tooltip_text:
+ * @tooltip_further_text:
+ * @node_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceNodeTool*
 cong_plugin_register_node_tool (CongPlugin *plugin,
 				const gchar *name, 
 				const gchar *description,
 				const gchar *service_id,
@@ -697,16 +923,28 @@
 
 	return tool;
 
 }
 
-CongServiceEditorNodeFactory *cong_plugin_register_editor_node_factory(CongPlugin *plugin, 
-								      const gchar *name, 
-								      const gchar *description,
-								      const gchar *service_id,
-								      CongEditorNodeFactoryMethod factory_method,
-								      gpointer user_data)
+/**
+ * cong_plugin_register_editor_node_factory:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @factory_method:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+CongServiceEditorNodeFactory *
+cong_plugin_register_editor_node_factory(CongPlugin *plugin, 
+					 const gchar *name, 
+					 const gchar *description,
+					 const gchar *service_id,
+					 CongEditorNodeFactoryMethod factory_method,
+					 gpointer user_data)
 {
 	CongServiceEditorNodeFactory *editor_node_factory;
 
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), NULL);
 	g_return_val_if_fail (name, NULL);
@@ -725,11 +963,22 @@
 				 CONG_SERVICE (editor_node_factory));
 
 	return editor_node_factory;
 }
 
-
+/**
+ * cong_plugin_register_exporter:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @doc_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceExporter*
 cong_plugin_register_exporter (CongPlugin *plugin, 
 			       const gchar *name, 
 			       const gchar *description,
 			       const gchar *service_id,
@@ -758,10 +1007,22 @@
 				 CONG_SERVICE (exporter));
 
 	return exporter;
 }
 
+/**
+ * cong_plugin_register_importer:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @mime_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceImporter*
 cong_plugin_register_importer (CongPlugin *plugin, 
 			       const gchar *name, 
 			       const gchar *description,
 			       const gchar *service_id,
@@ -790,10 +1051,21 @@
 				 CONG_SERVICE (importer));
 
 	return importer;
 }
 
+/**
+ * cong_plugin_register_custom_property_dialog:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @factory_method:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceNodePropertyDialog*
 cong_plugin_register_custom_property_dialog (CongPlugin *plugin,
 					     const gchar *name, 
 					     const gchar *description,
 					     const gchar *service_id,
@@ -819,10 +1091,20 @@
 
 	return property_dialog;
 
 }
 
+/**
+ * cong_plugin_register_custom_property_dialog_for_element:
+ * @plugin:
+ * @element_name:
+ * @service_id:
+ * @factory_method:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceNodePropertyDialog*
 cong_plugin_register_custom_property_dialog_for_element (CongPlugin *plugin,
 							 const gchar *element_name,
 							 const gchar *service_id,
 							 CongCustomPropertyFactoryMethod factory_method,
@@ -853,10 +1135,22 @@
 	
 	return property_dialog;
 }
 
 #if ENABLE_PRINTING
+/**
+ * cong_plugin_register_print_method:
+ * @plugin:
+ * @name:
+ * @description:
+ * @service_id:
+ * @doc_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServicePrintMethod*
 cong_plugin_register_print_method (CongPlugin *plugin, 
 				   const gchar *name, 
 				   const gchar *description,
 				   const gchar *service_id,
Index: cong-primary-window.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-primary-window.c,v
retrieving revision 1.53
diff -u -5 -r1.53 cong-primary-window.c
--- cong-primary-window.c	5 Mar 2004 21:04:20 -0000	1.53
+++ cong-primary-window.c	17 Apr 2004 17:45:27 -0000
@@ -112,11 +112,17 @@
 
 
 };
 
 #if 1
-GtkWidget* cong_gui_get_a_window(void)
+/**
+ * cong_gui_get_a_window:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_gui_get_a_window(void)
 {
 	CongPrimaryWindow *primary_window;
 
 	/* A window _must_ exist for this to work: */
 	if (cong_app_singleton()->primary_windows) {
@@ -130,53 +136,103 @@
 		/* No primary windows exist: */
 		return NULL;
 	}
 }
 #else
-GtkWidget* cong_gui_get_window(struct cong_gui* gui)
+/**
+ * cong_gui_get_window:
+ * @gui:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_gui_get_window(struct cong_gui* gui)
 {
 	g_assert(gui!=NULL);
 
 	return GTK_WIDGET(gui->window);
 }
 
-GtkWidget* cong_gui_get_popup(struct cong_gui* gui)
+/**
+ * cong_gui_get_popup:
+ * @gui:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_gui_get_popup(struct cong_gui* gui)
 {
 	g_assert(gui!=NULL);
 
 	return gui->popup;
 }
 
-void cong_gui_set_popup(struct cong_gui* gui, GtkWidget* popup)
+/**
+ * cong_gui_set_popup:
+ * @gui:
+ * @popup:
+ *
+ * TODO: Write me
+ */
+void 
+cong_gui_set_popup(struct cong_gui* gui, GtkWidget* popup)
 {
 	g_assert(gui!=NULL);
 
 	gui->popup=popup;
 }
 
-GtkWidget* cong_gui_get_button_submit(struct cong_gui* gui)
+/**
+ * cong_gui_get_button_submit:
+ * @gui:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_gui_get_button_submit(struct cong_gui* gui)
 {
 	g_assert(gui!=NULL);
 
 	return gui->butt_submit;
 }
 
-GtkTreeStore* cong_gui_get_tree_store(struct cong_gui* gui)
+/**
+ * cong_gui_get_tree_store:
+ * @gui:
+ *
+ * TODO: Write me
+ */
+GtkTreeStore* 
+cong_gui_get_tree_store(struct cong_gui* gui)
 {
 	g_assert(gui!=NULL);
 
 	return gui->global_tree_store;
 }
 
-GtkWidget* cong_gui_get_root(struct cong_gui* gui)
+/**
+ * cong_gui_get_root:
+ * @gui:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_gui_get_root(struct cong_gui* gui)
 {
 	g_assert(gui!=NULL);
 
 	return gui->root;
 }
 
-void cong_gui_destroy_tree_store(struct cong_gui* gui)
+/**
+ * cong_gui_destroy_tree_store:
+ * @gui:
+ *
+ * TODO: Write me
+ */
+void 
+cong_gui_destroy_tree_store(struct cong_gui* gui)
 {
 	gui->global_tree_store = gtk_tree_store_new (TREEVIEW_N_COLUMNS, G_TYPE_STRING, G_TYPE_POINTER, G_TYPE_POINTER, G_TYPE_STRING, G_TYPE_STRING);
 	gtk_tree_view_set_model(gui->global_tree_view, GTK_TREE_MODEL(gui->global_tree_store));
  
 #if 0
@@ -195,11 +251,19 @@
 extern char *icon_new[];
 extern char *icon_assemble[];
 extern char *icon_openfile[];
 extern char *icon_submit[];
 
-GtkPixmap* cong_primary_window_create_pixmap(CongPrimaryWindow *primary_window, char** xpm)
+/**
+ * cong_primary_window_create_pixmap:
+ * @primary_window:
+ * @xpm:
+ *
+ * TODO: Write me
+ */
+GtkPixmap* 
+cong_primary_window_create_pixmap(CongPrimaryWindow *primary_window, char** xpm)
 {
 	GdkPixmap *p;
 	GdkBitmap *mask;
 	GtkStyle *style;
 
@@ -211,51 +275,91 @@
 					 &style->bg[GTK_STATE_NORMAL],
 					 (gchar **) xpm);
 	return GTK_PIXMAP(gtk_pixmap_new(p, mask));
 }
 
-gint toolbar_callback_undo(GtkWidget *w, gpointer data)
+/**
+ * toolbar_callback_undo:
+ * @w:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_undo(GtkWidget *w, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	cong_document_undo(doc);
 
 	return TRUE;
 }
 
-gint toolbar_callback_redo(GtkWidget *w, gpointer data)
+/**
+ * toolbar_callback_redo:
+ * @w:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_redo(GtkWidget *w, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	cong_document_redo(doc);
 
 	return TRUE;
 }
 
-gint toolbar_callback_cut(GtkWidget *w, gpointer data)
+/**
+ * toolbar_callback_cut:
+ * @w:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_cut(GtkWidget *w, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	cong_document_cut_selection(doc);
 
 	return TRUE;
 }
 
-gint toolbar_callback_copy(GtkWidget *w, gpointer data)
+/**
+ * toolbar_callback_copy:
+ * @w:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_copy(GtkWidget *w, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	cong_document_copy_selection(doc);
 
 	return TRUE;
 }
 
-gint toolbar_callback_paste(GtkWidget *w, gpointer data)
+/**
+ * toolbar_callback_paste:
+ * @w:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+toolbar_callback_paste(GtkWidget *w, gpointer data)
 {
 	CongPrimaryWindow *primary_window = data;
 	CongDocument *doc = cong_primary_window_get_document(primary_window);
 
 	cong_document_paste_clipboard_or_selection(doc, w);
@@ -306,11 +410,18 @@
         CongRange *range = cong_selection_get_ordered_range(selection);
         gtk_widget_set_sensitive (cut,
                                   cong_range_can_be_cut (range));
 }
 
-void cong_primary_window_toolbar_populate(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_toolbar_populate:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_primary_window_toolbar_populate(CongPrimaryWindow *primary_window)
 {
 	if ( !(primary_window->doc) ) {
 		gtk_toolbar_insert_stock(primary_window->toolbar, 
 				 GTK_STOCK_OPEN,
 				 _("Open document"),
@@ -406,11 +517,18 @@
 		gtk_widget_set_sensitive (cut, FALSE);
 		gtk_widget_set_sensitive (paste, cong_document_can_paste(doc));
 	}
 }
 
-gboolean cong_primary_window_can_close(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_can_close:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_primary_window_can_close(CongPrimaryWindow *primary_window)
 {
 	g_assert(primary_window);
 
 	/* If there's no document, you're free to close */
 	if (!primary_window->doc) {
@@ -455,30 +573,52 @@
 	}
 	
 	return TRUE;
 }
 
-
-gint delete_event( GtkWidget *widget,
-		   GdkEvent  *event,
-		   gpointer   data )
+/**
+ * delete_event:
+ * @widget:
+ * @event:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+delete_event( GtkWidget *widget,
+	      GdkEvent  *event,
+	      gpointer   data )
 {
 	/* If the window can't close, return TRUE so the callback chain
 	   ends here */
 	return ! cong_primary_window_can_close((CongPrimaryWindow *)data);
 }
 
-
-void destroy( GtkWidget *widget,
-	      gpointer   data )
+/**
+ * destroy:
+ * @widget:
+ * @data:
+ *
+ * TODO: Write me
+ */
+void 
+destroy( GtkWidget *widget,
+	 gpointer   data )
 {
 	cong_primary_window_free((CongPrimaryWindow *)data);
 	if (g_list_length(cong_app_singleton()->primary_windows) == 0) {		
 		gtk_main_quit();
 	}
 }
 
+/**
+ * cong_primary_window_add_doc:
+ * @primary_window:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 void
 cong_primary_window_add_doc (CongPrimaryWindow *primary_window, CongDocument *doc)
 {
 /* Not sure if these doc != NULL tests area still needed here */
 	GtkWidget *w1 = NULL, *w2 = NULL;
@@ -600,12 +740,18 @@
 	/* update the menus */
 	item_factory = gtk_item_factory_from_widget (primary_window->menus);
 	cong_menus_create_items(item_factory, primary_window);
 }
 
-
-void cong_primary_window_make_gui(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_make_gui:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_primary_window_make_gui(CongPrimaryWindow *primary_window)
 {
 	GtkItemFactory *item_factory;
 	gchar *title;
 
 	g_assert(primary_window);
@@ -697,12 +843,18 @@
 		g_free(status_text);
 	}
 #endif
 }
 
-
-CongPrimaryWindow *cong_primary_window_new(CongDocument *doc)
+/**
+ * cong_primary_window_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+CongPrimaryWindow *
+cong_primary_window_new(CongDocument *doc)
 {
 
 	CongPrimaryWindow *prwin = (CongPrimaryWindow *)g_list_nth_data(cong_app_singleton()->primary_windows, 0);
 	CongPrimaryWindow *primary_window = NULL;
 	
@@ -732,11 +884,18 @@
 
 	return primary_window;
 	
 }
 
-void cong_primary_window_free(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_free:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_primary_window_free(CongPrimaryWindow *primary_window)
 {
 	g_return_if_fail(primary_window);
 
 	g_message ("cong_primary_window_free");
 
@@ -747,18 +906,32 @@
 	cong_app_singleton()->primary_windows = g_list_remove(cong_app_singleton()->primary_windows, primary_window);	
 
 	g_free(primary_window);
 }
 
-CongDocument *cong_primary_window_get_document(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_get_document:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+CongDocument *
+cong_primary_window_get_document(CongPrimaryWindow *primary_window)
 {
 	g_return_val_if_fail(primary_window, NULL);
 
 	return primary_window->doc;
 }
 
-void cong_primary_window_update_title(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_update_title:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_primary_window_update_title(CongPrimaryWindow *primary_window)
 {
 	gchar *title;
 	gchar *filename;
 
 	g_return_if_fail(primary_window);
@@ -783,11 +956,18 @@
 			      title);
 
 	g_free(title);
 }
 
-GtkWindow *cong_primary_window_get_toplevel(CongPrimaryWindow *primary_window)
+/**
+ * cong_primary_window_get_toplevel:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
+GtkWindow *
+cong_primary_window_get_toplevel(CongPrimaryWindow *primary_window)
 {
 	g_return_val_if_fail(primary_window, NULL);
 
 	return GTK_WINDOW(primary_window->window);
 }
Index: cong-progress-checklist.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-progress-checklist.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-progress-checklist.c
--- cong-progress-checklist.c	28 Apr 2003 14:21:36 -0000	1.2
+++ cong-progress-checklist.c	17 Apr 2004 17:45:28 -0000
@@ -116,11 +116,17 @@
 
 		stage_index++;
 	}
 }
 
-GtkWidget *cong_progress_checklist_new(void)
+/**
+ * cong_progress_checklist_new:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_progress_checklist_new(void)
 {
 	GtkTable *widget = GTK_TABLE(gtk_table_new(0,2,FALSE));
 	CongProgressChecklistDetails *details = g_new0(CongProgressChecklistDetails, 1);
 	gtk_table_set_row_spacings(widget,
 				   6);
@@ -132,12 +138,20 @@
 			  details);
 
 	return GTK_WIDGET(widget);
 }
 
-void cong_progress_checklist_add_stage(CongProgressChecklist *progress_checklist,
-				       const gchar *stage_name)
+/**
+ * cong_progress_checklist_add_stage:
+ * @progress_checklist:
+ * @stage_name:
+ *
+ * TODO: Write me
+ */
+void 
+cong_progress_checklist_add_stage(CongProgressChecklist *progress_checklist,
+				  const gchar *stage_name)
 {
 	CongProgressChecklistDetails *details;
 	CongProgressChecklistStage *new_stage;
 
 	g_return_if_fail(progress_checklist);
@@ -177,11 +191,18 @@
 	gtk_widget_show(GTK_WIDGET(new_stage->marker_label));
 	gtk_widget_show(GTK_WIDGET(new_stage->descriptive_label));
 
 }
 
-void cong_progress_checklist_complete_stage(CongProgressChecklist *progress_checklist)
+/**
+ * cong_progress_checklist_complete_stage:
+ * @progress_checklist:
+ *
+ * TODO: Write me
+ */
+void 
+cong_progress_checklist_complete_stage(CongProgressChecklist *progress_checklist)
 {
 	CongProgressChecklistDetails *details;
 
 	g_return_if_fail(progress_checklist);
 
@@ -191,12 +212,20 @@
 
 	details->stages_completed++;
 	refresh_stages(details);
 }
 
-GtkWidget *cong_progress_checklist_dialog_new(const gchar *title,
-					      GtkWindow *parent_window)
+/**
+ * cong_progress_checklist_dialog_new:
+ * @title:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_progress_checklist_dialog_new(const gchar *title,
+				   GtkWindow *parent_window)
 {
 	GtkWidget *dialog;
 	CongProgressChecklistDialogDetails *details = g_new0(CongProgressChecklistDialogDetails, 1);
 
 	dialog = gtk_dialog_new_with_buttons(title,
@@ -216,11 +245,18 @@
 	gtk_widget_show_all(dialog);
 
 	return GTK_WIDGET(dialog);
 }
 
-CongProgressChecklist *cong_progress_checklist_dialog_get_progress_checklist(CongProgressChecklistDialog *progress_checklist_dialog)
+/**
+ * cong_progress_checklist_dialog_get_progress_checklist:
+ * @progress_checklist_dialog:
+ *
+ * TODO: Write me
+ */
+CongProgressChecklist *
+cong_progress_checklist_dialog_get_progress_checklist(CongProgressChecklistDialog *progress_checklist_dialog)
 {
 	CongProgressChecklistDialogDetails *details;
 
 	g_return_val_if_fail(progress_checklist_dialog, NULL);
 	
@@ -229,10 +265,18 @@
 	g_assert(details);
 
 	return details->progress_checklist;
 }
 
-void cong_progress_checklist_dialog_set_progress_bar(CongProgressChecklist *progress_checklist, 
-						    GtkWidget *progress_bar)
+/**
+ * cong_progress_checklist_dialog_set_progress_bar:
+ * @progress_checklist:
+ * @progress_bar:
+ *
+ * This function is not currently implemented
+ */
+void 
+cong_progress_checklist_dialog_set_progress_bar(CongProgressChecklist *progress_checklist, 
+						GtkWidget *progress_bar)
 {
 	/* FIXME: unwritten */
 }
Index: cong-range.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-range.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-range.c
--- cong-range.c	19 Dec 2003 17:24:07 -0000	1.9
+++ cong-range.c	17 Apr 2004 17:45:28 -0000
@@ -24,28 +24,46 @@
 
 #include "global.h"
 #include "cong-range.h"
 #include "cong-eel.h"
 
+/**
+ * cong_range_init:
+ * @range:
+ *
+ * TODO: Write me
+ */
 void
 cong_range_init (CongRange *range)
 {
 	g_return_if_fail (range);
 
 	cong_location_nullify(&range->loc0);
 	cong_location_nullify(&range->loc1);
 }
 
+/**
+ * cong_range_nullify:
+ * @range:
+ *
+ * TODO: Write me
+ */
 void
 cong_range_nullify (CongRange *range)
 {
 	g_return_if_fail (range);
 
 	cong_location_nullify(&range->loc0);
 	cong_location_nullify(&range->loc1);
 }
 
+/**
+ * cong_range_is_valid:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_is_valid (CongRange *range)
 {
 	g_return_val_if_fail (range, FALSE);
 
@@ -66,10 +84,16 @@
 	   What about ordering of the range?
 	 */
 	return (range->loc0.node->parent == range->loc1.node->parent);
 }
 
+/**
+ * cong_range_generate_source:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_range_generate_source (CongRange *range)
 {
 	CongNodePtr iter;
 	gchar *result = NULL;
@@ -120,10 +144,16 @@
 	}
 
 	return result;
 }
 
+/**
+ * cong_range_exists:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_exists (CongRange *range)
 {
 	g_return_val_if_fail (range, FALSE);
 
@@ -132,10 +162,16 @@
 	} else {
 		return FALSE;
 	}	
 }
 
+/**
+ * cong_range_is_empty:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_is_empty (CongRange *range)
 {
 	g_return_val_if_fail (range, TRUE);
 	
@@ -148,10 +184,16 @@
 	}
 
 
 }
 
+/**
+ * cong_range_is_ordered:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_is_ordered (CongRange *range)
 {
 	g_return_val_if_fail (range, FALSE);
 
@@ -172,10 +214,16 @@
 
 	}
 
 }
 
+/**
+ * cong_range_can_be_cut:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_can_be_cut (CongRange *range)
 {
 	g_return_val_if_fail (range, FALSE);
 
@@ -200,18 +248,30 @@
 	} else {
 		return TRUE;
 	}
 }
 
+/**
+ * cong_range_can_be_copied:
+ * @range:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_can_be_copied (CongRange *range)
 {
 	/* FIXME: Should be different conditions, this is in Bugzilla
 	   as Bug #126091 - to be fixed after 0.8.0 */
 	return cong_range_can_be_cut(range);
 }
 
+/**
+ * cong_range_make_ordered:
+ * @range:
+ *
+ * TODO: Write me
+ */
 void
 cong_range_make_ordered (CongRange *range)
 {
 	g_return_if_fail (range);
 
@@ -249,10 +309,17 @@
 		}
 	}
 	
 }
 
+/**
+ * cong_range_is_node:
+ * @range:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_range_is_node (CongRange *range,
 		    CongNodePtr node)
 {
 	g_return_val_if_fail (range, FALSE);
@@ -264,10 +331,17 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_range_copy:
+ * @dst:
+ * @src:
+ *
+ * TODO: Write me
+ */
 void
 cong_range_copy(CongRange *dst, const CongRange *src)
 {
 	g_return_if_fail (dst);
 	g_return_if_fail (src);
Index: cong-service-doc-tool.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-doc-tool.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-doc-tool.c
--- cong-service-doc-tool.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-doc-tool.c	17 Apr 2004 17:45:28 -0000
@@ -31,10 +31,25 @@
 	CongServiceDocToolActionCallback action_callback;
 };
 
 CONG_DEFINE_CLASS (CongServiceDocTool, cong_service_doc_tool, CONG_SERVICE_DOC_TOOL, CongServiceTool, CONG_SERVICE_TOOL_TYPE)
 
+/**
+ * cong_service_doc_tool_construct:
+ * @tool:
+ * @name:
+ * @description:
+ * @service_id:
+ * @menu_text:
+ * @tooltip_text:
+ * @tooltip_further_text:
+ * @doc_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceDocTool*
 cong_service_doc_tool_construct (CongServiceDocTool *tool,
 				 const gchar *name, 
 				 const gchar *description,
 				 const gchar *service_id,
@@ -63,10 +78,17 @@
 
 	return tool;
 
 }
 
+/**
+ * cong_doc_tool_supports_document:
+ * @tool:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_doc_tool_supports_document (CongServiceDocTool *tool, 
 				 CongDocument *doc)
 {
 	g_return_val_if_fail (tool, FALSE);
@@ -77,10 +99,17 @@
 	return PRIVATE (tool)->doc_filter (tool, 
 					   doc, 
 					   cong_service_tool_get_user_data (CONG_SERVICE_TOOL (tool)));
 }
 
+/**
+ * cong_doc_tool_invoke:
+ * @tool:
+ * @primary_window:
+ *
+ * TODO: Write me
+ */
 void 
 cong_doc_tool_invoke (CongServiceDocTool *tool, 
 		      CongPrimaryWindow *primary_window)
 {
 	g_return_if_fail (tool);
Index: cong-service-document-factory.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-document-factory.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-document-factory.c
--- cong-service-document-factory.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-document-factory.c	17 Apr 2004 17:45:28 -0000
@@ -37,11 +37,23 @@
 	gpointer user_data;
 };
 
 CONG_DEFINE_CLASS (CongServiceDocumentFactory, cong_service_document_factory, CONG_SERVICE_DOCUMENT_FACTORY, CongService, CONG_SERVICE_TYPE)
 
-
+/**
+ * cong_service_document_factory_construct:
+ * @factory:
+ * @name: 
+ * @description:
+ * @id:
+ * @page_creation_callback:
+ * @action_callback:
+ * @icon:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceDocumentFactory*
 cong_service_document_factory_construct (CongServiceDocumentFactory* factory,
 					 const gchar *name, 
 					 const gchar *description,
 					 const gchar *id,
@@ -74,11 +86,19 @@
 	return factory;
 	
 }
 
 /* Implementation of CongServiceDocumentFactory: */
-void cong_document_factory_invoke_page_creation_callback(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant)
+/**
+ * cong_document_factory_invoke_page_creation_callback:
+ * @factory:
+ * @assistant:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_factory_invoke_page_creation_callback(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant)
 {
 	g_return_if_fail (IS_CONG_SERVICE_DOCUMENT_FACTORY (factory));
 	g_return_if_fail (assistant);
 
 #if 0
@@ -88,11 +108,19 @@
 	g_assert(PRIVATE (factory)->page_creation_callback);
 
 	PRIVATE (factory)->page_creation_callback(factory, assistant, PRIVATE (factory)->user_data);
 }
 
-void cong_document_factory_invoke_action_callback(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant)
+/**
+ * cong_document_factory_invoke_action_callback:
+ * @factory:
+ * @assistant:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_factory_invoke_action_callback(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant)
 {
 	g_return_if_fail (IS_CONG_SERVICE_DOCUMENT_FACTORY (factory));
 	g_return_if_fail (assistant);
 
 #if 0
@@ -102,11 +130,18 @@
 	g_assert(PRIVATE (factory)->action_callback);
 
 	PRIVATE (factory)->action_callback(factory, assistant, PRIVATE (factory)->user_data);
 }
 
-GdkPixbuf *cong_document_factory_get_icon(CongServiceDocumentFactory *factory)
+/**
+ * cong_document_factory_get_icon:
+ * @factory:
+ *
+ * TODO: Write me
+ */
+GdkPixbuf *
+cong_document_factory_get_icon(CongServiceDocumentFactory *factory)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_DOCUMENT_FACTORY (factory), NULL);
 
 	if (PRIVATE (factory)->icon16) {
 		g_object_ref(G_OBJECT(PRIVATE (factory)->icon16));
Index: cong-service-editor-node-factory.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-editor-node-factory.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-editor-node-factory.c
--- cong-service-editor-node-factory.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-editor-node-factory.c	17 Apr 2004 17:45:28 -0000
@@ -32,10 +32,21 @@
 	gpointer user_data;
 };
 
 CONG_DEFINE_CLASS (CongServiceEditorNodeFactory, cong_service_editor_node_factory, CONG_SERVICE_EDITOR_NODE_FACTORY, CongService, CONG_SERVICE_TYPE)
 
+/**
+ * cong_service_editor_node_factory_construct:
+ * @editor_node_factory:
+ * @name: 
+ * @description:
+ * @plugin_id:
+ * @factory_method:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceEditorNodeFactory*
 cong_service_editor_node_factory_construct (CongServiceEditorNodeFactory *editor_node_factory,
 					    const gchar *name, 
 					    const gchar *description,
 					    const gchar *plugin_id,
@@ -56,10 +67,18 @@
 	PRIVATE (editor_node_factory)->user_data = user_data;
 
 	return editor_node_factory;
 }
 
+/**
+ * cong_plugin_editor_node_factory_invoke:
+ * @service_editor_node_factory:
+ * @editor_widget: 
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElement*
 cong_plugin_editor_node_factory_invoke (CongServiceEditorNodeFactory *service_editor_node_factory,
 					CongEditorWidget3 *editor_widget, 
 					CongTraversalNode *traversal_node)
 {
Index: cong-service-exporter.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-exporter.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-exporter.c
--- cong-service-exporter.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-exporter.c	17 Apr 2004 17:45:28 -0000
@@ -33,10 +33,22 @@
 	gpointer user_data;
 };
 
 CONG_DEFINE_CLASS (CongServiceExporter, cong_service_exporter, CONG_SERVICE_EXPORTER, CongService, CONG_SERVICE_TYPE)
 
+/**
+ * cong_service_exporter_construct:
+ * @exporter:
+ * @name:
+ * @description:
+ * @service_id:
+ * @doc_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceExporter*
 cong_service_exporter_construct (CongServiceExporter *exporter,
 				 const gchar *name, 
 				 const gchar *description,
 				 const gchar *service_id,
@@ -61,11 +73,19 @@
 
 	return exporter;
 }
 
 /* Implementation of CongServiceExporter: */
-gboolean cong_exporter_supports_document(CongServiceExporter *exporter, CongDocument *doc)
+/**
+ * cong_exporter_supports_document:
+ * @exporter:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_exporter_supports_document(CongServiceExporter *exporter, CongDocument *doc)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_EXPORTER (exporter), FALSE);
 	g_return_val_if_fail (doc, FALSE);
 
 	g_assert (PRIVATE (exporter)->doc_filter);
@@ -73,11 +93,21 @@
 	return PRIVATE (exporter)->doc_filter (exporter, 
 					       doc, 
 					       PRIVATE (exporter)->user_data);
 }
 
-void cong_exporter_invoke(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, GtkWindow *toplevel_window)
+/**
+ * cong_exporter_invoke:
+ * @exporter:
+ * @doc:
+ * @uri:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_exporter_invoke(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, GtkWindow *toplevel_window)
 {
 	g_return_if_fail (IS_CONG_SERVICE_EXPORTER (exporter));
 	g_return_if_fail (doc);
 	g_return_if_fail (uri);
 	
@@ -88,11 +118,18 @@
 						    uri, 
 						    PRIVATE (exporter)->user_data, 
 						    toplevel_window);
 }
 
-gchar *cong_exporter_get_preferred_uri(CongServiceExporter *exporter)
+/**
+ * cong_exporter_get_preferred_uri:
+ * @exporter:
+ *
+ * TODO: Write me
+ */
+gchar *
+cong_exporter_get_preferred_uri(CongServiceExporter *exporter)
 {
 	gchar *gconf_key;
 	gchar *preferred_uri;
 
 	g_return_val_if_fail (IS_CONG_SERVICE_EXPORTER (exporter), NULL);
@@ -107,11 +144,19 @@
 	g_free(gconf_key);
 
 	return preferred_uri;
 }
 
-void cong_exporter_set_preferred_uri(CongServiceExporter *exporter, const gchar *uri)
+/**
+ * cong_exporter_set_preferred_uri:
+ * @exporter:
+ * @uri:
+ *
+ * TODO: Write me
+ */
+void 
+cong_exporter_set_preferred_uri(CongServiceExporter *exporter, const gchar *uri)
 {
 	gchar *gconf_key;
 
 	g_return_if_fail (IS_CONG_SERVICE_EXPORTER (exporter));
 	g_return_if_fail (uri);
Index: cong-service-importer.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-importer.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-importer.c
--- cong-service-importer.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-importer.c	17 Apr 2004 17:45:28 -0000
@@ -32,10 +32,22 @@
 	gpointer user_data;
 };
 
 CONG_DEFINE_CLASS (CongServiceImporter, cong_service_importer, CONG_SERVICE_IMPORTER, CongService, CONG_SERVICE_TYPE)
 
+/**
+ * cong_service_importer_construct:
+ * @importer:
+ * @name:
+ * @description:
+ * @id:
+ * @mime_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceImporter*
 cong_service_importer_construct (CongServiceImporter *importer,
 				 const gchar *name, 
 				 const gchar *description,
 				 const gchar *id,
@@ -61,11 +73,19 @@
 
 	return importer;
 }
 
 /* Implementation of CongServiceImporter: */
-gboolean cong_importer_supports_mime_type(CongServiceImporter *importer, const gchar *mime_type)
+/**
+ * cong_importer_supports_mime_type:
+ * @importer:
+ * @mime_type:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_importer_supports_mime_type(CongServiceImporter *importer, const gchar *mime_type)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_IMPORTER (importer), FALSE);
 	g_return_val_if_fail (mime_type, FALSE);
 
 	g_assert (PRIVATE (importer)->mime_filter);
@@ -74,11 +94,21 @@
 						mime_type, 
 						PRIVATE (importer)->user_data);
 
 }
 
-void cong_importer_invoke(CongServiceImporter *importer, const gchar *filename, const gchar *mime_type, GtkWindow *toplevel_window)
+/**
+ * cong_importer_invoke:
+ * @importer:
+ * @filename:
+ * @mime_type:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_importer_invoke(CongServiceImporter *importer, const gchar *filename, const gchar *mime_type, GtkWindow *toplevel_window)
 {
 	g_return_if_fail (IS_CONG_SERVICE_IMPORTER (importer));
 	g_return_if_fail (filename);
 	g_return_if_fail (mime_type);
 	
@@ -87,6 +117,5 @@
 	return PRIVATE (importer)->action_callback (importer, 
 						    filename, 
 						    mime_type, 
 						    PRIVATE (importer)->user_data, toplevel_window);
 }
-
Index: cong-service-node-property-dialog.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-node-property-dialog.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-node-property-dialog.c
--- cong-service-node-property-dialog.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-node-property-dialog.c	17 Apr 2004 17:45:28 -0000
@@ -31,10 +31,21 @@
 	gpointer user_data;
 };
 
 CONG_DEFINE_CLASS (CongServiceNodePropertyDialog, cong_service_node_property_dialog, CONG_SERVICE_NODE_PROPERTY_DIALOG, CongService, CONG_SERVICE_TYPE)
 
+/**
+ * cong_service_node_property_dialog_construct:
+ * @node_property_dialog:
+ * @name:
+ * @description:
+ * @service_id:
+ * @factory_method:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceNodePropertyDialog*
 cong_service_node_property_dialog_construct (CongServiceNodePropertyDialog* node_property_dialog,
 					     const gchar *name, 
 					     const gchar *description,
 					     const gchar *service_id,
@@ -54,13 +65,22 @@
 	PRIVATE (node_property_dialog)->user_data = user_data;
 
 	return node_property_dialog;
 }
 
-GtkWidget *cong_custom_property_dialog_make(CongServiceNodePropertyDialog *node_property_dialog,
-					    CongDocument *doc,
-					    CongNodePtr node)
+/**
+ * cong_custom_property_dialog_make:
+ * @node_property_dialog:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_custom_property_dialog_make(CongServiceNodePropertyDialog *node_property_dialog,
+				 CongDocument *doc,
+				 CongNodePtr node)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_NODE_PROPERTY_DIALOG (node_property_dialog), NULL);
 	g_return_val_if_fail (doc, NULL);
 	g_return_val_if_fail (node, NULL);
 
Index: cong-service-node-tool.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-node-tool.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-service-node-tool.c
--- cong-service-node-tool.c	23 Feb 2004 16:58:25 -0000	1.2
+++ cong-service-node-tool.c	17 Apr 2004 17:45:28 -0000
@@ -31,10 +31,25 @@
 	CongServiceNodeToolActionCallback action_callback;
 };
 
 CONG_DEFINE_CLASS (CongServiceNodeTool, cong_service_node_tool, CONG_SERVICE_NODE_TOOL, CongServiceTool, CONG_SERVICE_TOOL_TYPE)
 
+/**
+ * cong_service_node_tool_construct:
+ * @tool:
+ * @name: 
+ * @description:
+ * @service_id:
+ * @menu_text:
+ * @tooltip_text:
+ * @tooltip_further_text:
+ * @node_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceNodeTool*
 cong_service_node_tool_construct (CongServiceNodeTool *tool,
 				  const gchar *name, 
 				  const gchar *description,
 				  const gchar *service_id,
@@ -62,10 +77,18 @@
 	PRIVATE (tool)->action_callback = action_callback;
 
 	return tool;
 }
 
+/**
+ * cong_service_node_tool_filter_node:
+ * @tool:
+ * @doc: 
+ * @node:
+ *
+ * TODO: Write me
+ */
 enum NodeToolFilterResult
 cong_service_node_tool_filter_node (CongServiceNodeTool *tool, 
 				    CongDocument *doc,
 				    CongNodePtr node)
 {
@@ -78,10 +101,19 @@
 					    doc, 
 					    node, 
 					    cong_service_tool_get_user_data (CONG_SERVICE_TOOL (tool)));
 }
 
+/**
+ * cong_service_node_tool_invoke:
+ * @tool:
+ * @doc: 
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void 
 cong_service_node_tool_invoke (CongServiceNodeTool *tool,
 			       CongDocument *doc,
 			       CongNodePtr node,
 			       GtkWindow *parent_window)
Index: cong-service-print-method.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-print-method.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-print-method.c
--- cong-service-print-method.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-print-method.c	17 Apr 2004 17:45:28 -0000
@@ -32,11 +32,22 @@
 	CongServicePrintMethodActionCallback action_callback;
 	gpointer user_data;
 };
 CONG_DEFINE_CLASS (CongServicePrintMethod, cong_service_print_method, CONG_SERVICE_PRINT_METHOD, CongService, CONG_SERVICE_TYPE)
 
-
+/**
+ * cong_service_print_method_construct:
+ * @print_method:
+ * @name:
+ * @description:
+ * @service_id:
+ * @doc_filter:
+ * @action_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServicePrintMethod *
 cong_service_print_method_construct (CongServicePrintMethod *print_method,
 				     const gchar *name, 
 				     const gchar *description,
 				     const gchar *service_id,
@@ -61,11 +72,19 @@
 
 	return print_method;
 }
 
 /* Implementation of CongServicePrintMethod: */
-gboolean cong_print_method_supports_document(CongServicePrintMethod *print_method, CongDocument *doc)
+/**
+ * cong_print_method_supports_document:
+ * @print_method:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+gboolean 
+cong_print_method_supports_document(CongServicePrintMethod *print_method, CongDocument *doc)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_PRINT_METHOD (print_method), FALSE);
 	g_return_val_if_fail (doc, FALSE);
 
 	g_assert (PRIVATE (print_method)->doc_filter);
@@ -73,11 +92,21 @@
 	return PRIVATE (print_method)->doc_filter (print_method, 
 						   doc, 
 						   PRIVATE (print_method)->user_data);
 }
 
-void cong_print_method_invoke(CongServicePrintMethod *print_method, CongDocument *doc, GnomePrintContext *gpc, GtkWindow *toplevel_window)
+/**
+ * cong_print_method_invoke:
+ * @print_method:
+ * @doc:
+ * @gpc:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+cong_print_method_invoke(CongServicePrintMethod *print_method, CongDocument *doc, GnomePrintContext *gpc, GtkWindow *toplevel_window)
 {
 	g_return_if_fail (IS_CONG_SERVICE_PRINT_METHOD (print_method));
 	g_return_if_fail (doc);
 	g_return_if_fail (gpc);
 	
Index: cong-service-tool.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service-tool.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service-tool.c
--- cong-service-tool.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service-tool.c	17 Apr 2004 17:45:28 -0000
@@ -33,10 +33,23 @@
 	gpointer user_data;
 };
 
 CONG_DEFINE_CLASS (CongServiceTool, cong_service_tool, CONG_SERVICE_TOOL, CongService, CONG_SERVICE_TYPE)
 
+/**
+ * cong_service_tool_construct:
+ * @tool:
+ * @name:
+ * @description:
+ * @service_id:
+ * @menu_text:
+ * @tooltip_text:
+ * @tooltip_further_text:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongServiceTool*
 cong_service_tool_construct (CongServiceTool *tool,
 			     const gchar *name, 
 			     const gchar *description,
 			     const gchar *service_id,
@@ -62,34 +75,58 @@
 
 	return tool;
 
 }
 
+/**
+ * cong_service_tool_get_menu_text:
+ * @tool:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_service_tool_get_menu_text (CongServiceTool *tool)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_TOOL (tool), NULL);
 
 	return PRIVATE (tool)->menu_text;
 }
 
+/**
+ * cong_service_tool_get_tip_text:
+ * @tool:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_service_tool_get_tip_text (CongServiceTool *tool)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_TOOL (tool), NULL);
 
 	return PRIVATE (tool)->tooltip_text;
 }
 
+/**
+ * cong_service_tool_get_tip_further_text:
+ * @tool:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_service_tool_get_tip_further_text (CongServiceTool *tool)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_TOOL (tool), NULL);
 
 	return PRIVATE (tool)->tooltip_further_text;
 }
 
+/**
+ * cong_service_tool_get_user_data:
+ * @tool:
+ *
+ * TODO: Write me
+ */
 gpointer
 cong_service_tool_get_user_data (CongServiceTool *tool)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE_TOOL (tool), NULL);
 
Index: cong-service.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-service.c,v
retrieving revision 1.1
diff -u -5 -r1.1 cong-service.c
--- cong-service.c	11 Jan 2004 04:28:32 -0000	1.1
+++ cong-service.c	17 Apr 2004 17:45:28 -0000
@@ -37,10 +37,19 @@
 CONG_DEFINE_CLASS_END ()
 CONG_DEFINE_EMPTY_DISPOSE(cong_service)
 
 
 /* Implementation of CongService: */
+/**
+ * cong_service_construct:
+ * @service:
+ * @name:
+ * @description:
+ * @service_id:
+ *
+ * TODO: Write me
+ */
 CongService*
 cong_service_construct (CongService* service,
 			const gchar *name, 
 			const gchar *description,
 			const gchar *service_id)
@@ -55,44 +64,75 @@
 	PRIVATE (service)->service_id = g_strdup (service_id);
 
 	return service;
 }
 
+/**
+ * cong_service_get_name:
+ * @service:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_service_get_name (CongService *service)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE (service), NULL);
 	
 	return PRIVATE (service)->name;
 }
 
+/**
+ * cong_service_get_description:
+ * @service:
+ *
+ * TODO: Write me
+ */
 const gchar* 
 cong_service_get_description (CongService *service)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE (service), NULL);
 
 	return PRIVATE (service)->description;
 }
 
+/**
+ * cong_service_get_id:
+ * @service:
+ *
+ * TODO: Write me
+ */
 const gchar* 
 cong_service_get_id (CongService *service)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE (service), NULL);
 
 	return PRIVATE (service)->service_id;
 }
 
+/**
+ * cong_service_get_gconf_namespace:
+ * @service:
+ *
+ * TODO: Write me
+ */
 gchar* 
 cong_service_get_gconf_namespace (CongService* service)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE (service), NULL);
 
 	g_assert (PRIVATE (service)->service_id);
 
 	return g_strdup_printf (CONG_GCONF_PATH "services/%s", PRIVATE (service)->service_id);
 }
 
+/**
+ * cong_service_get_gconf_key:
+ * @service:
+ * @local_part:
+ *
+ * TODO: Write me
+ */
 gchar* 
 cong_service_get_gconf_key (CongService *service, 
 			    const gchar *local_part)
 {
 	g_return_val_if_fail (IS_CONG_SERVICE (service), NULL);
Index: cong-source-view.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-source-view.c,v
retrieving revision 1.16
diff -u -5 -r1.16 cong-source-view.c
--- cong-source-view.c	3 Mar 2004 21:26:23 -0000	1.16
+++ cong-source-view.c	17 Apr 2004 17:45:28 -0000
@@ -67,11 +67,18 @@
 				     gboolean before_change, 
 				     xmlDtdPtr dtd_ptr);
 
 #define DEBUG_SOURCE_VIEW 0
 
-void regenerate_text_buffer(CongSourceView *source_view)
+/**
+ * regenerate_text_buffer:
+ * @source_view:
+ *
+ * TODO: Write me
+ */
+void 
+regenerate_text_buffer(CongSourceView *source_view)
 {
 	CongSourceViewDetails *details;
 
 	g_return_if_fail(source_view);
 
@@ -102,11 +109,10 @@
 	gtk_text_buffer_set_text(GTK_TEXT_BUFFER(details->text_buffer),
 				 "fubar",
 				 -1);
 #endif
 
-
 }
 
 static void on_document_change(CongSourceView *source_view)
 {
 	CongSourceViewDetails *details;
@@ -308,11 +314,18 @@
 	if (!before_event) {
 		on_document_change(source_view);
 	}
 }
 
-GtkWidget *cong_source_view_new(CongDocument *doc)
+/**
+ * cong_source_view_new:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+GtkWidget *
+cong_source_view_new(CongDocument *doc)
 {
 	CongSourceViewDetails *details;
 	CongSourceView *view;
 #ifdef ENABLE_GTKSOURCEVIEW
         GtkSourceLanguagesManager *lang_manager;
Index: cong-text-cache.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-text-cache.c,v
retrieving revision 1.9
diff -u -5 -r1.9 cong-text-cache.c
--- cong-text-cache.c	5 Nov 2003 14:06:39 -0000	1.9
+++ cong-text-cache.c	17 Apr 2004 17:45:28 -0000
@@ -75,10 +75,18 @@
 static CongTextCacheSpan *
 get_text_span_at_original_byte_offset (CongTextCache *text_cache, 
 				       int byte_offset);
 
 /* Exported function definitions: */
+/**
+ * cong_text_cache_new:
+ * @strip_whitespace:
+ * @string:
+ * @attr_list:
+ *
+ * TODO: Write me
+ */
 CongTextCache*
 cong_text_cache_new (gboolean strip_whitespace,
 		     const gchar *string,
 		     PangoAttrList *attr_list)
 {
@@ -95,10 +103,16 @@
 	cong_text_cache_set_input_attributes (cache,
 					      attr_list);
 	return cache;
 }
 
+/**
+ * cong_text_cache_free:
+ * @text_cache:
+ *
+ * TODO: Write me
+ */
 void
 cong_text_cache_free (CongTextCache* text_cache)
 {
 	GList *iter;
 
@@ -112,10 +126,16 @@
 	g_list_free (text_cache->list_of_span);
 	
 	g_free (text_cache);
 }
 
+/**
+ * cong_text_cache_get_output_text:
+ * @text_cache:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_text_cache_get_output_text (CongTextCache* text_cache)
 {
 	g_return_val_if_fail (text_cache, NULL);
 
@@ -125,10 +145,16 @@
 
 	g_assert (text_cache->output_string);
 	return text_cache->output_string;
 }
 
+/**
+ * cong_text_cache_get_output_attributes:
+ * @text_cache:
+ *
+ * TODO: Write me
+ */
 PangoAttrList*
 cong_text_cache_get_output_attributes (CongTextCache* text_cache)
 {
 	g_return_val_if_fail (text_cache, NULL);
 
@@ -142,11 +168,17 @@
 
 	g_assert (text_cache->output_attr_list);
 	return text_cache->output_attr_list;
 }
 
-
+/**
+ * cong_text_cache_set_input_text:
+ * @text_cache:
+ * @input_string:
+ *
+ * TODO: Write me
+ */
 void
 cong_text_cache_set_input_text (CongTextCache* text_cache,
 				const gchar* input_string)
 {
 	g_return_if_fail (text_cache);
@@ -158,10 +190,17 @@
 	text_cache->input_string = g_strdup (input_string);
 
 	clear_cache (text_cache);
 }
 
+/**
+ * cong_text_cache_set_input_attributes:
+ * @text_cache:
+ * @attr_list:
+ *
+ * TODO: Write me
+ */
 void
 cong_text_cache_set_input_attributes (CongTextCache* text_cache,
 				      PangoAttrList *attr_list)
 {
 	g_return_if_fail (text_cache);
@@ -178,11 +217,18 @@
 		pango_attr_list_unref (text_cache->output_attr_list);
 		text_cache->output_attr_list = NULL;
 	}
 }
 
-
+/**
+ * cong_text_cache_convert_stripped_byte_offset_to_original:
+ * @text_cache:
+ * @stripped_byte_offset:
+ * @original_byte_offset:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_text_cache_convert_stripped_byte_offset_to_original (CongTextCache *text_cache,
 							  int stripped_byte_offset,
 							  int *original_byte_offset)
 {
@@ -214,10 +260,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_text_cache_convert_original_byte_offset_to_stripped:
+ * @text_cache:
+ * @original_byte_offset:
+ * @stripped_byte_offset:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_text_cache_convert_original_byte_offset_to_stripped (CongTextCache *text_cache,
 							  int original_byte_offset,
 							  int *stripped_byte_offset)
 {
@@ -521,7 +575,5 @@
 		}
 	}
 
 	return NULL;
 }
-
-
Index: cong-traversal-node.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-traversal-node.c,v
retrieving revision 1.2
diff -u -5 -r1.2 cong-traversal-node.c
--- cong-traversal-node.c	16 Dec 2003 17:27:18 -0000	1.2
+++ cong-traversal-node.c	17 Apr 2004 17:45:28 -0000
@@ -53,10 +53,19 @@
 cong_traversal_node_instance_init (CongTraversalNode *traversal_node)
 {
 	traversal_node->private = g_new0(CongTraversalNodeDetails,1);
 }
 
+/**
+ * cong_traversal_node_construct:
+ * @traversal_node:
+ * @doc_traversal:
+ * @xml_node:
+ * @traversal_parent:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_traversal_node_construct (CongTraversalNode *traversal_node,
 			       CongDocumentTraversal *doc_traversal,
 			       CongNodePtr xml_node,
 			       CongTraversalNode *traversal_parent)
@@ -70,10 +79,18 @@
 	PRIVATE(traversal_node)->traversal_parent = traversal_parent;
 
 	return traversal_node;
 }
 
+/**
+ * cong_traversal_node_new:
+ * @doc_traversal:
+ * @xml_node:
+ * @traversal_parent:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_traversal_node_new (CongDocumentTraversal *doc_traversal,
 			 CongNodePtr xml_node,
 			 CongTraversalNode *traversal_parent)
 {
@@ -81,43 +98,72 @@
 					      doc_traversal,
 					      xml_node,
 					      traversal_parent);
 }
 
-
+/**
+ * cong_traversal_node_get_document_traversal:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongDocumentTraversal*
 cong_traversal_node_get_document_traversal (CongTraversalNode *traversal_node)
 {
 	g_return_val_if_fail (IS_CONG_TRAVERSAL_NODE(traversal_node), NULL);
 
 	return PRIVATE (traversal_node)->doc_traversal;
 }
 
+/**
+ * cong_traversal_node_get_document:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_traversal_node_get_document (CongTraversalNode *traversal_node)
 {
 	g_return_val_if_fail (IS_CONG_TRAVERSAL_NODE(traversal_node), NULL);
 
 	return cong_document_traversal_get_document (PRIVATE (traversal_node)->doc_traversal);
 }
 
+/**
+ * cong_traversal_node_get_node:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_traversal_node_get_node (CongTraversalNode *traversal_node)
 {
 	g_return_val_if_fail (IS_CONG_TRAVERSAL_NODE(traversal_node), NULL);
 
 	return PRIVATE (traversal_node)->xml_node;
 }
 
+/**
+ * cong_traversal_node_get_parent:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_traversal_node_get_parent (CongTraversalNode *traversal_node)
 {
 	g_return_val_if_fail (IS_CONG_TRAVERSAL_NODE(traversal_node), NULL);
 
 	return PRIVATE (traversal_node)->traversal_parent;
 }
 
+/**
+ * cong_traversal_node_get_first_child:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_traversal_node_get_first_child (CongTraversalNode *traversal_node)
 {
 	CongNodePtr other_doc_node;
 
@@ -132,10 +178,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_traversal_node_get_prev:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_traversal_node_get_prev (CongTraversalNode *traversal_node)
 {
 	CongNodePtr other_doc_node;
 
@@ -155,10 +207,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_traversal_node_get_next:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongTraversalNode*
 cong_traversal_node_get_next (CongTraversalNode *traversal_node)
 {
 	CongNodePtr other_doc_node;
 
@@ -178,10 +236,16 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_traversal_node_is_referenced_entity_decl:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_traversal_node_is_referenced_entity_decl (CongTraversalNode *traversal_node)
 {
 	g_return_val_if_fail (IS_CONG_TRAVERSAL_NODE(traversal_node), FALSE);
 
Index: cong-tree-view.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-tree-view.c,v
retrieving revision 1.33
diff -u -5 -r1.33 cong-tree-view.c
--- cong-tree-view.c	3 Mar 2004 21:26:23 -0000	1.33
+++ cong-tree-view.c	17 Apr 2004 17:45:28 -0000
@@ -132,18 +132,28 @@
 
 static void recursive_remove_from_tree_store(CongTreeView *cong_tree_view,
 					     CongNodePtr node);
 
 /* Exported function implementations: */
+/**
+ * cong_tree_view_new:
+ * @doc:
+ * @use_markup:
+ * @node_filter:
+ * @node_creation_callback:
+ * @pixbuf_callback:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 CongTreeView *
 cong_tree_view_new (CongDocument *doc,
 		    gboolean use_markup,
 		    CongTreeViewNodeFilter node_filter,
 		    CongTreeViewNodeCreationCallback node_creation_callback,
 		    CongTreeViewPixbufCallback pixbuf_callback, /* can be NULL */
-		    gpointer user_data
-		    )
+		    gpointer user_data)
 {
 	CongTreeView *cong_tree_view;
 	CongTreeViewDetails *details;
 
  	GtkTreeViewColumn *column;
@@ -256,11 +266,18 @@
 	gtk_widget_show(GTK_WIDGET(details->gtk_tree_view));
 		
 	return cong_tree_view;
 }
 
-void cong_tree_view_free(CongTreeView *tree_view)
+/**
+ * cong_tree_view_free:
+ * @tree_view:
+ *
+ * TODO: Write me
+ */
+void 
+cong_tree_view_free(CongTreeView *tree_view)
 {
 	g_return_if_fail(tree_view);
 
 #if 0
 	g_message ("cong_tree_view_free");
@@ -274,17 +291,31 @@
 
 	g_free(tree_view->view.klass);
 	g_free(tree_view);
 }
 
-GtkWidget* cong_tree_view_get_widget(CongTreeView *tree_view)
+/**
+ * cong_tree_view_get_widget:
+ * @tree_view:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_tree_view_get_widget(CongTreeView *tree_view)
 {
 	g_return_val_if_fail(tree_view, NULL);
 
 	return GTK_WIDGET(tree_view->private->gtk_tree_view);
 }
 
+/**
+ * cong_tree_view_should_show_node:
+ * @cong_tree_view:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_tree_view_should_show_node (CongTreeView *cong_tree_view,
 				 CongNodePtr node)
 {
 	g_return_val_if_fail (cong_tree_view, FALSE);
@@ -295,10 +326,16 @@
 	return PRIVATE(cong_tree_view)->node_filter (cong_tree_view,
 						     node,
 						     PRIVATE(cong_tree_view)->user_data);
 }
 
+/**
+ * cong_tree_view_get_selected_node:
+ * @cong_tree_view:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_tree_view_get_selected_node (CongTreeView *cong_tree_view)
 {
 	GtkTreeIter tree_iter;
 
@@ -309,18 +346,31 @@
 	} else {
 		return NULL;
 	}
 }
 
+/**
+ * cong_tree_view_protected_get_tree_store:
+ * @tree_view:
+ *
+ * TODO: Write me
+ */
 GtkTreeStore* 
 cong_tree_view_protected_get_tree_store (CongTreeView *tree_view)
 {
 	g_return_val_if_fail(tree_view, NULL);
 
 	return tree_view->private->gtk_tree_store;
 }
 
+/**
+ * cong_tree_view_protected_force_node_update:
+ * @tree_view:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_tree_view_protected_force_node_update (CongTreeView *tree_view,
 					    CongNodePtr node)
 {
 	regenerate_data_for_node (tree_view, 
@@ -473,19 +523,34 @@
 	}
 
 }
 #endif
 
-
-gint key_compare_func (gconstpointer a, 
-		       gconstpointer b, 
-		       gpointer user_data)
+/**
+ * key_compare_func:
+ * @a:
+ * @b:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gint 
+key_compare_func (gconstpointer a, 
+		  gconstpointer b, 
+		  gpointer user_data)
 {
 	return (gint)(a-b);
 }
 
-void value_destroy_func (gpointer data)
+/**
+ * value_destroy_func:
+ * @data:
+ *
+ * TODO: Write me
+ */
+void 
+value_destroy_func (gpointer data)
 {
 	g_free(data);
 }
 
 static gboolean 
Index: cong-util.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-util.c,v
retrieving revision 1.30
diff -u -5 -r1.30 cong-util.c
--- cong-util.c	5 Mar 2004 21:04:20 -0000	1.30
+++ cong-util.c	17 Apr 2004 17:45:28 -0000
@@ -46,10 +46,19 @@
 #endif
 #endif
 
 #include "cong-attribute-editor.h"
 
+/**
+ * cong_util_load_glade_file:
+ * @filename:
+ * @root:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 GladeXML*
 cong_util_load_glade_file (const gchar *filename,
 			   const gchar *root,
 			   CongDocument *doc,
 			   CongNodePtr node)
@@ -81,10 +90,16 @@
 	g_free(glade_filename);
 
 	return xml;
 }
 
+/**
+ * cong_util_is_docbook:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_util_is_docbook (CongDocument *doc) 
 {
 	const CongXMLChar* dtd_public_id;
 
@@ -108,10 +123,16 @@
 
 
 	return FALSE;
 }
 
+/**
+ * cong_util_is_pure_whitespace:
+ * @utf8_text:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_util_is_pure_whitespace (const gchar *utf8_text)
 {
 	gunichar ch;
 
@@ -126,10 +147,16 @@
 	}
 	
 	return TRUE;
 }
 
+/**
+ * cong_util_cleanup_text:
+ * @src_text:
+ *
+ * TODO: Write me
+ */
 gchar* 
 cong_util_cleanup_text (const xmlChar *src_text) 
 {
 #if 0
 	gchar *buffer;
@@ -170,10 +197,17 @@
 
 	return buffer;
 #endif
 }
 
+/**
+ * cong_util_text_header:
+ * @text:
+ * @truncation_length:
+ *
+ * TODO: Write me
+ */
 gchar* 
 cong_util_text_header (const xmlChar *text,
 		       guint truncation_length)
 {
 	CongTextCache* text_cache;
@@ -199,11 +233,15 @@
 	cong_text_cache_free (text_cache);
 
 	return result;
 }
 
-
+/**
+ * cong_utils_get_norman_walsh_stylesheet_path:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_utils_get_norman_walsh_stylesheet_path(void)
 {
        /* This should be changed if another catalog is in use, i guess */
        xmlChar *resolved_path = NULL;
@@ -213,10 +251,16 @@
        g_message ("Norman Walsh XSL path: %s", resolved_path);
 
        return resolved_path;
 }
 
+/**
+ * cong_utils_get_norman_walsh_stylesheet:
+ * @stylesheet_relative_path:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_utils_get_norman_walsh_stylesheet(const gchar *stylesheet_relative_path)
 {
 	xmlChar *path;
 	gchar *result;
@@ -230,10 +274,16 @@
 	xmlFree (path);
 
 	return result;
 }
 
+/**
+ * cong_util_load_icon:
+ * @icon_basename:
+ *
+ * TODO: Write me
+ */
 GdkPixbuf*
 cong_util_load_icon (const gchar *icon_basename)
 {
 	gchar *filename;
 	gchar *full_path;
@@ -253,10 +303,17 @@
 	g_free(filename);
 
 	return pixbuf;
 }
 
+/**
+ * cong_util_append:
+ * @string:
+ * @to_add:
+ *
+ * TODO: Write me
+ */
 void 
 cong_util_append (gchar **string, 
 		  const gchar *to_add)
 {
 	gchar *new_string;
@@ -269,10 +326,17 @@
 	g_free(*string);
 
 	*string = new_string;
 }
 
+/**
+ * cong_util_prepend:
+ * @string:
+ * @to_add:
+ *
+ * TODO: Write me
+ */
 void 
 cong_util_prepend (gchar **string, 
 		  const gchar *to_add)
 {
 	gchar *new_string;
@@ -286,10 +350,18 @@
 
 	*string = new_string;
 }
 
 #if (ENABLE_PRINTING && ENABLED_LIBFO)
+/**
+ * cong_util_print_xslfo:
+ * @toplevel_window:
+ * @gpc:
+ * @xml_doc:
+ *
+ * TODO: Write me
+ */
 void 
 cong_util_print_xslfo (GtkWindow *toplevel_window, 
 		       GnomePrintContext *gpc,
 		       xmlDocPtr xml_doc)
 {
@@ -379,10 +451,19 @@
 #endif
 
 /**
    Make DTD declaration, and assigns it to the given document.  Doesn't add it to doc tree.
  */
+/**
+ * cong_util_make_dtd:
+ * @xml_doc:
+ * @root_element:
+ * @ExternalID:
+ * @SystemID:
+ *
+ * TODO: Write me
+ */
 xmlDtdPtr
 cong_util_make_dtd (xmlDocPtr xml_doc,
 		    const xmlChar *root_element,
 		    const xmlChar *ExternalID, 
 		    const xmlChar *SystemID)
@@ -430,10 +511,19 @@
 }	
 
 /**
    Make DTD declaration, assigns it to the given document, and add it to the tree.
 */
+/**
+ * cong_util_add_external_dtd:
+ * @xml_doc:
+ * @root_element:
+ * @ExternalID:
+ * @SystemID:
+ *
+ * TODO: Write me
+ */
 xmlDtdPtr 
 cong_util_add_external_dtd (xmlDocPtr xml_doc, 
 			    const xmlChar *root_element,
 			    const xmlChar *ExternalID, 
 			    const xmlChar *SystemID)
@@ -476,10 +566,20 @@
 }
 
 static GdkColor white = {0, 0xffff, 0xffff, 0xffff};
 
 /* Dodgy hack to do lines that blend to white: */
+/**
+ * cong_util_draw_blended_line:
+ * @w:
+ * @col:
+ * @x0:
+ * @y0:
+ * @x1:
+ *
+ * TODO: Write me
+ */
 void 
 cong_util_draw_blended_line (GtkWidget *w,
 			     const GdkColor *col,
 			     int x0, int y0,
 			     int x1)
@@ -506,10 +606,16 @@
 	}
 
 	gdk_gc_unref(gc);
 }
 
+/**
+ * cong_util_get_int_from_rgb_hex:
+ * @string:
+ *
+ * TODO: Write me
+ */
 unsigned int
 cong_util_get_int_from_rgb_hex (const gchar *string)
 {
 	unsigned int col;
 	
@@ -527,11 +633,17 @@
 	}
 	
 	return(col);
 }
 
-
+/**
+ * cong_util_ns_equality:
+ * @xml_ns1:
+ * @xml_ns2:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_util_ns_equality (const xmlNs *xml_ns1,
 		       const xmlNs *xml_ns2)
 {
 	if (xml_ns1 == NULL && xml_ns2 == NULL)
@@ -542,19 +654,33 @@
 
 	return cong_util_ns_uri_equality (xml_ns1->href, 
 					  xml_ns2->href);
 }
 
+/**
+ * cong_util_ns_uri_equality:
+ * @uri0:
+ * @uri1:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_util_ns_uri_equality (const gchar* uri0, 
 			   const gchar* uri1)
 {
 	return 0==cong_util_ns_uri_sort_order (uri0, 
 					       uri1);
 
 }
 
+/**
+ * cong_util_ns_uri_sort_order:
+ * @uri0:
+ * @uri1:
+ *
+ * TODO: Write me
+ */
 gint
 cong_util_ns_uri_sort_order (const gchar* uri0, 
 			     const gchar* uri1)
 {
 	/* Names are the same; continue searching by namespace; order the NULL namespace before all others: */
@@ -575,10 +701,17 @@
 		}
 	}
 
 }
 
+/**
+ * cong_util_attribute_value_equality:
+ * @value0:
+ * @value1:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_util_attribute_value_equality (const gchar *value0,
 				    const gchar *value1)
 {
 	if (value0) {
@@ -594,11 +727,17 @@
 			return TRUE;
 		}
 	}
 }
 
-
+/**
+ * cong_element_description_new:
+ * @ns_uri:
+ * @local_name:
+ *
+ * TODO: Write me
+ */
 CongElementDescription*
 cong_element_description_new (const gchar *ns_uri,
 			      const gchar *local_name)
 {
 	CongElementDescription *element_desc;
@@ -613,10 +752,16 @@
 	element_desc->local_name = g_strdup (local_name);
 
 	return element_desc;
 }
 
+/**
+ * cong_element_description_clone:
+ * @element_desc:
+ *
+ * TODO: Write me
+ */
 CongElementDescription*
 cong_element_description_clone (const CongElementDescription *element_desc)
 {
 	CongElementDescription *new_element_desc;
 
@@ -630,10 +775,16 @@
 	new_element_desc->local_name = g_strdup (element_desc->local_name);
 
 	return new_element_desc;
 }
 
+/**
+ * cong_element_description_free:
+ * @element_desc:
+ *
+ * TODO: Write me
+ */
 void
 cong_element_description_free (CongElementDescription *element_desc)
 {
 	g_return_if_fail (element_desc);
 
@@ -641,10 +792,18 @@
 		g_free (element_desc->ns_uri);
 	}
 	g_free (element_desc->local_name);
 }
 
+/**
+ * cong_element_description_make_node:
+ * @element_desc:
+ * @doc:
+ * @ns_search_node:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_element_description_make_node (const CongElementDescription *element_desc,
 				    CongDocument *doc,
 				    CongNodePtr ns_search_node)
 {
@@ -662,10 +821,17 @@
 					  element_desc->local_name,
 					  doc);
 	return new_node;	
 }
 
+/**
+ * cong_element_description_get_dispspec_element_for_doc:
+ * @element_desc:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_element_description_get_dispspec_element_for_doc (const CongElementDescription *element_desc,
 						       CongDocument *doc)
 {
 	CongDispspec *ds;
@@ -678,10 +844,17 @@
 
 	return cong_element_description_get_dispspec_element_for_dispspec (element_desc,
 									   ds);
 }
 
+/**
+ * cong_element_description_get_dispspec_element_for_dispspec:
+ * @element_desc:
+ * @ds:
+ *
+ * TODO: Write me
+ */
 CongDispspecElement*
 cong_element_description_get_dispspec_element_for_dispspec (const CongElementDescription *element_desc,
 							    CongDispspec *ds)
 {
 	g_return_val_if_fail (element_desc, NULL);
@@ -700,11 +873,16 @@
 
 	return ;
 }
 #endif
 
-
+/**
+ * cong_element_description_list_free:
+ * @list_of_element_desc:
+ *
+ * TODO: Write me
+ */
 void
 cong_element_description_list_free (GList *list_of_element_desc)
 {
 	GList *iter;
 
@@ -721,10 +899,19 @@
 	FIELD_ELEMENT_LOCAL_NAME,
 
 	NUM_FIELDS
 };
 
+/**
+ * sort_func_ds_user_visible_name:
+ * @model:
+ * @a:
+ * @b:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 gint
 sort_func_ds_user_visible_name (GtkTreeModel *model,
 				GtkTreeIter *a,
 				GtkTreeIter *b,
 				gpointer user_data)
@@ -762,10 +949,19 @@
 	g_free (val_b);
 
 	return result;
 }
 
+/**
+ * sort_func_element_local_name:
+ * @model:
+ * @a:
+ * @b:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 gint
 sort_func_element_local_name (GtkTreeModel *model,
 			      GtkTreeIter *a,
 			      GtkTreeIter *b,
 			      gpointer user_data)
@@ -800,11 +996,19 @@
 	
 	gtk_widget_set_sensitive (glade_xml_get_widget (xml, "okbutton"),
 				  gtk_tree_selection_get_selected (selection, NULL, NULL));
 }
 
-
+/**
+ * cong_util_modal_element_selection_dialog:
+ * @title:
+ * @description:
+ * @doc:
+ * @elements:
+ *
+ * TODO: Write me
+ */
 CongElementDescription*
 cong_util_modal_element_selection_dialog (const gchar *title, 
 					  const gchar *description,
 					  CongDocument *doc,
 					  GList *elements)
@@ -978,11 +1182,18 @@
         g_object_unref(G_OBJECT(xml));
 
 	return result;
 }
 
-
+/**
+ * cong_util_make_menu_item:
+ * @label:
+ * @tip:
+ * @pixbuf:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_util_make_menu_item (const gchar *label,
 			  const gchar *tip,
 			  GdkPixbuf *pixbuf)
 {
@@ -1006,19 +1217,31 @@
 	}
 
 	return GTK_MENU_ITEM(item);
 }
 
+/**
+ * cong_util_make_stock_menu_item:
+ * @stock_id:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_util_make_stock_menu_item (const gchar *stock_id)
 {
 	g_return_val_if_fail (stock_id, NULL);
 
 	return GTK_MENU_ITEM (gtk_image_menu_item_new_from_stock(stock_id,
 								 NULL));
 }
 
+/**
+ * cong_util_make_menu_item_for_dispspec_element:
+ * @element:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_util_make_menu_item_for_dispspec_element (CongDispspecElement *element)
 {
 	GtkMenuItem *item;
 	GdkPixbuf *pixbuf;
@@ -1041,10 +1264,17 @@
 	}
 
 	return item;
 }
 
+/**
+ * cong_util_make_menu_item_for_element_desc:
+ * @element_desc:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_util_make_menu_item_for_element_desc (const CongElementDescription *element_desc,
 					   CongDocument *doc)
 {
 	CongDispspecElement* ds_element;
@@ -1061,10 +1291,16 @@
 						 NULL,
 						 NULL);
 	}
 }
 
+/**
+ * cong_util_add_menu_separator:
+ * @menu:
+ *
+ * TODO: Write me
+ */
 GtkWidget*
 cong_util_add_menu_separator (GtkMenu *menu)
 {
 	GtkWidget *item = gtk_menu_item_new ();
 	GtkWidget *w0 = gtk_hseparator_new ();
@@ -1078,10 +1314,17 @@
 	gtk_widget_show (item);
 
 	return item;
 }
 
+/**
+ * cong_util_get_qualified_attribute_name:
+ * @namespace:
+ * @local_attribute_name:
+ *
+ * TODO: Write me
+ */
 char *
 cong_util_get_qualified_attribute_name(const xmlNs *namespace,
 				       const xmlChar *local_attribute_name)
 {
 	g_return_val_if_fail(local_attribute_name != NULL, NULL);
Index: cong-vfs.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-vfs.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-vfs.c
--- cong-vfs.c	1 Dec 2003 18:51:55 -0000	1.4
+++ cong-vfs.c	17 Apr 2004 17:45:28 -0000
@@ -30,10 +30,18 @@
 #include "cong-parser-error.h"
 
 /*
   A routine that tries to load all the bytes requested from the handle into the buffer and bails out on any failure
  */
+/**
+ * cong_vfs_read_bytes:
+ * @vfs_handle:
+ * @buffer:
+ * @bytes:
+ *
+ * TODO: Write me
+ */
 GnomeVFSResult
 cong_vfs_read_bytes (GnomeVFSHandle* vfs_handle, 
 		     char* buffer, 
 		     GnomeVFSFileSize bytes)
 {
@@ -46,10 +54,18 @@
 }
 
 /* 
    A routine that tries to syncronously load a file into a buffer in memory (surely this exists already somewhere?)
 */
+/**
+ * cong_vfs_new_buffer_from_file:
+ * @filename:
+ * @buffer:
+ * @size:
+ *
+ * TODO: Write me
+ */
 GnomeVFSResult
 cong_vfs_new_buffer_from_file (const char* filename, 
 			       char** buffer, 
 			       GnomeVFSFileSize* size)
 {
@@ -80,10 +96,18 @@
 	gnome_vfs_uri_unref(uri);
 
 	return vfs_result;
 }
 
+/**
+ * cong_vfs_new_buffer_from_uri:
+ * @uri:
+ * @buffer:
+ * @size:
+ *
+ * TODO: Write me
+ */
 GnomeVFSResult
 cong_vfs_new_buffer_from_uri (GnomeVFSURI* uri, 
 			      char** buffer, 
 			      GnomeVFSFileSize* size)
 {
@@ -150,10 +174,17 @@
 
 		return GNOME_VFS_OK;
 	}
 }
 
+/**
+ * cong_vfs_load_xml_from_uri:
+ * @string_uri:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 xmlDocPtr
 cong_vfs_load_xml_from_uri (const gchar *string_uri,
 			    GtkWindow *parent_window)
 {
 	xmlDocPtr xml_doc = NULL;
@@ -249,10 +280,18 @@
 		return xml_doc;
 	}
 #endif
 }
 
+/**
+ * cong_vfs_save_xml_to_uri:
+ * @doc_ptr:
+ * @file_uri:
+ * @output_file_size:
+ *
+ * TODO: Write me
+ */
 GnomeVFSResult
 cong_vfs_save_xml_to_uri (xmlDocPtr doc_ptr, 
 			  GnomeVFSURI *file_uri,	
 			  GnomeVFSFileSize *output_file_size)
 {
@@ -301,12 +340,17 @@
 	vfs_result = gnome_vfs_close(vfs_handle);
 
 	return vfs_result;
 }
 
-
-/* Convert a URI into a POSIX, path, assuming that this is valid: */
+/**
+ * cong_vfs_get_local_path_from_uri:
+ * @uri: a #GnomeVFSURI
+ *
+ * Returns: a #gchar containing @uri as a POSIX path, assuming it is
+ * valid
+ */
 gchar*
 cong_vfs_get_local_path_from_uri (GnomeVFSURI *uri)
 {
 	gchar *uri_string;
 
@@ -323,10 +367,18 @@
 
 	g_message("got \"%s\"",uri_string);
 	return uri_string;
 }
 
+/**
+ * cong_vfs_split_vfs_uri:
+ * @vfs_uri:
+ * @filename_alone:
+ * @path:
+ *
+ * TODO: Write me
+ */
 void
 cong_vfs_split_vfs_uri (const GnomeVFSURI* vfs_uri, 
 			gchar** filename_alone, 
 			gchar** path)
 {
@@ -357,10 +409,18 @@
 	gnome_vfs_uri_unref(parent_uri);
 
 #endif
 }
 
+/**
+ * cong_vfs_split_string_uri:
+ * @string_uri:
+ * @filename_alone:
+ * @path:
+ *
+ * TODO: Write me
+ */
 void
 cong_vfs_split_string_uri (const gchar* string_uri,
 			   gchar** filename_alone, 
 			   gchar** path)
 {
@@ -375,10 +435,16 @@
 				path);
 	
 	gnome_vfs_uri_unref (vfs_uri);
 }
 
+/**
+ * cong_vfs_extract_short_name:
+ * @string_uri:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_vfs_extract_short_name (const gchar *string_uri)
 {
 	GnomeVFSURI* vfs_uri;
 	gchar *result;
Index: cong-view.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-view.c,v
retrieving revision 1.3
diff -u -5 -r1.3 cong-view.c
--- cong-view.c	24 Jun 2003 16:44:03 -0000	1.3
+++ cong-view.c	17 Apr 2004 17:45:28 -0000
@@ -24,18 +24,30 @@
 
 #include "global.h"
 #include "cong-view.h"
 #include "cong-document.h"
 
+/**
+ * cong_view_get_document:
+ * @view:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_view_get_document(CongView *view)
 {
 	g_return_val_if_fail(view, NULL);
 
 	return view->doc;
 }
 
+/**
+ * cong_view_get_dispspec
+ * @view:
+ *
+ * TODO: Write me
+ */
 CongDispspec*
 cong_view_get_dispspec(CongView *view)
 {
 	g_return_val_if_fail(view, NULL);
 
Index: cong-xpath-expression.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cong-xpath-expression.c,v
retrieving revision 1.4
diff -u -5 -r1.4 cong-xpath-expression.c
--- cong-xpath-expression.c	4 Feb 2004 16:24:21 -0000	1.4
+++ cong-xpath-expression.c	17 Apr 2004 17:45:28 -0000
@@ -88,10 +88,19 @@
 cong_xpath_expression_instance_init (CongXPathExpression *node)
 {
 	node->private = g_new0(CongXPathExpressionDetails,1);
 }
 
+/**
+ * cong_xpath_expression_construct:
+ * @xpath_expression:
+ * @doc:
+ * @context_node:
+ * @xpath_expression_string:
+ *
+ * TODO: Write me
+ */
 CongXPathExpression*
 cong_xpath_expression_construct (CongXPathExpression *xpath_expression,
 				 CongDocument *doc,
 				 CongNodePtr context_node,
 				 const gchar *xpath_expression_string)
@@ -104,10 +113,18 @@
 	PRIVATE(xpath_expression)->ctxt->node = context_node;
 
 	return xpath_expression;
 }
 
+/**
+ * cong_xpath_expression_new:
+ * @doc:
+ * @context_node:
+ * @xpath_expression_string:
+ *
+ * TODO: Write me
+ */
 CongXPathExpression*
 cong_xpath_expression_new (CongDocument *doc,
 			   CongNodePtr context_node,
 			   const gchar *xpath_expression_string)
 {
@@ -120,26 +137,44 @@
 		 doc,
 		 context_node,
 		 xpath_expression_string);
 }
 
+/**
+ * cong_xpath_expression_get_document:
+ * @xpath_expression:
+ *
+ * TODO: Write me
+ */
 CongDocument*
 cong_xpath_expression_get_document (CongXPathExpression *xpath_expression)
 {
 	g_return_val_if_fail (xpath_expression, NULL);
 	
 	return PRIVATE(xpath_expression)->doc;
 }
 
+/**
+ * cong_xpath_expression_get_context_node:
+ * @xpath_expression:
+ *
+ * TODO: Write me
+ */
 CongNodePtr
 cong_xpath_expression_get_context_node (CongXPathExpression *xpath_expression)
 {
 	g_return_val_if_fail (xpath_expression, NULL);
 
 	return PRIVATE(xpath_expression)->context_node;
 }
 
+/**
+ * cong_xpath_expression_get_string_result:
+ * @xpath_expression:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_xpath_expression_get_string_result (CongXPathExpression *xpath_expression)
 {
 	g_return_val_if_fail (xpath_expression, NULL);
 
Index: cursor.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/cursor.c,v
retrieving revision 1.41
diff -u -5 -r1.41 cursor.c
--- cursor.c	11 Feb 2004 15:54:23 -0000	1.41
+++ cursor.c	17 Apr 2004 17:45:28 -0000
@@ -12,11 +12,19 @@
 #include "cong-error-dialog.h"
 #include "cong-font.h"
 #include "cong-command.h"
 #include "cong-ui-hooks.h"
 
-void cong_cursor_init(CongCursor *curs, CongDocument *doc)
+/**
+ * cong_cursor_init:
+ * @curs:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_cursor_init(CongCursor *curs, CongDocument *doc)
 {
 	GdkColor gcol;
 
 	g_assert(curs!=NULL);
 	g_assert(doc!=NULL);
@@ -33,11 +41,18 @@
 	col_to_gcol(&gcol, 0x00000000);
 	gdk_colormap_alloc_color(cong_gui_get_a_window()->style->colormap, &gcol, 0, 1);
 	gdk_gc_set_foreground(curs->gc, &gcol);
 }
 
-void cong_cursor_uninit(CongCursor *curs)
+/**
+ * cong_cursor_uninit:
+ * @curs:
+ *
+ * TODO: Write me
+ */
+void 
+cong_cursor_uninit(CongCursor *curs)
 {
 	g_assert(curs);
 
 	curs->doc = NULL;
 	cong_location_nullify(&curs->location);
@@ -48,12 +63,18 @@
 	}
 
 	/* FIXME: anything else needed? */
 }
 
-
-gint cong_cursor_blink(gpointer data)
+/**
+ * cong_cursor_blink:
+ * @data:
+ *
+ * TODO: Write me
+ */
+gint 
+cong_cursor_blink(gpointer data)
 {
 	CongCursor *curs = data;
 
 #if 0
 	g_message("cong_cursor_blink");
@@ -74,11 +95,18 @@
 	cong_document_end_edit(curs->doc);
 	
 	return(TRUE);
 }
 
-int cong_cursor_paragraph_insert(CongCursor *curs)
+/**
+ * cong_cursor_paragraph_insert:
+ * @curs:
+ *
+ * TODO: Write me
+ */
+int 
+cong_cursor_paragraph_insert(CongCursor *curs)
 {
         CongNodePtr t;
         CongNodePtr iter, next;
 	CongNodePtr new_element;
 	xmlNsPtr xml_ns;
@@ -139,11 +167,19 @@
 	cong_document_end_edit (doc);
 
 	return(1);
 }
 
-void cong_cursor_del_prev_char(CongCursor *curs, CongDocument *doc)
+/**
+ * cong_cursor_del_prev_char:
+ * @curs:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_cursor_del_prev_char(CongCursor *curs, CongDocument *doc)
 {
 	CongLocation prev_char;
 
 	g_return_if_fail(curs);
 	g_return_if_fail(doc);
@@ -157,17 +193,22 @@
 		
 		cong_location_del_next_char(doc, &curs->location);
 	}
 }
 
-
-void cong_cursor_del_next_char(CongCursor *curs, CongDocument *doc)
+/**
+ * cong_cursor_del_next_char:
+ * @curs:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_cursor_del_next_char(CongCursor *curs, CongDocument *doc)
 {
 	g_return_if_fail(curs);
 	g_return_if_fail(doc);
 
 	if (!cong_location_exists(&curs->location)) return;
 
 	cong_location_del_next_char(doc, &curs->location);
 }
-
-
Index: file.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/file.c,v
retrieving revision 1.6
diff -u -5 -r1.6 file.c
--- file.c	1 Dec 2003 03:17:45 -0000	1.6
+++ file.c	17 Apr 2004 17:45:29 -0000
@@ -68,11 +68,21 @@
 	gtk_widget_destroy (dialog);
 	
 	return result;
 }
 #else
+
 /* Implementation in terms of gtk_file_selection: */
+/**
+ * cong_get_file_name:
+ * @title:
+ * @filename:
+ * @parent_window:
+ * @cong_action:
+ * 
+ * TODO: Write me
+ */
 gchar*
 cong_get_file_name (const gchar *title, 
 		    const gchar *filename,
 		    GtkWindow *parent_window,
 		    CongFileChooserAction cong_action)
Index: fo-print-context.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/fo-print-context.c,v
retrieving revision 1.4
diff -u -5 -r1.4 fo-print-context.c
--- fo-print-context.c	28 Apr 2003 14:21:36 -0000	1.4
+++ fo-print-context.c	17 Apr 2004 17:45:29 -0000
@@ -19,11 +19,18 @@
 };
 
 /* FoPrintContext internals: */
 
 /* FoPrintContext methods: */
-FoPrintContext *fo_print_context_new_from_gnome_print(GnomePrintContext *gpc)
+/**
+ * fo_print_context_new_from_gnome_print:
+ * @gpc:
+ *
+ * TODO: Write me
+ */
+FoPrintContext *
+fo_print_context_new_from_gnome_print(GnomePrintContext *gpc)
 {
 	FoPrintContext *fpc;
 	
 	g_return_val_if_fail(gpc, NULL);
 
@@ -32,39 +39,70 @@
 	fpc->gpc = gpc;
 
 	return fpc;  
 }
 
-void fo_print_context_delete(FoPrintContext *fpc)
+/**
+ * fo_print_context_delete:
+ * @fpc:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_delete(FoPrintContext *fpc)
 {
 	g_return_if_fail(fpc);
 
 	g_free(fpc);
 
 	/* (No other cleanup required) */
 }
 
-void fo_print_context_beginpage(FoPrintContext *fpc, const gchar* name)
+/**
+ * fo_print_context_beginpage:
+ * @fpc:
+ * @name:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_beginpage(FoPrintContext *fpc, const gchar* name)
 {
 	g_return_if_fail(fpc);
 	g_return_if_fail(name);
 
 	g_assert(fpc->gpc);
 
 	gnome_print_beginpage (fpc->gpc, name);
 }
 
-void fo_print_context_showpage (FoPrintContext *fpc)
+/**
+ * fo_print_context_showpage:
+ * @fpc:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_showpage (FoPrintContext *fpc)
 {
 	g_return_if_fail(fpc);
 
 	g_assert(fpc->gpc);
 
 	gnome_print_showpage (fpc->gpc);
 }
 
-void fo_print_context_test_rect(FoPrintContext *fpc, const FoRect *rect, const gchar *label)
+/**
+ * fo_print_context_test_rect:
+ * @fpc:
+ * @rect:
+ * @label:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_test_rect(FoPrintContext *fpc, const FoRect *rect, const gchar *label)
 {
 	GnomeFont *font;
 
 	g_return_if_fail(fpc);
 
@@ -80,29 +118,52 @@
 
 	gnome_print_rect_stroked(fpc->gpc, rect->x, rect->y, rect->w, rect->h);
 	
 }
 
-void fo_print_context_push_state(FoPrintContext *fpc)
+/**
+ * fo_print_context_push_state:
+ * @fpc:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_push_state(FoPrintContext *fpc)
 {
 	g_return_if_fail(fpc);
 
 	g_assert(fpc->gpc);
 
 	gnome_print_gsave(fpc->gpc);
 }
 
-void fo_print_context_pop_state(FoPrintContext *fpc)
+/**
+ * fo_print_context_pop_state:
+ * @fpc:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_pop_state(FoPrintContext *fpc)
 {
 	g_return_if_fail(fpc);
 
 	g_assert(fpc->gpc);
 
 	gnome_print_grestore(fpc->gpc);
 }
 
-void fo_print_context_translate(FoPrintContext *fpc, FoUnit x, FoUnit y)
+/**
+ * fo_print_context_translate:
+ * @fpc:
+ * @x:
+ * @y:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_context_translate(FoPrintContext *fpc, FoUnit x, FoUnit y)
 {
 	g_return_if_fail(fpc);
 
 	g_assert(fpc->gpc);
 	gnome_print_translate(fpc->gpc,
Index: fo-rect.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/fo-rect.c,v
retrieving revision 1.3
diff -u -5 -r1.3 fo-rect.c
--- fo-rect.c	28 Apr 2003 14:21:36 -0000	1.3
+++ fo-rect.c	17 Apr 2004 17:45:29 -0000
@@ -12,30 +12,61 @@
 
 #include "global.h"
 #include "fo.h"
 
 /* FoRect methods: */
-void fo_rect_set_xywh(FoRect *rect, FoUnit x, FoUnit y, FoUnit w, FoUnit h)
+/**
+ * fo_rect_set_xywh:
+ * @rect:
+ * @x:
+ * @y:
+ * @w:
+ * @h:
+ *
+ * TODO: Write me
+ */
+void 
+fo_rect_set_xywh(FoRect *rect, FoUnit x, FoUnit y, FoUnit w, FoUnit h)
 {
 	g_return_if_fail(rect);
 
 	rect->x=x;
 	rect->y=y;
 	rect->w=w;
 	rect->h=h;
 }
 
-void fo_rect_set_xyxy(FoRect *rect, FoUnit x0, FoUnit y0, FoUnit x1, FoUnit y1)
+/**
+ * fo_rect_set_xyxy:
+ * @rect:
+ * @x0:
+ * @y0:
+ * @x1:
+ * @y1:
+ *
+ * TODO: Write me
+ */
+void 
+fo_rect_set_xyxy(FoRect *rect, FoUnit x0, FoUnit y0, FoUnit x1, FoUnit y1)
 {
 	g_return_if_fail(rect);
 
 	rect->x=x0;
 	rect->y=y0;
 	rect->w=x1-x0;
 	rect->h=y1-y0;
 }
 
-void fo_rect_test_render(const FoRect *rect, FoPrintContext *fpc, const gchar *label)
+/**
+ * fo_rect_test_render:
+ * @rect:
+ * @fpc:
+ * @label:
+ *
+ * TODO: Write me
+ */
+void 
+fo_rect_test_render(const FoRect *rect, FoPrintContext *fpc, const gchar *label)
 {
 	fo_print_context_test_rect(fpc, rect, label);
 }
 
Index: gxx-impl-object-to-xml-tree.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/gxx-impl-object-to-xml-tree.c,v
retrieving revision 1.3
diff -u -5 -r1.3 gxx-impl-object-to-xml-tree.c
--- gxx-impl-object-to-xml-tree.c	2 Mar 2004 15:00:45 -0000	1.3
+++ gxx-impl-object-to-xml-tree.c	17 Apr 2004 17:45:29 -0000
@@ -11,10 +11,18 @@
 
 #include <glib.h>
 #include <libxml/tree.h>
 #include "gxx-object-to-xml-tree.h"
 
+/**
+ * gxx_hash_table_of_children_with_pcdata_to_xml_tree:
+ * @key:
+ * @value:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 void
 gxx_hash_table_of_children_with_pcdata_to_xml_tree (gpointer key,
 						    gpointer value,
 						    gpointer user_data)
 {
Index: main.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/main.c,v
retrieving revision 1.73
diff -u -5 -r1.73 main.c
--- main.c	11 Feb 2004 15:54:23 -0000	1.73
+++ main.c	17 Apr 2004 17:45:29 -0000
@@ -11,11 +11,17 @@
 
 /*
 #define AUTOGENERATE_DS
 */
 
-void status_update()
+/**
+ * status_update:
+ *
+ * TODO: Write me
+ */
+void 
+status_update()
 {
   while (g_main_iteration(FALSE));
 }
 
 
@@ -24,12 +30,13 @@
 {
 	return(TRUE);
 }
 #endif
 
-int main( int   argc,
-	  char *argv[] )
+int 
+main( int   argc,
+      char *argv[] )
 {
 	bindtextdomain(GETTEXT_PACKAGE, LOCALEDIR);
 	bind_textdomain_codeset(GETTEXT_PACKAGE, "UTF-8");
 	textdomain(GETTEXT_PACKAGE);
 
Index: plugin-abiword.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-abiword.c,v
retrieving revision 1.1
diff -u -5 -r1.1 plugin-abiword.c
--- plugin-abiword.c	22 Feb 2004 16:56:55 -0000	1.1
+++ plugin-abiword.c	17 Apr 2004 17:45:29 -0000
@@ -28,10 +28,16 @@
 #include "cong-plugin.h"
 
 #include "cong-fake-plugin-hooks.h"
 
  /* would be exposed as "plugin_register"? */
+/**
+ * plugin_abiword_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_abiword_plugin_register (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
@@ -39,10 +45,16 @@
 	
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
+/**
+ * plugin_abiword_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_abiword_plugin_configure (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
Index: plugin-admonition-node-element.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-admonition-node-element.c,v
retrieving revision 1.6
diff -u -5 -r1.6 plugin-admonition-node-element.c
--- plugin-admonition-node-element.c	5 Mar 2004 21:48:24 -0000	1.6
+++ plugin-admonition-node-element.c	17 Apr 2004 17:45:29 -0000
@@ -83,10 +83,18 @@
 cong_editor_node_element_admonition_instance_init (CongEditorNodeElementAdmonition *node_element_admonition)
 {
 	node_element_admonition->private = g_new0(CongEditorNodeElementAdmonitionDetails,1);
 }
 
+/**
+ * cong_editor_node_element_admonition_construct:
+ * @editor_node_element_admonition:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElementAdmonition*
 cong_editor_node_element_admonition_construct (CongEditorNodeElementAdmonition *editor_node_element_admonition,
 					       CongEditorWidget3* editor_widget,
 					       CongTraversalNode *traversal_node)
 {
@@ -95,10 +103,17 @@
 					    traversal_node);
 
 	return editor_node_element_admonition;
 }
 
+/**
+ * cong_editor_node_element_admonition_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_element_admonition_new (CongEditorWidget3* widget,
 					 CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
Index: plugin-admonition.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-admonition.c,v
retrieving revision 1.3
diff -u -5 -r1.3 plugin-admonition.c
--- plugin-admonition.c	9 Jan 2004 08:34:43 -0000	1.3
+++ plugin-admonition.c	17 Apr 2004 17:45:29 -0000
@@ -34,10 +34,19 @@
 
 #include "cong-fake-plugin-hooks.h"
 
 #include "plugin-admonition-node-element.h"
 
+/**
+ * manufacture_editor_node_admonition:
+ * @plugin_editor_node_factory:
+ * @editor_widget:
+ * @traversal_node:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 static CongEditorNodeElement*  
 manufacture_editor_node_admonition (CongServiceEditorNodeFactory *plugin_editor_node_factory, 
 				    CongEditorWidget3 *editor_widget, 
 				    CongTraversalNode *traversal_node,
 				    gpointer user_data)
@@ -49,11 +58,18 @@
 	return CONG_EDITOR_NODE_ELEMENT( cong_editor_node_element_admonition_new (editor_widget,
 										  traversal_node));
 }
 
  /* would be exposed as "plugin_register"? */
-gboolean plugin_admonition_plugin_register(CongPlugin *plugin)
+/**
+ * plugin_admonition_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_admonition_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_editor_node_factory(plugin, 
 						 _("Admonition"), 
@@ -63,11 +79,18 @@
 						 NULL);
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_admonition_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_admonition_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_admonition_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-cleanup-source.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-cleanup-source.c,v
retrieving revision 1.16
diff -u -5 -r1.16 plugin-cleanup-source.c
--- plugin-cleanup-source.c	4 Feb 2004 16:24:21 -0000	1.16
+++ plugin-cleanup-source.c	17 Apr 2004 17:45:29 -0000
@@ -79,10 +79,17 @@
 		return g_strnfill((indent_level*options->num_spaces_per_indent), ' ');
 	}
 
 }
 
+/**
+ * cong_util_is_recursively_inline:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean 
 cong_util_is_recursively_inline (CongDocument *doc,
 				 CongNodePtr node)
 {
 	CongNodePtr iter;
@@ -152,12 +159,20 @@
 	
 	
 	return TRUE;
 }
 
-gchar* cong_util_strip_whitespace_from_string (const gchar* input_string, 
-					       gboolean strip_all_initial_whitespace)
+/**
+ * cong_util_strip_whitespace_from_string:
+ * @input_string:
+ * @strip_all_initial_whitespace:
+ *
+ * TODO: Write me
+ */
+gchar* 
+cong_util_strip_whitespace_from_string (const gchar* input_string, 
+					gboolean strip_all_initial_whitespace)
 {
 	gunichar *unichar_string;
 	glong num_chars;
 	gchar *result_string;
 	gchar *dst;
@@ -419,12 +434,19 @@
 	options.num_text_columns = 80;
 
 	cong_util_cleanup_source(cong_primary_window_get_document(primary_window), &options);
 }
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_cleanup_source_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_cleanup_source_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_cleanup_source_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	cong_plugin_register_doc_tool(plugin, 
 				      _("Cleanup XML Source"),
@@ -439,11 +461,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_cleanup_source_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_cleanup_source_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_cleanup_source_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-convert-case.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-convert-case.c,v
retrieving revision 1.9
diff -u -5 -r1.9 plugin-convert-case.c
--- plugin-convert-case.c	4 Feb 2004 16:24:21 -0000	1.9
+++ plugin-convert-case.c	17 Apr 2004 17:45:29 -0000
@@ -107,11 +107,18 @@
 		xmlFreeDoc(doc_ptr);
 	}
 }
 
  /* would be exposed as "plugin_register"? */
-gboolean plugin_convert_case_plugin_register(CongPlugin *plugin)
+/**
+ * plugin_convert_case_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_convert_case_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_exporter(plugin, 
 				      _("Export as \"lower case\" XML"),
@@ -122,11 +129,18 @@
 				      NULL);
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_convert_case_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_convert_case_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_convert_case_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-doc-from-xds.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-doc-from-xds.c,v
retrieving revision 1.5
diff -u -5 -r1.5 plugin-doc-from-xds.c
--- plugin-doc-from-xds.c	9 Jan 2004 08:34:43 -0000	1.5
+++ plugin-doc-from-xds.c	17 Apr 2004 17:45:29 -0000
@@ -30,11 +30,20 @@
 #include "cong-fake-plugin-hooks.h"
 #include "cong-dispspec.h"
 #include "cong-dispspec-registry.h"
 #include "cong-util.h"
 
-void factory_action_callback_doc_from_xds(CongServiceDocumentFactory *factory,
+/**
+ * factory_action_callback_doc_from_xds:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_doc_from_xds(CongServiceDocumentFactory *factory,
 	CongNewFileAssistant *assistant, gpointer user_data)
 {
 	xmlDocPtr xml_doc;
 	CongDispspec* dispspec;
 	xmlNodePtr template;
@@ -69,18 +78,34 @@
 
 	cong_ui_new_document_from_manufactured_xml(xml_doc,
 		cong_new_file_assistant_get_toplevel(assistant));
 }
 
-void factory_page_creation_callback_doc_from_xds(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_page_creation_callback_doc_from_xds:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_page_creation_callback_doc_from_xds(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 }
 
 
 
 /* would be exposed as "plugin_register"? */
-gboolean plugin_doc_from_xds_plugin_register(CongPlugin *plugin)
+/**
+ * plugin_doc_from_xds_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_doc_from_xds_plugin_register(CongPlugin *plugin)
 {
 	int i;
 	CongDispspecRegistry* registry;
 
 	g_return_val_if_fail(plugin, FALSE);
@@ -106,19 +131,23 @@
 				"cong-docbook-article",
 				dispspec);
 		}
 
 	}
-	                                                                                
-
-
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_doc_from_xds_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_doc_from_xds_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_doc_from_xds_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-docbook.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-docbook.c,v
retrieving revision 1.39
diff -u -5 -r1.39 plugin-docbook.c
--- plugin-docbook.c	5 Mar 2004 14:27:56 -0000	1.39
+++ plugin-docbook.c	17 Apr 2004 17:45:29 -0000
@@ -54,11 +54,20 @@
 {
 	const gchar *
 };
 #endif
 
-void factory_page_creation_callback_unified(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_page_creation_callback_unified:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_page_creation_callback_unified(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 #if 0
 	GnomeDruidPageStandard *which_settings_page;
 	GnomeDruidPageStandard *create_new_settings_authorship_page;
 	GnomeDruidPageStandard *create_new_settings_legal_page;
@@ -157,11 +166,18 @@
 					      "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd");
 
 	return xml_dtd;
 }
 
-xmlDocPtr make_article(const xmlChar *title)
+/**
+ * make_article:
+ * @title:
+ *
+ * TODO: Write me
+ */
+xmlDocPtr 
+make_article(const xmlChar *title)
 {
 	xmlDocPtr xml_doc;
 	xmlNodePtr root_node;
 
 	/* Build up the document and its content: */
@@ -192,22 +208,37 @@
 		    );
 
 	return xml_doc;
 }
 
-void factory_action_callback_article(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_action_callback_article:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_article(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	xmlDocPtr xml_doc;
 
 	xml_doc = make_article(_("Untitled Article"));
 
 	cong_ui_new_document_from_manufactured_xml(xml_doc,
 						   cong_new_file_assistant_get_toplevel(assistant));
 }
 
-
-xmlDocPtr make_book(const xmlChar *title)
+/**
+ * make_book:
+ * @title:
+ *
+ * TODO: Write me
+ */
+xmlDocPtr 
+make_book(const xmlChar *title)
 {
 	xmlDocPtr xml_doc;
 	xmlNodePtr root_node;
 	xmlNodePtr chapter_node;
 
@@ -245,22 +276,37 @@
 		    );
 
 	return xml_doc;
 }
 
-void factory_action_callback_book(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_action_callback_book:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_book(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	xmlDocPtr xml_doc;
 
 	xml_doc = make_book(_("Untitled Book"));
 
 	cong_ui_new_document_from_manufactured_xml(xml_doc,
 						   cong_new_file_assistant_get_toplevel(assistant));
 }
 
-
-xmlDocPtr make_set(const xmlChar *title)
+/**
+ * make_set:
+ * @title:
+ *
+ * TODO: Write me
+ */
+xmlDocPtr 
+make_set(const xmlChar *title)
 {
 	xmlDocPtr xml_doc;
 	xmlNodePtr root_node;
 
 	/* Build up the document and its content: */
@@ -284,21 +330,39 @@
 		    );
 
 	return xml_doc;
 }
 
-void factory_action_callback_set(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_action_callback_set:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_set(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	xmlDocPtr xml_doc;
 
 	xml_doc = make_set(_("Untitled Set of Documents"));
 
 	cong_ui_new_document_from_manufactured_xml(xml_doc,
 						   cong_new_file_assistant_get_toplevel(assistant));
 }
 
-gboolean text_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
+/**
+ * text_importer_mime_filter:
+ * @importer:
+ * @mime_type:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+text_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
 {
 	g_return_val_if_fail(importer, FALSE);
 	g_return_val_if_fail(mime_type, FALSE);
 
 	if (0==strcmp(mime_type,"text/plain")) {
@@ -315,10 +379,16 @@
 		return FALSE;
 	}
 }
 
 /* Internal stuff for the text importer: */
+/**
+ * cong_unichar_is_line_break:
+ * @c:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_unichar_is_line_break(gunichar c)
 {
 	switch (g_unichar_break_type (c)) {
 	default: return FALSE;
@@ -461,10 +531,17 @@
 		}
 	}
 	return FALSE;
 }
 
+/**
+ * should_merge:
+ * @ucs4_input_1:
+ * @ucs4_input_2:
+ *
+ * TODO: Write me
+ */
 gboolean
 should_merge (gunichar *ucs4_input_1,
 	      gunichar *ucs4_input_2)
 {
 	if (0==ucs4_input_2[0]) {
@@ -484,10 +561,17 @@
 	}
 
 	return TRUE;
 }
 
+/**
+ * cong_ucs4_concat:
+ * @ucs4_input_1:
+ * @ucs4_input_2:
+ *
+ * TODO: Write me
+ */
 gunichar*
 cong_ucs4_concat (gunichar *ucs4_input_1,
 		  gunichar *ucs4_input_2)
 {
 	gchar *utf8_input_1 = g_ucs4_to_utf8 (ucs4_input_1,
@@ -512,11 +596,16 @@
 	g_free (utf8_result);
 
 	return ucs4_result;
 }
 
-
+/**
+ * merge_lines:
+ * @list:
+ *
+ * TODO: Write me
+ */
 GList*
 merge_lines (GList *list)
 {
 #if 0	
 	GList *iter;
@@ -774,11 +863,22 @@
 	#endif
 
 	cong_document_end_edit (doc);
 }
 
-void text_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * text_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+text_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	char* buffer;
 	GnomeVFSFileSize size;
 	xmlDocPtr xml_doc;
 
@@ -818,11 +918,20 @@
 		g_free(buffer);
 
 	}
 }
 
-gboolean sourcecode_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
+/**
+ * sourcecode_importer_mime_filter:
+ * @importer:
+ * @mime_type:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+sourcecode_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
 {
 	g_return_val_if_fail(importer, FALSE);
 	g_return_val_if_fail(mime_type, FALSE);
 
 	if (0==strcmp(mime_type,"text/x-c-header")) {
@@ -832,11 +941,22 @@
 	} else {
 		return FALSE;
 	}
 }
 
-void sourcecode_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * sourcecode_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+sourcecode_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	char* buffer;
 	GnomeVFSFileSize size;
 	xmlDocPtr xml_doc;
 	xmlNodePtr root_node;
@@ -878,19 +998,39 @@
 		cong_ui_new_document_from_imported_xml(xml_doc,
 						       toplevel_window);
 	}
 }
 
-gboolean docbook_exporter_document_filter(CongServiceExporter *exporter, CongDocument *doc, gpointer user_data)
+/**
+ * docbook_exporter_document_filter:
+ * @exporter:
+ * @doc:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+docbook_exporter_document_filter(CongServiceExporter *exporter, CongDocument *doc, gpointer user_data)
 {
 	g_return_val_if_fail(exporter, FALSE);
 	g_return_val_if_fail(doc, FALSE);
 
 	return cong_util_is_docbook(doc);
 }
 
-void html_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * html_exporter_action_callback:
+ * @exporter:
+ * @doc:
+ * @uri:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+html_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
 {
 	gchar *stylesheet_path;
 
 	g_return_if_fail(exporter);
 	g_return_if_fail(doc);
@@ -907,11 +1047,22 @@
 				     toplevel_window);
 
 	g_free(stylesheet_path);
 }
 
-void pdf_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * pdf_exporter_action_callback:
+ * @exporter:
+ * @doc:
+ * @uri:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+pdf_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
 {
 #if 1
 	GtkWidget *progress_checklist_dialog;
 	CongProgressChecklist *progress_checklist;
 	xmlDocPtr fo_doc;
@@ -958,11 +1109,22 @@
 
 	CONG_DO_UNIMPLEMENTED_DIALOG(toplevel_window, "Exporting DocBook as PDF");	
 #endif
 }
 
-void fo_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * fo_exporter_action_callback:
+ * @exporter:
+ * @doc:
+ * @uri:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+fo_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
 {
 	gchar *stylesheet_path;
 
 	g_return_if_fail(exporter);
 	g_return_if_fail(doc);
@@ -979,11 +1141,19 @@
 				     toplevel_window);
 
 	g_free(stylesheet_path);
 }
 
-#if (ENABLE_PRINTING &&ENABLE_LIBFO)
+#if (ENABLE_PRINTING && ENABLE_LIBFO)
+/**
+ * docbook_print_method_document_filter:
+ * @print_method:
+ * @doc:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 gboolean 
 docbook_print_method_document_filter (CongServicePrintMethod *print_method, 
 				      CongDocument *doc, 
 				      gpointer user_data)
 {
@@ -991,10 +1161,20 @@
 	g_return_val_if_fail(doc, FALSE);
 
 	return cong_util_is_docbook(doc);
 }
 
+/**
+ * docbook_print_method_action_callback:
+ * @print_method:
+ * @doc:
+ * @gpc:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
 void 
 docbook_print_method_action_callback (CongServicePrintMethod *print_method, 
 				      CongDocument *doc, 
 				      GnomePrintContext *gpc, 
 				      gpointer user_data, 
@@ -1042,11 +1222,20 @@
 
 
 }
 #endif /* #if ENABLE_PRINTING */
 
-GtkWidget* docbook_generic_node_factory_method(CongServiceNodePropertyDialog *custom_property_dialog, CongDocument *doc, CongNodePtr node)
+/**
+ * docbook_generic_node_factory_method:
+ * @custom_property_dialog:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+docbook_generic_node_factory_method(CongServiceNodePropertyDialog *custom_property_dialog, CongDocument *doc, CongNodePtr node)
 {
 	gchar* glade_filename;
 	GladeXML *xml;
 	GtkWidget *notebook1;
 
@@ -1082,11 +1271,20 @@
 						     node);
 	
 	return glade_xml_get_widget(xml, "common_dialog");
 }
 
-GtkWidget* docbook_orderedlist_properties_factory_method(CongServiceNodePropertyDialog *custom_property_dialog, CongDocument *doc, CongNodePtr node)
+/**
+ * docbook_orderedlist_properties_factory_method:
+ * @custom_property_dialog:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+docbook_orderedlist_properties_factory_method(CongServiceNodePropertyDialog *custom_property_dialog, CongDocument *doc, CongNodePtr node)
 {
 	gchar* glade_filename;
 	GladeXML *xml;
 	GtkWidget *notebook1;
 
@@ -1202,11 +1400,20 @@
 	CongNodePtr node = user_data;
 
 	open_ulink_in_browser (node);
 }
 
-GtkWidget* docbook_ulink_properties_factory_method(CongServiceNodePropertyDialog *custom_property_dialog, CongDocument *doc, CongNodePtr node)
+/**
+ * docbook_ulink_properties_factory_method:
+ * @custom_property_dialog:
+ * @doc:
+ * @node:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+docbook_ulink_properties_factory_method(CongServiceNodePropertyDialog *custom_property_dialog, CongDocument *doc, CongNodePtr node)
 {
 	gchar* glade_filename;
 	GladeXML *xml;
 	GtkWidget *notebook1;
 
@@ -1354,12 +1561,19 @@
 				      "demote DocBook");
 }
 
 
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_docbook_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_docbook_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_docbook_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_document_factory(plugin, 
 					      _("DocBook Article"), 
@@ -1494,11 +1708,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_docbook_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_docbook_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_docbook_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-dtd.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-dtd.c,v
retrieving revision 1.17
diff -u -5 -r1.17 plugin-dtd.c
--- plugin-dtd.c	2 Mar 2004 12:31:41 -0000	1.17
+++ plugin-dtd.c	17 Apr 2004 17:45:29 -0000
@@ -54,11 +54,20 @@
 attribute_callback_generate_rng_from_dtd (xmlElementPtr dtd_element,
 					  xmlAttributePtr attr,
 					  gpointer user_data);
 
 /* Plugin hooks: */
-gboolean dtd_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
+/**
+ * dtd_importer_mime_filter:
+ * @importer:
+ * @mime_type:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+dtd_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
 {
 	g_return_val_if_fail(importer, FALSE);
 	g_return_val_if_fail(mime_type, FALSE);
 
 	if (0==strcmp(mime_type,"text/x-dtd")) {
@@ -66,11 +75,22 @@
 	} else {
 		return FALSE;
 	}
 }
 
-void dtd_to_xds_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * dtd_to_xds_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+dtd_to_xds_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	xmlDtdPtr dtd;
 
 	g_message("dtd_to_xds_importer_action_callback");
 
@@ -96,12 +116,22 @@
 		cong_ui_new_document_from_imported_xml(xml_doc,
 						       toplevel_window);
 	}
 }
 
-
-void dtd_to_rng_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * dtd_to_rng_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+dtd_to_rng_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	xmlDtdPtr dtd;
 
 	g_message("dtd_to_rng_importer_action_callback");
 
@@ -119,35 +149,73 @@
 		cong_ui_new_document_from_imported_xml(xml_doc,
 						       toplevel_window);
 	}
 }
 
-void dtd_to_w3c_xml_schema_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * dtd_to_w3c_xml_schema_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+dtd_to_w3c_xml_schema_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	g_message("dtd_to_w3c_xml_schema_importer_action_callback");
 
 	CONG_DO_UNIMPLEMENTED_DIALOG(toplevel_window, "Importing DTD as W3C XML Schema");
 }
 
-void dtd_to_schematron_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * dtd_to_schematron_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+dtd_to_schematron_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	g_message("dtd_to_schematron_importer_action_callback");
 
 	CONG_DO_UNIMPLEMENTED_DIALOG(toplevel_window, "Importing DTD as Schematron Schema");
 }
 
-void dtd_to_examplotron_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * dtd_to_examplotron_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+dtd_to_examplotron_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 	g_message("dtd_to_examplotron_importer_action_callback");
 
 	CONG_DO_UNIMPLEMENTED_DIALOG(toplevel_window, "Importing DTD as Examplotron Schema");
 }
 
-
-
- /* would be exposed as "plugin_register"? */
-gboolean plugin_dtd_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_dtd_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_dtd_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	cong_plugin_register_importer(plugin, 
 				      _("Convert DTD into a Conglomerate Display Specification"), 
@@ -191,11 +259,18 @@
 	
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_dtd_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_dtd_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_dtd_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
@@ -298,10 +373,17 @@
 
 
 
 /* Implementation of CongDTD2RNGConverter: */
 
+/**
+ * cong_dtd2rng_converter_new:
+ * @dtd:
+ * @list_of_start_elements:
+ *
+ * TODO: Write me
+ */
 CongDTD2RNGConverter*
 cong_dtd2rng_converter_new (xmlDtdPtr dtd,
 			    GList *list_of_start_elements)
 {
 	CongDTD2RNGConverter *converter;
@@ -315,16 +397,29 @@
 	converter->list_of_start_elements = list_of_start_elements;
 
 	return converter;
 }
 
+/**
+ * cong_dtd2rng_converter_free:
+ * @converter: a #CongDTD2RNGConverter
+ *
+ * Calls g_free on @converter
+ */
 void
 cong_dtd2rng_converter_free (CongDTD2RNGConverter *converter)
 {
 	g_free (converter);
 }
 
+/**
+ * cong_dtd2rng_converter_is_start_element:
+ * @converter:
+ * @dtd_element:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dtd2rng_converter_is_start_element (CongDTD2RNGConverter *converter,
 					 xmlElementPtr dtd_element)
 {
 	GList *iter;
@@ -342,10 +437,17 @@
 }
 
 /*
   Count references; they can happen in the main DTD, or in the <start> element (if any):
 */
+/**
+ * cong_dtd2rng_converter_get_element_ref_count:
+ * @converter:
+ * @dtd_element:
+ *
+ * TODO: Write me
+ */
 guint
 cong_dtd2rng_converter_get_element_ref_count (CongDTD2RNGConverter *converter,
 					      xmlElementPtr dtd_element)
 {
 	guint num_element_references;
@@ -369,10 +471,17 @@
 
 /* 
    Elements need to be wrapped with a define if they are referenced more than once (or if the
    user has requested a flat schema?)
 */
+/**
+ * cong_dtd2rng_converter_should_element_have_define:
+ * @converter:
+ * @dtd_element:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_dtd2rng_converter_should_element_have_define (CongDTD2RNGConverter *converter,
 						   xmlElementPtr dtd_element)
 {
 	guint ref_count;
@@ -388,10 +497,16 @@
 	} else {
 		return FALSE;
 	}
 }
 
+/**
+ * cong_dtd2rng_converter_make_schema:
+ * @converter:
+ *
+ * TODO: Write me
+ */
 xmlDocPtr
 cong_dtd2rng_converter_make_schema (CongDTD2RNGConverter *converter)
 {
 	xmlNodePtr choice_node;
 
@@ -459,11 +574,10 @@
 
 	return converter->xml_doc;	
 
 }
 
-
 static void
 element_reference_callback_add_comment (xmlDtdPtr dtd,
 					xmlElementPtr dtd_element,
 					xmlElementContentPtr content,
 					gpointer user_data)
@@ -474,10 +588,18 @@
 		     xmlNewDocComment (xml_node->doc,
 				       "element is cross-referenced"));
 }
 
 /* Adds the element either via a ref, or directly inline, depending on whether its referenced elsewhere or not: */
+/**
+ * cong_dtd2rng_converter_add_element_or_ref:
+ * @converter:
+ * @dtd_element:
+ * @parent_node:
+ *
+ * TODO: Write me
+ */
 void
 cong_dtd2rng_converter_add_element_or_ref (CongDTD2RNGConverter *converter,
 					   xmlElementPtr dtd_element,
 					   xmlNodePtr parent_node)
 {
@@ -494,10 +616,18 @@
 	}
 }
 
 
 /* Add a <ref name="foobar"> tag: */
+/**
+ * cong_dtd2rng_converter_add_rng_element_ref:
+ * @converter:
+ * @dtd_element:
+ * @parent_node:
+ *
+ * TODO: Write me
+ */
 void
 cong_dtd2rng_converter_add_rng_element_ref (CongDTD2RNGConverter *converter,
 					    xmlElementPtr dtd_element,
 					    xmlNodePtr parent_node)
 {
@@ -512,10 +642,18 @@
 		    "name",
 		    dtd_element->name);
 }
 
 /* Create a RELAX NG <element>, either somewhere inside a content model, or inside a <define> element */
+/**
+ * cong_dtd2rng_converter_add_rng_element_inline:
+ * @converter:
+ * @dtd_element:
+ * @parent_node:
+ *
+ * TODO: Write me
+ */
 void
 cong_dtd2rng_converter_add_rng_element_inline (CongDTD2RNGConverter *converter,
 					       xmlElementPtr dtd_element,
 					       xmlNodePtr parent_node)
 {
@@ -830,6 +968,5 @@
 			}
 		}
 		break;
 	}
 }
-
Index: plugin-empty.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-empty.c,v
retrieving revision 1.4
diff -u -5 -r1.4 plugin-empty.c
--- plugin-empty.c	22 Feb 2004 16:57:49 -0000	1.4
+++ plugin-empty.c	17 Apr 2004 17:45:29 -0000
@@ -27,11 +27,17 @@
 #include "global.h"
 #include "cong-plugin.h"
 
 #include "cong-fake-plugin-hooks.h"
 
- /* would be exposed as "plugin_register"? */
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_empty_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_empty_plugin_register (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
@@ -39,10 +45,16 @@
 	
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
+/**
+ * plugin_empty_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_empty_plugin_configure (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
Index: plugin-fo.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-fo.c,v
retrieving revision 1.6
diff -u -5 -r1.6 plugin-fo.c
--- plugin-fo.c	7 Feb 2004 02:48:57 -0000	1.6
+++ plugin-fo.c	17 Apr 2004 17:45:29 -0000
@@ -34,11 +34,18 @@
 
 #include "cong-fake-plugin-hooks.h"
 
 #define FO_NS_URI ("http://www.w3.org/1999/XSL/Format")
 
-static gboolean is_fo(CongDocument *doc) 
+/**
+ * is_fo:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+static gboolean 
+is_fo(CongDocument *doc) 
 {
 	CongNodePtr root;
 
 	g_return_val_if_fail(doc, FALSE);
 
@@ -49,20 +56,39 @@
 	}
 
 	return FALSE;
 }
 
-
-gboolean fo_pdf_exporter_document_filter(CongServiceExporter *exporter, CongDocument *doc, gpointer user_data)
+/**
+ * fo_pdf_exporter_document_filter:
+ * @exporter:
+ * @doc:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+fo_pdf_exporter_document_filter(CongServiceExporter *exporter, CongDocument *doc, gpointer user_data)
 {
 	g_return_val_if_fail(exporter, FALSE);
 	g_return_val_if_fail(doc, FALSE);
 
 	return is_fo(doc);
 }
 
-void fo_pdf_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * fo_pdf_export_action_callback:
+ * @exporter:
+ * @doc:
+ * @uri:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+fo_pdf_exporter_action_callback(CongServiceExporter *exporter, CongDocument *doc, const gchar *uri, gpointer user_data, GtkWindow *toplevel_window)
 {
 	g_message("fo_pdf_exporter_action_callback");
 
 	g_return_if_fail(exporter);
 	g_return_if_fail(doc);
@@ -72,28 +98,55 @@
 	CONG_DO_UNIMPLEMENTED_DIALOG_WITH_BUGZILLA_ID(toplevel_window, _("Converting XSL Formatting Objects to PDF"), 108467);
 	/* FIXME: ultimately we probably want to use xmlroff to do this stage */
 }
 
 #if (ENABLE_PRINTING && ENABLE_LIBFO)
-gboolean fo_print_method_document_filter(CongServicePrintMethod *print_method, CongDocument *doc, gpointer user_data)
+/**
+ * fo_print_method_document_filter:
+ * @print_method:
+ * @doc:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+fo_print_method_document_filter(CongServicePrintMethod *print_method, CongDocument *doc, gpointer user_data)
 {
 	g_return_val_if_fail(print_method, FALSE);
 	g_return_val_if_fail(doc, FALSE);
 
 	return is_fo(doc);
 }
 
-void fo_print_method_action_callback(CongServicePrintMethod *print_method, CongDocument *doc, GnomePrintContext *gpc, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * fo_print_method_action_callback:
+ * @print_method:
+ * @doc:
+ * @gpc:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+fo_print_method_action_callback(CongServicePrintMethod *print_method, CongDocument *doc, GnomePrintContext *gpc, gpointer user_data, GtkWindow *toplevel_window)
 {
 	g_message("fo_print_method_action_callback");
 
 	cong_util_print_xslfo(toplevel_window, gpc, cong_document_get_xml(doc));
 }
 #endif /* #if ENABLE_PRINTING */
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_fo_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_fo_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_fo_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	cong_plugin_register_exporter(plugin, 
 				      _("Export XSL-FO as PDF"), 
@@ -114,11 +167,18 @@
 #endif
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_fo_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_fo_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_fo_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-html.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-html.c,v
retrieving revision 1.2
diff -u -5 -r1.2 plugin-html.c
--- plugin-html.c	23 Feb 2004 16:58:25 -0000	1.2
+++ plugin-html.c	17 Apr 2004 17:45:29 -0000
@@ -116,11 +116,17 @@
 	CONG_DO_UNIMPLEMENTED_DIALOG (parent_window,
 				      "demote HTML");
 }
 
 
- /* would be exposed as "plugin_register"? */
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_html_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_html_plugin_register (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
@@ -162,10 +168,16 @@
 	
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
+/**
+ * plugin_html_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_html_plugin_configure (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
Index: plugin-lists-area-listitem.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-lists-area-listitem.c,v
retrieving revision 1.7
diff -u -5 -r1.7 plugin-lists-area-listitem.c
--- plugin-lists-area-listitem.c	14 Oct 2003 19:17:50 -0000	1.7
+++ plugin-lists-area-listitem.c	17 Apr 2004 17:45:29 -0000
@@ -56,10 +56,18 @@
 	area_listitem->private = g_new0(CongEditorAreaListitemDetails,1);
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_listitem_construct:
+ * @area_listitem:
+ * @editor_widget:
+ * @label:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_listitem_construct (CongEditorAreaListitem *area_listitem,
 				     CongEditorWidget3 *editor_widget,
 				     const gchar *label)
 {
@@ -74,10 +82,17 @@
 					     CONG_EDITOR_AREA(PRIVATE(area_listitem)->area_label));
 
 	return CONG_EDITOR_AREA (area_listitem);
 }
 
+/**
+ * cong_editor_area_listitem_new:
+ * @editor_widget:
+ * @label:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_listitem_new (CongEditorWidget3 *editor_widget,
 			       const gchar *label)
 
 {
@@ -89,10 +104,17 @@
 		(g_object_new (CONG_EDITOR_AREA_LISTITEM_TYPE, NULL),
 		 editor_widget,
 		 label);
 }
 
+/**
+ * cong_editor_area_listitem_set_label:
+ * @area_listitem:
+ * @label:
+ *
+ * TODO: Write me
+ */
 void
 cong_editor_area_listitem_set_label (CongEditorAreaListitem *area_listitem,
 				     const gchar *label)
 {
 	g_return_if_fail (IS_CONG_EDITOR_AREA_LISTITEM (area_listitem));
Index: plugin-lists-node-element-listitem.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-lists-node-element-listitem.c,v
retrieving revision 1.12
diff -u -5 -r1.12 plugin-lists-node-element-listitem.c
--- plugin-lists-node-element-listitem.c	1 Mar 2004 19:27:42 -0000	1.12
+++ plugin-lists-node-element-listitem.c	17 Apr 2004 17:45:29 -0000
@@ -103,10 +103,18 @@
 cong_editor_node_element_listitem_instance_init (CongEditorNodeElementListitem *node_element_listitem)
 {
 	node_element_listitem->private = g_new0(CongEditorNodeElementListitemDetails,1);
 }
 
+/**
+ * cong_editor_node_element_listitem_construct:
+ * @editor_node_element_listitem:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElementListitem*
 cong_editor_node_element_listitem_construct (CongEditorNodeElementListitem *editor_node_element_listitem,
 					     CongEditorWidget3* editor_widget,
 					     CongTraversalNode *traversal_node)
 {
@@ -122,10 +130,17 @@
 												editor_node_element_listitem);
 
 	return editor_node_element_listitem;
 }
 
+/**
+ * cong_editor_node_element_listitem_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_element_listitem_new (CongEditorWidget3* widget,
 				       CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
@@ -136,10 +151,16 @@
 				 (g_object_new (CONG_EDITOR_NODE_ELEMENT_LISTITEM_TYPE, NULL),
 				  widget,
 				  traversal_node));
 }
 
+/**
+ * cong_editor_node_element_listitem_get_label:
+ * @listitem:
+ *
+ * TODO: Write me
+ */
 const gchar*
 cong_editor_node_element_listitem_get_label (CongEditorNodeElementListitem* listitem)
 {
 	g_return_val_if_fail (IS_CONG_EDITOR_NODE_ELEMENT_LISTITEM (listitem), NULL);
 	return PRIVATE(listitem)->cached_label;
@@ -163,10 +184,17 @@
 /*
  * 0 should return empty
  * 1..26 should return "a".."z"
  * 27..52 should return "aa".."az"
  */
+/**
+ * cong_util_format_number_alpha:
+ * @number:
+ * @is_upper:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_util_format_number_alpha (guint number,
 			       gboolean is_upper)
 {
 	gchar *result = g_strdup("");
@@ -185,10 +213,17 @@
 	}
 
 	return result;
 }
 
+/**
+ * cong_util_format_number_roman:
+ * @number:
+ * @is_upper:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_util_format_number_roman (guint number,
 			       gboolean is_upper)
 {
 	gchar *result = g_strdup("");
@@ -250,10 +285,17 @@
     }
 
     return result;
 }
 
+/**
+ * cong_util_numeration:
+ * @numeration:
+ * @number:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_util_numeration (enum CongNumeration numeration, 
 		      guint number)
 {
 	switch (numeration) {
@@ -292,10 +334,16 @@
 					 sizeof(docbook_orderedlist_numeration)/sizeof(CongEnumMapping),
 					 numeration_attr,
 					 CONG_NUMERATION_ARABIC);
 }
 
+/**
+ * cong_util_string_from_unichar:
+ * @ch:
+ *
+ * TODO: Write me
+ */
 gchar*
 cong_util_string_from_unichar (gunichar ch) 
 {
 	gunichar str[2];
 
@@ -309,10 +357,16 @@
 			       NULL);
 }
 
 #define BULLET_UNICHAR (0x2022)
 
+/**
+ * get_child_index:
+ * @listitem:
+ *
+ * TODO: Write me
+ */
 guint
 get_child_index(CongEditorNodeElementListitem* listitem)
 {
 	CongNodePtr node_listitem;
 	CongNodePtr node_parent;
@@ -339,11 +393,10 @@
 	}
 
 	return item_count+1;
 }
 
-
 static gchar*
 calculate_label (CongEditorNodeElementListitem* listitem)
 {
 	CongNodePtr node_listitem;
 	CongNodePtr node_parent;
@@ -477,6 +530,5 @@
 	CongEditorAreaListitem *area_listitem = CONG_EDITOR_AREA_LISTITEM (user_data);
 
 	cong_editor_area_listitem_set_label (area_listitem,
 					     cong_editor_node_element_listitem_get_label (listitem));
 }
-
Index: plugin-lists.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-lists.c,v
retrieving revision 1.11
diff -u -5 -r1.11 plugin-lists.c
--- plugin-lists.c	9 Jan 2004 08:34:43 -0000	1.11
+++ plugin-lists.c	17 Apr 2004 17:45:29 -0000
@@ -34,10 +34,19 @@
 
 #include "cong-fake-plugin-hooks.h"
 
 #include "plugin-lists-node-element-listitem.h"
 
+/**
+ * manufacture_editor_node_listitem:
+ * @plugin_editor_node_factory:
+ * @editor_widget:
+ * @traversal_node:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
 static CongEditorNodeElement*  
 manufacture_editor_node_listitem (CongServiceEditorNodeFactory *plugin_editor_node_factory, 
 				  CongEditorWidget3 *editor_widget, 
 				  CongTraversalNode *traversal_node,
 				  gpointer user_data)
@@ -49,11 +58,18 @@
 	return CONG_EDITOR_NODE_ELEMENT( cong_editor_node_element_listitem_new (editor_widget,
 										traversal_node));
 }
 
  /* would be exposed as "plugin_register"? */
-gboolean plugin_lists_plugin_register(CongPlugin *plugin)
+/**
+ * plugin_lists_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_lists_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_editor_node_factory(plugin, 
 						 _("List Member Element"), 
@@ -63,11 +79,18 @@
 						 NULL);
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_lists_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_lists_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_lists_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-paragraph-area-paragraph.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-paragraph-area-paragraph.c,v
retrieving revision 1.7
diff -u -5 -r1.7 plugin-paragraph-area-paragraph.c
--- plugin-paragraph-area-paragraph.c	11 Feb 2004 15:54:23 -0000	1.7
+++ plugin-paragraph-area-paragraph.c	17 Apr 2004 17:45:29 -0000
@@ -82,10 +82,17 @@
 #endif
 }
 
 
 /* Exported function definitions: */
+/**
+ * cong_editor_area_paragraph_construct:
+ * @area_paragraph:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_paragraph_construct (CongEditorAreaParagraph *area_paragraph,
 				      CongEditorWidget3 *editor_widget)
 {
 	cong_editor_area_border_construct (CONG_EDITOR_AREA_BORDER(area_paragraph),
@@ -96,13 +103,18 @@
 					   5);
 
 	return CONG_EDITOR_AREA (area_paragraph);
 }
 
+/**
+ * cong_editor_area_paragraph_new:
+ * @editor_widget:
+ *
+ * TODO: Write me
+ */
 CongEditorArea*
 cong_editor_area_paragraph_new (CongEditorWidget3 *editor_widget)
-
 {
 #if DEBUG_EDITOR_AREA_LIFETIMES
 	g_message("cong_editor_area_paragraph_new");
 #endif
 
Index: plugin-paragraph-node-element-paragraph.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-paragraph-node-element-paragraph.c,v
retrieving revision 1.5
diff -u -5 -r1.5 plugin-paragraph-node-element-paragraph.c
--- plugin-paragraph-node-element-paragraph.c	16 Dec 2003 17:27:18 -0000	1.5
+++ plugin-paragraph-node-element-paragraph.c	17 Apr 2004 17:45:29 -0000
@@ -58,10 +58,18 @@
 cong_editor_node_element_paragraph_instance_init (CongEditorNodeElementParagraph *node_element_paragraph)
 {
 	node_element_paragraph->private = g_new0(CongEditorNodeElementParagraphDetails,1);
 }
 
+/**
+ * cong_editor_node_element_paragraph_construct:
+ * @editor_node_element_paragraph:
+ * @editor_widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNodeElementParagraph*
 cong_editor_node_element_paragraph_construct (CongEditorNodeElementParagraph *editor_node_element_paragraph,
 					      CongEditorWidget3 *editor_widget,
 					      CongTraversalNode *traversal_node)
 {
@@ -70,10 +78,17 @@
 					    traversal_node);
 
 	return editor_node_element_paragraph;
 }
 
+/**
+ * cong_editor_node_element_paragraph_new:
+ * @widget:
+ * @traversal_node:
+ *
+ * TODO: Write me
+ */
 CongEditorNode*
 cong_editor_node_element_paragraph_new (CongEditorWidget3* widget,
 					CongTraversalNode *traversal_node)
 {
 #if DEBUG_EDITOR_NODE_LIFETIMES
Index: plugin-paragraph.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-paragraph.c,v
retrieving revision 1.6
diff -u -5 -r1.6 plugin-paragraph.c
--- plugin-paragraph.c	9 Jan 2004 08:34:43 -0000	1.6
+++ plugin-paragraph.c	17 Apr 2004 17:45:29 -0000
@@ -48,12 +48,19 @@
 
 	return CONG_EDITOR_NODE_ELEMENT( cong_editor_node_element_paragraph_new (editor_widget,
 										 traversal_node));
 }
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_paragraph_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_paragraph_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_paragraph_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_editor_node_factory(plugin, 
 						 _("Paragraph"), 
@@ -63,14 +70,18 @@
 						 NULL);
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_paragraph_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_paragraph_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_paragraph_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
-
-
-
Index: plugin-random.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-random.c,v
retrieving revision 1.8
diff -u -5 -r1.8 plugin-random.c
--- plugin-random.c	5 Mar 2004 14:27:56 -0000	1.8
+++ plugin-random.c	17 Apr 2004 17:45:30 -0000
@@ -117,11 +117,20 @@
 
 	g_object_unref (G_OBJECT (random_gui->xml));
 	g_free (random_gui);	
 }
 
-void factory_page_creation_callback_random(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_page_creation_callback_random:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_page_creation_callback_random(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	RandomGUI *random_gui;
 #if 0
 	g_message("factory_page_creation_callback_random");
 #endif
@@ -178,38 +187,63 @@
 populate_element (RandomCreationInfo *rci,
 		  xmlDocPtr xml_doc,
 		  xmlNodePtr xml_node,
 		  int depth);
 
+/**
+ * generate_bool_for_opt:
+ * @rci:
+ *
+ * TODO: Write me
+ */
 gboolean
 generate_bool_for_opt (RandomCreationInfo *rci)
 {
 	g_assert (rci);
 
 	return g_rand_boolean (rci->random);
 }
 
+/**
+ * generate_count_for_mult:
+ * @rci:
+ *
+ * TODO: Write me
+ */
 gint
 generate_count_for_mult (RandomCreationInfo *rci)
 {
 	g_assert (rci);
 
 	return g_rand_int_range (rci->random,
 				 0,
 				 6);
 }
 
+/**
+ * generate_count_for_plus:
+ * @rci:
+ *
+ * TODO: Write me
+ */
 gint
 generate_count_for_plus (RandomCreationInfo *rci)
 {
 	g_assert (rci);
 
 	return g_rand_int_range (rci->random,
 				 1,
 				 7);
 }
 
+/**
+ * generate_count_for_ocur:
+ * @rci:
+ * @ocur:
+ *
+ * TODO: Write me
+ */
 gint
 generate_count_for_ocur (RandomCreationInfo *rci,
 			 xmlElementContentOccur ocur)
 {
 	g_assert (rci);
@@ -253,10 +287,16 @@
 	}
 	
 }
 #endif
 
+/**
+ * random_unichar:
+ * @rci:
+ *
+ * TODO: Write me
+ */
 gunichar
 random_unichar (RandomCreationInfo *rci)
 {
 	/* FIXME: probably should have a smarter system... */
 	gunichar result;
@@ -284,10 +324,16 @@
 			}
 		}
 	}
 }
 
+/**
+ * random_text:
+ * @rci:
+ *
+ * TODO: Write me
+ */
 gchar*
 random_text (RandomCreationInfo *rci)
 {
 	/* FIXME: should we translate the various strings in this function? */
 	switch (g_rand_int_range (rci->random, 0, 3)) {
@@ -569,12 +615,20 @@
 			  root_node,
 			  0);
 	return xml_doc;
 }
 
-
-void factory_action_callback_random(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_action_callback_random:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_random(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	RandomCreationInfo rci;
 	xmlDocPtr xml_doc;
 	RandomGUI *gui;
 
@@ -596,12 +650,19 @@
 
 	cong_ui_new_document_from_manufactured_xml (xml_doc,
 						    cong_new_file_assistant_get_toplevel (assistant));
 }
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_random_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_random_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_random_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_document_factory(plugin, 
 					      _("Random Document"), 
@@ -613,11 +674,18 @@
 					      NULL);
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_random_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_random_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_random_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-relaxng.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-relaxng.c,v
retrieving revision 1.1
diff -u -5 -r1.1 plugin-relaxng.c
--- plugin-relaxng.c	22 Feb 2004 16:56:55 -0000	1.1
+++ plugin-relaxng.c	17 Apr 2004 17:45:30 -0000
@@ -27,11 +27,17 @@
 #include "global.h"
 #include "cong-plugin.h"
 
 #include "cong-fake-plugin-hooks.h"
 
- /* would be exposed as "plugin_register"? */
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_relaxng_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_relaxng_plugin_register (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
@@ -39,10 +45,16 @@
 	
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
+/**
+ * plugin_relaxng_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_relaxng_plugin_configure (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
Index: plugin-save-dispspec.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-save-dispspec.c,v
retrieving revision 1.5
diff -u -5 -r1.5 plugin-save-dispspec.c
--- plugin-save-dispspec.c	4 Feb 2004 16:24:21 -0000	1.5
+++ plugin-save-dispspec.c	17 Apr 2004 17:45:30 -0000
@@ -36,11 +36,18 @@
 {
 	/* Always appropriate: */
 	return TRUE;
 }
 
-gchar* change_to_xds(gchar* filename)
+/**
+ * change_to_xds:
+ * @filename:
+ *
+ * TODO: Write me
+ */
+gchar* 
+change_to_xds(gchar* filename)
 {
 	gchar **split_strings;
 	gchar *old_doc_name;
 	gchar *result;
 
@@ -122,12 +129,19 @@
 
 }
 
 
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_save_dispspec_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_save_dispspec_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_save_dispspec_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	cong_plugin_register_doc_tool(plugin, 
 				      _("Dump Display Spec"),
@@ -154,11 +168,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_save_dispspec_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_save_dispspec_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_save_dispspec_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-sgml.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-sgml.c,v
retrieving revision 1.6
diff -u -5 -r1.6 plugin-sgml.c
--- plugin-sgml.c	4 Feb 2004 16:24:21 -0000	1.6
+++ plugin-sgml.c	17 Apr 2004 17:45:30 -0000
@@ -29,18 +29,34 @@
 #include "cong-error-dialog.h"
 #include "cong-parser-error.h"
 
 #include "cong-fake-plugin-hooks.h"
 
-gchar *cong_ui_make_what_failed_string_for_import(const gchar *uri_string)
+/**
+ * cong_ui_make_what_failed_string_for_import:
+ * @uri_string:
+ *
+ * TODO: Write me
+ */
+gchar *
+cong_ui_make_what_failed_string_for_import(const gchar *uri_string)
 {
 	gchar *return_val = g_strdup_printf(_("Conglomerate could not import the file \"%s\""), uri_string);
 
 	return return_val;
 }
 
-gboolean sgml_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
+/**
+ * sgml_importer_mime_filter:
+ * @importer:
+ * @mime_type:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+gboolean 
+sgml_importer_mime_filter(CongServiceImporter *importer, const gchar *mime_type, gpointer user_data)
 {
 	g_return_val_if_fail(importer, FALSE);
 	g_return_val_if_fail(mime_type, FALSE);
 
 	if (0==strcmp(mime_type,"text/sgml")) {
@@ -68,11 +84,22 @@
 
 	return TRUE;
 }
 #endif
 
-void sgml_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
+/**
+ * sgml_importer_action_callback:
+ * @importer:
+ * @uri:
+ * @mime_type:
+ * @user_data:
+ * @toplevel_window:
+ *
+ * TODO: Write me
+ */
+void 
+sgml_importer_action_callback(CongServiceImporter *importer, const gchar *uri, const gchar *mime_type, gpointer user_data, GtkWindow *toplevel_window)
 {
 #if 0
 	char* buffer;
 	GnomeVFSFileSize size;
 #endif
@@ -170,12 +197,19 @@
 	CONG_DO_UNIMPLEMENTED_DIALOG_WITH_BUGZILLA_ID(toplevel_window, _("Importing SGML"), 108465);
 #endif
 }
 
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_sgml_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_sgml_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_sgml_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 	
 	cong_plugin_register_importer(plugin, 
 				      _("Import SGML"), 
@@ -186,11 +220,18 @@
 				      NULL);
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_sgml_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_sgml_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_sgml_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-tei.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-tei.c,v
retrieving revision 1.1
diff -u -5 -r1.1 plugin-tei.c
--- plugin-tei.c	22 Feb 2004 16:56:55 -0000	1.1
+++ plugin-tei.c	17 Apr 2004 17:45:30 -0000
@@ -27,11 +27,17 @@
 #include "global.h"
 #include "cong-plugin.h"
 
 #include "cong-fake-plugin-hooks.h"
 
- /* would be exposed as "plugin_register"? */
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_tei_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_tei_plugin_register (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
@@ -39,10 +45,16 @@
 	
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
+/**
+ * plugin_tei_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
 gboolean 
 plugin_tei_plugin_configure (CongPlugin *plugin)
 {
 	g_return_val_if_fail (IS_CONG_PLUGIN (plugin), FALSE);
 
Index: plugin-templates.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-templates.c,v
retrieving revision 1.8
diff -u -5 -r1.8 plugin-templates.c
--- plugin-templates.c	4 Feb 2004 16:24:21 -0000	1.8
+++ plugin-templates.c	17 Apr 2004 17:45:30 -0000
@@ -69,11 +69,20 @@
 
 	xmlXPathFreeObject(xpathObj);
 	xmlXPathFreeContext(xpathCtx); 
 }
 
-void factory_action_callback_templates(CongServiceDocumentFactory *factory,
+/**
+ * factory_action_callback_templates:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_templates(CongServiceDocumentFactory *factory,
 	CongNewFileAssistant *assistant, gpointer user_data)
 {
 	xmlDocPtr template;
 	gchar* template_file_name;
 
@@ -85,11 +94,20 @@
 
 	cong_ui_new_document_from_manufactured_xml(template,
 		cong_new_file_assistant_get_toplevel(assistant));
 }
 
-void factory_page_creation_callback_templates(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_page_creation_callback_templates:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * This function is not currently implemented
+ */
+void 
+factory_page_creation_callback_templates(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 }
 
 static GSList* get_template_paths(CongPlugin* plugin)
 {
@@ -219,11 +237,18 @@
 	}
 
 }
 
 /* would be exposed as "plugin_register"? */
-gboolean plugin_templates_plugin_register(CongPlugin *plugin)
+/**
+ * plugin_templates_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_templates_plugin_register(CongPlugin *plugin)
 {
 	GSList* template_paths;
 	CongTemplate* template;
 
 	g_return_val_if_fail(plugin, FALSE);
@@ -239,11 +264,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_templates_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_templates_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean
+plugin_templates_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-tests.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-tests.c,v
retrieving revision 1.9
diff -u -5 -r1.9 plugin-tests.c
--- plugin-tests.c	20 Jan 2004 15:58:31 -0000	1.9
+++ plugin-tests.c	17 Apr 2004 17:45:30 -0000
@@ -36,11 +36,20 @@
 	int rows_per_table;
 	int cols_per_table;
 	int starting_character;
 };
 
-void factory_page_creation_callback_unicode(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_page_creation_callback_unicode:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_page_creation_callback_unicode(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	GnomeDruidPageStandard *page;
 
 #if 0
 	g_message("factory_page_creation_callback_unicode");
@@ -304,11 +313,20 @@
 
 	return xml_doc;
 }
 #endif
 
-void factory_action_callback_unicode(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
+/**
+ * factory_action_callback_unicode:
+ * @factory:
+ * @assistant:
+ * @user_data:
+ *
+ * TODO: Write me
+ */
+void 
+factory_action_callback_unicode(CongServiceDocumentFactory *factory, CongNewFileAssistant *assistant, gpointer user_data)
 {
 	xmlDocPtr xml_doc;
 	struct UnicodeCreationInfo uci;
 	
 	uci.num_tables = 16;
@@ -320,12 +338,19 @@
 
 	cong_ui_new_document_from_manufactured_xml(xml_doc,
 						   cong_new_file_assistant_get_toplevel(assistant));	
 }
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_tests_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_tests_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_tests_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	/* Disable this service; it's confusing to end-users and unstable: */
 #if 0	
@@ -341,11 +366,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_tests_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_tests_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_tests_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-validate.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-validate.c,v
retrieving revision 1.8
diff -u -5 -r1.8 plugin-validate.c
--- plugin-validate.c	4 Feb 2004 16:24:21 -0000	1.8
+++ plugin-validate.c	17 Apr 2004 17:45:30 -0000
@@ -156,12 +156,19 @@
 		return;
 	}
 	
 }
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_validate_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_validate_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_validate_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	cong_plugin_register_doc_tool(plugin, 
 				      _("Validate Document"),
@@ -176,11 +183,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_validate_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_validate_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_validate_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-website.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-website.c,v
retrieving revision 1.14
diff -u -5 -r1.14 plugin-website.c
--- plugin-website.c	7 Feb 2004 01:01:31 -0000	1.14
+++ plugin-website.c	17 Apr 2004 17:45:30 -0000
@@ -487,12 +487,19 @@
 	/* FIXME: memory leaks here! */
 	g_free(workspace);
 }
 #endif
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_website_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_website_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_website_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	/* Disabled this plugin as it's too broken to be fixed.  See Bugzilla #113001 */
 #if 0
@@ -511,11 +518,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_website_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_website_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_website_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: plugin-xsl.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/plugin-xsl.c,v
retrieving revision 1.6
diff -u -5 -r1.6 plugin-xsl.c
--- plugin-xsl.c	22 Sep 2003 17:00:18 -0000	1.6
+++ plugin-xsl.c	17 Apr 2004 17:45:30 -0000
@@ -303,12 +303,19 @@
 	return cong_dummy_element_editor_new(editor_widget, node, "This will be the XSL template element");
 #endif
 }
 #endif
 
- /* would be exposed as "plugin_register"? */
-gboolean plugin_xsl_plugin_register(CongPlugin *plugin)
+/* would be exposed as "plugin_register"? */
+/**
+ * plugin_xsl_plugin_register:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_xsl_plugin_register(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	/* FIXME: port all of this code over to the CongEditorWidget3 framework: */
 #if 0	
@@ -322,11 +329,18 @@
 
 	return TRUE;
 }
 
 /* exposed as "plugin_configure"? legitimate for it not to be present */
-gboolean plugin_xsl_plugin_configure(CongPlugin *plugin)
+/**
+ * plugin_xsl_plugin_configure:
+ * @plugin:
+ *
+ * TODO: Write me
+ */
+gboolean 
+plugin_xsl_plugin_configure(CongPlugin *plugin)
 {
 	g_return_val_if_fail(plugin, FALSE);
 
 	return TRUE;
 }
Index: popup.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/popup.c,v
retrieving revision 1.75
diff -u -5 -r1.75 popup.c
--- popup.c	23 Feb 2004 16:58:25 -0000	1.75
+++ popup.c	17 Apr 2004 17:45:30 -0000
@@ -96,10 +96,18 @@
 
 	return TRUE;
 }
 
 /* Implementations: */
+/**
+ * cong_menu_item_attach_callback_Document:
+ * @item:
+ * @callback:
+ * @doc:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_menu_item_attach_callback_Document (GtkMenuItem *item,
 					 CongUICallback_Document callback,
 					 CongDocument *doc)
 {
@@ -116,11 +124,20 @@
 			    GTK_SIGNAL_FUNC(callback_marshaller_Document), 
 			    doc);
 	return item;
 }
 
-
+/**
+ * cong_menu_item_attach_callback_Document_Node_ParentWindow:
+ * @item:
+ * @callback:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem*
 cong_menu_item_attach_callback_Document_Node_ParentWindow (GtkMenuItem *item,
 							   CongUICallback_Document_Node_ParentWindow callback,
 							   CongDocument *doc,
 							   CongNodePtr node,
@@ -149,10 +166,20 @@
 			   parent_window);
 
 	return item;
 }
 
+/**
+ * cong_menu_item_attach_callback_Document_DispspecElement_Node:
+ * @item:
+ * @callback:
+ * @doc:
+ * @ds_element:
+ * @node:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem*
 cong_menu_item_attach_callback_Document_DispspecElement_Node (GtkMenuItem *item, 
 							      CongUICallback_Document_DispspecElement_Node callback,
 							      CongDocument *doc,
 							      CongDispspecElement *ds_element,
@@ -190,10 +217,20 @@
    "document" -> the CongDocument
    "parent_window" -> the  parent_window
   
    The CongNodePtr is passed to the callback function
 */
+/**
+ * cong_menu_item_attach_callback_legacy:
+ * @item:
+ * @callback:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem*
 cong_menu_item_attach_callback_legacy (GtkMenuItem *item,
 				       gint (*callback)(GtkWidget *widget, CongNodePtr node),
 				       CongDocument *doc,
 				       CongNodePtr node,
@@ -218,10 +255,18 @@
 			   parent_window);
 
 	return item;
 }
 
+/**
+ * cong_menu_add_item:
+ * @menu:
+ * @item:
+ * @is_sensitive:
+ *
+ * TODO: Write me
+ */
 GtkMenuItem* 
 cong_menu_add_item (GtkMenu *menu,
 		    GtkMenuItem *item,
 		    gboolean is_sensitive)
 {
@@ -396,15 +441,20 @@
 	}
 
 	return(TRUE);
 }
 
-
+/**
+ * popup_item_handlers_destroy:
+ * @widget:
+ * @data:
+ *
+ * TODO: Write me
+ */
 void popup_item_handlers_destroy(GtkWidget *widget, gpointer data)
 {
 	UNUSED_VAR(int sig);
-
 }
 
 #if 0
 static gint popup_deactivate(GtkWidget *widget, GdkEvent *event)
 {
@@ -434,21 +484,34 @@
 	
 	return(FALSE);
 }
 #endif
 
-
-
-void editor_popup_show(GtkWidget *widget, GdkEventButton *bevent)
+/**
+ * editor_popup_show:
+ * @widget:
+ * @bevent:
+ *
+ * TODO: Write me
+ */
+void 
+editor_popup_show(GtkWidget *widget, GdkEventButton *bevent)
 {
 	gtk_menu_popup(GTK_MENU(widget), NULL, NULL, NULL, NULL, bevent->button,
 								 bevent->time);
 	
 	return;
 }
 
-void editor_popup_init(CongDocument *doc)
+/**
+ * editor_popup_init:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+editor_popup_init(CongDocument *doc)
 {
 	g_return_if_fail (cong_app_singleton());
 
 	if (cong_app_singleton()->popup) gtk_widget_destroy(cong_app_singleton()->popup);
 	cong_app_singleton()->popup = gtk_menu_new();
@@ -487,12 +550,19 @@
 	
 	cong_document_paste_clipboard_or_selection(doc, widget);
 	return TRUE;
 }
 
-
-void editor_popup_build(CongEditorWidget3 *editor_widget, GtkWindow *parent_window)
+/**
+ * editor_popup_build:
+ * @editor_widget:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+void 
+editor_popup_build(CongEditorWidget3 *editor_widget, GtkWindow *parent_window)
 {
 	GtkMenuItem *item;
 	GtkWidget *sub_popup;
 	CongDispspec *dispspec;
 	CongCursor *cursor;
@@ -1005,22 +1075,22 @@
 		gtk_widget_set_sensitive (GTK_WIDGET (item),
 					  FALSE);
 	}	
 }
 
-
-		      
-		      
-		      
-
-
-
-
-
-GtkWidget* cong_ui_popup_init(CongDocument *doc, 
-			      CongNodePtr node,
-			      GtkWindow *parent_window)
+/**
+ * cong_ui_popup_init:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
+GtkWidget* 
+cong_ui_popup_init(CongDocument *doc, 
+		   CongNodePtr node,
+		   GtkWindow *parent_window)
 {
 	GtkMenu *tpopup;
 /* 	GtkWidget *w0; */
 	CongDispspec *ds;
 
@@ -1185,7 +1255,5 @@
 							&callback_data);
 	}
 
 	return GTK_WIDGET(tpopup);
 }
-
-
Index: select.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/select.c,v
retrieving revision 1.30
diff -u -5 -r1.30 select.c
--- select.c	11 Feb 2004 15:54:23 -0000	1.30
+++ select.c	17 Apr 2004 17:45:30 -0000
@@ -27,10 +27,15 @@
 /* Internal function declarations: */
 static void
 update_ordered_selection (CongSelection *selection);
 
 /* Exported function definitions: */
+/**
+ * cong_selection_new:
+ *
+ * Returns: a new #CongSelection
+ */
 CongSelection*
 cong_selection_new (void)
 {
 	CongSelection* selection; 
 	GdkColor gcol;
@@ -65,10 +70,16 @@
 #endif
 
 	return selection;
 }
 
+/**
+ * cong_selection_free:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 void 
 cong_selection_free (CongSelection *selection)
 {	
 	if (selection->gc_valid) {
 		g_object_unref (G_OBJECT (selection->gc_valid));
@@ -78,10 +89,17 @@
 		g_object_unref (G_OBJECT (selection->gc_invalid));
 		selection->gc_invalid = NULL;
 	}
 }
 
+/**
+ * cong_selection_start_from_curs:
+ * @selection:
+ * @curs:
+ *
+ * TODO: Write me
+ */
 void 
 cong_selection_start_from_curs (CongSelection *selection, 
 				CongCursor *curs)
 {
 	g_assert(selection!=NULL);
@@ -91,11 +109,17 @@
 	cong_location_copy(&selection->logical_range.loc1, &curs->location);
 
 	update_ordered_selection (selection);
 }
 
-
+/**
+ * cong_selection_end_from_curs:
+ * @selection:
+ * @curs:
+ *
+ * TODO: Write me
+ */
 void 
 cong_selection_end_from_curs (CongSelection *selection, 
 			      CongCursor *curs)
 {
 	g_assert(selection!=NULL);
@@ -104,18 +128,30 @@
 	cong_location_copy(&selection->logical_range.loc1, &curs->location);
 
 	update_ordered_selection (selection);
 }
 
+/**
+ * cong_selection_get_logical_range:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 CongRange*
 cong_selection_get_logical_range (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, NULL);
 
 	return &selection->logical_range;
 }
 
+/**
+ * cong_selection_get_ordered_range:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 CongRange*
 cong_selection_get_ordered_range (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, NULL);
 
@@ -123,26 +159,44 @@
 	update_ordered_selection (selection);
 
 	return &selection->ordered_range;
 }
 
+/**
+ * cong_selection_get_logical_start:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 CongLocation*
 cong_selection_get_logical_start (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, NULL);
 
 	return &(selection->logical_range.loc0);
 }
 
+/**
+ * cong_selection_get_logical_end:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 CongLocation*
 cong_selection_get_logical_end (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, NULL);
 
 	return &(selection->logical_range.loc1);
 }
 
+/**
+ * cong_selection_get_ordered_start:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 CongLocation*
 cong_selection_get_ordered_start (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, NULL);
 
@@ -150,10 +204,16 @@
 	update_ordered_selection (selection);
 
 	return &(selection->ordered_range.loc0);
 }
 
+/**
+ * cong_selection_get_ordered_end:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 CongLocation*
 cong_selection_get_ordered_end (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, NULL);
 
@@ -161,10 +221,17 @@
 	update_ordered_selection (selection);
 
 	return &(selection->ordered_range.loc1);
 }
 
+/**
+ * cong_selection_set_logical_start:
+ * @selection:
+ * @location:
+ *
+ * TODO: Write me
+ */
 void
 cong_selection_set_logical_start (CongSelection *selection,
 				  const CongLocation *location)
 {	
 	g_assert(selection!=NULL);
@@ -174,10 +241,17 @@
 
 	update_ordered_selection (selection);
 
 }
 
+/**
+ * cong_selection_set_logical_end:
+ * @selection:
+ * @location:
+ *
+ * TODO: Write me
+ */
 void
 cong_selection_set_logical_end (CongSelection *selection,
 				const CongLocation *location)
 {
 	g_assert(selection!=NULL);
@@ -186,10 +260,18 @@
 	cong_location_copy(&selection->logical_range.loc1, location);
 
 	update_ordered_selection (selection);
 }
 
+/**
+ * cong_selection_set_logical_range:
+ * @selection:
+ * @start_loc:
+ * @end_loc:
+ *
+ * TODO: Write me
+ */
 void
 cong_selection_set_logical_range (CongSelection *selection,
 				  const CongLocation *start_loc,
 				  const CongLocation *end_loc)
 {
@@ -204,23 +286,37 @@
 }
 
 
 #if 1
 
-void cong_selection_import(CongSelection *selection, GtkWidget* widget)
+/**
+ * cong_selection_import:
+ * @selection:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+cong_selection_import(CongSelection *selection, GtkWidget* widget)
 {
 	gtk_selection_convert(widget, GDK_SELECTION_PRIMARY,
 			      gdk_atom_intern("STRING", FALSE), GDK_CURRENT_TIME);
 
 #ifndef RELEASE	
 	printf("In cong_selection_import().\n");
 #endif
 	
 }
 
-
-void cong_selection_claim(CongSelection *selection)
+/**
+ * cong_selection_claim:
+ * @selection:
+ *
+ * TODO: Write me
+ */
+void 
+cong_selection_claim(CongSelection *selection)
 {
 
 #if 0	
 	gint gtk_selection_owner_set(GtkWidget *widget,
 															 GdkAtom    selection,
@@ -231,29 +327,48 @@
 #endif
 }
 
 #endif
 
+/**
+ * cong_selection_is_node:
+ * @selection:
+ * @node:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_selection_is_node (CongSelection *selection,
 			CongNodePtr node)
 {
 	g_return_val_if_fail (selection, FALSE);
 
 	return cong_range_is_node (&selection->logical_range,
 				   node);
 }
 
+/**
+ * cong_selection_nullify:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 void
 cong_selection_nullify (CongSelection *selection)
 {
 	g_return_if_fail (selection);
 
 	cong_range_nullify (&selection->logical_range);
 	cong_range_nullify (&selection->ordered_range);
 }
 
+/**
+ * cong_selection_is_valid:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 gboolean
 cong_selection_is_valid (CongSelection *selection)
 {
 	g_return_val_if_fail (selection, FALSE);
 
@@ -264,16 +379,28 @@
 	}
 	
 	return FALSE;
 }
 
+/**
+ * cong_selection_legacy_get_gc_valid:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 GdkGC*
 cong_selection_legacy_get_gc_valid (CongSelection *selection)
 {
 	return selection->gc_valid;
 }
 
+/**
+ * cong_selection_legacy_get_gc_invalid:
+ * @selection:
+ *
+ * TODO: Write me
+ */
 GdkGC*
 cong_selection_legacy_get_gc_invalid (CongSelection *selection)
 {
 	return selection->gc_invalid;
 }
@@ -285,6 +412,5 @@
 	cong_range_copy (&selection->ordered_range, &selection->logical_range);
 	cong_range_make_ordered (&selection->ordered_range);
 
 	/* probabky should have some caching of the result */
 }
-
Index: tree.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/tree.c,v
retrieving revision 1.52
diff -u -5 -r1.52 tree.c
--- tree.c	11 Feb 2004 17:35:56 -0000	1.52
+++ tree.c	17 Apr 2004 17:45:30 -0000
@@ -15,10 +15,18 @@
 #include "cong-command.h"
 #include "cong-ui-hooks.h"
 
 /* the popup items have the data "popup_data_item" set on them: */
 
+/**
+ * cong_ui_hook_tree_new_sibling:
+ * @doc:
+ * @ds_element:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void 
 cong_ui_hook_tree_new_sibling (CongDocument *doc,
 			       CongDispspecElement *ds_element,
 			       CongNodePtr node)
 {
@@ -55,10 +63,18 @@
 
 	cong_document_end_edit(doc);
 	
 }
 
+/**
+ * cong_ui_hook_tree_new_sub_element:
+ * @doc:
+ * @ds_element:
+ * @node:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_tree_new_sub_element (CongDocument *doc,
 				   CongDispspecElement *ds_element,
 				   CongNodePtr node)
 {
@@ -94,10 +110,18 @@
 	}
 
 	cong_document_end_edit(doc);
 }
 
+/**
+ * cong_ui_hook_tree_properties:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_tree_properties (CongDocument *doc,
 			      CongNodePtr node,
 			      GtkWindow *parent_window)
 {
@@ -136,10 +160,18 @@
 	}
 
 	return FALSE;
 }
 
+/**
+ * cong_ui_hook_tree_cut:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void 
 cong_ui_hook_tree_cut (CongDocument *doc,
 		       CongNodePtr node,
 		       GtkWindow *parent_window)
 {
@@ -173,11 +205,18 @@
 	}
 
 	cong_document_end_edit(doc);
 }
 
-
+/**
+ * cong_ui_hook_tree_copy:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void 
 cong_ui_hook_tree_copy (CongDocument *doc,
 			CongNodePtr node,
 			GtkWindow *parent_window)
 {
@@ -194,10 +233,18 @@
 						  source,
 						  doc);	
 	g_free(source);
 }
 
+/**
+ * cong_ui_hook_tree_paste_under:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void 
 cong_ui_hook_tree_paste_under (CongDocument *doc,
 			       CongNodePtr node,
 			       GtkWindow *parent_window)
 {
@@ -217,11 +264,18 @@
 						  node,
 						  clipboard_source);
 	}
 }
 
-
+/**
+ * cong_ui_hook_tree_paste_before:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_tree_paste_before (CongDocument *doc,
 				CongNodePtr node,
 				GtkWindow *parent_window)
 {
@@ -241,11 +295,18 @@
 						   node,
 						   clipboard_source);
 	}
 }
 
-
+/**
+ * cong_ui_hook_tree_paste_after:
+ * @doc:
+ * @node:
+ * @parent_window:
+ *
+ * TODO: Write me
+ */
 void
 cong_ui_hook_tree_paste_after (CongDocument *doc,
 			       CongNodePtr node,
 			       GtkWindow *parent_window)
 {
Index: xmldata.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/xmldata.c,v
retrieving revision 1.64
diff -u -5 -r1.64 xmldata.c
--- xmldata.c	5 Mar 2004 01:27:49 -0000	1.64
+++ xmldata.c	17 Apr 2004 17:45:30 -0000
@@ -33,11 +33,18 @@
 						      gint elements_length, enum CongElementType tag_type);
 static GList* xml_get_elements_from_dispspec(CongDispspec* ds, enum CongElementType tag_type);
 
 
 /* Other stuff: */
-const gchar *xml_frag_data_nice(CongNodePtr x)
+/**
+ * xml_frag_data_nice:
+ * @x:
+ *
+ * TODO: Write me
+ */
+const gchar *
+xml_frag_data_nice(CongNodePtr x)
 {
 	const char *s;
 	
 	g_return_val_if_fail(cong_node_is_valid_cursor_location (x), NULL);
 	
@@ -71,11 +78,12 @@
 
 	return(new);
 }
 
 /* Recursively traverses the document from that node concatenating the character data into a string */
-char *xml_fetch_clean_data(CongNodePtr x)
+char *
+xml_fetch_clean_data(CongNodePtr x)
 {
 	CongNodePtr n0;
 	char *s = 0, *s_sub;
 
 	n0 = cong_node_first_child(x);
@@ -102,12 +110,19 @@
 	}
 	
 	return(s);
 }
 
-
-GList* xml_all_present_span_elements(CongDispspec *ds, CongNodePtr node) 
+/**
+ * xml_all_present_span_elements:
+ * @ds:
+ * @node:
+ *
+ * TODO: Write me
+ */
+GList* 
+xml_all_present_span_elements(CongDispspec *ds, CongNodePtr node) 
 {
 	GList* list = NULL;
 
 	g_return_val_if_fail(ds, NULL);
 	g_return_val_if_fail(node, NULL);
@@ -166,11 +181,19 @@
 		*list_ptr = g_list_prepend (*list_ptr,
 					    ds_element);
 	}
 }
 
-GList* xml_all_valid_span_elements(CongDispspec *ds, CongNodePtr node) 
+/**
+ * xml_all_valid_span_elements:
+ * @ds:
+ * @node:
+ *
+ * TODO: Write me
+ */
+GList*
+xml_all_valid_span_elements(CongDispspec *ds, CongNodePtr node) 
 {
 	GList* list = NULL;
 
 	g_return_val_if_fail(ds, NULL);
 	g_return_val_if_fail(node, NULL);
@@ -190,11 +213,11 @@
 
 	return list;
 }
 
 /**
- * xml_add_required_children
+ * xml_add_required_children:
  * @doc:
  * @node:
  *
  * In the presence of a DTD, adds all children required
  * by the DTD to the node.  This is a recursive process,
@@ -208,13 +231,12 @@
  * to the input node.
  *
  * If no DTD is present, this function will default to
  * simply adding a text node under the node as well.
  *
- * Returns: a boolean telling whether the structure of the
- * node passed is now valid under a DTD.  If no DTD exists,
- * this will return FALSE.
+ * Returns: %TRUE if the structure of @node is valid under
+ * a DTD, %FALSE otherwise.
  */
 gboolean 
 cong_command_add_xml_add_required_children (CongCommand *cmd, 
 					    CongNodePtr node)
 {
@@ -253,11 +275,13 @@
  * Helper function to add the required children
  * to a node.
  *
  * Returns whether the node is now valid
  */
-static gboolean cong_command_add_xml_add_required_sub_elements(CongCommand *cmd, CongNodePtr node) {
+static gboolean 
+cong_command_add_xml_add_required_sub_elements(CongCommand *cmd, CongNodePtr node) 
+{
 	xmlDocPtr doc;
 	xmlElementPtr elemDecl = NULL;
 	xmlElementContentPtr content;
 	const xmlChar *prefix = NULL;
 	gboolean extsubset = FALSE;
@@ -538,11 +562,11 @@
 	return FALSE;
 }
 /**** end of the add_required stuff ****/
 
 /**
- * xml_valid_get_potential_element_children
+ * xml_valid_get_potential_element_children:
  * @ctree:
  * @list:
  * @len:
  * @max:
  * 
@@ -587,11 +611,11 @@
     
     return(*len);
 }
 
 /**
- * wrap_xml_valid_get_valid_elements
+ * wrap_xml_valid_get_valid_elements:
  * @doc:
  * @parent:
  * @next_sibling:
  * @elements:
  * @max:
@@ -677,11 +701,11 @@
 
 
 #define MAX_ELEMENTS 256
 
 /**
- * cong_document_get_valid_new_child_elements
+ * cong_document_get_valid_new_child_elements:
  * @doc:
  * @node: node for which to get valid children
  * @tag_type: either CONG_ELEMENT_TYPE_STRUCTURAL, CONG_ELEMENT_TYPE_SPAN, or CONG_ELEMENT_TYPE_ALL
  * 
  * Get the set of valid children for a node.  If the document
@@ -689,11 +713,11 @@
  * of the valid children and elements in the display spec of 
  * type tag_type.
  * If the document does not contain a dtd, the function will fallback
  * on returning the elements in the display spec of type tag_type.
  *
- * Returns: GList of CongDispspecElement
+ * Returns: #GList of #CongDispspecElement
  */
 GList*
 cong_document_get_valid_new_child_elements (CongDocument *doc,
 					    CongNodePtr node, 
 					    enum CongElementType tag_type)
@@ -720,23 +744,23 @@
 	}
 }
 
 
 /**
- * cong_document_get_valid_new_previous_sibling_elements
+ * cong_document_get_valid_new_previous_sibling_elements:
  * @doc:
- * @node: CongNodePtr node for which to get valid previous siblings
+ * @node: #CongNodePtr node for which to get valid previous siblings
  * @tag_type: either CONG_ELEMENT_TYPE_STRUCTURAL, CONG_ELEMENT_TYPE_SPAN, or CONG_ELEMENT_TYPE_ALL
  * 
  * Get the set of valid previous siblings for a node.  If the document
  * contains a DTD, this function will return the intersection
  * of the valid previous siblings and elements in the display spec of 
  * type tag_type.
  * If the document does not contain a dtd, the function will fallback
  * on returning the elements in the display spec of type tag_type.
  *
- * Returns: GList of CongDispspecElement
+ * Returns: #GList of #CongDispspecElement
  */
 GList* 
 cong_document_get_valid_new_previous_sibling_elements (CongDocument *doc,
 						       CongNodePtr node, 
 						       enum CongElementType tag_type)
@@ -758,11 +782,11 @@
 		return xml_get_elements_from_dispspec(ds, tag_type);
 	}
 }
 
 /**
- * cong_document_get_valid_new_next_sibling_elements
+ * cong_document_get_valid_new_next_sibling_elements:
  * @doc:
  * @node: node for which to get valid next siblings
  * @tag_type: either CONG_ELEMENT_TYPE_STRUCTURAL, CONG_ELEMENT_TYPE_SPAN, or CONG_ELEMENT_TYPE_ALL
  * 
  * Get the set of valid next siblings for a node.  If the document
@@ -770,11 +794,11 @@
  * of the valid next siblings and elements in the display spec of 
  * type tag_type.
  * If the document does not contain a dtd, the function will fallback
  * on returning the elements in the display spec of type tag_type.
  *
- * Returns: GList of CongDispspecElement
+ * Returns: #GList of #CongDispspecElement
  */
 GList* 
 cong_document_get_valid_new_next_sibling_elements (CongDocument* doc, 
 						   CongNodePtr node, 
 						   enum CongElementType tag_type)
@@ -795,10 +819,17 @@
 	else {
 		return xml_get_elements_from_dispspec(ds, tag_type);
 	}
 }
 
+/**
+ * should_include_element:
+ * @element:
+ * @tag_type:
+ *
+ * TODO: Write me
+ */
 gboolean
 should_include_element (CongDispspecElement *element,
 			enum CongElementType tag_type )
 {
 	g_return_val_if_fail (element, FALSE);
@@ -820,11 +851,11 @@
 		return cong_dispspec_element_is_span(element);
 	}
 }
 
 /**
- * xml_filter_valid_children_with_dispspec
+ * xml_filter_valid_children_with_dispspec:
  * @ds:
  * @elements:
  * @elements_length:
  * @tag_type:
  * 
@@ -882,11 +913,11 @@
 	}
 }
 		
 
 /**
- * xml_get_elements_from_dispspec
+ * xml_get_elements_from_dispspec:
  * @ds:
  * @tag_type:
  * 
  * Get all elements from the display spec that
  * are of tag_type.
@@ -908,13 +939,22 @@
 	
 	return add_element_data.list;
 }
 
 /* Extensions to libxml: */
-xmlAttrPtr	xmlNewProp_NUMBER	(xmlNodePtr node,
-					 const xmlChar *name,
-					 int value)
+/**
+ * xmlNewProp_NUMBER:
+ * @node:
+ * @name:
+ * @value:
+ *
+ * TODO: Write me
+ */
+xmlAttrPtr
+xmlNewProp_NUMBER (xmlNodePtr node,
+		   const xmlChar *name,
+		   int value)
 {
 	gchar *textual_value = g_strdup_printf("%i", value);
 	xmlAttrPtr attr = xmlNewProp(node, name, textual_value);
 
 	g_free(textual_value);
Index: xmledit.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/xmledit.c,v
retrieving revision 1.66
diff -u -5 -r1.66 xmledit.c
--- xmledit.c	11 Feb 2004 15:54:23 -0000	1.66
+++ xmledit.c	17 Apr 2004 17:45:30 -0000
@@ -13,11 +13,18 @@
 #include "cong-range.h"
 #include "cong-error-dialog.h"
 #include "cong-command.h"
 
 /* --- Cut/copy/paste --- */
-void cong_document_cut_selection(CongDocument *doc)
+/**
+ * cong_document_cut_selection:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_cut_selection(CongDocument *doc)
 {
 	CongSelection *selection;
 	CongCursor *curs;
 	CongRange *ordered_range; 
 	gchar *source;
@@ -56,11 +63,18 @@
 	}
 
 	cong_document_end_edit (doc);
 }
 
-void cong_document_copy_selection(CongDocument *doc)
+/**
+ * cong_document_copy_selection:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_copy_selection(CongDocument *doc)
 {
 	CongSelection *selection;
 	CongCursor *curs;
 
 	g_return_if_fail(doc);
@@ -99,12 +113,19 @@
 	}
 
 	cong_document_end_edit (doc);
 }
 
-
-void cong_document_paste_clipboard_or_selection(CongDocument *doc, GtkWidget *widget)
+/**
+ * cong_document_paste_clipboard_or_selection:
+ * @doc:
+ * @widget:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_paste_clipboard_or_selection(CongDocument *doc, GtkWidget *widget)
 {
 	CongSelection *selection;
 	CongCursor *curs;
 	const gchar *source_fragment;
 
@@ -125,10 +146,18 @@
 					       &curs->location, 
 					       source_fragment);
 	}
 }
 
+/**
+ * cong_document_paste_source_at:
+ * @doc:
+ * @insert_loc:
+ * @source_fragment:
+ *
+ * TODO: Write me
+ */
 void 
 cong_document_paste_source_at (CongDocument *doc, 
 			       CongLocation *insert_loc, 
 			       const gchar *source_fragment)
 {
@@ -213,10 +242,18 @@
 	
 	cong_document_end_edit (doc);
 
 }
 
+/**
+ * cong_document_paste_source_under:
+ * @doc:
+ * @relative_to_node:
+ * @source_fragment:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_paste_source_under (CongDocument *doc, 
 				  CongNodePtr relative_to_node,
 				  const gchar *source_fragment)
 {
@@ -256,10 +293,18 @@
 	}
 	
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_document_paste_source_before:
+ * @doc:
+ * @relative_to_node:
+ * @source_fragment:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_paste_source_before (CongDocument *doc, 
 				   CongNodePtr relative_to_node,
 				   const gchar *source_fragment)
 {
@@ -298,10 +343,18 @@
 	}
 	
 	cong_document_end_edit (doc);
 }
 
+/**
+ * cong_document_paste_source_after:
+ * @doc:
+ * @relative_to_node:
+ * @source_fragment:
+ *
+ * TODO: Write me
+ */
 void
 cong_document_paste_source_after (CongDocument *doc, 
 				  CongNodePtr relative_to_node,
 				  const gchar *source_fragment)
 {
@@ -346,11 +399,18 @@
 	cong_document_end_edit (doc);
 }
 
 extern char *ilogo_xpm[];
 
-void cong_document_view_source(CongDocument *doc)
+/**
+ * cong_document_view_source:
+ * @doc:
+ *
+ * TODO: Write me
+ */
+void 
+cong_document_view_source(CongDocument *doc)
 {
 	GtkWidget *window;
 	GtkWidget *source_view;
 
 	g_return_if_fail(doc);
@@ -377,15 +437,5 @@
 				    400);
 
 	gtk_widget_show(GTK_WIDGET(window));
 
 }
-
-
-
-
-
-
-
-
-
-
Index: xmlview.c
===================================================================
RCS file: /cvs/gnome/conglomerate/src/xmlview.c,v
retrieving revision 1.35
diff -u -5 -r1.35 xmlview.c
--- xmlview.c	1 Sep 2003 18:19:06 -0000	1.35
+++ xmlview.c	17 Apr 2004 17:45:31 -0000
@@ -51,10 +51,16 @@
 {
 	return g_strdup_printf ("#%06X", (guint) (color & 0xFFFFFF));
 }
 #endif
 
+/**
+ * get_col_string:
+ * @col:
+ *
+ * TODO: Write me
+ */
 gchar*
 get_col_string(const GdkColor* col)
 {
 
 	guint32 col32;
