From 31decc27dff97eb7b3a41531863f31e2389d60a0 Mon Sep 17 00:00:00 2001
From: kai <kai@redstar.de>
Date: Sat, 16 Mar 2013 23:43:19 +0100
Subject: [PATCH] Cosmetic changes to gen/todebug.h.

Remove an unused prototype and transform comment from JavaDoc-style
to Doxygen.
---
 gen/todebug.h | 46 +++++++++++++++++++---------------------------
 1 file changed, 19 insertions(+), 27 deletions(-)

diff --git a/gen/todebug.h b/gen/todebug.h
index 94468aaa..822f97f6 100644
--- a/gen/todebug.h
+++ b/gen/todebug.h
@@ -17,27 +17,22 @@
 #include "gen/irstate.h"
 #include "gen/tollvm.h"
 
-void RegisterDwarfSymbols(llvm::Module* mod);
 
-/**
- * Emit the Dwarf compile_unit global for a Module m.
- * @param m
- */
+/// \brief Emit the Dwarf compile_unit global for a Module m.
+/// \param m        Module to emit as compile unit.
 void DtoDwarfCompileUnit(Module* m);
 
-/**
- * Emit the Dwarf subprogram global for a function declaration fd.
- * @param fd
- * @return the Dwarf subprogram global.
- */
+/// \brief Emit the Dwarf subprogram global for a function declaration fd.
+/// \param fd       Function declaration to emit as subprogram.
+/// \returns        the Dwarf subprogram global.
 llvm::DISubprogram DtoDwarfSubProgram(FuncDeclaration* fd);
 
-/**
- * Emit the Dwarf subprogram global for a internal function.
- * This is used for generated functions like moduleinfoctors,
- * module ctors/dtors and unittests.
- * @return the Dwarf subprogram global.
- */
+/// \brief Emit the Dwarf subprogram global for a internal function.
+/// This is used for generated functions like moduleinfoctors,
+/// module ctors/dtors and unittests.
+/// \param prettyname   The name as seen in the source.
+/// \param mangledname  The mangled name in the object file.
+/// \returns       the Dwarf subprogram global.
 llvm::DISubprogram DtoDwarfSubProgramInternal(const char* prettyname, const char* mangledname);
 
 void DtoDwarfFuncStart(FuncDeclaration* fd);
@@ -49,20 +44,17 @@ void DtoDwarfStopPoint(unsigned ln);
 
 void DtoDwarfValue(LLValue *val, VarDeclaration* vd);
 
-/**
- * Emits all things necessary for making debug info for a local variable vd.
- * @param ll LLVM Value of the variable.
- * @param vd Variable declaration to emit debug info for.
- */
+/// \brief Emits all things necessary for making debug info for a local variable vd.
+/// \param ll       LLVM Value of the variable.
+/// \param vd       Variable declaration to emit debug info for.
+/// \param addr     An array of complex address operations.
 void DtoDwarfLocalVariable(LLValue* ll, VarDeclaration* vd,
                            llvm::ArrayRef<LLValue*> addr = llvm::ArrayRef<LLValue*>());
 
-/**
- * Emits all things necessary for making debug info for a global variable vd.
- * @param ll
- * @param vd
- * @return
- */
+/// \brief Emits all things necessary for making debug info for a global variable vd.
+/// \param ll       LLVM global variable
+/// \param vd       Variable declaration to emit debug info for.
+/// \returns        Created debug info
 llvm::DIGlobalVariable DtoDwarfGlobalVariable(LLGlobalVariable* ll, VarDeclaration* vd);
 
 void DtoDwarfModuleEnd();