From: Boris Boesler <boesler@ipd.info.uni-karlsruhe.de>
Date: Mon, 12 Mar 2001 14:51:05 +0000 (+0000)
Subject: *** empty log message ***
X-Git-Url: http://nsz.repo.hu/git/?a=commitdiff_plain;h=6224811da0d867d6b082fb1a4e9ac18ff1c15ce7;p=libfirm

*** empty log message ***

[r122]
---

diff --git a/ir/ir/ircons.c b/ir/ir/ircons.c
index 18f1b5383..09eda5267 100644
--- a/ir/ir/ircons.c
+++ b/ir/ir/ircons.c
@@ -36,7 +36,7 @@ struct Phi_in_stack {
 typedef struct Phi_in_stack Phi_in_stack;
 #endif
 
-/*********************************************** */
+/*** ******************************************** */
 /** privat interfaces, for professional use only */
 
 /* Constructs a Block with a fixed number of predecessors.
@@ -579,10 +579,24 @@ new_r_Bad ()
   return current_ir_graph->bad;
 }
 
-/***********************/
+/** ********************/
 /** public interfaces  */
 /** construction tools */
 
+/****f* ircons/new_Start
+ *
+ * NAME
+ *   new_Start -- create a new Start node in the current block
+ *
+ * SYNOPSIS
+ *   s = new_Start(void);
+ *   ir_node* new_Start(void);
+ *
+ * RESULT
+ *   s - pointer to the created Start node
+ *
+ ****
+ */
 ir_node *
 new_Start (void)
 {
@@ -632,7 +646,7 @@ new_Block (int arity, ir_node **in)
   return res;
 }
 
-/*************************************************************************/
+/* ***********************************************************************/
 /* Methods necessary for automatic Phi node creation                     */
 /*
   ir_node *phi_merge            (ir_node *block, int pos, ir_mode *mode, ir_node **nin, int ins)
@@ -656,7 +670,7 @@ new_Block (int arity, ir_node **in)
 	       \|/                \|/
   	    new_r_Phi0          new_r_Phi_in
 
-*****************************************************************************/
+* *************************************************************************** */
 
 /* Creates a Phi node with 0 predecessors */
 inline ir_node *
@@ -1194,7 +1208,7 @@ get_r_value_internal (ir_node *block, int pos, ir_mode *mode)
 
 #endif /* USE_FAST_PHI_CONSTRUCTION */
 
-/****************************************************************************/
+/* ************************************************************************** */
 
 /** Finalize a Block node, when all control flows are known.  */
 /** Acceptable parameters are only Block nodes.               */
@@ -1504,10 +1518,10 @@ new_Bad (void)
   return current_ir_graph->bad;
 }
 
-/*************************************************************************/
+/* ********************************************************************* */
 /* Comfortable interface with automatic Phi node construction.           */
 /* (Uses also constructors of ?? interface, except new_Block.            */
-/*************************************************************************/
+/* ********************************************************************* */
 
 /** Block construction **/
 /* immature Block without predecessors */
@@ -1551,7 +1565,7 @@ switch_block (ir_node *target)
   current_ir_graph->current_block = target;
 }
 
-/****************************/
+/* ************************ */
 /* parameter administration */
 
 /* get a value from the parameter array from the current block by its index */
@@ -1586,7 +1600,7 @@ set_store (ir_node *store)
   current_ir_graph->current_block->attr.block.graph_arr[0] = store;
 }
 
-/*************************************************************************/
+/* ********************************************************************* */
 /* initialize */
 
 /* call once for each run of the library */
diff --git a/ir/ir/ircons.h b/ir/ir/ircons.h
index b00434f90..5409d0d03 100644
--- a/ir/ir/ircons.h
+++ b/ir/ir/ircons.h
@@ -21,8 +21,12 @@
  it is always unambiguous.
 **/
 
-/**
-***  IRCONS
+/****h* libfirm/ircons
+ *
+ * NAME
+ *   file ircons.h
+ *
+ * NOTES
 
   This file documents all datatypes and constructors needed to
   build a FIRM representation of a pocedure.  The constructors are
@@ -1075,8 +1079,8 @@
   --------------------------------
 
   Returns the node defining the actual store.
-
-**/
+  *****
+  */
 
 
 # ifndef _IRCONS_H_
diff --git a/ir/ir/iropt.c b/ir/ir/iropt.c
index 05ffcef17..d668c6a1b 100644
--- a/ir/ir/iropt.c
+++ b/ir/ir/iropt.c
@@ -714,7 +714,7 @@ transform_node (ir_node *n)
   return n;
 }
 
-/***************** Common Subexpression Elimination *****************/
+/* **************** Common Subexpression Elimination **************** */
 
 /* Compare function for two nodes in the hash table.   Gets two     */
 /* nodes as parameters.                                             */
diff --git a/ir/tv/tv.c b/ir/tv/tv.c
index a4c40f6c8..2db2910e6 100644
--- a/ir/tv/tv.c
+++ b/ir/tv/tv.c
@@ -338,7 +338,7 @@ tarval_hash (tarval *tv)
 
 
 
-/******************** Initialization ****************************************/
+/*** ***************** Initialization ************************************* ***/
 
 void
 tarval_init_1 (void)
@@ -432,7 +432,7 @@ tarval_init_2 (void)
 
 
 
-/************************* Constructors for tarvals *************************/
+/*** ********************** Constructors for tarvals ********************** ***/
 
 /* copy from src to dst len chars omitting '_'. */
 static char *
@@ -765,7 +765,7 @@ tarval_cancel (void)
 
 
 
-/********************* Arithmethic operations on tarvals ********************/
+/*** ****************** Arithmethic operations on tarvals ***************** ***/
 
 /* Return `src' converted to mode `m' if representable, else NULL.
    @@@ lots of conversions missing */