Improved doxygen docu.

ir/be/bechordal_main.c

@@ -183,7 +183,9 @@ static void dump(unsigned mask, ir_graph *irg,
 }
 
 /**
- * Checks for every reload if its user can perform the load on itself.
+ * Post-Walker: Checks for the given reload if has only one user that can perform the
+ * reload as part of its address mode.
+ * Fold the reload into the user it that is possible.
  */
 static void memory_operand_walker(ir_node *irn, void *env)
 {
@@ -214,7 +216,7 @@ static void memory_operand_walker(ir_node *irn, void *env)
 		}
 	}
 
-	/* kill the Reload */
+	/* kill the Reload if it was folded */
 	if (get_irn_n_edges(irn) == 0) {
 		ir_graph *irg = get_irn_irg(irn);
 		ir_mode  *frame_mode = get_irn_mode(get_irn_n(irn, n_be_Reload_frame));

ir/be/beutil.c

@@ -68,6 +68,9 @@ ir_node *be_get_Proj_for_pn(const ir_node *irn, long pn)
 	return NULL;
 }
 
+/**
+ * Block-walker: adds the visited block to a flexible array.
+ */
 static void add_to_postorder(ir_node *block, void *data)
 {
 	ir_node ***list = (ir_node***) data;