Commit d8fb82e9 authored by Matthias Braun's avatar Matthias Braun
Browse files

added license information, cleaned up doxygen comments

[r13484]
parent b1523373
/**
* Debug facility.
* @author Michael Beck, Sebastian Hack
* @date 15.12.2004
/*
* Copyright (C) 1995-2007 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 Debug facility.
* @author Michael Beck, Sebastian Hack
* @date 15.12.2004
* @version $Id$
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
......
/**
* Debug facility.
* @author Michael Beck, Sebastian Hack
* @date 15.12.2004
/*
* Copyright (C) 1995-2007 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.
*
* $Id$
* 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.
*/
#ifndef _FIRM_DEBUG_H
#define _FIRM_DEBUG_H
/**
* @file
* @brief Debug facility.
* @author Michael Beck, Sebastian Hack
* @date 15.12.2004
* @version $Id$
*/
#ifndef FIRM_COMMON_DEBUG_H
#define FIRM_COMMON_DEBUG_H
#include "firm_config.h"
......@@ -188,4 +206,4 @@ void firm_dbg_set_file(firm_dbg_module_t *module, FILE *file);
#endif /* DEBUG_libfirm */
#endif /* _FIRM_DEBUG_H */
#endif
/*
* Project: libFIRM
* File name: ir/common/error.c
* Purpose: Error handling for libFirm
* Author: Michael Beck
* Modified by:
* Created:
* CVS-ID: $Id$
* Copyright: (C) 1998-2006 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 Error handling for libFirm
* @author Michael Beck
* @version $Id$
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
......
/*
* Project: libFIRM
* File name: ir/common/error.h
* Purpose: Error handling for libFirm
* Author: Michael Beck
* Modified by:
* Created:
* CVS-ID: $Id$
* Copyright: (C) 1998-2006 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 Error handling for libFirm
* @author Michael Beck
* @version $Id$
*/
#ifndef _ERROR_H_
#define _ERROR_H_
#ifndef FIRM_COMMON_ERROR_H
#define FIRM_COMMON_ERROR_H
/**
* @file error.h
......@@ -43,4 +57,4 @@
*/
NORETURN panic(const char *fmt, ...);
# endif /*_ERROR_H_ */
# endif
/*
* Project: libFIRM
* File name: ir/common/firm.c
* Purpose: Central firm functionality.
* Author: Martin Trapp, Christian Schaefer
* Modified by: Goetz Lindenmaier
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1998-2003 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 Central firm functionality.
* @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier
* @version $Id$
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
......
/*
* 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.
* Copyright (C) 1995-2007 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 firm.h
*
* @file
* @brief Central firm header.
* @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier
* @version $Id$
* @summary
* Central FIRM header.
*
* FIRM is a full graph based intermediate representation in SSA Form
......@@ -46,8 +56,8 @@
* generic functionality to support implementations using firm. (Code generation,
* further optimizations).
*/
#ifndef _FIRM_H_
#define _FIRM_H_
#ifndef FIRM_COMMON_FIRM_H
#define FIRM_COMMON_FIRM_H
#ifdef __cplusplus
extern "C" {
......@@ -250,4 +260,4 @@ void firm_init_options(const char *arg_prefix, int argc, const char **argv);
}
#endif
#endif /* _FIRM_H_ */
#endif
/*
* Project: libFIRM
* File name: ir/common/firm_common.c
* Purpose:
* Author: Martin Trapp, Christian Schaefer
* Modified by: Goetz Lindenmaier, Michael Beck
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1998-2007 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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
* @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier, Michael Beck
* @version $Id$
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
......
/*
* Project: libFIRM
* File name: ir/common/firm_common.c
* Purpose: Stuff common to all firm modules.
* Author: Martin Trapp, Christian Schaefer
* Modified by: Goetz Lindenmaier
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1998-2007 Universität Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 firm_common.h
*
* common firm declarations
*
* @author Martin Trapp, Christian Schaefer & Goetz Lindenmaier
* @file
* @brief common firm declarations
* @author Martin Trapp, Christian Schaefer, Goetz Lindenmaier
* @version $Id$
*/
#ifndef _FIRM_COMMON_H_
#define _FIRM_COMMON_H_
#ifndef FIRM_COMMON_FIRM_COMMON_H
#define FIRM_COMMON_FIRM_COMMON_H
/** a list of firm kinds
@@@ not all datatypes are tagged yet. */
......@@ -52,4 +58,4 @@ const char *print_firm_kind(void *firm_thing);
/** Print an identification of a firm thing. */
void firm_identify_thing(void *X);
#endif /*_FIRM_COMMON_H_ */
#endif
/*
* Project: libFIRM
* File name: ir/common/firm_common.c
* Purpose: Internal preprocessor directives.
* Author: Goetz Lindenmaier
* Modified by:
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1999-2003 Universität Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
*/
/**
* @file firm_common_t.h
* Copyright (C) 1995-2007 University of Karlsruhe. All right reserved.
*
* This file is part of libFirm.
*
* preprocessor flags
* 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.
*
* @author Goetz Lindenmaier
* 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.
*/
# ifndef _COMMON_T_H_
# define _COMMON_T_H_
/**
* @file
* @brief Internal preprocessor directives.
* @author Goetz Lindenmaier
* @version $Id$
*/
#ifndef FIRM_COMMON_COMMON_T_H
#define FIRM_COMMON_COMMON_T_H
#include "firm_common.h"
......@@ -48,4 +53,4 @@
* Sometimes it's useful to see the pointer values, though. */
#define NODEID_AS_LABEL 1
# endif /*_COMMON_T_H_ */
#endif
/*
* Project: libFIRM
* File name: ir/common/firm_types.c
* Purpose: Definition of opaque firm types
* Author: Michael Beck
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1998-2007 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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.
*/
#ifndef _FIRM_TYPES_H_
#define _FIRM_TYPES_H_
/**
* @file
* @brief Definition of opaque firm types
* @author Michael Beck
* @version $Id$
*/
#ifndef FIRM_COMMON_FIRM_TYPES_H
#define FIRM_COMMON_FIRM_TYPES_H
#ifdef _MSC_VER
typedef __int64 long64;
......@@ -127,4 +142,4 @@ typedef struct sn_entry *seqno_t;
typedef struct ir_exec_freq ir_exec_freq, *ir_exec_freq_ptr;
#endif
#endif /* _FIRM_TYPES_H_ */
#endif
/*
* Project: libFIRM
* File name: ir/common/firmwalk.c
* Purpose: Walker that touches all Firm data structures
* Author: Sebastian Felis
* Modified by:
* Created: 7.2003
* CVS-ID: $Id$
* Copyright: (c) 2003 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 Walker that touches all Firm data structures
* @author Sebastian Felis
* @date 7.2003
* @version $Id$
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif
......
/*
* Project: libFIRM
* File name: ir/common/firmwalk.h
* Purpose: Walker that touches all Firm data structures
* Author: Sebastian Felis
* Modified by:
* Created: 7.2003
* CVS-ID: $Id$
* Copyright: (c) 2003 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 firmwalk.h
*
* @file
* @biref Walker that touches all Firm data structures
* @author Sebastian Felis
* @date 7.2003
* @version $Id$
* @summary
* Firm walker over intermediate representation.
*
* To initialize the walker, call firm_walk_init(). This function
......@@ -28,9 +39,10 @@
* of any firm node, the the wrapper functions set_firm_walk_link()
* and get_firm_walk_link() should be used, because the firm walker
* make use of the link field to store its own data.
* @note Deprecated, better use the stuff in irgwalk.h, typewalk.h
*/
#ifndef _FIRM_WALK_H_
#define _FIRM_WALK_H_
#ifndef FIRM_COMMON_FIRM_WALK_H
#define FIRM_COMMON_FIRM_WALK_H
#include "firm_types.h"
......@@ -216,4 +228,4 @@ void firm_walk_finalize(void);
#endif
#endif /* _FIRM_WALK_H_ */
#endif
/*
* Project: libFIRM
* File name: ir/ir/irtools.c
* Purpose: Some often needed tool-functions
* Author: Michael Beck
* Modified by:
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1999-2005 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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 Some often needed tool-functions
* @author Michael Beck
* @version $Id$
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
......
/*
* Project: libFIRM
* File name: ir/ir/irtools.h
* Purpose: Some often needed tool-functions
* Author: Michael Beck
* Modified by:
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1999-2006 Universität Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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.
*/
#ifndef _FIRM_COMMON_IRTOOLS_H_
#define _FIRM_COMMON_IRTOOLS_H_
/**
* @file
* @brief Some often needed tool-functions
* @author Michael Beck
* @version $Id$
*/
#ifndef FIRM_COMMON_IRTOOLS_H
#define FIRM_COMMON_IRTOOLS_H
#include "firm_config.h"
#include "firm_types.h"
......@@ -81,4 +95,4 @@ void copy_irn_to_irg(ir_node *n, ir_graph *irg);
*/
ir_node *exact_copy(const ir_node *n);
#endif /* _FIRM_COMMON_IRTOOLS_H_ */
#endif
/*
* Project: libFIRM
* File name: ir/ir/old_fctnames.h
* Purpose: Some makros supporting old function names.
* Author: Goetz Lindenmaier
* Modified by:
* Created:
* CVS-ID: $Id$
* Copyright: (c) 1998-2003 Universitt Karlsruhe
* Licence: This file protected by GPL - GNU GENERAL PUBLIC LICENSE.
* Copyright (C) 1995-2007 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