X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Fdebug%2Fdbginfo_t.h;h=271e09bd775589611a203ab06f0e20fba9c79be6;hb=2c8cc375a52fbfb9bdf15ebed6278a6d7b23a6ff;hp=2f6b0acf7180bd7798815db606aead6c96339b65;hpb=8410ebe71f429a39822b055009b850ad2169c600;p=libfirm

diff --git a/ir/debug/dbginfo_t.h b/ir/debug/dbginfo_t.h
index 2f6b0acf7..271e09bd7 100644
--- a/ir/debug/dbginfo_t.h
+++ b/ir/debug/dbginfo_t.h
@@ -1,26 +1,74 @@
 /*
-**  Copyright (C) 2001 by Universitaet Karlsruhe
-**  All rights reserved.
-**
-**  Authors: Goetz Lindenmaier
-**
-**  dbginfo: This is a empty implementation of the Firm interface to
-**  debugging support.  It only guarantees that the Firm library compiles
-**  and runs without any real debugging support.
-**  The functions herein are declared weak so that they can be overriden
-**  by a real implementation.
-*/
-
-/* $Id$ */
-
-#ifndef __DBGINFO_T_H__
-#define __DBGINFO_T_H__
+ * Copyright (C) 1995-2008 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      Implements the Firm interface to debug information -- private header.
+ * @author     Goetz Lindenmaier
+ * @date       2001
+ * @version    $Id$
+ * @brief
+ *  dbginfo: This is a empty implementation of the Firm interface to
+ *  debugging support.  It only guarantees that the Firm library compiles
+ *  and runs without any real debugging support.
+ */
+#ifndef FIRM_DEBUG_DBGINFO_T_H
+#define FIRM_DEBUG_DBGINFO_T_H
+
+#include <stdlib.h>
 #include "dbginfo.h"
 
-extern void (*__dbg_info_merge_pair)(ir_node *nw, ir_node *old, ident *info);
+/**
+ * The default merge_pair_func implementation, simply copies the debug info
+ * from the old Firm node to the new one if the new one does not have debug info yet.
+ *
+ * @param nw    The new Firm node.
+ * @param old   The old Firm node.
+ * @param info  The action that cause old node to be replaced by new one.
+ */
+void default_dbg_info_merge_pair(ir_node *nw, ir_node *old, dbg_action info);
+
+/**
+ * The default merge_sets_func implementation.  If n_old_nodes is equal 1,
+ * copies the debug info from the old node to all new ones (if they do not have
+ * one), else does nothing.
+ *
+ * @param new_nodes     An array of new Firm nodes.
+ * @param n_new_nodes   The length of the new_nodes array.
+ * @param old_nodes     An array of old (replaced) Firm nodes.
+ * @param n_old_nodes   The length of the old_nodes array.
+ * @param info          The action that cause old node to be replaced by new one.
+ */
+void default_dbg_info_merge_sets(ir_node **new_nodes, int n_new_nodes,
+                            ir_node **old_nodes, int n_old_nodes,
+                            dbg_action info);
+
+/**
+ * The current merge_pair_func(), access only from inside firm.
+ */
+extern merge_pair_func *__dbg_info_merge_pair;
+
+/**
+ * The current merge_sets_func(), access only from inside firm.
+ */
+extern merge_sets_func *__dbg_info_merge_sets;
 
-extern void (*__dbg_info_merge_sets)(ir_node **new_nodes, ir_node **old_nodes,
-				     ident *info);
+void ir_dbg_info_snprint(char *buf, size_t buf_size, const dbg_info *dbg);
 
-#endif /* __DBGINFO_T_H__ */
+#endif