used enum values for Tuple creation

[libfirm] / ir / common / firm.h

diff --git a/ir/common/firm.h b/ir/common/firm.h
index 6e2ed3b..0e6ffb8 100644 (file)
--- a/ir/common/firm.h
+++ b/ir/common/firm.h
@@ -1,13 +1,22 @@
-/* Copyright (C) 1998 - 2000 by Universitaet Karlsruhe
-** All rights reserved.
-**
-** Authors: Martin Trapp, Christian Schaefer, Goetz Lindenmaier.
-**
-** firm.h: Central FIRM header.
-**
-**
-**
-**
+/*
+ * Project:     libFIRM
+ * File name:   ir/common/firm.h
+ * Purpose:     Central firm header.
+ * Author:      Martin Trapp, Christian Schaefer
+ * Modified by: Goetz Lindenmaier
+ * Created:
+ * CVS-ID:      $Id$
+ * Copyright:   (c) 1998-2003 Universität Karlsruhe
+ * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
+ */
+
+/**
+ @file firm.h
+
+ This documentation no more  maintained since 2001!!!
+
+    Central FIRM header.
+
     FIRM is a full graph based intermediate representation in SSA Form
     with a novel concept to model side effects.  It allows fast, aggressive
     optimizations.
@@ -50,15 +59,14 @@
 
      irgwalk: walker for ir graphs.
      irvrfy:  verify the correctness of a firm node.
-**
+*
 */
 
-/* $Id$ */
-
 # ifndef _FIRM_H_
 # define _FIRM_H_
 
 /* The representations */
+# include "firm_common.h"/* common type tags. */
 # include "irprog.h"     /* control flow and data of a program */
 # include "type.h"       /* type representation */
 # include "entity.h"     /* entity representation */
@@ -66,11 +74,44 @@
 # include "ident.h"      /* source code identificators */
 /* Functionality */
 # include "ircons.h"     /* construct ir */
+# include "ircgcons.h"   /* construct interprocedural graph */
+
+# include "irflag.h"     /* optimization flags */
 # include "irgopt.h"     /* optimize ir */
+# include "ircgopt.h"    /* Optimizations based on interprocedural graph */
+
+# include "irdom.h"      /* Dominator analysis */
+# include "cgana.h"      /* Analysis to construct interprocedural graph */
+                         /* including some optimizations */
+# include "irloop.h"     /* loop and backedge analysis */
+
 # include "irgmod.h"     /* Support to modify ir */
-# include "irflag.h"     /* optimization flags */
+# include "irgwalk.h"    /* Support to walk ir */
+# include "typewalk.h"   /* Support to walk type information */
+# include "typegmod.h"   /* Support to modify type graph */
+# include "mangle.h"     /* Support for mangling ident names. */
+
+/* @@@ temporarily for jni builder until preprocessor works.
+   Then it should be sufficient to include <file.h> instead
+   of firm.h as not all enums are needed in the impelmentation
+   files. */
+# include "irdump.h"
+# include "irvrfy.h"
+
+/**
+ * Initialize the firm library.
+ *
+ * @param func    This function is called, whenever a local variable is used before definition
+ *
+ * The parameter func may be NULL. In that case, the old FIRM behavior is conserved.
+ *
+ * @see default_initialize_local_variable_func_t
+ */
+void init_firm (default_initialize_local_variable_func_t *func);
 
-/* initialize firm */
-void init_firm (void);
+/**
+ * Frees all memory occupied by the firm library.
+ */
+void free_firm (void);
 
 # endif /* _FIRM_H_ */