X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Utils%2FBacktrace.hh;h=f7f8925886b7b630e28e426ee0017688acb45625;hb=92f8630b75f3ef50e73c48cde58645dcd1534e27;hp=b2d39d75a2f56df8bffc85742213452d936d325b;hpb=d5ba3d7759212c90a5f4a25baf0dc38e290c3b64;p=senf.git

diff --git a/Utils/Backtrace.hh b/Utils/Backtrace.hh
index b2d39d7..f7f8925 100644
--- a/Utils/Backtrace.hh
+++ b/Utils/Backtrace.hh
@@ -23,8 +23,8 @@
 /** \file
     \brief Backtrace public header */
 
-#ifndef HH_Backtrace_
-#define HH_Backtrace_ 1
+#ifndef HH_SENF_Utils_Backtrace_
+#define HH_SENF_Utils_Backtrace_ 1
 
 // Custom includes
 #include <iostream>
@@ -33,9 +33,29 @@
 ///////////////////////////////hh.p////////////////////////////////////////
 
 namespace senf {
+    /** \defgroup backtraces Backtrace formatting and parsing
 
+        These functions help format and barse backtrace information as returned by the glibc
+        ::backtrace function.
+     */
+
+    /** \brief Format a given backtrace
+
+        This functions will write \a backtrace formatted to \a os. This includes demangling symbol
+        names and interpreting some additional kernel symbols.
+
+        \ingroup backtraces
+     */
     void formatBacktrace(std::ostream & os, void ** backtrace, unsigned numEntries);
 
+    /** \brief Write a backtrace to \a os
+
+        backtrace() will write a backtrace of the current call stack to \a os.
+
+        \ingroup backtraces
+     */
+    void backtrace(std::ostream & os, unsigned numEntries);
+
 }
 
 ///////////////////////////////hh.e////////////////////////////////////////