Improve code comment

darcs-hash:20080116010601-75c98-fc7e940543424479bf1016cec26af619f177f5fd.gz

1 files changed, 6 insertions, 2 deletions

diff --git a/function.h b/function.h
index a79b3725..7e172948 100644
--- a/function.h
+++ b/function.h
@@ -15,8 +15,12 @@
 #include "util.h"
 
 /**
-   Structure describing a function
-*/
+   Structure describing a function. This is used by the parser to
+   store data on a function while parsing it. It is not used
+   internally to store functions, the function_internal_data_t
+   structure is used for that purpose. Parhaps these two should be
+   merged.
+  */
 typedef struct function_data
 {
 	/**