becopyilp: Do not advertise the switch to dump the solution, because this is not...

[libfirm] / ir / be / TEMPLATE / TEMPLATE_emitter.h

diff --git a/ir/be/TEMPLATE/TEMPLATE_emitter.h b/ir/be/TEMPLATE/TEMPLATE_emitter.h
index c30354c..932d290 100644 (file)
--- a/ir/be/TEMPLATE/TEMPLATE_emitter.h
+++ b/ir/be/TEMPLATE/TEMPLATE_emitter.h
@@ -1,30 +1,41 @@
-#ifndef _TEMPLATE_EMITTER_H_
-#define _TEMPLATE_EMITTER_H_
-
-#include "irargs_t.h"  // this also inlucdes <libcore/lc_print.h>
+/*
+ * This file is part of libFirm.
+ * Copyright (C) 2012 University of Karlsruhe.
+ */
+
+/**
+ * @file
+ * @brief    declarations for emit functions
+ */
+#ifndef FIRM_BE_TEMPLATE_TEMPLATE_EMITTER_H
+#define FIRM_BE_TEMPLATE_TEMPLATE_EMITTER_H
+
+#include "irargs_t.h"
 #include "irnode.h"
 #include "debug.h"
 
-#include "../bearch.h"
-#include "../beemitter.h"
+#include "bearch.h"
+#include "beemitter.h"
 
 #include "bearch_TEMPLATE_t.h"
 
-typedef struct _TEMPLATE_emit_env_t {
-       be_emit_env_t             *emit;
-       const arch_env_t          *arch_env;
-       const TEMPLATE_code_gen_t *cg;
-       TEMPLATE_isa_t            *isa;
-       DEBUG_ONLY(firm_dbg_module_t *mod;)
-} TEMPLATE_emit_env_t;
-
-void TEMPLATE_emit_source_register(TEMPLATE_emit_env_t *env, const ir_node *node, int pos);
-void TEMPLATE_emit_dest_register(TEMPLATE_emit_env_t *env, const ir_node *node, int pos);
-void TEMPLATE_emit_immediate(TEMPLATE_emit_env_t *env, const ir_node *node);
-
-int get_TEMPLATE_reg_nr(ir_node *irn, int posi, int in_out);
-const char *get_TEMPLATE_in_reg_name(ir_node *irn, int pos);
-
-void TEMPLATE_gen_routine(const TEMPLATE_code_gen_t *cg, ir_graph *irg);
-
-#endif /* _TEMPLATE_EMITTER_H_ */
+/**
+ * emit assembler instructions with format string. Automatically indents
+ * instructions and adds debug comments at the end (in verbose-asm mode).
+ * Format specifiers:
+ *
+ * fmt  parameter               output
+ * ---- ----------------------  ---------------------------------------------
+ * %%                           %
+ * %r   const arch_register_t*  register
+ * %Sx  <node>                  source register x
+ * %Dx  <node>                  destination register x
+ * %O   <node>                  shifter operand
+ * %I   <node>                  immediate
+ * %L   <node>                  target label
+ */
+void TEMPLATE_emitf(const ir_node *node, const char *format, ...);
+
+void TEMPLATE_emit_routine(ir_graph *irg);
+
+#endif