X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Fir%2Firgopt.h;h=e85fd4e6548c0eba606c8c8956dfad8886c87ad3;hb=e570f00fb465d212dde403160e97ab45d36d1d7e;hp=3e8f6d875fb96dde21c12512a4caaa8848e79669;hpb=e818ee8a4bc281ea5a1824d07bbc38fc64d9c5d4;p=libfirm

diff --git a/ir/ir/irgopt.h b/ir/ir/irgopt.h
index 3e8f6d875..e85fd4e65 100644
--- a/ir/ir/irgopt.h
+++ b/ir/ir/irgopt.h
@@ -1,16 +1,22 @@
-/* Copyright (C) 1998 - 2001 by Universitaet Karlsruhe
-* All rights reserved.
-*/
+/*
+ * 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
+ * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
+ */
 
 /**
-* @file irgopts.h
-*
-* Optimizations for a whole ir graph, i.e., a procedure.
-*
-* @author Christian Schaefer, Goetz Lindenmaier
-*/
-
-/* $Id$ */
+ * @file irgopt.h
+ *
+ * Optimizations for a whole ir graph, i.e., a procedure.
+ *
+ * @author Christian Schaefer, Goetz Lindenmaier
+ */
 
 # ifndef _IRGOPT_H_
 # define _IRGOPT_H_
@@ -32,6 +38,8 @@ void local_optimize_graph (ir_graph *irg);
 
    Backedge information is conserved.
    Removes old attributes of nodes.  Sets link field to NULL.
+   Callee information must be freed (irg_callee_info_none).
+
    Attention: the numbers assigned to nodes if the library is compiled for
    development/debugging are not conserved by copying. */
 void dead_node_elimination(ir_graph *irg);
@@ -83,6 +91,27 @@ void inline_method(ir_node *call, ir_graph *called_graph);
    combination as control flow operation.  */
 void inline_small_irgs(ir_graph *irg, int size);
 
+
+/** Inlineing with a different heuristic than inline_small_irgs.
+ *
+ *  Inlines leave functions.  If inlinening creates new leave
+ *  function inlines these, too. (If g calls f, and f calls leave h,
+ *  h is first inlined in f and then f in g.)
+ *
+ *  Then inlines all small functions (this is not recursive).
+ *
+ *  For a heuristic this inlineing uses firm node counts.  It does
+ *  not count auxiliary nodes as Proj, Tuple, End, Start, Id, Sync.
+ *
+ *  maxsize   Do not inline any calls if a method has more than
+ *            maxsize firm nodes.  It may reach this limit by
+ *            inlineing.
+ *  leavesize Inline leave functions if they have less than leavesize
+ *            nodes.
+ *  size      Inline all function smaller than size.
+ */
+void inline_leave_functions(int maxsize, int leavesize, int size);
+
 /** Code Placement.  Pinns all floating nodes to a block where they
    will be executed only if needed.   Depends on the flag opt_global_cse.
    Graph may not be in phase_building.  Does not schedule control dead
@@ -101,25 +130,28 @@ void place_code(ir_graph *irg);
 
 /** Control flow optimization.
  * Removes empty blocks doing if simplifications and loop simplifications.
- * A block is empty if it contains only a Jmp node and
- * Phi nodes.
+ * A block is empty if it contains only a Jmp node and Phi nodes.
  * Merges single entry single exit blocks with their predecessor
  * and propagates dead control flow by calling equivalent_node.
  * Independent of compiler flag it removes Tuples from cf edges,
  * Bad predecessors form blocks and unnecessary predecessors of End.
  *
  * @bug So far destroys backedge information.
+ * @bug Chokes on Id nodes if called in a certain order with other
+ *      optimizations.  Call local_optimize_graph before to remove
+ *      Ids.
  */
 void optimize_cf(ir_graph *irg);
 
+
 /** Places an empty basic block on critical control flow edges thereby
    removing them.
-
    A critical control flow edge is an edge from a block with several
    control exits to a block with several control entries (See Muchnic
    p. 407).
-
-   @todo not yet implemented!!! */
+   Is only executed if flag set_opt_critical_edges() is set.
+   @param irg IR Graph
+*/
 void remove_critical_cf_edges(ir_graph *irg);
 
 # endif /* _IRGOPT_H_ */