/*
- * Copyright (C) 1995-2008 University of Karlsruhe. All right reserved.
+ * Copyright (C) 1995-2010 University of Karlsruhe. All right reserved.
*
* This file is part of libFirm.
*
* @file
* @brief Central firm header.
* @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier
- * @version $Id$
- * @summary
- * Central FIRM header.
+ * This header includes all other firm headers and can be included conveniently
+ * by users of the library.
+ */
+
+/** @mainpage
*
* FIRM is a full graph based intermediate representation in SSA Form
* with a novel concept to model side effects. It allows fast, aggressive
* optimizations.
*
- * This header is the central header of the library implementation of this
- * IR.
- *
* The internal representation of a program in firm is separated into five
* different modules:
* - Firm Graphs representing the code of a program. (Subdirectory ir.)
*
* Further this library supplies functionality to build and optimize FIRM graphs
* and further functionality needed in a compiler. Finally there is more
- * generic functionality to support implementations using firm. (Code generation,
- * further optimizations).
+ * generic functionality to support implementations using firm.
+ * (Code generation, further optimizations).
*/
-#ifndef FIRM_COMMON_FIRM_H
-#define FIRM_COMMON_FIRM_H
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* The representations */
-#include "firm_common.h" /* common type tags. */
-#include "irprog.h" /* control flow and data of a program */
-#include "irgraph.h" /* graphs */
-#include "typerep.h" /* type representation */
-#include "tv.h" /* target values */
-#include "irnode.h"
-#include "irop.h"
-#include "ident.h" /* source code identificators */
+/** @defgroup irana Analyses */
-/* Functionality */
-#include "ircons.h" /* construct ir */
-#include "ircgcons.h" /* construct interprocedural graph */
-
-/* Optimizations */
-#include "irflag.h" /* optimization flags */
-#include "irgopt.h" /* optimize ir */
-#include "iroptimize.h" /* optimize ir by reassociation */
-#include "ircgopt.h" /* Optimizations based on interprocedural graph */
-#include "iropt.h"
-#include "irpass.h" /* Pass management */
-
-/* Lowering */
-#include "lowering.h" /* lowering of different calls parameters, intrinsic calls, double word types, high-level constructs */
-
-/* Analyses */
-#include "irouts.h" /* Graph reversal / out edges. */
-#include "trouts.h" /* Graph reversal / out edges for types. */
-#include "irdom.h" /* Dominator analysis */
-#include "cgana.h" /* Analysis to construct interprocedural graph */
- /* including some optimizations */
-#include "irloop.h" /* loop and backedge analysis */
-#include "callgraph.h" /* Callgraph construction */
-#include "irconsconfirm.h" /* Confirm nodes */
-#include "analyze_irg_args.h" /* Simple pointer parameter analysis */
-#include "irtypeinfo.h" /* type information for nodes */
-#include "irmemory.h" /* memory disambiguation */
-#include "interval_analysis.h"
-#include "field_temperature.h"
-#include "execution_frequency.h"
-
-/* Support */
-#include "irgmod.h" /* Support to modify ir */
-#include "irgwalk.h" /* Support to walk ir */
-
-#include "irarch.h" /* architecture dependent optimizations */
-
-#include "firmstat.h" /* statistics */
+/** @defgroup adt Abstract Data Structures
+ * This module contains abstract datatypes like lists and hashmaps.
+ * They're provided as a convenience, the firm API is fully functionaly without
+ * them so you can just as well use a library like glib and libapr or write
+ * your own.
+ */
-#include "dbginfo.h" /* debug support */
-#include "seqnumbers.h" /* debug support */
+/** @defgroup algorithms Algorithms
+ * This module contains generic algorithms like bipartite matching or solvers
+ * for linear equation systems.
+ * They're provided as a convenience, the firm API is fully functionaly without
+ * them so you can just as well use a library like glib and libapr or write
+ * your own.
+ */
+#ifndef FIRM_COMMON_FIRM_H
+#define FIRM_COMMON_FIRM_H
+#include "analyze_irg_args.h"
+#include "be.h"
+#include "callgraph.h"
+#include "cdep.h"
+#include "cgana.h"
+#include "dbginfo.h"
+#include "execfreq.h"
+#include "firm_common.h"
+#include "firmstat.h"
+#include "firm_types.h"
+#include "heights.h"
+#include "ident.h"
+#include "irarch.h"
+#include "ircgopt.h"
+#include "irconsconfirm.h"
+#include "ircons.h"
+#include "irdom.h"
+#include "vrp.h"
#include "irdump.h"
+#include "iredgekinds.h"
+#include "iredges.h"
+#include "irflag.h"
+#include "irgmod.h"
+#include "irgopt.h"
+#include "irgraph.h"
+#include "irgwalk.h"
#include "irio.h"
+#include "irloop.h"
+#include "irmemory.h"
+#include "irmode.h"
+#include "irnode.h"
+#include "irop.h"
+#include "iropt.h"
+#include "iroptimize.h"
+#include "irouts.h"
+#include "irpass.h"
#include "irprintf.h"
-#include "irvrfy.h"
-
-#include "irarch.h"
-
-#include "iredges.h"
-
-#include "be.h"
-
-#ifdef __cplusplus
-}
-#endif
+#include "irprog.h"
+#include "irtypeinfo.h"
+#include "irverify.h"
+#include "lowering.h"
+#include "timing.h"
+#include "trouts.h"
+#include "tv.h"
+#include "typerep.h"
#endif
projects / libfirm / blobdiff