diff --git a/src/codegen.c b/src/codegen.c
index 26b68e2e..5c458317 100644
--- a/src/codegen.c
+++ b/src/codegen.c
@@ -15,6 +15,10 @@
 # error enable PIC_NONE_IS_FALSE
 #endif
 
+/**
+ * scope object
+ */
+
 typedef struct analyze_scope {
   int depth;
   bool varg;
@@ -22,6 +26,10 @@ typedef struct analyze_scope {
   struct analyze_scope *up;
 } analyze_scope;
 
+/**
+ * global analyzer state
+ */
+
 typedef struct analyze_state {
   pic_state *pic;
   analyze_scope *scope;