[Libsysio-commit] HEAD: libsysio/src init.c

[Lee W. <lw...@us...>]

Update of /cvsroot/libsysio/libsysio/src
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23070/src

Modified Files:
	init.c 
Log Message:


Oops. forgot to remove the old _sysio_tracing global declaration. Fixed.

Added a bunch of comments.


Index: init.c
===================================================================
RCS file: /cvsroot/libsysio/libsysio/src/init.c,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -w -b -B -p -r1.22 -r1.23
--- init.c	15 Sep 2005 21:31:38 -0000	1.22
+++ init.c	15 Sep 2005 21:46:23 -0000	1.23
@@ -81,18 +81,30 @@
 
 #if SYSIO_TRACING
 
+/*
+ * Tracing callback record.
+ */
 struct trace_callback {
 	TAILQ_ENTRY(trace_callback) links;
 	void	(*f)(const char *file, const char *func, int line);
 };
 
+/*
+ * Initialize a tracing callback record.
+ */
 #define TCB_INIT(__tcb, __f) \
 	do { \
 		(__tcb)->f = (__f); \
 	} while (0);
 
+/*
+ * Trace queue head record.
+ */
 TAILQ_HEAD(trace_q, trace_callback);
 
+/*
+ * The entry and exit queue heads, and queue pointers.
+ */
 static struct trace_q _sysio_entry_trace_head;
 void	*_sysio_entry_trace_q = &_sysio_entry_trace_head;
 static struct trace_q _sysio_exit_trace_head;
@@ -187,6 +199,9 @@ _sysio_shutdown()
 	{
 		struct trace_callback *tcb;
 
+		/*
+		 * Empty the trace queues and free the entries.
+		 */
 		while ((tcb = _sysio_entry_trace_head.tqh_first) != NULL) {
 			TAILQ_REMOVE(&_sysio_entry_trace_head, tcb, links);
 			free(tcb);
@@ -287,7 +302,7 @@ _sysio_cprintf(const char *fmt, ...)
 /*
  * Register a trace callback.
  *
- * The pointer to the tracde record is returned.
+ * The pointer to the trace record is returned.
  */
 void *
 _sysio_register_trace(void *q,
@@ -305,6 +320,9 @@ _sysio_register_trace(void *q,
 	return tcb;
 }
 
+/*
+ * Remove a registered trace callback.
+ */
 void
 _sysio_remove_trace(void *q, void *p)
 {
@@ -314,6 +332,9 @@ _sysio_remove_trace(void *q, void *p)
 }
 
 void
+/*
+ * Run a trace queue, making all the callbacks.
+ */
 _sysio_run_trace_q(void *q,
 		   const char *file,
 		   const char *func,