Mercurial > hg > openttd
changeset 16091:a9945a283858 draft
(svn r20784) -Doc: Doxyment a few debug line printing functions.
author | alberth <alberth@openttd.org> |
---|---|
date | Sat, 11 Sep 2010 11:48:37 +0000 |
parents | c8af6f6c1e5a |
children | 9e2d9845b808 |
files | src/debug.cpp src/debug.h |
diffstat | 2 files changed, 24 insertions(+), 2 deletions(-) [+] |
line wrap: on
line diff
--- a/src/debug.cpp +++ b/src/debug.cpp @@ -69,6 +69,11 @@ #if !defined(NO_DEBUG_MESSAGES) +/** + * Internal function for outputting the debug line. + * @param dbg Debug category. + * @param buf Text line to output. + */ static void debug_print(const char *dbg, const char *buf) { #if defined(ENABLE_NETWORK) @@ -99,6 +104,12 @@ } } +/** + * Output a debug line. + * @note Do not call directly, use the #DEBUG macro instead. + * @param dbg Debug category. + * @param format Text string a la printf, with optional arguments. + */ void CDECL debug(const char *dbg, const char *format, ...) { char buf[1024]; @@ -112,6 +123,12 @@ } #endif /* NO_DEBUG_MESSAGES */ +/** + * Set debugging levels by parsing the text in \a s. + * For setting individual levels a string like \c "net=3,grf=6" should be used. + * If the string starts with a number, the number is used as global debugging level. + * @param s Text describing the wanted debugging levels. + */ void SetDebugString(const char *s) { int v; @@ -162,8 +179,8 @@ } /** - * Print out the current debug-level - * Just return a string with the values of all the debug categorites + * Print out the current debug-level. + * Just return a string with the values of all the debug categories. * @return string with debug-levels */ const char *GetDebugString()
--- a/src/debug.h +++ b/src/debug.h @@ -29,6 +29,11 @@ #ifdef NO_DEBUG_MESSAGES #define DEBUG(name, level, ...) { } #else /* NO_DEBUG_MESSAGES */ + /** + * Output a line of debugging information. + * @param name Category + * @param level Debugging level, higher levels means more detailed information. + */ #define DEBUG(name, level, ...) if ((level) == 0 || _debug_ ## name ## _level >= (level)) debug(#name, __VA_ARGS__) extern int _debug_ai_level;