some more comments

1999-05-01  bertrand <Bertrand.Guiheneuf@inria.fr>

	* camel/url-util.c (g_url_new): some
	more comments

1999-04-27  bertrand <Bertrand.Guiheneuf@inria.fr>

	* camel/camel-folder.c (camel_folder_create):
	new public function.

svn path=/trunk/; revision=884

2 files changed, 17 insertions, 4 deletions

diff --git a/ChangeLog b/ChangeLog
index 82ea43e27f..36b6af4d86 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+1999-05-01  bertrand <Bertrand.Guiheneuf@inria.fr>
+
+	* camel/url-util.c (g_url_new): some
+	more comments 
+
+1999-04-27  bertrand <Bertrand.Guiheneuf@inria.fr>
+
+	* camel/camel-folder.c (camel_folder_create): 
+	new public function.
+
 1999-04-25  bertrand <Bertrand.Guiheneuf@inria.fr>
 
 	* camel/camel-session.c (camel_session_get_store_from_provider): 
diff --git a/camel/url-util.c b/camel/url-util.c
index 089254bc9c..1b784385f5 100644
--- a/camel/url-util.c
+++ b/camel/url-util.c
@@ -37,13 +37,16 @@
 
 #include "url-util.h"
 
-
+/* general item finder */
+/* it begins the search at position @position in @url,
+   returns true when the item is found, amd set position after the item */
 typedef gboolean find_item_func(GString *url, GString **item, guint *position, gboolean *error);
 
+/* used to find one item (protocol, then user .... */
 typedef struct {
-	char *item_name;
-	GString **item_value;
-	find_item_func *find_func;
+	char *item_name;           /* item name : for debug only */
+	GString **item_value;      /* where the item value will go */
+	find_item_func *find_func; /* item finder */
 } FindStepStruct;
 
 static gboolean find_protocol(GString *url, GString **item, guint *position, gboolean *error);