X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=ir%2Ftr%2Ftpop_t.h;h=4d51cf027df9865703710d80912e15319b5c6b38;hb=0eadb153b414eb3ca87d859488b289b90d64c208;hp=2f8917cb5678dacf748f6d202b1d9094c93b8fa2;hpb=e3e22fa6f927847099c0bff62457003aa81f2518;p=libfirm

diff --git a/ir/tr/tpop_t.h b/ir/tr/tpop_t.h
index 2f8917cb5..4d51cf027 100644
--- a/ir/tr/tpop_t.h
+++ b/ir/tr/tpop_t.h
@@ -1,88 +1,74 @@
+/*
+ * Project:     libFIRM
+ * File name:   ir/tr/tpop_t.h
+ * Purpose:     Opcode of types -- private header.
+ * Author:      Goetz Lindenmaier
+ * Modified by:
+ * Created:
+ * CVS-ID:      $Id$
+ * Copyright:   (c) 2001-2003 Universität Karlsruhe
+ * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
+ */
 
-/* $Id$ */
 
-# ifndef _IROP_T_H_
-# define _IROP_T_H_
+# ifndef _TPOP_T_H_
+# define _TPOP_T_H_
 
 # include <stddef.h>
 # include "tpop.h"
-/****h* libfirm/tpop_t.h
+/**
+ * @file tpop_t.h
+ *
+ * This file contains the datatypes hidden in tpop.h.
  *
- * NAME
- *   file tpop_t.h
- * COPYRIGHT
- *   (C) 2001 by Universitaet Karlsruhe
- * AUTHORS
- *   Goetz Lindenmaier
- * NOTES
- *   This file contains the datatypes hidden in tpop.h.
- * SEE ALSO
- *   tpop.h
- *****
+ * @autor Goetz Lindenmaier
+ * @see  tpop.h
  */
 
+/** The type opcode */
 struct tp_op {
   tp_opcode code;
   ident *name;
   size_t attr_size;
 };
 
-/****f* tpop/new_tpop
+/**
+ *   Returns a new type opcode.
  *
- * NAME
- *   new_tpop - Returns a new type opcode.
- * NOTE
  *   Allocates a new tp_op struct and initializes it's fields with
  *   the passed values.  This function is only to be used during
  *   initialization of the library.
- * SYNOPSIS
- *   tp_op * new_tpop (tp_opcode code, ident *name, size_t attr_size);
- * INPUTS
- *   code      - the enum for this type opcode.
- *   name      - an ident for the name of the type opcode.
- *   attr_size - the size of the attributes necessary for a type with
- *               this opcode
- * RESULT
- *   A new type opcode.
- ***
+ *
+ *   @param code        the enum for this type opcode.
+ *   @param name        an ident for the name of the type opcode.
+ *   @param attr_size   the size of the attributes necessary for a type with
+ *                      this opcode
+ *   @return A new type opcode.
+ *
  */
-tp_op * new_tpop (tp_opcode code, ident *name, size_t attr_size);
+tp_op *new_tpop (tp_opcode code, ident *name, size_t attr_size);
 
-/****f* tpop/new_tpop
+/**
+ *   Initialize the tpop module.
  *
- * NAME
- *   init_tpop - Initialize the tpop module.
- * NOTE
  *   Must be called during the initizlization of the library. Allocates
  *   opcodes and sets the globals that are external visible as specified
  *   in tpop.h.
- * SYNOPSIS
- *   void init_tpop (void);
- * INPUTS
- * RESULT
- * SIDE EFFECTS
  *   Allocates opcodes for classes, struct, method, union, array,
  *   enumeration, pointer and primitive and sets the according values.
- ***
  */
 void init_tpop (void);
 
-/****f* tpop/get_tpop_attr_size
- *
- * NAME
- *   get_tpop_attr_size - Returns the size of the attribute to this kind
+/**
+ *   Returns the size of the attribute to this kind
  *   of type.
- * NOTE
+ *
  *   Internal feature.
- * SYNOPSIS
- *   int get_tpop_attr_size (tp_op *op)
- * INPUTS
- *   op - The type opcode to get the size for.
- * RESULT
- *   The size of the attribute of types with this opcode.
- * SIDE EFFECTS
- ***
+ *
+ *   @param op  The type opcode to get the size for.
+ *   @return The size of the attribute of types with this opcode.
+ *
  */
 int get_tpop_attr_size (tp_op *op);
 
-#endif /* _IROP_T_H_ */
+#endif /* _TPOP_T_H_ */