cleaned up doxygen comments

[r13522]

diff --git a/ir/ir/irarch.c b/ir/ir/irarch.c
index 377200b..d7d5a35 100644 (file)
--- a/ir/ir/irarch.c
+++ b/ir/ir/irarch.c
@@ -18,12 +18,11 @@
  */
 
 /**
- * @file irarch.c
- * @date 28.9.2004
- * @author Sebastian Hack, Michael Beck
- * @brief Machine dependent Firm optimizations.
- *
- * $Id$
+ * @file
+ * @brief   Machine dependent Firm optimizations.
+ * @date    28.9.2004
+ * @author  Sebastian Hack, Michael Beck
+ * @version $Id$
  */
 #ifdef HAVE_CONFIG_H
 # include "config.h"

diff --git a/ir/ir/irarch.h b/ir/ir/irarch.h
index 25a10ef..2a36ac2 100644 (file)
--- a/ir/ir/irarch.h
+++ b/ir/ir/irarch.h
@@ -18,16 +18,14 @@
  */
 
 /**
- * @file irarch.h
- * @date 1.10.2004
+ * @file
+ * @brief  Some machine dependent optimizations.
+ * @date   1.10.2004
  * @author Sebastian Hack
- * @brief Some machine dependent optimizations.
- *
- * $Id$
+ * @version $Id$
  */
-
-#ifndef _FIRM_IR_IRARCH_H_
-#define _FIRM_IR_IRARCH_H_
+#ifndef FIRM_IR_IRARCH_H
+#define FIRM_IR_IRARCH_H
 
 #include "firm_types.h"
 
@@ -155,4 +153,4 @@ ir_node *arch_dep_replace_mod_by_const(ir_node *irn);
  */
 void arch_dep_replace_divmod_by_const(ir_node **div, ir_node **mod, ir_node *irn);
 
-#endif /* _FIRM_IR_IRARCH_H_ */
+#endif

diff --git a/ir/ir/irargs.c b/ir/ir/irargs.c
index 86e883e..44f5c96 100644 (file)
--- a/ir/ir/irargs.c
+++ b/ir/ir/irargs.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irargs.c
- * Purpose:     Support for libcore IR object output.
- * Author:      Sebastian Hack
- * Modified by:
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2005 Universitaet Karlsruhe
+/**
+ * @file
+ * @brief    Support for libcore IR object output.
+ * @author   Sebastian Hack
+ * @version  $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irargs_t.h b/ir/ir/irargs_t.h
index 7c086e2..611f4fe 100644 (file)
--- a/ir/ir/irargs_t.h
+++ b/ir/ir/irargs_t.h
@@ -17,9 +17,13 @@
  * PURPOSE.
  */
 
-
-#ifndef _FIRM_IRARGS_H
-#define _FIRM_IRARGS_H
+/**
+ * @file
+ * @brief   irargs private declarations
+ * @version $Id$
+ */
+#ifndef FIRM_IR_IRARGS_H
+#define FIRM_IR_IRARGS_H
 
 #include <libcore/lc_printf.h>
 

diff --git a/ir/ir/irbitset.h b/ir/ir/irbitset.h
index e3b10de..bbb5e93 100644 (file)
--- a/ir/ir/irbitset.h
+++ b/ir/ir/irbitset.h
@@ -18,13 +18,14 @@
  */
 
 /**
- * Some convenience macros for node bitmaps.
- * @author Sebastian Hack
- * @date   10.05.2006
+ * @file
+ * @brief   Some convenience macros for node bitmaps.
+ * @author  Sebastian Hack
+ * @date    10.05.2006
+ * @version $Id$
  */
-
-#ifndef __FIRM_IRBITSET_H
-#define __FIRM_IRBITSET_H
+#ifndef FIRM_IR_IRBITSET_H
+#define FIRM_IR_IRBITSET_H
 
 #include "bitset.h"
 
@@ -50,4 +51,4 @@
        for(elm = bitset_next_set(bs, 0), irn = _bsfe_get_irn(irg, elm); elm != -1; elm = bitset_next_set(bs, elm + 1), irn = _bsfe_get_irn(irg, elm))
 
 
-#endif /* __FIRM_IRBITSET_H */
+#endif

diff --git a/ir/ir/ircgcons.c b/ir/ir/ircgcons.c
index 000343c..fda541d 100644 (file)
--- a/ir/ir/ircgcons.c
+++ b/ir/ir/ircgcons.c
@@ -17,16 +17,13 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircgcons.c
- * Purpose:     Construction and removal of interprocedural representation
- *              (explicit interprocedural dependencies).
- * Author:      Hubert Schmid
- * Modified by:
- * Created:     09.06.2002
- * CVS-ID:      $Id$
- * Copyright:   (c) 2002-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Construction and removal of interprocedural representation
+ *          (explicit interprocedural dependencies).
+ * @author  Hubert Schmid
+ * @date    09.06.2002
+ * @version $Id$
  */
 #ifdef HAVE_CONFIG_H
 # include "config.h"

diff --git a/ir/ir/ircgcons.h b/ir/ir/ircgcons.h
index b9d2499..2f627b1 100644 (file)
--- a/ir/ir/ircgcons.h
+++ b/ir/ir/ircgcons.h
@@ -17,19 +17,16 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircgcons.h
- * Purpose:     Construction and removal of interprocedural representation
- *              (explicit interprocedural dependencies).
- * Author:      Hubert Schmid
- * Modified by:
- * Created:     09.06.2002
- * CVS-ID:      $Id$
- * Copyright:   (c) 2002-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Construction and removal of interprocedural representation
+ *          (explicit interprocedural dependencies).
+ * @author  Hubert Schmid
+ * @date    09.06.2002
+ * @version $Id$
  */
-#ifndef _FIRM_IR_ICGCONS_H_
-#define _FIRM_IR_ICGCONS_H_
+#ifndef FIRM_IR_IRCGCONS_H
+#define FIRM_IR_IRCGCONS_H
 
 #include "firm_types.h"
 
@@ -67,4 +64,4 @@ void cg_construct(int arr_len, ir_entity *free_methods_arr[]);
     the ir. Sets ip_view_no in irp. */
 void cg_destruct(void);
 
-#endif /* _FIRM_IR_ICGCONS_H_ */
+#endif

diff --git a/ir/ir/ircgopt.c b/ir/ir/ircgopt.c
index 8fbf0c6..da2b33e 100644 (file)
--- a/ir/ir/ircgopt.c
+++ b/ir/ir/ircgopt.c
@@ -17,18 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircgopt.c
- * Purpose:     Removal of unreachable methods.
- * Author:      Hubert Schmid
- * Modified by:
- * Created:     09.06.2002
- * CVS-ID:      $Id$
- * Copyright:   (c) 2002-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Removal of unreachable methods.
+ * @author   Hubert Schmid
+ * @date     09.06.2002
+ * @version  $Id$
  */
 
-/**
+/*
  * Entfernen von nicht erreichbaren (aufrufbaren) Methoden. Die Menge
  * der nicht erreichbaren Methoden wird aus der Abschätzung der
  * Aufrufrelation bestimmt.

diff --git a/ir/ir/ircgopt.h b/ir/ir/ircgopt.h
index 07b977c..b5b96fb 100644 (file)
--- a/ir/ir/ircgopt.h
+++ b/ir/ir/ircgopt.h
@@ -17,26 +17,20 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircgopt.h
- * Purpose:     Removal of unreachable methods.
- * Author:      Hubert Schmid
- * Modified by:
- * Created:     09.06.2002
- * CVS-ID:      $Id$
- * Copyright:   (c) 2002-2003 Universität Karlsruhe
- */
-
 /**
- * @file irgopt.h
- *
- * Entfernen von nicht erreichbaren (aufrufbaren) Methoden. Die Menge
- * der nicht erreichbaren Methoden wird aus der Abschätzung der
- * Aufrufrelation bestimmt.
+ * @file
+ * @brief   Removal of unreachable methods.
+ * @author  Hubert Schmid
+ * @date    09.06.2002
+ * @version $Id$
+ * @summary
+ *  (TODO: translate to english)
+ *  Entfernen von nicht erreichbaren (aufrufbaren) Methoden. Die Menge
+ *  der nicht erreichbaren Methoden wird aus der Abschätzung der
+ *  Aufrufrelation bestimmt.
  */
-#ifndef _FIRM_IR_ICGOPT_H_
-#define _FIRM_IR_ICGOPT_H_
+#ifndef FIRM_IR_ICGOPT_H
+#define FIRM_IR_ICGOPT_H
 
 #include "firm_types.h"
 
@@ -49,4 +43,4 @@
  * Frees all interprocedural loop information. */
 void gc_irgs(int n_keep, ir_entity *keep_arr[]);
 
-#endif /* _FIRM_IR_ICGOPT_H_ */
+#endif

diff --git a/ir/ir/ircons.c b/ir/ir/ircons.c
index b4d320b..a9d5b02 100644 (file)
--- a/ir/ir/ircons.c
+++ b/ir/ir/ircons.c
@@ -17,18 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircons.c
- * Purpose:     Various irnode constructors.  Automatic construction
- *              of SSA representation.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Boris Boesler, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Various irnode constructors. Automatic construction of SSA
+ *          representation.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Boris Boesler
+            Michael Beck
+ * @version $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/ircons.h b/ir/ir/ircons.h
index f7f3b6c..30c916c 100644 (file)
--- a/ir/ir/ircons.h
+++ b/ir/ir/ircons.h
@@ -17,20 +17,16 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircons.h
- * Purpose:     Various irnode constructors.  Automatic construction
- *              of SSA representation.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Boris Boesler, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Various irnode constructors. Automatic construction of SSA
+ *          representation.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Boris Boesler,
+ *          Michael Beck
+ * @version $Id$
  */
 
-/**
- @todo
+/**@todo
  Ideas for improvement:
  -# Handle construction of exceptions more comfortable:
     Add new constructors that pass the exception region (or better the
@@ -42,14 +38,12 @@
 */
 
 /**
- *  @file ircons.h
+ *  @file
  *
  *  documentation no more supported since 2001
  *
  *  ir node construction.
  *
- *  @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier
- *
  *    This file documents all datatypes and constructors needed to
  *    build a FIRM representation of a procedure.  The constructors are
  *    also implemented in this file.
@@ -1120,8 +1114,8 @@
  *   node.
  *
  */
-#ifndef _FIRM_IR_IRCONS_H_
-#define _FIRM_IR_IRCONS_H_
+#ifndef FIRM_IR_IRCONS_H
+#define FIRM_IR_IRCONS_H
 
 #include "firm_common.h"
 #include "irnode.h"
@@ -4352,4 +4346,4 @@ void irp_finalize_cons(void);
  */
 typedef ir_node *uninitialized_local_variable_func_t(ir_graph *irg, ir_mode *mode, int pos);
 
-#endif /* _FIRM_IR_IRCONS_H_ */
+#endif

diff --git a/ir/ir/ircons_t.h b/ir/ir/ircons_t.h
index da7c228..80353cb 100644 (file)
--- a/ir/ir/ircons_t.h
+++ b/ir/ir/ircons_t.h
@@ -17,22 +17,18 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/ircons_t.h
- * Purpose:     Various irnode constructors.  Automatic construction
- *              of SSA representation.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief     Various irnode constructors.  Automatic construction
+ *            of SSA representation. Private Header
+ * @author    Martin Trapp, Christian Schaefer, Michael Beck
+ * @version   $Id$
  */
-#ifndef _IRCONS_T_H_
-#define _IRCONS_T_H_
+#ifndef FIRM_IR_IRCONS_T_H
+#define FIRM_IR_IRCONS_T_H
 
 #include "ircons.h"
-# include "irgraph_t.h"
+#include "irgraph_t.h"
 
 /**
  * Initializes the graph construction.
@@ -60,4 +56,4 @@ _new_d_NoMem(void) {
 #define new_d_Bad()               _new_d_Bad()
 #define new_d_NoMem()             _new_d_NoMem()
 
-#endif /* _IRCONS_T_H_ */
+#endif

diff --git a/ir/ir/irdump.c b/ir/ir/irdump.c
index 0289e7d..682e4f1 100644 (file)
--- a/ir/ir/irdump.c
+++ b/ir/ir/irdump.c
@@ -17,15 +17,11 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irdump.c
- * Purpose:     Write vcg representation of firm to file.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Hubert Schmidt
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universit�t Karlsruhe
+/**
+ * @file
+ * @brief   Write vcg representation of firm to file.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Hubert Schmidt
+ * @version $Id$
  */
 #ifdef HAVE_CONFIG_H
 #include "config.h"
@@ -3021,9 +3017,9 @@ void dump_callgraph_loop_tree(const char *suffix) {
 }
 
 
-/*-----------------------------------------------------------------------------*/
-/* Dumps the firm nodes in the loop tree to a graph along with the loop nodes. */
-/*-----------------------------------------------------------------------------*/
+/*----------------------------------------------------------------------------*/
+/* Dumps the firm nodes in the loop tree to a graph along with the loop nodes.*/
+/*----------------------------------------------------------------------------*/
 
 void collect_nodeloop(FILE *F, ir_loop *loop, eset *loopnodes) {
        int i, son_number = 0, node_number = 0;

diff --git a/ir/ir/irdump.h b/ir/ir/irdump.h
index 58c352e..c2ada43 100644 (file)
--- a/ir/ir/irdump.h
+++ b/ir/ir/irdump.h
@@ -17,36 +17,29 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irdump.h
- * Purpose:     Write vcg representation of firm to file.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Hubert Schmidt
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file irdump.h
- *
- * Dump routines for the ir graph and all type information.
+ * @file
+ * @brief   Write vcg representation of firm to file.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Hubert Schmidt
+ * @version $Id$
+ * @summary
+ *  Dump routines for the ir graph and all type information.
  *
- * @author Martin Trapp, Christian Schaefer
+ *  The dump format of most functions is vcg.  This is a text based graph
+ *  representation. Some use the original format,
+ *  but most generate an extended format that is only read by some special
+ *  versions of xvcg or by the comercialized version now calles aiSee.
+ *  A test version of aiSee is available at
+ *   http://www.absint.de/aisee/download/index.htm.
  *
- * The dump format of most functions is vcg.  This is a text based graph
- * representation. Some use the original format,
- * but most generate an extended format that is only read by some special
- * versions of xvcg or by the comercialized version now calles aiSee.
- * A test version of aiSee is available at
- * http://www.absint.de/aisee/download/index.htm.
+ *  We have developed an own advanced viewer called ycomp:
+ *    http://www.info.uni-karlsruhe.de/software.php/id=6&lang=en
  *
- * Most routines use the name of the passed entity as the name of the
- * file dumped to.
+ *  Most routines use the name of the passed entity as the name of the
+ *  file dumped to.
  */
-#ifndef _FIRM_IR_IRDUMP_H_
-#define _FIRM_IR_IRDUMP_H_
+#ifndef FIRM_IR_IRDUMP_H
+#define FIRM_IR_IRDUMP_H
 
 #include "irnode.h"
 #include "irgraph.h"
@@ -702,4 +695,4 @@ void *dump_add_node_info_callback(dump_node_info_cb_t *cb, void *data);
  */
 void dump_remv_node_info_callback(void *handle);
 
-#endif /* _FIRM_IR_IRDUMP_H_ */
+#endif

diff --git a/ir/ir/irdump_t.h b/ir/ir/irdump_t.h
index 773332d..d25b362 100644 (file)
--- a/ir/ir/irdump_t.h
+++ b/ir/ir/irdump_t.h
@@ -17,10 +17,13 @@
  * PURPOSE.
  */
 
-
-
-#ifndef __IRDUMPT_T_H__
-#define __IRDUMPT_T_H__
+/**
+ * @file
+ * @brief   Private header for irdump
+ * @version $Id$
+ */
+#ifndef FIRM_IR_IRDUMPT_T_H
+#define FIRM_IR_IRDUMPT_T_H
 
 #include "irdump.h"
 
@@ -103,6 +106,4 @@ int dump_node_label(FILE *F, ir_node *n);
 /** Writes vcg representation with title "PRINT_TYPEID(tp)" to file F. */
 int dump_type_node(FILE *F, ir_type *tp);
 
-
-
-#endif /* __IRDUMPT_T_H__ */
+#endif

diff --git a/ir/ir/irdumptxt.c b/ir/ir/irdumptxt.c
index 1b59e36..d95350b 100644 (file)
--- a/ir/ir/irdumptxt.c
+++ b/ir/ir/irdumptxt.c
@@ -17,15 +17,11 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irdumptxt.c
- * Purpose:     Write vcg representation of firm to file.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Hubert Schmidt
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Write vcg representation of firm to file.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Hubert Schmidt
+ * @version $Id$
  */
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/ir/ir/iredgekinds.h b/ir/ir/iredgekinds.h
index c5d4b03..5d7ae20 100644 (file)
--- a/ir/ir/iredgekinds.h
+++ b/ir/ir/iredgekinds.h
@@ -18,16 +18,13 @@
  */
 
 /**
- * @file   iredgekinds.h
+ * @file
+ * @breif  Declares different kind of edges between nodes
  * @date   29.08.2006
  * @author Sebastian Hack
- *
- * Copyright (C) 2006 Universitaet Karlsruhe
- * Released under the GPL
  */
-
-#ifndef _IREDGEKINDS_H
-#define _IREDGEKINDS_H
+#ifndef FIRM_IR_IREDGEKINDS_H
+#define FIRM_IR_IREDGEKINDS_H
 
 /** Supported Edge kinds. */
 enum _ir_edge_kind_t {
@@ -45,4 +42,4 @@ typedef enum _ir_edge_kind_t ir_edge_kind_t;
 
 void edges_notify_edge_kind(ir_node *src, int pos, ir_node *tgt, ir_node *old_tgt, ir_edge_kind_t kind, ir_graph *irg);
 
-#endif /* _IREDGEKINDS_H */
+#endif

diff --git a/ir/ir/iredges.c b/ir/ir/iredges.c
index a7b26aa..27dd5b3 100644 (file)
--- a/ir/ir/iredges.c
+++ b/ir/ir/iredges.c
@@ -17,23 +17,16 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iredges.c
- * Purpose:     Always available outs.
- * Author:      Sebastian Hack
- * Modified by: Michael Beck, Andreas Schoesser
- * Created:     14.1.2005
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
- */
-
 /**
- * Always available outs.
- * @author Sebastian Hack
- * @date 14.1.2005
+ * @file
+ * @brief   Always available outs.
+ * @author  Sebastian Hack, Michael Beck, Andreas Schoesser
+ * @date    14.1.2005
+ * @version $Id$
+ * @summary
+ *   This are out-edges (also called def-use edges) that are dynamically
+ *   updated as the graph changes.
  */
-
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -52,10 +45,10 @@
 #include "xmalloc.h"
 
 /**
-* A function that allows for setting an edge.
-* This abstraction is necessary since different edge kind have
-* different methods of setting edges.
-*/
+ * A function that allows for setting an edge.
+ * This abstraction is necessary since different edge kind have
+ * different methods of setting edges.
+ */
 typedef void (set_edge_func_t)(ir_node *src, int pos, ir_node *tgt);
 
 typedef int (get_edge_src_arity_func_t)(const ir_node *src);
@@ -65,8 +58,8 @@ typedef int (get_edge_src_first_func_t)(const ir_node *src);
 typedef ir_node *(get_edge_src_n_func_t)(const ir_node *src, int pos);
 
 /**
-* Additional data for an edge kind.
-*/
+ * Additional data for an edge kind.
+ */
 typedef struct {
        const char                *name;
        set_edge_func_t           *set_edge;
@@ -723,7 +716,7 @@ static void verify_edge_counter(ir_node *irn, void *env) {
                ir_fprintf(stderr, "Edge Verifier: %+F reachable by %d node(s), but the list contains %d edge(s)\n",
                        irn, ref_cnt, list_cnt);
 
-               // Matze: buggy if a node has multiple ins pointing at irn
+               /* Matze: buggy if a node has multiple ins pointing at irn */
 #if 0
                list_for_each(pos, head) {
                        ir_edge_t *edge = list_entry(pos, ir_edge_t, list);

diff --git a/ir/ir/iredges.h b/ir/ir/iredges.h
index 4bec89f..8c1da4f 100644 (file)
--- a/ir/ir/iredges.h
+++ b/ir/ir/iredges.h
@@ -17,24 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iredges.h
- * Purpose:     Public header for the automatically updating outs.
- * Author:      Sebastian Hack
- * Created:     3.2.2005
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2005 Universität Karlsruhe
- */
-
 /**
- * Public header for the automatically updating outs.
- * @author Sebastian Hack
- * @date 3.2.2005
+ * @file
+ * @brief   Public header for the automatically updating outs.
+ * @author  Sebastian Hack
+ * @date    3.2.2005
+ * @version $Id$
  */
-
-#ifndef _FIRM_IR_EDGES_H
-#define _FIRM_IR_EDGES_H
+#ifndef FIRM_IR_IREDGES_H
+#define FIRM_IR_IREDGES_H
 
 #include "firm_types.h"
 #include "iredgekinds.h"
@@ -44,13 +35,6 @@
 typedef struct _ir_edge_t ir_edge_t;
 #endif
 
-#if 0
-#ifndef _IR_EDGE_KIND_TYPEDEF_
-#define _IR_EDGE_KIND_TYPEDEF_
-typedef enum _ir_edge_kind_t ir_edge_kind_t;
-#endif /* _IR_EDGE_KIND_TYPEDEF_ */
-#endif
-
 /**
  * Get the first edge pointing to some node.
  * @note There is no order on out edges. First in this context only
@@ -234,5 +218,4 @@ void edges_reset_private_data(ir_graph *irg, int offset, size_t size);
 /* End Old Interface                                                    */
 /************************************************************************/
 
-
-#endif /* _FIRM_IR_EDGES_H */
+#endif

diff --git a/ir/ir/iredges_t.h b/ir/ir/iredges_t.h
index 4fc5920..f17e837 100644 (file)
--- a/ir/ir/iredges_t.h
+++ b/ir/ir/iredges_t.h
@@ -17,25 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iredges_t.h
- * Purpose:     Everlasting outs -- private header.
- * Author:      Sebastian Hack
- * Modified by: Andreas Schoesser
- * Created:     15.01.2005
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2005 Universit�t Karlsruhe
- */
-
 /**
- * everlasting outs.
- * @author Sebastian Hack
- * @date 15.1.2005
+ * @file
+ * @brief   Everlasting outs -- private header.
+ * @author  Sebastian Hack, Andreas Schoesser
+ * @date    15.01.2005
+ * @version $Id$
  */
-
-#ifndef _FIRM_EDGES_T_H
-#define _FIRM_EDGES_T_H
+#ifndef FIRM_IR_EDGES_T_H
+#define FIRM_IR_EDGES_T_H
 
 #include "firm_config.h"
 #include "debug.h"
@@ -221,6 +211,4 @@ void edges_invalidate_all(ir_node *irn, ir_graph *irg);
 #define get_block_succ_next(irn, last)    _get_irn_out_edge_next(irn, last)
 #endif
 
-
-
-#endif /* _FIRM_EDGES_T_H */
+#endif

diff --git a/ir/ir/irflag.c b/ir/ir/irflag.c
index feec4be..30b98ce 100644 (file)
--- a/ir/ir/irflag.c
+++ b/ir/ir/irflag.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irflag.c
- * Purpose:     Flags to control optimizations.
- * Author:      Christian Schaefer, Goetz Lindenmaier
- * Modified by:
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Flags to control optimizations.
+ * @author  Christian Schaefer, Goetz Lindenmaier
+ * @version $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irflag.h b/ir/ir/irflag.h
index 4459826..1489253 100644 (file)
--- a/ir/ir/irflag.h
+++ b/ir/ir/irflag.h
@@ -17,24 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irflag.h
- * Purpose:     Flags to control optimizations.
- * Author:      Christian Schaefer, Goetz Lindenmaier
- * Modified by: Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-2003 Universität Karlsruhe
- */
-
 /**
- * @file irflag.h
- *
+ * @file
+ * @brief   Flags to control optimizations.
+ * @author  Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
+ * @summary
  * Flags to customize the behavior of libfirm.
  *
- * @author Christian Schaefer
- *
  * There are the following groups of flags:
  * 1. Optimization flags.
  *    a)  There is a flag, 'optimize' to turn on/off all optimizations.
@@ -49,8 +39,8 @@
  * 4. Verification flag
  *    This one controls the behavior of node and type verifications
  */
-#ifndef _FIRM_IR_IRFLAG_H_
-#define _FIRM_IR_IRFLAG_H_
+#ifndef FIRM_IR_IRFLAG_H
+#define FIRM_IR_IRFLAG_H
 
 #include "firm_types.h"
 
@@ -393,4 +383,4 @@ typedef enum _firm_verification_t {
  */
 void do_node_verification(firm_verification_t mode);
 
-#endif /* _FIRM_IR_IRFLAG_H_ */
+#endif

diff --git a/ir/ir/irflag_t.def b/ir/ir/irflag_t.def
index 39bdb62..da4b571 100644 (file)
--- a/ir/ir/irflag_t.def
+++ b/ir/ir/irflag_t.def
@@ -1,12 +1,27 @@
 /*
- * Project:     libFIRM
- * File name:   ir/ir/irflag_t.def
- * Purpose:     Flags to control optimizations, inline implementation.
- * Author:      Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2004 Universität Karlsruhe
- * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
+ * Copyright (C) 1995-2007 University of Karlsruhe.  All right reserved.
+ *
+ * This file is part of libFirm.
+ *
+ * This file may be distributed and/or modified under the terms of the
+ * GNU General Public License version 2 as published by the Free Software
+ * Foundation and appearing in the file LICENSE.GPL included in the
+ * packaging of this file.
+ *
+ * Licensees holding valid libFirm Professional Edition licenses may use
+ * this file in accordance with the libFirm Commercial License.
+ * Agreement provided with the Software.
+ *
+ * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+ * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE.
+ */
+
+/**
+ * @file
+ * @brief     Definitions for optimisation flags
+ * @author    Michael Beck
+ * @version   $Id$
  */
 
 /** Turn off all optimizations. */

diff --git a/ir/ir/irflag_t.h b/ir/ir/irflag_t.h
index 266b3d1..32cd48e 100644 (file)
--- a/ir/ir/irflag_t.h
+++ b/ir/ir/irflag_t.h
@@ -17,25 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgraph.c
- * Purpose:     Flags to control optimizations, inline implementation.
- * Author:      Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2004 Universität Karlsruhe
- */
-
 /**
- * @file irflag_t.h
- *
- * Inline implementation of Optimization flags.
- *
- * @author Michael Beck
+ * @file
+ * @brief    Flags to control optimizations, inline implementation.
+ * @author   Michael Beck
+ * @version  $Id$
  */
-#ifndef _IRFLAG_T_H_
-#define _IRFLAG_T_H_
+#ifndef FIRM_IR_IRFLAG_T_H
+#define FIRM_IR_IRFLAG_T_H
 
 #include "irflag.h"
 
@@ -106,4 +95,4 @@ get_node_verification_mode(void) {
 
 extern void firm_init_flags(void);
 
-#endif /* _IRFLAG_T_H_ */
+#endif

diff --git a/ir/ir/irgmod.c b/ir/ir/irgmod.c
index c4ba378..0167e8a 100644 (file)
--- a/ir/ir/irgmod.c
+++ b/ir/ir/irgmod.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgmod.c
- * Purpose:     Support for ir graph modification.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Support for ir graph modification.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier
+ * @version  $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irgmod.h b/ir/ir/irgmod.h
index a953eff..f6d09a5 100644 (file)
--- a/ir/ir/irgmod.h
+++ b/ir/ir/irgmod.h
@@ -17,27 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgmod.h
- * Purpose:     Support for ir graph modification.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- *
- * @file irgmod.h
- *
- * ir graph modification.
- *
- * @author Martin Trapp, Christian Schaefer
+ * @file
+ * @brief    Support for ir graph modification.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier
+ * @version  $Id$
  */
-#ifndef _FIRM_IR_IRGMOD_H_
-#define _FIRM_IR_IRGMOD_H_
+#ifndef FIRM_IR_IRGMOD_H
+#define FIRM_IR_IRGMOD_H
 
 #include "firm_types.h"
 
@@ -86,4 +73,4 @@ void collect_phiprojs(ir_graph *irg);
  */
 void part_block(ir_node *node);
 
-#endif /* ifndef _FIRM_IR_IRGMOD_H_ */
+#endif

diff --git a/ir/ir/irgopt.c b/ir/ir/irgopt.c
index 7b0d982..dc0df8d 100644 (file)
--- a/ir/ir/irgopt.c
+++ b/ir/ir/irgopt.c
@@ -17,15 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgopt.c
- * Purpose:     Optimizations for a whole ir graph, i.e., a procedure.
- * Author:      Christian Schaefer, Goetz Lindenmaier
- * Modified by: Sebastian Felis, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Optimizations for a whole ir graph, i.e., a procedure.
+ * @author   Christian Schaefer, Goetz Lindenmaier, Sebastian Felis,
+ *           Michael Beck
+ * @version  $Id$
  */
 #ifdef HAVE_CONFIG_H
 # include "config.h"

diff --git a/ir/ir/irgopt.h b/ir/ir/irgopt.h
index 2fffa92..e267e36 100644 (file)
--- a/ir/ir/irgopt.h
+++ b/ir/ir/irgopt.h
@@ -17,26 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgopt.h
- * Purpose:     Optimizations for a whole ir graph, i.e., a procedure.
- * Author:      Christian Schaefer, Goetz Lindenmaier
- * Modified by: Sebastian Felis
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file irgopt.h
- *
- * Optimizations for a whole ir graph, i.e., a procedure.
- *
- * @author Christian Schaefer, Goetz Lindenmaier
+ * @file
+ * @brief   Optimizations for a whole ir graph, i.e., a procedure.
+ * @author  Christian Schaefer, Goetz Lindenmaier, Sebastian Felis
+ * @version $Id$
  */
-#ifndef _FIRM_IR_IRGOPT_H_
-#define _FIRM_IR_IRGOPT_H_
+#ifndef FIRM_IR_IRGOPT_H
+#define FIRM_IR_IRGOPT_H
 
 #include "firm_types.h"
 
@@ -227,4 +215,4 @@ void place_code(ir_graph *irg);
  */
 void remove_critical_cf_edges(ir_graph *irg);
 
-#endif /* _FIRM_IR_IRGOPT_H_ */
+#endif

diff --git a/ir/ir/irgopt_t.h b/ir/ir/irgopt_t.h
index 996acfc..073acea 100644 (file)
--- a/ir/ir/irgopt_t.h
+++ b/ir/ir/irgopt_t.h
@@ -18,11 +18,12 @@
  */
 
 /**
- * Internal irgopt functions.
+ * @file
+ * @brief   Internal irgopt functions.
+ * @version $Id$
  */
-
-#ifndef _IRGOPT_T_H
-#define _IRGOPT_T_H
+#ifndef FIRM_IR_IRGOPT_T_H
+#define FIRM_IR_IRGOPT_T_H
 
 //void copy_node (ir_node *n, void *env);
 void copy_preds(ir_node *n, void *env);

diff --git a/ir/ir/irgraph.c b/ir/ir/irgraph.c
index 3e1eda3..01e652a 100644 (file)
--- a/ir/ir/irgraph.c
+++ b/ir/ir/irgraph.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgraph.c
- * Purpose:     Entry point to the representation of procedure code.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Entry point to the representation of procedure code.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version  $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irgraph.h b/ir/ir/irgraph.h
index 826b457..a2d769b 100644 (file)
--- a/ir/ir/irgraph.h
+++ b/ir/ir/irgraph.h
@@ -17,26 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgraph.c
- * Purpose:     Entry point to the representation of procedure code.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file irgraph.h
- *
- * ir graph construction.
- *
- * @author Martin Trapp, Christian Schaefer
+ * @file
+ * @brief    Entry point to the representation of procedure code.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier
+ * @version  $Id$
  */
-#ifndef _FIRM_IR_IRGRAPH_H_
-#define _FIRM_IR_IRGRAPH_H_
+#ifndef FIRM_IR_IRGRAPH_H
+#define FIRM_IR_IRGRAPH_H
 
 #include <stddef.h>
 
@@ -576,4 +564,4 @@ void set_irg_fp_model(ir_graph *irg, unsigned model);
  */
 size_t register_additional_graph_data(size_t size);
 
-#endif /* _FIRM_IR_IRGRAPH_H_ */
+#endif

diff --git a/ir/ir/irgraph_t.h b/ir/ir/irgraph_t.h
index 2934f8c..72a9b8b 100644 (file)
--- a/ir/ir/irgraph_t.h
+++ b/ir/ir/irgraph_t.h
@@ -17,24 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgraph.c
- * Purpose:     Entry point to the representation of procedure code -- internal header.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universität Karlsruhe
- */
-
 /**
- * @file irgraph_t.h
- *
- * IR graph construction.
+ * @file
+ * @brief    Entry point to the representation of procedure code -- internal header.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version  $Id$
  */
-#ifndef _IRGRAPH_T_H_
-#define _IRGRAPH_T_H_
+#ifndef FIRM_IR_IRGRAPH_T_H
+#define FIRM_IR_IRGRAPH_T_H
 
 #include "firm_types.h"
 #include "irgraph.h"
@@ -700,4 +690,4 @@ get_idx_irn(ir_graph *irg, unsigned idx) {
 #define get_irg_estimated_node_cnt(irg)       _get_irg_estimated_node_cnt(irg)
 #define get_irg_fp_model(irg)                 _get_irg_fp_model(irg)
 
-# endif /* _IRGRAPH_T_H_ */
+#endif

diff --git a/ir/ir/irgwalk.c b/ir/ir/irgwalk.c
index 8c51832..7e87d12 100644 (file)
--- a/ir/ir/irgwalk.c
+++ b/ir/ir/irgwalk.c
@@ -17,26 +17,16 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgwalk.c
- * Purpose:
- * Author:      Boris Boesler
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-20036Universität Karlsruhe
- */
-
 /**
- * @file irgwalk.c
- *
- * traverse an ir graph
- * - execute the pre function before recursion
- * - execute the post function after recursion
+ * @file
+ * @brief   Functions for traversing ir graphs
+ * @author  Boris Boesler, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
+ * @summary
+ *  traverse an ir graph
+ *  - execute the pre function before recursion
+ *  - execute the post function after recursion
  */
-
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif
@@ -53,15 +43,16 @@
 #include "irhooks.h"
 #include "ircgcons.h"
 
-#include "eset.h"
+#include "pset_new.h"
 #include "array.h"
 
 /**
  * Walk over an interprocedural graph (callgraph).
  * Visits only graphs in irg_set.
  */
-static void irg_walk_cg(ir_node * node, unsigned long visited, eset * irg_set,
-                        irg_walk_func *pre, irg_walk_func *post, void * env) {
+static void irg_walk_cg(ir_node * node, unsigned long visited,
+                        pset_new_t *irg_set, irg_walk_func *pre,
+                        irg_walk_func *post, void * env) {
   int i;
   ir_graph * rem = current_ir_graph;
   ir_node * pred;
@@ -91,7 +82,7 @@ static void irg_walk_cg(ir_node * node, unsigned long visited, eset * irg_set,
       if ((get_irn_op(pred) != op_CallBegin
            && get_irn_op(pred) != op_EndReg
            && get_irn_op(pred) != op_EndExcept)
-          || eset_contains(irg_set, get_irn_irg(pred))) {
+          || pset_new_contains(irg_set, get_irn_irg(pred))) {
         irg_walk_cg(exec, visited, irg_set, pre, post, env);
       }
     }
@@ -111,7 +102,7 @@ static void irg_walk_cg(ir_node * node, unsigned long visited, eset * irg_set,
         assert(get_irn_op(exec) == op_CallBegin
                || get_irn_op(exec) == op_EndReg
                || get_irn_op(exec) == op_EndExcept);
-        if (eset_contains(irg_set, get_irn_irg(exec))) {
+        if (pset_new_contains(irg_set, get_irn_irg(exec))) {
           current_ir_graph = get_irn_irg(exec);
           irg_walk_cg(pred, visited, irg_set, pre, post, env);
           current_ir_graph = rem;
@@ -133,14 +124,14 @@ static void irg_walk_cg(ir_node * node, unsigned long visited, eset * irg_set,
 /**
  * Insert all ir_graphs in irg_set, that are (transitive) reachable.
  */
-static void collect_irgs(ir_node * node, eset * irg_set) {
+static void collect_irgs(ir_node * node, pset_new_t *irg_set) {
   if (is_Call(node)) {
     int i;
     for (i = get_Call_n_callees(node) - 1; i >= 0; --i) {
       ir_entity * ent = get_Call_callee(node, i);
       ir_graph * irg = get_entity_irg(ent);
-      if (irg && !eset_contains(irg_set, irg)) {
-        eset_insert(irg_set, irg);
+      if (irg && !pset_new_contains(irg_set, irg)) {
+        pset_new_insert(irg_set, irg);
         irg_walk_graph(irg, (irg_walk_func *) collect_irgs, NULL, irg_set);
       }
     }
@@ -262,21 +253,24 @@ void irg_walk(ir_node *node, irg_walk_func *pre, irg_walk_func *post, void *env)
   assert(is_ir_node(node));
 
   if (get_interprocedural_view()) {
-    eset * irg_set = eset_create();
-    unsigned long visited;
-    ir_graph * irg;
+       pset_new_t           irg_set;
+       pset_new_iterator_t  iter;
+    unsigned long        visited;
+    ir_graph            *irg;
     assert(get_irp_ip_view_state() == ip_view_valid);
 
+       pset_new_init(&irg_set);
     set_interprocedural_view(0);
-    eset_insert(irg_set, current_ir_graph);
-    irg_walk(node, (irg_walk_func *) collect_irgs, NULL, irg_set);
+    pset_new_insert(&irg_set, current_ir_graph);
+    irg_walk(node, (irg_walk_func *) collect_irgs, NULL, &irg_set);
     set_interprocedural_view(1);
     visited = get_max_irg_visited() + 1;
-    for (irg = eset_first(irg_set); irg; irg = eset_next(irg_set)) {
+
+       foreach_pset_new(&irg_set, irg, iter) {
       set_irg_visited(irg, visited);
     }
-    irg_walk_cg(node, visited, irg_set, pre, post, env);
-    eset_destroy(irg_set);
+    irg_walk_cg(node, visited, &irg_set, pre, post, env);
+       pset_new_destroy(&irg_set);
   } else {
     set_using_visited(current_ir_graph);
     inc_irg_visited(current_ir_graph);

diff --git a/ir/ir/irgwalk.h b/ir/ir/irgwalk.h
index 25d0adc..5809fe2 100644 (file)
--- a/ir/ir/irgwalk.h
+++ b/ir/ir/irgwalk.h
@@ -17,34 +17,21 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgwalk.h
- * Purpose:
- * Author:      Boris Boesler
- * Modified by: Goetz Lindenmaier
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-2003 Universität Karlsruhe
- */
-
-
 /**
- * @file irgwalk.h
+ * @file
+ * @brief    Traverse an ir graph
+ * @author   Boris Boesler, Goetz Lindenmaier
+ * @version  $Id$
+ * @summary
+ *  Traverse an ir graph:
+ *  - execute the pre function before recursion
+ *  - execute the post function after recursion
  *
- * Traverse an ir graph.
- *
- * @author Boris Boesler
- *
- * Traverse an ir graph:
- * - execute the pre function before recursion
- * - execute the post function after recursion
- *
- * Uses current_ir_graph (from irgraph.h)!!! Set it to the proper
- * graph before starting the walker.
+ *  Uses current_ir_graph (from irgraph.h)!!! Set it to the proper
+ *  graph before starting the walker.
  */
-#ifndef _FIRM_IR_IRGWALK_H_
-#define _FIRM_IR_IRGWALK_H_
+#ifndef FIRM_IR_IRGWALK_H
+#define FIRM_IR_IRGWALK_H
 
 #include "firm_types.h"
 
@@ -248,4 +235,4 @@ void irg_walk_in_or_dep_blkwise_graph(ir_graph *irg, irg_walk_func *pre, irg_wal
  */
 void irg_walk_anchors(ir_graph *irg, irg_walk_func *pre, irg_walk_func *post, void *env);
 
-#endif /* _FIRM_IR_IRGWALK_H_ */
+#endif

diff --git a/ir/ir/irgwalk_blk.c b/ir/ir/irgwalk_blk.c
index 6289b4a..e452789 100644 (file)
--- a/ir/ir/irgwalk_blk.c
+++ b/ir/ir/irgwalk_blk.c
@@ -17,15 +17,11 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irgwalk_blk.c
- * Purpose:
- * Author:      Michael Beck
- * Modified by:
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-2004 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Blockwise walker implementation
+ * @author  Michael Beck
+ * @version $Id$
  */
 #ifdef HAVE_CONFIG_H
 # include "config.h"

diff --git a/ir/ir/irhooks.c b/ir/ir/irhooks.c
index 8b95b77..9d40a82 100644 (file)
--- a/ir/ir/irhooks.c
+++ b/ir/ir/irhooks.c
@@ -17,22 +17,11 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irhooks.c
- * Purpose:     Generic hooks for various libFirm functions.
- * Author:      Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (C) 1998-2005 Universität Karlsruhe
- */
-
 /**
- * @file irhooks.c
- *
- * Generic hooks for various libFirm functions.
- *
- * @author Michael Beck
+ * @file
+ * @brief    Generic hooks for various libFirm functions.
+ * @author   Michael Beck
+ * @version  $Id$
  */
 #ifdef HAVE_CONFIG_H
 #include "config.h"

diff --git a/ir/ir/irhooks.h b/ir/ir/irhooks.h
index 70c9c7c..a892d1e 100644 (file)
--- a/ir/ir/irhooks.h
+++ b/ir/ir/irhooks.h
@@ -17,25 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irhooks.h
- * Purpose:     Generic hooks for various libFirm functions.
- * Author:      Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (C) 1998-2005 Universität Karlsruhe
- */
-
 /**
- * @file irhooks.h
- *
- * Generic hooks for various libFirm functions.
- *
- * @author Michael Beck
+ * @file
+ * @brief   Generic hooks for various libFirm functions.
+ * @author  Michael Beck
+ * @version $Id$
  */
-#ifndef _FIRM_IR_IRHOOKS_H_
-#define _FIRM_IR_IRHOOKS_H_
+#ifndef FIRM_IR_IRHOOKS_H
+#define FIRM_IR_IRHOOKS_H
 
 #include "firm_config.h"
 #include "irop.h"
@@ -302,4 +291,4 @@ extern hook_entry_t *hooks[hook_last];
 /* the initializer, move to hooks_t.h some day */
 int firm_init_hooks(void);
 
-#endif /* _FIRM_IR_IRHOOKS_H_ */
+#endif

diff --git a/ir/ir/irmode.c b/ir/ir/irmode.c
index 5000069..8d4a1b8 100644 (file)
--- a/ir/ir/irmode.c
+++ b/ir/ir/irmode.c
@@ -17,15 +17,11 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irmode.c
- * Purpose:     Data modes of operations.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Mathias Heil
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Data modes of operations.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Mathias Heil
+ * @version  $Id$
  */
 #ifdef HAVE_CONFIG_H
 # include "config.h"

diff --git a/ir/ir/irmode.h b/ir/ir/irmode.h
index 56c5c1f..d33c0f7 100644 (file)
--- a/ir/ir/irmode.h
+++ b/ir/ir/irmode.h
@@ -17,35 +17,23 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irmode.h
- * Purpose:     Data modes of operations.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Mathias Heil, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universität Karlsruhe
- */
-
 /**
- * @file irmode.h
- *    irmode -- Modes for ir operators
- *
- * @author Christian Schaefer, Matthias Heil
- *
- * This module specifies the modes that type the firm nodes.  It defines
- * a datasturcture that describes a mode and implements constructors and
- * access routines to this datastructure. Further it defines a set of
- * predefined modes.
+ * @file
+ * @brief   Data modes of operations.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Mathias Heil,
+ *          Michael Beck
+ * @version $Id$
+ * @summary
+ *  This module specifies the modes that type the firm nodes.  It defines
+ *  a datasturcture that describes a mode and implements constructors and
+ *  access routines to this datastructure. Further it defines a set of
+ *  predefined modes.
  *
- * SEE ALSO:
+ *  SEE ALSO:
  *    UKA tech report 1999-44 for more information about modes.
- *
  */
-
-#ifndef _FIRM_IR_IRMODE_H_
-#define _FIRM_IR_IRMODE_H_
+#ifndef FIRM_IR_IRMODE_H
+#define FIRM_IR_IRMODE_H
 
 #include "firm_types.h"
 #include "ident.h"
@@ -514,4 +502,4 @@ ir_mode *get_reference_mode_unsigned_eq(ir_mode *mode);
  */
 void set_reference_mode_unsigned_eq(ir_mode *ref_mode, ir_mode *int_mode);
 
-#endif /* _FIRM_IR_IRMODE_H_ */
+#endif

diff --git a/ir/ir/irmode_t.h b/ir/ir/irmode_t.h
index 0fbf7e1..609aec1 100644 (file)
--- a/ir/ir/irmode_t.h
+++ b/ir/ir/irmode_t.h
@@ -17,23 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irmode_t.h
- * Purpose:     Data modes of operations -- private header.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Mathias Heil, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universität Karlsruhe
- */
-
-
 /**
- * @file irmode_t.h
+ * @file
+ * @brief   Data modes of operations -- private header.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Mathias Heil,
+ *          Michael Beck
+ * @version $Id$
  */
-#ifndef _IRMODE_T_H_
-#define _IRMODE_T_H_
+#ifndef FIRM_IR_IRMODE_T_H
+#define FIRM_IR_IRMODE_T_H
 
 #include <assert.h>
 #include "irmode.h"
@@ -260,4 +252,4 @@ void finish_mode(void);
 #define mode_is_float_vector(mode)     _mode_is_float_vector(mode)
 #define mode_is_int_vector(mode)       _mode_is_int_vector(mode)
 
-#endif /* _IRMODE_T_H_ */
+#endif

diff --git a/ir/ir/irnode.c b/ir/ir/irnode.c
index 10813ee..ae5e6e5 100644 (file)
--- a/ir/ir/irnode.c
+++ b/ir/ir/irnode.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irnode.c
- * Purpose:     Representation of an intermediate operation.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Representation of an intermediate operation.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irnode.h b/ir/ir/irnode.h
index 08553a0..31c8759 100644 (file)
--- a/ir/ir/irnode.h
+++ b/ir/ir/irnode.h
@@ -17,18 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irnode.h
- * Purpose:     Representation of an intermediate operation.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Representation of an intermediate operation.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
  */
-#ifndef _FIRM_IR_IRNODE_H_
-#define _FIRM_IR_IRNODE_H_
+#ifndef FIRM_IR_IRNODE_H
+#define FIRM_IR_IRNODE_H
 
 #include <stddef.h>
 
@@ -1400,4 +1396,4 @@ int dump_node_opcode(FILE *F, ir_node *n);
 }
 #endif
 
-#endif /* _FIRM_IR_IRNODE_H_ */
+#endif

diff --git a/ir/ir/irnode_t.h b/ir/ir/irnode_t.h
index 01b616d..3b7d9cb 100644 (file)
--- a/ir/ir/irnode_t.h
+++ b/ir/ir/irnode_t.h
@@ -17,26 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irnode_t.h
- * Purpose:     Representation of an intermediate operation -- private header.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file irnode_t.h
- *
- * Declarations of an ir node.
- *
- * @author Martin Trapp, Christian Schaefer
+ * @file
+ * @brief   Representation of an intermediate operation -- private header.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
  */
-#ifndef _FIRM_IRNODE_T_H_
-#define _FIRM_IRNODE_T_H_
+#ifndef FIRM_IR_IRNODE_T_H
+#define FIRM_IR_IRNODE_T_H
 
 #include "firm_config.h"
 #include "irnode.h"
@@ -1069,4 +1057,4 @@ static INLINE unsigned _get_irn_idx(const ir_node *node) {
 #define get_irn_ins_or_deps(node)             _get_irn_ins_or_deps(node)
 #define get_irn_in_or_dep(node, pos)          _get_irn_in_or_dep(node, pos)
 
-#endif /* _FIRM_IRNODE_T_H_ */
+#endif

diff --git a/ir/ir/irnodeset.h b/ir/ir/irnodeset.h
index 6e5a51e..afbfac8 100644 (file)
--- a/ir/ir/irnodeset.h
+++ b/ir/ir/irnodeset.h
@@ -24,6 +24,8 @@
  * @brief     A nodeset. This should be prefered over a simple pset, because it
  *            tries to guarantee deterministic behavior. (and is faster)
  * @version   $Id$
+ * @note      Actually the bits to make the behaviour deterministic are not
+ *            implemented yet...
  */
 #ifndef _FIRM_IRNODESET_H_
 #define _FIRM_IRNODESET_H_

diff --git a/ir/ir/irop.c b/ir/ir/irop.c
index 80928cf..b4a9267 100644 (file)
--- a/ir/ir/irop.c
+++ b/ir/ir/irop.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irop.c
- * Purpose:     Representation of opcode of intermediate operation.
- * Author:      Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Representation of opcode of intermediate operation.
+ * @author  Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irop.h b/ir/ir/irop.h
index d260096..bf1676f 100644 (file)
--- a/ir/ir/irop.h
+++ b/ir/ir/irop.h
@@ -17,30 +17,20 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irop.h
- * Purpose:     Representation of opcode of intermediate operation.
- * Author:      Christian Schaefer
- * Modified by: Goetz Lindenmaier
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file irop.h
- *
- * Operators of firm nodes.
- *
- * @author Christian Schaefer
+ * @file
+ * @brief   Representation of opcode of intermediate operation.
+ * @author  Christian Schaefer, Goetz Lindenmaier
+ * @version $Id$
+ * @summary
+ *  Operators of firm nodes.
  *
  *  This module specifies the opcodes possible for ir nodes.  Their
  *  definition is close to the operations specified in UKA Tech-Report
  *  1999-14
  */
-#ifndef _FIRM_IR_IROP_H_
-#define _FIRM_IR_IROP_H_
+#ifndef FIRM_IR_IROP_H
+#define FIRM_IR_IROP_H
 
 #include "firm_types.h"
 
@@ -380,4 +370,4 @@ ir_op *new_ir_op(ir_opcode code, const char *name, op_pin_state p,
 /** Returns the ir_op_ops of an ir_op. */
 const ir_op_ops *get_op_ops(const ir_op *op);
 
-#endif /* _FIRM_IR_IROP_H_ */
+#endif

diff --git a/ir/ir/irop_t.h b/ir/ir/irop_t.h
index 076818d..cca5987 100644 (file)
--- a/ir/ir/irop_t.h
+++ b/ir/ir/irop_t.h
@@ -17,18 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irop_t.h
- * Purpose:     Representation of opcode of intermediate operation -- private header.
- * Author:      Christian Schaefer
- * Modified by: Goetz Lindenmaier
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Representation of opcode of intermediate operation -- private header.
+ * @author   Christian Schaefer, Goetz Lindenmaier
+ * @version  $Id$
  */
-#ifndef _IROP_T_H_
-#define _IROP_T_H_
+#ifndef FIRM_IR_IROP_T_H
+#define FIRM_IR_IROP_T_H
 
 #include "firm_config.h"
 #include "irop.h"
@@ -188,4 +184,4 @@ static INLINE void *_get_op_tag(ir_op *op) {
 #define set_op_tag(op, tag)     _set_op_tag((op), (tag))
 #define get_op_tag(op)          _get_op_tag(op)
 
-#endif /* _IROP_T_H_ */
+#endif

diff --git a/ir/ir/iropt.c b/ir/ir/iropt.c
index 6c94442..6e96bd7 100644 (file)
--- a/ir/ir/iropt.c
+++ b/ir/ir/iropt.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iropt.c
- * Purpose:     iropt --- optimizations intertwined with IR construction.
- * Author:      Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
+/**
+ * @file
+ * @brief   iropt --- optimizations intertwined with IR construction.
+ * @author  Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/iropt.h b/ir/ir/iropt.h
index 1e426fe..4ca8ceb 100644 (file)
--- a/ir/ir/iropt.h
+++ b/ir/ir/iropt.h
@@ -17,26 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iropt.h
- * Purpose:     iropt --- optimizations of an ir node.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file iropt.h
- *
- * Declarations for optimizations of an ir node.
- *
- * @author Martin Trapp, Christian Schaefer
+ * @file
+ * @brief   iropt --- optimizations of an ir node.
+ * @author  Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version $Id$
  */
-#ifndef _FIRM_IR_IROPT_H_
-#define _FIRM_IR_IROPT_H_
+#ifndef FIRM_IR_IROPT_H
+#define FIRM_IR_IROPT_H
 
 #include "firm_types.h"
 
@@ -102,4 +90,4 @@ tarval *computed_value(ir_node *n);
  */
 ir_node *optimize_in_place(ir_node *n);
 
-#endif /* _FIRM_IR_IROPT_H_ */
+#endif

diff --git a/ir/ir/iropt_dbg.h b/ir/ir/iropt_dbg.h
index d37f919..3d44948 100644 (file)
--- a/ir/ir/iropt_dbg.h
+++ b/ir/ir/iropt_dbg.h
@@ -17,19 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iropt_dbg.h
- * Purpose:     Debug makros used in iropt.
- * Author:      Goetz Lindenmaier
- * Modified by:
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 2001-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief   Debug makros used in iropt.
+ * @author  Goetz Lindenmaier
+ * @version $Id$
  */
-
-#ifndef _IROPT_DBG_H_
-#define _IROPT_DBG_H_
+#ifndef FIRM_IR_IROPT_DBG_H
+#define FIRM_IR_IROPT_DBG_H
 
 #include "dbginfo_t.h"
 #include "irhooks.h"
@@ -390,4 +385,4 @@
     hook_merge_nodes(NULL, 0, &n, 1, HOOK_OPT_CONFIRM_E);    \
   } while(0)
 
-#endif /* _IROPT_DBG_H_ */
+#endif

diff --git a/ir/ir/iropt_t.h b/ir/ir/iropt_t.h
index cd2ea2f..ca1ad64 100644 (file)
--- a/ir/ir/iropt_t.h
+++ b/ir/ir/iropt_t.h
@@ -17,27 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/iropt_t.h
- * Purpose:     iropt --- optimizations intertwined with IR construction -- private header.
- * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier, Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file iropt_t.h
- *
- * Declarations for optimizations intertwined with IR construction.
- *
- * @author Martin Trapp, Christian Schaefer
+ * @file
+ * @brief    iropt --- optimizations intertwined with IR construction -- private header.
+ * @author   Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
+ * @version  $Id$
  */
-
-#ifndef _IROPT_T_H_
-#define _IROPT_T_H_
+#ifndef FIRM_IR_IROPT_T_H
+#define FIRM_IR_IROPT_T_H
 
 #include "iropt.h"
 #include "irnode_t.h"
@@ -116,4 +103,4 @@ value_of(ir_node *n) {
  */
 ir_op_ops *firm_set_default_operations(ir_opcode code, ir_op_ops *ops);
 
-#endif /* _IROPT_T_H_ */
+#endif

diff --git a/ir/ir/irphase.c b/ir/ir/irphase.c
index 1d4d421..70268b6 100644 (file)
--- a/ir/ir/irphase.c
+++ b/ir/ir/irphase.c
@@ -17,17 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irphase.c
- * Purpose:     Phase information handling using node indexes.
- * Author:      Sebastian Hack
- * Modified by:
- * Created:
- * SVN-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universitaet Karlsruhe
+/**
+ * @file
+ * @brief    Phase information handling using node indexes.
+ * @author   Sebastian Hack
+ * @version  $Id$
+ * @summary
+ *  A phase contains a link to private data for each node in an ir graph.
+ *  A phase is independent from the globally visible link field of ir nodes.
  */
-
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/ir/ir/irphase_t.h b/ir/ir/irphase_t.h
index 62c410d..d3857b9 100644 (file)
--- a/ir/ir/irphase_t.h
+++ b/ir/ir/irphase_t.h
@@ -17,19 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irphase_t.c
- * Purpose:     Phase information handling using node indexes.
- * Author:      Sebastian Hack
- * Modified by:
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2007 Universitaet Karlsruhe
+/**
+ * @file
+ * @brief   Phase information handling using node indexes.
+ * @author  Sebastian Hack
+ * @version $Id$
  */
-
-#ifndef _FIRM_IR_PHASE_T_H
-#define _FIRM_IR_PHASE_T_H
+#ifndef FIRM_IR_PHASE_T_H
+#define FIRM_IR_PHASE_T_H
 
 #include "firm_types.h"
 #include "obst.h"
@@ -314,4 +309,4 @@ static INLINE void *_phase_get_or_set_irn_data(ir_phase *ph, ir_node *irn)
        return res;
 }
 
-#endif /* _FIRM_IR_PHASE_T_H */
+#endif

diff --git a/ir/ir/irprintf.c b/ir/ir/irprintf.c
index 3172032..4eb1d0b 100644 (file)
--- a/ir/ir/irprintf.c
+++ b/ir/ir/irprintf.c
@@ -17,24 +17,13 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irprintf.c
- * Purpose:     A little printf helper unterstanding firm types
- * Author:      Sebastian Hack
- * Created:     29.11.2004
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2006 Universität Karlsruhe
- */
-
 /**
- * @file irprintf.c
- *
- * A little printf helper unterstanding firm types.
- * @author Sebastian Hack
- * @date 29.11.2004
+ * @file
+ * @brief   A little printf helper unterstanding firm types
+ * @author  Sebastian Hack
+ * @date    29.11.2004
+ * @version $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

diff --git a/ir/ir/irprintf.h b/ir/ir/irprintf.h
index 1f4795c..5e6b7d4 100644 (file)
--- a/ir/ir/irprintf.h
+++ b/ir/ir/irprintf.h
@@ -17,25 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irprintf.h
- * Purpose:     A little printf understanding some firm types.
- * Author:      Sebastian Hack
- * Created:     29.11.2004
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2004 Universität Karlsruhe
- */
-
 /**
- * @file irprintf.h
- *
- * A little printf understanding some firm types.
- * @author Sebastian Hack
- * @date 29.11.2004
+ * @file
+ * @brief    A little printf understanding some firm types.
+ * @author   Sebastian Hack
+ * @date     29.11.2004
+ * @version  $Id$
  */
-#ifndef _FIRM_IR_IRPRINTF_H_
-#define _FIRM_IR_IRPRINTF_H_
+#ifndef FIRM_IR_IRPRINTF_H
+#define FIRM_IR_IRPRINTF_H
 
 #include "firm_config.h"
 
@@ -164,4 +154,4 @@ void ir_obst_vprintf(struct obstack *obst, const char *fmt, va_list args);
 #include <libcore/lc_printf.h>
 #endif /* WITH_LIBCORE */
 
-#endif /* _FIRM_IR_IRPRINTF_H_ */
+#endif

diff --git a/ir/ir/irprintf_t.h b/ir/ir/irprintf_t.h
index 33af3bd..b5a9776 100644 (file)
--- a/ir/ir/irprintf_t.h
+++ b/ir/ir/irprintf_t.h
@@ -17,18 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irprintf_t.h
- * Purpose:     A little printf understanding some firm types.
- * Author:      Sebastian Hack
- * Created:     29.11.2004
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2004 Universität Karlsruhe
+/**
+ * @file
+ * @brief   A little printf understanding some firm types.
+ * @author  Sebastian Hack
+ * @date    29.11.2004
+ * @version $Id$
  */
-
-#ifndef _IRPRINTF_T_H
-#define _IRPRINTF_T_H
+#ifndef FIRM_IR_IRPRINTF_T_H
+#define FIRM_IR_IRPRINTF_T_H
 
 #include "firm_config.h"
 #include "irprintf.h"
@@ -50,5 +47,4 @@ static INLINE void ir_fdebugf(FILE *f, const char *fmt, ...)
 
 #endif
 
-
 #endif

diff --git a/ir/ir/irprog.c b/ir/ir/irprog.c
index 4a0a4bf..42af15b 100644 (file)
--- a/ir/ir/irprog.c
+++ b/ir/ir/irprog.c
@@ -17,17 +17,13 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irprog.c
- * Purpose:     Entry point to the representation of a whole program.
- * Author:      Goetz Lindenmaier
- * Modified by:
- * Created:     2000
- * CVS-ID:      $Id$
- * Copyright:   (c) 2000-2007 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Entry point to the representation of a whole program.
+ * @author   Goetz Lindenmaier
+ * @date     2000
+ * @version  $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irprog.h b/ir/ir/irprog.h
index 6a01bff..cd10c38 100644 (file)
--- a/ir/ir/irprog.h
+++ b/ir/ir/irprog.h
@@ -17,26 +17,17 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irprog.h
- * Purpose:     Entry point to the representation of a whole program.
- * Author:      Goetz Lindenmaier
- * Modified by:
- * Created:     2000
- * CVS-ID:      $Id$
- * Copyright:   (c) 2000-2003 Universität Karlsruhe
- */
-
 /**
- * @file irprog.h
+ * @file
+ * @brief   Entry point to the representation of a whole program.
+ * @author  Goetz Lindenmaier
+ * @date    2000
+ * @version $Id$
+ * @summary
+ *  ir representation of a program.
  *
- * ir representation of a program.
- *
- * @author Goetz Lindenmaier
- *
- * This file defines a construct that keeps all information about a
- * program:
+ *  This file defines a construct that keeps all information about a
+ *  program:
  *   - A reference point to the method to be executed on program start.
  *   - A list of all procedures.
  *   - A list of all types.
@@ -49,9 +40,8 @@
  *   - a flag indicating validity of the interprocedural representation.
  *   - the output file name
  */
-
-#ifndef _FIRM_IR_IRPROG_H_
-#define _FIRM_IR_IRPROG_H_
+#ifndef FIRM_IR_IRPROG_H
+#define FIRM_IR_IRPROG_H
 
 #include "firm_types.h"
 #include "irgraph.h"
@@ -231,4 +221,4 @@ void           set_irp_ip_outs_inconsistent(void);
 irg_callee_info_state get_irp_callee_info_state(void);
 void                  set_irp_callee_info_state(irg_callee_info_state s);
 
-#endif /* ifndef _FIRM_IR_IRPROG_H_ */
+#endif

diff --git a/ir/ir/irprog_t.h b/ir/ir/irprog_t.h
index 00af1dc..5e882e8 100644 (file)
--- a/ir/ir/irprog_t.h
+++ b/ir/ir/irprog_t.h
@@ -17,23 +17,15 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irprog_t.h
- * Purpose:     Entry point to the representation of a whole program 0-- private header.
- * Author:      Goetz Lindenmaier
- * Modified by:
- * Created:     2000
- * CVS-ID:      $Id$
- * Copyright:   (c) 2000-2007 Universität Karlsruhe
- */
-
 /**
- * @file irprog_t.h
+ * @file
+ * @brief    Entry point to the representation of a whole program 0-- private header.
+ * @author   Goetz Lindenmaier
+ * @date     2000
+ * @version  $Id$
  */
-
-#ifndef _FIRM_IR_IRPROG_T_H_
-#define _FIRM_IR_IRPROG_T_H_
+#ifndef FIRM_IR_IRPROG_T_H
+#define FIRM_IR_IRPROG_T_H
 
 #ifdef HAVE_CONFIG_H
 #include "firm_config.h"
@@ -211,4 +203,4 @@ void init_irprog_2(void);
 #define get_glob_type()        _get_glob_type()
 #define get_tls_type()         _get_tls_type()
 
-#endif /* ifndef _FIRM_IR_IRPROG_T_H_ */
+#endif

diff --git a/ir/ir/irreflect.c b/ir/ir/irreflect.c
index afcd08a..0b6633a 100644 (file)
--- a/ir/ir/irreflect.c
+++ b/ir/ir/irreflect.c
@@ -18,12 +18,11 @@
  */
 
 /**
- * @file irreflect.c
- * @date 9.9.2004
- * @author Sebastian Hack
- * @brief Reflection for Firm operands.
- *
- * $Id$
+ * @file
+ * @brief   Reflection for Firm operands.
+ * @author  Sebastian Hack
+ * @date    9.9.2004
+ * @version $Id$
  */
 #ifdef HAVE_CONFIG_H
 # include "config.h"

diff --git a/ir/ir/irreflect.h b/ir/ir/irreflect.h
index a03fc65..8e303f5 100644 (file)
--- a/ir/ir/irreflect.h
+++ b/ir/ir/irreflect.h
@@ -18,15 +18,14 @@
  */
 
 /**
- * @file irreflect.h
- * @date 9.9.2004
- * @author Sebastian Hack
- * @brief Reflection for Firm operations.
- *
- * $Id$
+ * @file
+ * @brief   Reflection for Firm operations.
+ * @author  Sebastian Hack
+ * @date    9.9.2004
+ * @version $Id$
  */
-#ifndef _FIRM_IR_REFLECT_H_
-#define _FIRM_IR_REFLECT_H_
+#ifndef FIRM_IR_REFLECT_H
+#define FIRM_IR_REFLECT_H
 
 #include <limits.h>
 
@@ -235,5 +234,4 @@ int rflct_signature_set_arg(rflct_sig_t *sig, int is_use, int num,
  */
 int rflct_signature_get_index(const rflct_sig_t *sig, int is_use, int num);
 
-
-#endif /* _FIRM_IR_REFLECT_H_ */
+#endif

diff --git a/ir/ir/irreflect_t.h b/ir/ir/irreflect_t.h
index 7e09027..db87446 100644 (file)
--- a/ir/ir/irreflect_t.h
+++ b/ir/ir/irreflect_t.h
@@ -18,17 +18,15 @@
  */
 
 /**
- * @file reflect_t.h
- * @date 10.9.2004
- * @author Sebastian Hack
- * @brief Basic (private) data structures for reflection.
- *
- * $Id$
+ * @file
+ * @brief   Basic (private) data structures for reflection.
+ * @author  Sebastian Hack
+ * @date    10.9.2004
+ * @version $Id$
  */
-
-#ifndef _FIRM_REFLECT_T_H
-#define _FIRM_REFLECT_T_H
+#ifndef FIRM_IR_REFLECT_T_H
+#define FIRM_IR_REFLECT_T_H
 
 void firm_init_rflct(void);
 
-#endif /* _FIRM_REFLECT_T_H */
+#endif

diff --git a/ir/ir/irvrfy.c b/ir/ir/irvrfy.c
index 625e1f1..dd35653 100644 (file)
--- a/ir/ir/irvrfy.c
+++ b/ir/ir/irvrfy.c
@@ -17,17 +17,12 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irvrfy.c
- * Purpose:     Check irnodes for correctness.
- * Author:      Christian Schaefer
- * Modified by: Goetz Lindenmaier. Till Riedel. Michael Beck.
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
+/**
+ * @file
+ * @brief    Check irnodes for correctness.
+ * @author   Christian Schaefer, Goetz Lindenmaier, Till Riedel, Michael Beck
+ * @version  $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/irvrfy.h b/ir/ir/irvrfy.h
index 9c3151f..d073c88 100644 (file)
--- a/ir/ir/irvrfy.h
+++ b/ir/ir/irvrfy.h
@@ -17,26 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irvrfy.h
- * Purpose:     Check irnodes for correctness.
- * Author:      Christian Schaefer
- * Modified by: Goetz Lindenmaier. Till Riedel
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
- */
-
 /**
- * @file irvrfy.h
- *
- * ir graph verification.
- *
- * @author Christian Schaefer
+ * @file
+ * @brief    Check irnodes for correctness.
+ * @author   Christian Schaefer, Goetz Lindenmaier, Till Riedel
+ * @version  $Id$
  */
-#ifndef _FIRM_IR_IRVRFY_H_
-#define _FIRM_IR_IRVRFY_H_
+#ifndef FIRM_IR_IRVRFY_H
+#define FIRM_IR_IRVRFY_H
 
 #include "firm_types.h"
 
@@ -115,4 +103,4 @@ int irg_vrfy_bads(ir_graph *irg, int flags);
  */
 void vrfy_enable_entity_tests(int enable);
 
-#endif /* _FIRM_IR_IRVRFY_H_ */
+#endif

diff --git a/ir/ir/irvrfy_t.h b/ir/ir/irvrfy_t.h
index f977fbe..fd1ab70 100644 (file)
--- a/ir/ir/irvrfy_t.h
+++ b/ir/ir/irvrfy_t.h
@@ -17,18 +17,14 @@
  * PURPOSE.
  */
 
-/*
- * Project:     libFIRM
- * File name:   ir/ir/irvrfy_t.h
- * Purpose:     New checker of irnodes for correctness.
- * Author:      Michael Beck
- * Modified by:
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2005 Universität Karlsruhe
+/**
+ * @file
+ * @brief    New checker of irnodes for correctness.
+ * @author   Michael Beck
+ * @version  $Id$
  */
-#ifndef _IRVRFY_T_H_
-#define _IRVRFY_T_H_
+#ifndef FIRM_IR_IRVRFY_T_H
+#define FIRM_IR_IRVRFY_T_H
 
 #include "irflag_t.h"
 #include "irvrfy.h"
@@ -86,4 +82,4 @@ do { \
  */
 void firm_set_default_verifyer(ir_opcode code, ir_op_ops *ops);
 
-#endif /* _IRVRFY_T_H_ */
+#endif

diff --git a/ir/ir/pseudo_irg.c b/ir/ir/pseudo_irg.c
index 32731a3..673df4a 100644 (file)
--- a/ir/ir/pseudo_irg.c
+++ b/ir/ir/pseudo_irg.c
@@ -17,19 +17,13 @@
  * PURPOSE.
  */
 
-/* -*- c -*- */
-
-/*
- * Project:     libFIRM
- * File name:   ir/external/pseudo_irg.c
- * Purpose:     implementation
- * Author:      G"otz Lindenmaier
- * Modified by: Boris Boesler
- * Created:     xx.10.2004
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-2004 Universität Karlsruhe
+/**
+ * @file
+ * @brief    pseudo irg implementation
+ * @author   Goetz Lindenmaier, Boris Boesler
+ * @date     Oktober 2004
+ * @version  $Id$
  */
-
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif

diff --git a/ir/ir/pseudo_irg.h b/ir/ir/pseudo_irg.h
index 4042718..3c39973 100644 (file)
--- a/ir/ir/pseudo_irg.h
+++ b/ir/ir/pseudo_irg.h
@@ -17,21 +17,15 @@
  * PURPOSE.
  */
 
-/* -*- c -*- */
-
-/*
- * Project:     libFIRM
- * File name:   ir/external/pseudo_irg.h
- * Purpose:     interface to pseudo irgs
- * Author:      G"otz Lindenmaier
- * Modified by: Boris Boesler
- * Created:     xx.10.2004
- * CVS-ID:      $Id$
- * Copyright:   (c) 1999-2004 Universität Karlsruhe
+/**
+ * @file
+ * @brief    interface to pseudo irgs
+ * @author   Goetz Lindenmaier, Boris Boesler
+ * @date     Oktober 2004
+ * @version  $Id$
  */
-
-#ifndef _FIRM_IR_PSEUDO_IRG_H_
-#define _FIRM_IR_PSEUDO_IRG_H_
+#ifndef FIRM_IR_PSEUDO_IRG_H
+#define FIRM_IR_PSEUDO_IRG_H
 
 #include "firm_types.h"
 
@@ -59,4 +53,4 @@ ir_graph *get_irp_pseudo_irg(int pos);
 void set_visit_pseudo_irgs(int x);
 int  get_visit_pseudo_irgs(void);
 
-#endif /* _FIRM_IR_PSEUDO_IRG_H_ */
+#endif