Convert to doxygen comments

[libfirm] / ir / ir / irgraph_t.h

diff --git a/ir/ir/irgraph_t.h b/ir/ir/irgraph_t.h
index b330c73..66f7ae8 100644 (file)
--- a/ir/ir/irgraph_t.h
+++ b/ir/ir/irgraph_t.h
@@ -1,9 +1,9 @@
 /* Copyright (C) 1998 - 2000 by Universitaet Karlsruhe
-** All rights reserved.
-**
-** Authors: Martin Trapp, Christian Schaefer
-**
-** irgraph.h: ir graph construction
+* All rights reserved.
+*
+* Authors: Martin Trapp, Christian Schaefer
+*
+* irgraph.h: ir graph construction
 */
 
 /* $Id$ */
@@ -13,9 +13,13 @@
 # include "obst.h"
 # include "pset.h"
 # include "irgraph.h"
+# include "firm_common_t.h"
+
+#define FRAME_TP_SUFFIX "frame_tp"
 
 /* ir_graph holds all information for a procedure */
 struct ir_graph {
+  /** Basics of the representation **/
   struct entity  *ent;               /* The entity of this procedure, i.e.,
                                        the type of the procedure and the
                                        class it belongs to. */
@@ -32,27 +36,45 @@ struct ir_graph {
   struct ir_node *args;              /* methods arguments */
   struct ir_node *bad;              /* bad node of this ir_graph, the one and
                                         only in this graph */
+  struct ir_node *unknown;           /* unknown node of this ir_graph */
   struct obstack *obst;                     /* obstack where all of the ir_nodes live */
-#if USE_EXPICIT_PHI_IN_STACK
-  struct Phi_in_stack *Phi_in_stack; /* needed for automatic Phi construction */
-#endif
   struct ir_node *current_block;     /* block for newly gen_*()-erated
                                        ir_nodes */
+
+  /** Fields indicating different states of irgraph **/
+  irg_phase_state phase_state;       /* compiler phase */
+  op_pinned pinned;                  /* Flag for status of nodes */
+  irg_outs_state outs_state;         /* Out edges. */
+  irg_dom_state dom_state;           /* Dominator information */
+
+  /** Fields for construction **/
+#if USE_EXPLICIT_PHI_IN_STACK
+  struct Phi_in_stack *Phi_in_stack; /* needed for automatic Phi construction */
+#endif
   int n_loc;                         /* number of local variable in this
                                        procedure including procedure parameters. */
-  pset *value_table;                 /* value table for global value numbering
+
+  /** Fields for optimizations / analysis information **/
+  pset *value_table;                 /* hash table for global value numbering (cse)
                                        for optimizing use in iropt.c */
+  struct ir_node **outs;             /* Space for the out arrays. */
+  struct ir_loop *loop;              /* The outermost loop */
+  void *link;                        /* A void* field to link any information to
+                                       the node. */
+
+  /** Fields for Walking the graph **/
   unsigned long visited;             /* this flag is an identifier for
-                                       ir walk. it will be incremented,
-                                       every time, someone walk through
+                                       ir walk. it will be incremented
+                                       every time someone walks through
                                        the graph */
-  unsigned long block_visited;       /* same as visited, for a
-                                       complete block */
+  unsigned long block_visited;       /* same as visited, for a complete block */
 };
 
 /* Make a rudimentary ir graph for the constant code.
    Must look like a correct irg, spare everything else. */
 ir_graph *new_const_code_irg();
 
+INLINE void
+set_irg_pinned (ir_graph *irg, op_pinned p);
 
 # endif /* _IRGRAPH_T_H_ */