From 4d062df20ce3b853319899469adbc37457b15499 Mon Sep 17 00:00:00 2001
From: bernie <bernie@38d2e660-2303-0410-9eaa-f027e97ec537>
Date: Thu, 23 Feb 2006 11:17:16 +0000
Subject: [PATCH] Documentation fixes.

git-svn-id: https://src.develer.com/svnoss/bertos/trunk@548 38d2e660-2303-0410-9eaa-f027e97ec537
---
 cfg/debug.h      | 26 +++++++++++++++-----------
 emul/emulkbd.cpp |  3 +--
 gfx/bitmap.c     | 12 ++++++++++--
 3 files changed, 26 insertions(+), 15 deletions(-)

diff --git a/cfg/debug.h b/cfg/debug.h
index 97913088..3b077448 100755
--- a/cfg/debug.h
+++ b/cfg/debug.h
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.11  2006/02/23 11:17:16  bernie
+ *#* Documentation fixes.
+ *#*
  *#* Revision 1.10  2006/02/23 09:10:10  bernie
  *#* Add even more code duplication until we properly refactor debug.h.
  *#*
@@ -109,18 +112,19 @@
 #define CONFIG_KDEBUG_ASSERT_NO_TEXT  0
 #endif
 
+#if defined(__doxygen__)
+	/**
+	 * Preprocessor symbol defined only for debug builds.
+	 *
+	 * The build infrastructure must arrange for _DEBUG to
+	 * be predefined for all the source files being compiled.
+	 *
+	 * This is compatible with the MSVC convention for the
+	 * default Debug and Release project targets.
+	 */
+	#define _DEBUG 1
+#endif
 
-/*!
- * \def _DEBUG
- *
- * This preprocessor symbol is defined only in debug builds.
- *
- * The build infrastructure must arrange for _DEBUG to
- * be predefined for all source files being compiled.
- *
- * This is compatible with the Microsoft convention for
- * the default Debug and Release targets.
- */
 #ifdef _DEBUG
 
 	// STLport specific: enable extra checks
diff --git a/emul/emulkbd.cpp b/emul/emulkbd.cpp
index 1dfdd9d5..95b70214 100755
--- a/emul/emulkbd.cpp
+++ b/emul/emulkbd.cpp
@@ -57,8 +57,7 @@ EmulKey::~EmulKey()
 
 
 /**
- * \reimp
- * Override standad QButton behaviour: we must also emit the signals
+ * Override standad QButton behaviour: we must also emit the signals.
  */
 // unused
 void EmulKey::setDown(bool enable)
diff --git a/gfx/bitmap.c b/gfx/bitmap.c
index 01ae977a..ccc6f0be 100755
--- a/gfx/bitmap.c
+++ b/gfx/bitmap.c
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/02/23 11:17:16  bernie
+ *#* Documentation fixes.
+ *#*
  *#* Revision 1.5  2006/02/15 09:10:15  bernie
  *#* Implement prop fonts; Fix algo styles.
  *#*
@@ -117,8 +120,13 @@ void gfx_blit_P(Bitmap *bm, const pgm_uint8_t *raster)
  *
  * \note Using the same bitmap for \a src and \a dst is unsupported.
  *
- * \param dst Bitmap where the operation writes
- *
+ * \param dst  Bitmap where the operation writes.
+ * \param rect The (xmin;ymin) coordinates provide the top/left offset
+ *             for drawing in the destination bitmap.  If the source
+ *             bitmap is larger than the rectangle, drawing is clipped.
+ * \param src  Bitmap containing the source pixels.
+ * \param srcx Starting X offset in the source bitmap.
+ * \param srcy Starting Y offset in the source bitmap.
  */
 void gfx_blit(Bitmap *dst, const Rect *rect, const Bitmap *src, coord_t srcx, coord_t srcy)
 {
-- 
2.34.1