From f4c1938af90e7daa612b6169b1b988547d4012ff Mon Sep 17 00:00:00 2001
From: truelight <truelight@openttd.org>
Date: Fri, 8 Jun 2007 18:23:26 +0000
Subject: (svn r10069) -Documentation: some documentation for TIC/TOC, as it
 isn't what I expected...

---
 src/debug.h | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

(limited to 'src/debug.h')

diff --git a/src/debug.h b/src/debug.h
index faac0c09f..c84ec7f46 100644
--- a/src/debug.h
+++ b/src/debug.h
@@ -93,7 +93,27 @@ const char *GetDebugString();
 	#define OTTD_PRINTF64 "ll"
 #endif
 
-/* Used for profiling */
+/* Used for profiling
+ *
+ * Usage:
+ * TIC();
+ *   --Do your code--
+ * TOC("A name", 1);
+ *
+ * When you run the TIC() / TOC() multiple times, you can increase the '1'
+ *  to only display average stats every N values. Some things to know:
+ *
+ * for (int i = 0; i < 5; i++) {
+ *   TIC();
+ *     --Do yuor code--
+ *   TOC("A name", 5);
+ * }
+ *
+ * Is the correct usage for multiple TIC() / TOC() calls.
+ *
+ * TIC() / TOC() creates it's own block, so make sure not the mangle
+ *  it with an other block.
+ **/
 #define TIC() {\
 	extern uint64 _rdtsc();\
 	uint64 _xxx_ = _rdtsc();\
-- 
cgit v1.2.3-54-g00ecf