From bcf38f772b397e7a8ba781a69aacb9380e54b32a Mon Sep 17 00:00:00 2001
From: bernie <bernie@38d2e660-2303-0410-9eaa-f027e97ec537>
Date: Wed, 19 Jul 2006 12:56:28 +0000
Subject: [PATCH] Convert to new Doxygen style.

git-svn-id: https://src.develer.com/svnoss/bertos/trunk@671 38d2e660-2303-0410-9eaa-f027e97ec537
---
 app/demo/appconfig.h    | 47 +++++++++++++++-------------
 app/demo/verstag.h      | 12 +++----
 app/triface/appconfig.h |  5 ++-
 app/triface/verstag.h   | 12 +++----
 appconfig_common.h      | 47 +++++++++++++++-------------
 cfg/arch_config.h       |  7 +++--
 cfg/compiler.h          |  5 ++-
 cfg/cpu.h               | 15 +++++----
 cfg/cpu_detect.h        |  5 ++-
 cfg/debug.h             | 15 +++++----
 cfg/macros.h            | 25 ++++++++-------
 cfg/module.h            |  2 +-
 cfg/os.h                |  7 +++--
 config.mk               |  8 ++++-
 config_kern.h           | 11 ++++---
 drv/adc.c               |  9 ++++--
 drv/adc.h               |  7 +++--
 drv/buzzer.c            | 15 +++++----
 drv/buzzer.h            |  5 ++-
 drv/buzzerled.c         |  5 ++-
 drv/buzzerled.h         | 15 +++++----
 drv/buzzerled_dsp56k.h  |  7 +++--
 drv/eeprom.c            | 19 +++++++-----
 drv/eeprom.h            | 17 +++++-----
 drv/kbd.c               | 69 +++++++++++++++++++++--------------------
 drv/kbd.h               | 15 +++++----
 drv/kdebug.c            | 11 ++++---
 drv/lcd_gfx.c           | 49 +++++++++++++++--------------
 drv/lcd_gfx.h           |  5 ++-
 drv/lcd_gfx_qt.cpp      |  5 ++-
 drv/lcd_hd44.c          | 21 +++++++------
 drv/lcd_hd44.h          | 27 +++++++++-------
 drv/lcd_text.c          | 21 +++++++------
 drv/lcd_text.h          | 15 +++++----
 drv/ntc.c               | 11 ++++---
 drv/ntc.h               | 33 +++++++++++---------
 drv/phase.c             | 19 +++++++-----
 drv/phase.h             | 15 +++++----
 drv/pwm.c               |  9 ++++--
 drv/pwm.h               |  5 ++-
 drv/ser.c               | 39 ++++++++++++-----------
 drv/ser.h               | 69 +++++++++++++++++++++--------------------
 drv/ser_avr.c           | 57 ++++++++++++++++++----------------
 drv/ser_dsp56k.c        |  5 ++-
 drv/ser_i196.c          |  5 ++-
 drv/ser_p.h             |  5 ++-
 drv/ser_posix.c         |  7 +++--
 drv/ser_simple.c        | 21 +++++++------
 drv/ser_simple.h        | 27 +++++++++-------
 drv/thermo.c            | 31 +++++++++---------
 drv/thermo.h            | 17 +++++-----
 drv/timer.c             | 23 ++++++++------
 drv/timer.h             | 39 ++++++++++++-----------
 drv/timer_avr.c         |  7 +++--
 drv/timer_avr.h         | 27 +++++++++-------
 drv/timer_dsp56k.h      | 11 ++++---
 drv/timer_i196.h        |  7 +++--
 drv/timer_posix.c       |  5 ++-
 drv/timer_posix.h       |  5 ++-
 drv/timer_qt.c          |  5 ++-
 drv/timer_qt.h          |  5 ++-
 drv/timer_simple.c      |  7 +++--
 drv/timer_simple.h      |  5 ++-
 drv/timer_test.c        |  5 ++-
 drv/twi.c               | 21 +++++++------
 drv/twi.h               |  5 ++-
 drv/wdt.h               |  9 ++++--
 dt/dnotifier.c          | 15 +++++----
 dt/dnotifier.h          | 41 ++++++++++++------------
 dt/dtag.h               | 15 +++++----
 dt/dwidget.c            |  7 +++--
 dt/dwidget.h            | 11 ++++---
 dt/editbool.c           | 11 ++++---
 dt/editbool.h           |  5 ++-
 dt/editint.c            | 11 ++++---
 dt/editint.h            |  7 +++--
 fonts/fixed6x8.c        |  5 ++-
 gfx/bitmap.c            | 11 ++++---
 gfx/charts.c            | 11 ++++---
 gfx/charts.h            |  9 ++++--
 gfx/font.h              |  5 ++-
 gfx/gfx.h               | 29 +++++++++--------
 gfx/gfx_p.h             | 13 +++++---
 gfx/line.c              | 29 +++++++++--------
 gfx/text.c              | 15 +++++----
 gfx/text.h              | 19 +++++++-----
 gfx/text_format.c       | 15 +++++----
 gfx/win.c               |  5 ++-
 gfx/win.h               |  5 ++-
 gui/menu.c              |  9 ++++--
 gui/menu.h              | 51 ++++++++++++++++--------------
 hw/hw_buzzer.h          |  5 ++-
 hw/hw_kbd.h             |  5 ++-
 hw/kbd_map.h            | 13 +++++---
 kern/file.h             |  7 +++--
 kern/monitor.c          |  5 ++-
 kern/monitor.h          | 11 ++++---
 kern/msg.h              | 29 +++++++++--------
 kern/proc.c             | 33 +++++++++++---------
 kern/proc.h             |  7 +++--
 kern/proc_p.h           | 43 +++++++++++++------------
 kern/sem.c              | 13 +++++---
 kern/sem.h              |  7 +++--
 kern/signal.c           | 11 ++++---
 kern/signal.h           | 23 ++++++++------
 kern/switch_dsp56k.c    |  5 ++-
 mware/cmd_hunk.h        |  5 ++-
 mware/crc.c             |  7 +++--
 mware/crc.h             | 11 ++++---
 mware/event.c           |  5 ++-
 mware/event.h           | 21 +++++++------
 mware/fifobuf.h         | 25 ++++++++-------
 mware/formatwr.c        | 11 ++++---
 mware/formatwr.h        |  9 ++++--
 mware/hashtable.c       |  7 +++--
 mware/hashtable.h       | 55 ++++++++++++++++----------------
 mware/heap.c            |  7 +++--
 mware/heap.h            | 15 +++++----
 mware/hex.c             |  5 ++-
 mware/hex.h             |  2 +-
 mware/kfile.h           |  5 ++-
 mware/list.h            | 41 ++++++++++++------------
 mware/msg.c             |  9 ++++--
 mware/parser.c          | 15 +++++----
 mware/parser.h          | 13 +++++---
 mware/pgm.h             |  6 ++--
 mware/pool.h            |  5 ++-
 mware/readline.c        | 37 ++++++++++++----------
 mware/readline.h        |  5 ++-
 mware/rle.c             |  9 ++++--
 mware/rle.h             |  5 ++-
 mware/sprintf.c         |  9 ++++--
 mware/sprintf_test.c    |  5 ++-
 mware/strtol10.c        |  9 ++++--
 mware/strtol10.h        |  9 ++++--
 mware/xmodem.c          | 33 +++++++++++---------
 mware/xmodem.h          |  5 ++-
 os/hptime.c             |  5 ++-
 rules.mk                |  4 +++
 verstag.c               |  2 +-
 verstag.h               | 12 +++----
 141 files changed, 1263 insertions(+), 857 deletions(-)

diff --git a/app/demo/appconfig.h b/app/demo/appconfig.h
index 70a02afa..8e2eca46 100755
--- a/app/demo/appconfig.h
+++ b/app/demo/appconfig.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -46,6 +46,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:24  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/05/28 12:18:12  bernie
  *#* Disable menu timeout.
  *#*
@@ -92,10 +95,10 @@
 #ifndef CONFIG_COMMON_H
 #define CONFIG_COMMON_H
 
-/*! Baud-rate for the kdebug console */
+/** Baud-rate for the kdebug console */
 #define CONFIG_KDEBUG_BAUDRATE  19200
 
-/*!
+/**
  * printf()-style formatter configuration.
  *
  * \sa PRINTF_DISABLED
@@ -106,54 +109,54 @@
  */
 #define CONFIG_PRINTF PRINTF_FULL
 
-/*!
+/**
  * Multithreading kernel.
  *
  * \sa config_kern.h
  */
 #define CONFIG_KERNEL 1
 
-/*!
+/**
  * \name Serial driver parameters
  * \{
  */
-	/*! [bytes] Size of the outbound FIFO buffer for port 0. */
+	/** [bytes] Size of the outbound FIFO buffer for port 0. */
 	#define CONFIG_UART0_TXBUFSIZE  32
 
-	/*! [bytes] Size of the inbound FIFO buffer for port 0. */
+	/** [bytes] Size of the inbound FIFO buffer for port 0. */
 	#define CONFIG_UART0_RXBUFSIZE  64
 
-	/*! [bytes] Size of the outbound FIFO buffer for port 1. */
+	/** [bytes] Size of the outbound FIFO buffer for port 1. */
 	#define CONFIG_UART1_TXBUFSIZE  32
 
-	/*! [bytes] Size of the inbound FIFO buffer for port 1. */
+	/** [bytes] Size of the inbound FIFO buffer for port 1. */
 	#define CONFIG_UART1_RXBUFSIZE  64
 
-	/*! [bytes] Size of the outbound FIFO buffer for SPI port (AVR only). */
+	/** [bytes] Size of the outbound FIFO buffer for SPI port (AVR only). */
 	#define CONFIG_SPI_TXBUFSIZE	16
 
-	/*! [bytes] Size of the inbound FIFO buffer for SPI port (AVR only). */
+	/** [bytes] Size of the inbound FIFO buffer for SPI port (AVR only). */
 	#define CONFIG_SPI_RXBUFSIZE	32
 
-	/*! Default transmit timeout (ms). Set to -1 to disable timeout support */
+	/** Default transmit timeout (ms). Set to -1 to disable timeout support */
 	#define CONFIG_SER_TXTIMEOUT    -1
 
-	/*! Default receive timeout (ms). Set to -1 to disable timeout support */
+	/** Default receive timeout (ms). Set to -1 to disable timeout support */
 	#define CONFIG_SER_RXTIMEOUT    -1
 
-	/*! Use RTS/CTS handshake */
+	/** Use RTS/CTS handshake */
 	#define CONFIG_SER_HWHANDSHAKE   0
 
-	/*! Default baud rate (set to 0 to disable) */
+	/** Default baud rate (set to 0 to disable) */
 	#define CONFIG_SER_DEFBAUDRATE   0
 
-	/*! Enable ser_gets() and ser_gets_echo() */
+	/** Enable ser_gets() and ser_gets_echo() */
 	#define CONFIG_SER_GETS          0
 
 	/** Enable second serial port in emulator. */
 	#define CONFIG_EMUL_UART1        0
 
-	/*!
+	/**
 	 * Transmit always something on serial port 0 TX
 	 * to avoid interference when sending burst of data,
 	 * using AVR multiprocessor serial mode
@@ -163,16 +166,16 @@
 	#define CONFIG_SER_STROBE        0
 /*\}*/
 
-//! Hardware timer selection for drv/timer.c
+/// Hardware timer selection for drv/timer.c
 #define CONFIG_TIMER  TIMER_ON_OUTPUT_COMPARE2
 
-//! Debug timer interrupt using a strobe pin.
+/// Debug timer interrupt using a strobe pin.
 #define CONFIG_TIMER_STROBE  0
 
-//! Enable watchdog timer.
+/// Enable watchdog timer.
 #define CONFIG_WATCHDOG  1
 
-//! EEPROM type for drv/eeprom.c
+/// EEPROM type for drv/eeprom.c
 #define CONFIG_EEPROM_TYPE EEPROM_24XX256
 
 /// Select bitmap pixel format.
@@ -196,7 +199,7 @@
 /// Enable key beeps.
 #define CONFIG_KBD_BEEP  1
 
-/*!
+/**
  * \name Type for the chart dataset
  * \{
  */
diff --git a/app/demo/verstag.h b/app/demo/verstag.h
index 5989123d..5777807d 100755
--- a/app/demo/verstag.h
+++ b/app/demo/verstag.h
@@ -29,7 +29,7 @@
 #define VERS_REV   0
 #define VERS_LETTER ""
 
-/*!
+/**
  * If _SNAPSHOT is defined, \c VERS_TAG contains the build date
  * date instead of a numeric version string.
  */
@@ -44,7 +44,7 @@
 #define __STRINGIZE(x) #x
 #define _STRINGIZE(x) __STRINGIZE(x)
 
-/*! Build application version string (i.e.: "1.7.0") */
+/** Build application version string (i.e.: "1.7.0") */
 #define MAKE_VERS(maj,min,rev) _STRINGIZE(maj) "." _STRINGIZE(min) "." _STRINGIZE(rev) VERS_LETTER VERS_DBG
 #ifdef _SNAPSHOT
 	#define VERS_TAG "snapshot" " " __DATE__ " " __TIME__ " " VERS_LETTER " " VERS_DBG
@@ -52,18 +52,18 @@
 	#define VERS_TAG MAKE_VERS(VERS_MAJOR,VERS_MINOR,VERS_REV)
 #endif
 
-/*! Build application version string suitable for MS windows resource files (i.e.: "1, 7, 0, 1") */
+/** Build application version string suitable for MS windows resource files (i.e.: "1, 7, 0, 1") */
 #define MAKE_RCVERS(maj,min,rev,bld) _STRINGIZE(maj) ", " _STRINGIZE(min) ", " _STRINGIZE(rev) ", " _STRINGIZE(bld)
 #define RCVERSION_TAG MAKE_VERS(VERS_MAJOR,VERS_MINOR,VERS_REV)
 
-/*! The revision string (contains VERS_TAG) */
+/** The revision string (contains VERS_TAG) */
 extern const char vers_tag[];
 
-/*! Sequential build number (contains VERS_BUILD) */
+/** Sequential build number (contains VERS_BUILD) */
 extern const int vers_build_nr;
 //extern const char vers_build_str[];
 
-/*! Hostname of the machine used to build this binary (contains VERS_HOST) */
+/** Hostname of the machine used to build this binary (contains VERS_HOST) */
 extern const char vers_host[];
 
 #endif /* DEVLIB_VERSTAG_H */
diff --git a/app/triface/appconfig.h b/app/triface/appconfig.h
index c7ceca08..06f3030a 100755
--- a/app/triface/appconfig.h
+++ b/app/triface/appconfig.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -46,6 +46,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/06/12 21:37:01  marco
  *#* implemented some commands (ver and sleep)
  *#*
diff --git a/app/triface/verstag.h b/app/triface/verstag.h
index 86ea7c43..dc815b8f 100755
--- a/app/triface/verstag.h
+++ b/app/triface/verstag.h
@@ -29,7 +29,7 @@
 #define VERS_REV   0
 #define VERS_LETTER ""
 
-/*!
+/**
  * If _SNAPSHOT is defined, \c VERS_TAG contains the build date
  * date instead of a numeric version string.
  */
@@ -44,7 +44,7 @@
 #define __STRINGIZE(x) #x
 #define _STRINGIZE(x) __STRINGIZE(x)
 
-/*! Build application version string (i.e.: "1.7.0") */
+/** Build application version string (i.e.: "1.7.0") */
 #define MAKE_VERS(maj,min,rev) _STRINGIZE(maj) "." _STRINGIZE(min) "." _STRINGIZE(rev) VERS_LETTER VERS_DBG
 #ifdef _SNAPSHOT
 	#define VERS_TAG "snapshot" " " __DATE__ " " __TIME__ " " VERS_LETTER " " VERS_DBG
@@ -52,18 +52,18 @@
 	#define VERS_TAG MAKE_VERS(VERS_MAJOR,VERS_MINOR,VERS_REV)
 #endif
 
-/*! Build application version string suitable for MS windows resource files (i.e.: "1, 7, 0, 1") */
+/** Build application version string suitable for MS windows resource files (i.e.: "1, 7, 0, 1") */
 #define MAKE_RCVERS(maj,min,rev,bld) _STRINGIZE(maj) ", " _STRINGIZE(min) ", " _STRINGIZE(rev) ", " _STRINGIZE(bld)
 #define RCVERSION_TAG MAKE_VERS(VERS_MAJOR,VERS_MINOR,VERS_REV)
 
-/*! The revision string (contains VERS_TAG) */
+/** The revision string (contains VERS_TAG) */
 extern const char vers_tag[];
 
-/*! Sequential build number (contains VERS_BUILD) */
+/** Sequential build number (contains VERS_BUILD) */
 extern const int vers_build_nr;
 //extern const char vers_build_str[];
 
-/*! Hostname of the machine used to build this binary (contains VERS_HOST) */
+/** Hostname of the machine used to build this binary (contains VERS_HOST) */
 extern const char vers_host[];
 
 #endif /* DEVLIB_VERSTAG_H */
diff --git a/appconfig_common.h b/appconfig_common.h
index fc6a0b22..ee310024 100755
--- a/appconfig_common.h
+++ b/appconfig_common.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -46,6 +46,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:24  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/05/18 00:40:43  bernie
  *#* Rename appconfig.h to appconfig_common.h.
  *#*
@@ -86,10 +89,10 @@
 #ifndef CONFIG_COMMON_H
 #define CONFIG_COMMON_H
 
-/*! Baud-rate for the kdebug console */
+/** Baud-rate for the kdebug console */
 #define CONFIG_KDEBUG_BAUDRATE  19200
 
-/*!
+/**
  * printf()-style formatter configuration.
  *
  * \sa PRINTF_DISABLED
@@ -100,54 +103,54 @@
  */
 #define CONFIG_PRINTF PRINTF_FULL
 
-/*!
+/**
  * Multithreading kernel.
  *
  * \sa config_kern.h
  */
 #define CONFIG_KERNEL 1
 
-/*!
+/**
  * \name Serial driver parameters
  * \{
  */
-	/*! [bytes] Size of the outbound FIFO buffer for port 0. */
+	/** [bytes] Size of the outbound FIFO buffer for port 0. */
 	#define CONFIG_UART0_TXBUFSIZE  32
 
-	/*! [bytes] Size of the inbound FIFO buffer for port 0. */
+	/** [bytes] Size of the inbound FIFO buffer for port 0. */
 	#define CONFIG_UART0_RXBUFSIZE  64
 
-	/*! [bytes] Size of the outbound FIFO buffer for port 1. */
+	/** [bytes] Size of the outbound FIFO buffer for port 1. */
 	#define CONFIG_UART1_TXBUFSIZE  32
 
-	/*! [bytes] Size of the inbound FIFO buffer for port 1. */
+	/** [bytes] Size of the inbound FIFO buffer for port 1. */
 	#define CONFIG_UART1_RXBUFSIZE  64
 
-	/*! [bytes] Size of the outbound FIFO buffer for SPI port (AVR only). */
+	/** [bytes] Size of the outbound FIFO buffer for SPI port (AVR only). */
 	#define CONFIG_SPI_TXBUFSIZE	16
 
-	/*! [bytes] Size of the inbound FIFO buffer for SPI port (AVR only). */
+	/** [bytes] Size of the inbound FIFO buffer for SPI port (AVR only). */
 	#define CONFIG_SPI_RXBUFSIZE	32
 
-	/*! Default transmit timeout (ms). Set to -1 to disable timeout support */
+	/** Default transmit timeout (ms). Set to -1 to disable timeout support */
 	#define CONFIG_SER_TXTIMEOUT    -1
 
-	/*! Default receive timeout (ms). Set to -1 to disable timeout support */
+	/** Default receive timeout (ms). Set to -1 to disable timeout support */
 	#define CONFIG_SER_RXTIMEOUT    -1
 
-	/*! Use RTS/CTS handshake */
+	/** Use RTS/CTS handshake */
 	#define CONFIG_SER_HWHANDSHAKE   0
 
-	/*! Default baud rate (set to 0 to disable) */
+	/** Default baud rate (set to 0 to disable) */
 	#define CONFIG_SER_DEFBAUDRATE   0
 
-	/*! Enable ser_gets() and ser_gets_echo() */
+	/** Enable ser_gets() and ser_gets_echo() */
 	#define CONFIG_SER_GETS          0
 
 	/** Enable second serial port in emulator. */
 	#define CONFIG_EMUL_UART1        0
 
-	/*!
+	/**
 	 * Transmit always something on serial port 0 TX
 	 * to avoid interference when sending burst of data,
 	 * using AVR multiprocessor serial mode
@@ -157,16 +160,16 @@
 	#define CONFIG_SER_STROBE        0
 /*\}*/
 
-//! Hardware timer selection for drv/timer.c
+/// Hardware timer selection for drv/timer.c
 #define CONFIG_TIMER  TIMER_ON_OUTPUT_COMPARE2
 
-//! Debug timer interrupt using a strobe pin.
+/// Debug timer interrupt using a strobe pin.
 #define CONFIG_TIMER_STROBE  0
 
-//! Enable watchdog timer.
+/// Enable watchdog timer.
 #define CONFIG_WATCHDOG  1
 
-//! EEPROM type for drv/eeprom.c
+/// EEPROM type for drv/eeprom.c
 #define CONFIG_EEPROM_TYPE EEPROM_24XX256
 
 /// Select bitmap pixel format.
@@ -190,7 +193,7 @@
 /// Enable key beeps
 #define CONFIG_KBD_BEEP 1
 
-/*!
+/**
  * \name Type for the chart dataset
  * \{
  */
diff --git a/cfg/arch_config.h b/cfg/arch_config.h
index c1307135..53da57c3 100755
--- a/cfg/arch_config.h
+++ b/cfg/arch_config.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/24 00:27:56  bernie
  *#* Remove #error to allow compiling local demo.
  *#*
@@ -38,7 +41,7 @@
 #ifndef ARCH_CONFIG_H
 #define ARCH_CONFIG_H
 
-/*!
+/**
  * \name Architectures
  * \{
  */
diff --git a/cfg/compiler.h b/cfg/compiler.h
index aadb2521..9f5462b3 100755
--- a/cfg/compiler.h
+++ b/cfg/compiler.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.22  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.21  2006/07/19 12:53:43  bernie
  *#* Prune log.
  *#*
diff --git a/cfg/cpu.h b/cfg/cpu.h
index 94928215..66ae5d73 100755
--- a/cfg/cpu.h
+++ b/cfg/cpu.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.15  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.14  2006/07/19 12:54:12  bernie
  *#* Documentation fixes.
  *#*
@@ -372,7 +375,7 @@
 	#define CPU_BYTE_ORDER          CPU_LITTLE_ENDIAN
 	#define CPU_HARVARD             1
 
-	/*!
+	/**
 	 * Initialization value for registers in stack frame.
 	 * The register index is not directly corrispondent to CPU
 	 * register numbers. Index 0 is the SREG register: the initial
@@ -384,7 +387,7 @@
 	#error No CPU_... defined.
 #endif
 
-/*!
+/**
  * Execute \a CODE atomically with respect to interrupts.
  *
  * \see IRQ_SAVE_DISABLE IRQ_RESTORE
@@ -398,7 +401,7 @@
 	} while (0)
 
 
-//! Default for macro not defined in the right arch section
+/// Default for macro not defined in the right arch section
 #ifndef CPU_REG_INIT_VALUE
 	#define CPU_REG_INIT_VALUE(reg)     0
 #endif
@@ -478,7 +481,7 @@
 #endif
 
 
-/*!
+/**
  * \name Default type sizes.
  *
  * These defaults are reasonable for most 16/32bit machines.
@@ -572,7 +575,7 @@ STATIC_ASSERT(sizeof(int64_t) * CPU_BITS_PER_CHAR == 64);
 STATIC_ASSERT(sizeof(uint64_t) * CPU_BITS_PER_CHAR == 64);
 #endif
 
-/*!
+/**
  * \def CPU_IDLE
  *
  * \brief Invoked by the scheduler to stop the CPU when idle.
diff --git a/cfg/cpu_detect.h b/cfg/cpu_detect.h
index 47b029fe..2a285ba3 100755
--- a/cfg/cpu_detect.h
+++ b/cfg/cpu_detect.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -12,6 +12,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/10 12:37:37  bernie
  *#* Add support for ARM on IAR.
  *#*
diff --git a/cfg/debug.h b/cfg/debug.h
index fc811ee5..f31fc556 100755
--- a/cfg/debug.h
+++ b/cfg/debug.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.14  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.13  2006/03/22 13:34:34  bernie
  *#* MSVC support.
  *#*
@@ -129,7 +132,7 @@
 	#undef NDEBUG
 	#endif
 
-	/*!
+	/**
 	 * This macro duplicates the old MSVC trick of redefining
 	 * THIS_FILE locally to avoid the overhead of many duplicate
 	 * strings in ASSERT().
@@ -138,7 +141,7 @@
 		#define THIS_FILE  __FILE__
 	#endif
 
-	/*!
+	/**
 	 * This macro can be used to conditionally exclude one or more
 	 * statements conditioned on \c _DEBUG, avoiding the clutter
 	 * of ifdef/endif pairs.
@@ -291,7 +294,7 @@
 
 	#endif /* !OS_HOSTED */
 
-	/*!
+	/**
 	 * \name Walls to detect data corruption
 	 * \{
 	 */
@@ -303,7 +306,7 @@
 	#define CHECK_WALL(name)             __check_wall((name), countof(name), #name, THIS_FILE, __LINE__)
 	/*\}*/
 
-	/*!
+	/**
 	 * Check that the given pointer actually points to an object
 	 * of the specified type.
 	 */
@@ -312,7 +315,7 @@
 		ASSERT(dynamic_cast<_t>((_o)) != NULL); \
 	}
 
-	/*!
+	/**
 	 * \name Debug object creation and destruction.
 	 *
 	 * These macros help track some kinds of leaks in C++ programs.
diff --git a/cfg/macros.h b/cfg/macros.h
index a017457e..17ee7887 100755
--- a/cfg/macros.h
+++ b/cfg/macros.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.8  2006/03/13 02:06:55  bernie
  *#* ROUND_UP2: Rename from ROUND2.
  *#*
@@ -124,14 +127,14 @@
 	#define MAX(a,b)	(((a) > (b)) ? (a) : (b))
 #endif /* !(COMPILER_STATEMENT_EXPRESSIONS && COMPILER_TYPEOF) */
 
-/*! Bound \a x between \a min and \a max. */
+/** Bound \a x between \a min and \a max. */
 #define MINMAX(min,x,max)  (MIN(MAX(min, x), max))
 
 #ifdef __cplusplus
 	/* Use standard implementation from <algorithm> */
 	#define SWAP(a,b)  std::swap(a, b)
 #elif COMPILER_TYPEOF
-	/*!
+	/**
 	 * Type-generic macro to swap \a a with \a b.
 	 *
 	 * \note Arguments are evaluated multiple times.
@@ -156,7 +159,7 @@
 #endif /* COMPILER_TYPEOF */
 
 #ifndef BV
-	/*! Convert a bit value to a binary flag. */
+	/** Convert a bit value to a binary flag. */
 	#define BV(x)  (1<<(x))
 #endif
 
@@ -166,7 +169,7 @@
 /* OBSOLETE */
 #define ROUND2 ROUND_UP2
 
-/*!
+/**
  * \name Integer round macros.
  *
  * Round \a x to a multiple of \a base.
@@ -181,7 +184,7 @@
 /** Check if \a x is an integer power of 2. */
 #define IS_POW2(x)     (!(bool)((x) & ((x)-1)))
 
-/*! Calculate a compile-time log2 for a uint8_t */
+/** Calculate a compile-time log2 for a uint8_t */
 #define UINT8_LOG2(x) \
 	((x) < 2 ? 0 : \
 	 ((x) < 4 ? 1 : \
@@ -191,16 +194,16 @@
 	     ((x) < 64 ? 5 : \
 	      ((x) < 128 ? 6 : 7)))))))
 
-/*! Calculate a compile-time log2 for a uint16_t */
+/** Calculate a compile-time log2 for a uint16_t */
 #define UINT16_LOG2(x) \
 	((x < 256) ? UINT8_LOG2(x) : UINT8_LOG2((x) >> 8) + 8)
 
-/*! Calculate a compile-time log2 for a uint32_t */
+/** Calculate a compile-time log2 for a uint32_t */
 #define UINT32_LOG2(x) \
 	((x < 65536UL) ? UINT16_LOG2(x) : UINT16_LOG2((x) >> 16) + 16)
 
 #if COMPILER_VARIADIC_MACROS
-	/*! Count the number of arguments (up to 16). */
+	/** Count the number of arguments (up to 16). */
 	#define PP_COUNT(...) \
 		PP_COUNT__(__VA_ARGS__,16,15,14,13,12,11,10,9,8,7,6,5,4,3,2,1,0)
 	#define PP_COUNT__(a0,a1,a2,a3,a4,a5,a6,a7,a8,a9,a10,a11,a12,a13,a14,a15,count,...) \
@@ -208,7 +211,7 @@
 #endif
 
 #if COMPILER_VARIADIC_MACROS
-	/*!
+	/**
 	 * \def BIT_CHANGE(reg, (mask, value), ...)
 	 *
 	 * This macro allows for efficient and compact bit toggling in a hardware
@@ -247,7 +250,7 @@
 	 * for use with C90 compilers, through Boost Preprocessor.
 	 */
 
-	/*!
+	/**
 	 * \def BIT_CHANGE_BV(reg, (bit, value), ...)
 	 *
 	 * Similar to BIT_CHANGE(), but get bits instead of masks (and applies BV() to convert
diff --git a/cfg/module.h b/cfg/module.h
index 31bb07f2..750368aa 100755
--- a/cfg/module.h
+++ b/cfg/module.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2006 Develer S.r.l. (http://www.develer.com/)
diff --git a/cfg/os.h b/cfg/os.h
index eb82043a..249a947a 100755
--- a/cfg/os.h
+++ b/cfg/os.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.10  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.9  2006/03/22 13:34:34  bernie
  *#* MSVC support.
  *#*
@@ -48,7 +51,7 @@
 #ifndef DEVLIB_OS_H
 #define DEVLIB_OS_H
 
-/*! Macro to include OS-specific versions of the headers. */
+/** Macro to include OS-specific versions of the headers. */
 #define OS_HEADER(module)  PP_STRINGIZE(PP_CAT3(module, _, OS_ID).h)
 #define OS_CSOURCE(module) PP_STRINGIZE(PP_CAT3(module, _, OS_ID).c)
 
diff --git a/config.mk b/config.mk
index fec9b52d..dd3128d3 100755
--- a/config.mk
+++ b/config.mk
@@ -10,6 +10,9 @@
 # Author: Bernardo Innocenti <bernie@develer.com>
 #
 # $Log$
+# Revision 1.7  2006/07/19 12:56:24  bernie
+# Convert to new Doxygen style.
+#
 # Revision 1.6  2006/06/12 22:05:09  marco
 # Bring back config wrongly commited
 #
@@ -36,6 +39,9 @@ DPROG = -V -c stk500 -P /dev/ttyS0
 # STK200 parallel cable
 #DPROG = -c stk200 -E noreset
 
+# JTAG ICE mkII
+#DPROG = avarice --mkII -j usb -l
+
 # PonyProg serial programmer
 #DPROG = -c dasa2
 
@@ -50,7 +56,7 @@ DEBUGCFLAGS = -ggdb
 #
 # define some variables based on the AVR base path in $(AVR)
 #
-CROSS   = 
+CROSS   = avr-
 CC      = $(CROSS)gcc
 AS      = $(CC) -x assembler-with-cpp
 LD      = $(CC)
diff --git a/config_kern.h b/config_kern.h
index 420a48e8..06779c27 100755
--- a/config_kern.h
+++ b/config_kern.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2001,2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:24  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2006/02/21 16:05:53  bernie
  *#* Move from cfg/ to top-level.
  *#*
@@ -49,7 +52,7 @@
 
 #include <cfg/arch_config.h>  /* ARCH_EMUL */
 
-/*!
+/**
  * \name Modules activation
  *
  * \{
@@ -66,12 +69,12 @@
 /* EXPERIMENTAL */
 #define CONFIG_KERN_PREEMPTIVE  (0    && CONFIG_KERN_SCHED && CONFIG_KERN_TIMER)
 
-#define CONFIG_KERN_QUANTUM     50    /*!< Time sharing quantum in timer ticks. */
+#define CONFIG_KERN_QUANTUM     50    /**< Time sharing quantum in timer ticks. */
 
 #if (ARCH & ARCH_EMUL)
 	#define CONFIG_KERN_DEFSTACKSIZE  65536
 #else
-	#define CONFIG_KERN_DEFSTACKSIZE  128  /*!< Default stack size for each thread. */
+	#define CONFIG_KERN_DEFSTACKSIZE  128  /**< Default stack size for each thread. */
 #endif
 
 /* Memory fill codes to help debugging */
diff --git a/drv/adc.c b/drv/adc.c
index c775e161..dffb9ce4 100755
--- a/drv/adc.c
+++ b/drv/adc.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/06/27 21:28:31  bernie
  *#* Import ADC driver.
  *#*
@@ -31,7 +34,7 @@
 
 DB(bool adc_initialized = false;)
 
-/*!
+/**
  * Read the ADC channel \a ch.
  */
 adcread_t adc_read(uint16_t ch)
@@ -44,7 +47,7 @@ adcread_t adc_read(uint16_t ch)
 	return(adc_hw_read());
 }
 
-/*!
+/**
  * Initialize the ADC hardware.
  */
 void adc_init(void)
diff --git a/drv/adc.h b/drv/adc.h
index d87a2687..6a36683d 100755
--- a/drv/adc.h
+++ b/drv/adc.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/06/27 21:28:31  bernie
  *#* Import ADC driver.
  *#*
@@ -27,7 +30,7 @@
 #include <cfg/compiler.h>
 #include <cfg/debug.h>
 
-/*!Type for ADC return value. */
+/**Type for ADC return value. */
 typedef uint16_t adcread_t;
 
 #define adc_bits() ADC_BITS
diff --git a/drv/buzzer.c b/drv/buzzer.c
index f5d047b6..940bad6a 100755
--- a/drv/buzzer.c
+++ b/drv/buzzer.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.19  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.18  2006/02/17 21:15:25  bernie
  *#* Add MOD_CHECK() checks.
  *#*
@@ -66,7 +69,7 @@ static mtime_t buz_repeat_interval;
 static mtime_t buz_repeat_duration;
 
 
-/*!
+/**
  * Turn off buzzer, called by software timer
  */
 static void buz_softint(void)
@@ -95,7 +98,7 @@ static void buz_softint(void)
 }
 
 
-/*!
+/**
  * Beep for the specified ms time
  */
 void buz_beep(mtime_t time)
@@ -119,7 +122,7 @@ void buz_beep(mtime_t time)
 }
 
 
-/*!
+/**
  * Start buzzer repetition
  */
 void buz_repeat_start(mtime_t duration, mtime_t interval)
@@ -130,7 +133,7 @@ void buz_repeat_start(mtime_t duration, mtime_t interval)
 }
 
 
-/*!
+/**
  * Stop buzzer repetition
  */
 void buz_repeat_stop(void)
@@ -153,7 +156,7 @@ void buz_repeat_stop(void)
 
 MOD_DEFINE(buzzer)
 
-/*!
+/**
  * Initialize buzzer.
  */
 void buz_init(void)
diff --git a/drv/buzzer.h b/drv/buzzer.h
index 65c02d8e..f7118ab4 100755
--- a/drv/buzzer.h
+++ b/drv/buzzer.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.10  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.9  2005/11/27 23:32:15  bernie
  *#* Update copyright information.
  *#*
diff --git a/drv/buzzerled.c b/drv/buzzerled.c
index 3e8841c4..92f5dfa0 100755
--- a/drv/buzzerled.c
+++ b/drv/buzzerled.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -27,6 +27,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/drv/buzzerled.h b/drv/buzzerled.h
index aa1c7afd..012def4e 100755
--- a/drv/buzzerled.h
+++ b/drv/buzzerled.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -43,7 +46,7 @@
 
 #include <cfg/cpu.h>
 
-/*! Include hw.h. We expect hw.h to define enum BLD_DEVICE, which must contain
+/** Include hw.h. We expect hw.h to define enum BLD_DEVICE, which must contain
  *  an enumarator for each device, plus a special symbol NUM_BLDS containing the
  *  number of devices.
  */
@@ -57,14 +60,14 @@
 #include CPU_HEADER(buzzerled)
 
 
-/*! Initialize the buzzerled library.
+/** Initialize the buzzerled library.
  *
  * \note This function must be called before any other function in the library.
  */
 void bld_init(void);
 
 
-/*! Set or reset a device.
+/** Set or reset a device.
  *
  * \param device Device to be set
  * \param enable Enable/disable status
@@ -72,7 +75,7 @@ void bld_init(void);
 #define bld_set(device, enable)  bld_hw_set(device, enable)
 
 
-/*! Enable a device for a certain interval of time
+/** Enable a device for a certain interval of time
  *
  * \param device Device to be enabled
  * \param duration Number of milliseconds the device must be enabled
@@ -82,7 +85,7 @@ void bld_init(void);
 void bld_beep(enum BLD_DEVICE device, uint16_t duration);
 
 
-/*! Enable a device for a certain interval of time and wait.
+/** Enable a device for a certain interval of time and wait.
  *
  * \param device Device to be enabled
  * \param duration Number of milliseconds the device must be enabled
diff --git a/drv/buzzerled_dsp56k.h b/drv/buzzerled_dsp56k.h
index f1b0ba27..3a7a2bf8 100755
--- a/drv/buzzerled_dsp56k.h
+++ b/drv/buzzerled_dsp56k.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -44,7 +47,7 @@
 
 #if ARCH & ARCH_HECO
 
-/*!
+/**
  * \name Connection of the leds to the DSP:
  * <pre>
  *   Led       Line    DSP Pin
diff --git a/drv/eeprom.c b/drv/eeprom.c
index 9eeb011a..fb83a071 100755
--- a/drv/eeprom.c
+++ b/drv/eeprom.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.20  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.19  2006/03/20 17:49:50  bernie
  *#* Make the TWI driver more generic to work with devices other than EEPROMS.
  *#*
@@ -68,7 +71,7 @@
 
 
 
-/*!
+/**
  * Copy \c count bytes from buffer \c buf to
  * eeprom at address \c addr.
  */
@@ -134,7 +137,7 @@ static bool eeprom_writeRaw(e2addr_t addr, const void *buf, size_t count)
 
 
 #if CONFIG_EEPROM_VERIFY
-/*!
+/**
  * Check that the contents of an EEPROM range
  * match with a provided data buffer.
  *
@@ -194,7 +197,7 @@ bool eeprom_write(e2addr_t addr, const void *buf, size_t count)
 }
 
 
-/*!
+/**
  * Copy \c count bytes at address \c addr
  * from eeprom to RAM to buffer \c buf.
  *
@@ -240,7 +243,7 @@ bool eeprom_read(e2addr_t addr, void *buf, size_t count)
 }
 
 
-/*!
+/**
  * Write a single character \a c at address \a addr.
  */
 bool eeprom_write_char(e2addr_t addr, char c)
@@ -249,7 +252,7 @@ bool eeprom_write_char(e2addr_t addr, char c)
 }
 
 
-/*!
+/**
  * Read a single character at address \a addr.
  *
  * \return the requested character or -1 in case of failure.
@@ -265,7 +268,7 @@ int eeprom_read_char(e2addr_t addr)
 }
 
 
-/*!
+/**
  * Erase specified part of eeprom, writing 0xFF.
  *
  * \param addr   starting address
@@ -290,7 +293,7 @@ void eeprom_erase(e2addr_t addr, size_t count)
 }
 
 
-/*!
+/**
  * Initialize TWI module.
  */
 void eeprom_init(void)
diff --git a/drv/eeprom.h b/drv/eeprom.h
index ec2f5286..c41519d7 100755
--- a/drv/eeprom.h
+++ b/drv/eeprom.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.8  2005/11/27 23:33:40  bernie
  *#* Use appconfig.h instead of cfg/config.h.
  *#*
@@ -46,7 +49,7 @@
 #include <cfg/compiler.h>
 #include <appconfig.h>
 
-/*!
+/**
  * \name Values for CONFIG_EEPROM_TYPE
  * \{
  */
@@ -55,16 +58,16 @@
 /*\}*/
 
 #if CONFIG_EEPROM_TYPE == EEPROM_24XX16
-	#define EEPROM_BLKSIZE   0x10 //!< Eeprom block size (16byte)
-	#define EEPROM_SIZE     0x800 //!< Eeprom total size (2kB)
+	#define EEPROM_BLKSIZE   0x10 ///< Eeprom block size (16byte)
+	#define EEPROM_SIZE     0x800 ///< Eeprom total size (2kB)
 #elif CONFIG_EEPROM_TYPE == EEPROM_24XX256
-	#define EEPROM_BLKSIZE   0x40 //!< Eeprom block size (64byte)
-	#define EEPROM_SIZE    0x8000 //!< Eeprom total size (32kB)
+	#define EEPROM_BLKSIZE   0x40 ///< Eeprom block size (64byte)
+	#define EEPROM_SIZE    0x8000 ///< Eeprom total size (32kB)
 #else
 	#error Unsupported EEPROM type.
 #endif
 
-//! Type for EEPROM addresses
+/// Type for EEPROM addresses
 typedef uint16_t e2addr_t;
 
 bool eeprom_write(e2addr_t addr, const void *buf, size_t count);
diff --git a/drv/kbd.c b/drv/kbd.c
index 4dabd3b3..6f51f4c8 100755
--- a/drv/kbd.c
+++ b/drv/kbd.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2006/06/03 13:57:36  bernie
  *#* Make keyboard repeat mask run-time configurable.
  *#*
@@ -64,38 +67,38 @@
 	#include <drv/buzzer.h>
 #endif
 
-#define KBD_CHECK_INTERVAL  10  /*!< (ms) Timing for kbd softint */
-#define KBD_DEBOUNCE_TIME   30  /*!< (ms) Debounce time */
-#define KBD_BEEP_TIME        5  /*!< (ms) Duration of keybeep */
+#define KBD_CHECK_INTERVAL  10  /**< (ms) Timing for kbd softint */
+#define KBD_DEBOUNCE_TIME   30  /**< (ms) Debounce time */
+#define KBD_BEEP_TIME        5  /**< (ms) Duration of keybeep */
 
-#define KBD_REPEAT_DELAY   400  /*!< (ms) Keyboard repeat delay for first character */
-#define KBD_REPEAT_RATE    100  /*!< (ms) Initial interchar delay for keyboard repeat */
-#define KBD_REPEAT_MAXRATE  20  /*!< (ms) Minimum delay for keyboard repeat */
-#define KBD_REPEAT_ACCEL     5  /*!< (ms) Keyboard repeat speed increase */
+#define KBD_REPEAT_DELAY   400  /**< (ms) Keyboard repeat delay for first character */
+#define KBD_REPEAT_RATE    100  /**< (ms) Initial interchar delay for keyboard repeat */
+#define KBD_REPEAT_MAXRATE  20  /**< (ms) Minimum delay for keyboard repeat */
+#define KBD_REPEAT_ACCEL     5  /**< (ms) Keyboard repeat speed increase */
 
-#define KBD_LNG_DELAY     1000  /*!< (ms) Keyboard long pression keys delay */
+#define KBD_LNG_DELAY     1000  /**< (ms) Keyboard long pression keys delay */
 
 
-/*! Status for keyboard repeat state machine */
+/** Status for keyboard repeat state machine */
 static enum { KS_IDLE, KS_REPDELAY, KS_REPEAT } kbd_rptStatus;
 
 
-static volatile keymask_t kbd_buf; /*!< Single entry keyboard buffer */
-static volatile keymask_t kbd_cnt; /*!< Number of keypress events in \c kbd_buf */
+static volatile keymask_t kbd_buf; /**< Single entry keyboard buffer */
+static volatile keymask_t kbd_cnt; /**< Number of keypress events in \c kbd_buf */
 static keymask_t kbd_rpt_mask;     /**< Mask of repeatable keys. */
 
 #if CONFIG_KBD_POLL == KBD_POLL_SOFTINT
-static Timer kbd_timer;            /*!< Keyboard softtimer */
+static Timer kbd_timer;            /**< Keyboard softtimer */
 #endif
 
-static List kbd_rawHandlers;       /*!< Raw keyboard handlers */
-static List kbd_handlers;          /*!< Cooked keyboard handlers */
+static List kbd_rawHandlers;       /**< Raw keyboard handlers */
+static List kbd_handlers;          /**< Cooked keyboard handlers */
 
-static KbdHandler kbd_defHandler;  /*!< The default keyboard handler */
-static KbdHandler kbd_debHandler;  /*!< The debounce keyboard handler */
-static KbdHandler kbd_rptHandler;  /*!< Auto-repeat keyboard handler */
+static KbdHandler kbd_defHandler;  /**< The default keyboard handler */
+static KbdHandler kbd_debHandler;  /**< The debounce keyboard handler */
+static KbdHandler kbd_rptHandler;  /**< Auto-repeat keyboard handler */
 #ifdef  K_LNG_MASK
-static KbdHandler kbd_lngHandler;  /*!< Long pression keys handler */
+static KbdHandler kbd_lngHandler;  /**< Long pression keys handler */
 #endif
 
 #if CONFIG_KBD_OBSERVER
@@ -104,7 +107,7 @@ static KbdHandler kbd_lngHandler;  /*!< Long pression keys handler */
 #endif
 
 
-/*!
+/**
  * Poll keyboard and dispatch keys to handlers.
  *
  * Read the key states and invoke all keyboard
@@ -115,7 +118,7 @@ static KbdHandler kbd_lngHandler;  /*!< Long pression keys handler */
  */
 static void kbd_poll(void)
 {
-	/*! Currently depressed key */
+	/** Currently depressed key */
 	static keymask_t current_key;
 
 	struct KbdHandler *handler;
@@ -139,7 +142,7 @@ static void kbd_poll(void)
 
 #if CONFIG_KBD_POLL == KBD_POLL_SOFTINT
 
-/*!
+/**
  * Keyboard soft-irq handler.
  */
 static void kbd_softint(UNUSED_ARG(iptr_t, arg))
@@ -164,7 +167,7 @@ static portTASK_FUNCTION(kbd_task, arg)
 
 #endif /* CONFIG_KBD_POLL */
 
-/*!
+/**
  * \brief Read a key from the keyboard buffer.
  *
  * When a key is kept depressed between calls of this function a value
@@ -197,7 +200,7 @@ keymask_t kbd_peek(void)
 	return key;
 }
 
-/*!
+/**
  * Wait for a keypress and return the mask of depressed keys.
  *
  * \note This function is \b not interrupt safe!
@@ -212,7 +215,7 @@ keymask_t kbd_get(void)
 }
 
 
-/*!
+/**
  * Wait up to \c timeout ms for a keypress
  * and return the mask of depressed keys, or K_TIMEOUT
  * if the timeout was reacked.
@@ -268,7 +271,7 @@ void kbd_remHandler(struct KbdHandler *handler)
 }
 
 
-/*!
+/**
  * This is the default key handler, called after
  * all other handlers have had their chance to
  * do their special processing. This handler
@@ -296,18 +299,18 @@ static keymask_t kbd_defHandlerFunc(keymask_t key)
 	return 0;
 }
 
-/*!
+/**
  * Handle keyboard debounce
  */
 static keymask_t kbd_debHandlerFunc(keymask_t key)
 {
-	/*! Buffer for debounce */
+	/** Buffer for debounce */
 	static keymask_t debounce_key;
 
-	/*! Timer for keyboard debounce */
+	/** Timer for keyboard debounce */
 	static ticks_t debounce_time;
 
-	/*! Key aquired after debounce */
+	/** Key aquired after debounce */
 	static keymask_t new_key;
 
 
@@ -359,7 +362,7 @@ keymask_t kbd_setRepeatMask(keymask_t mask)
 	return oldmask;
 }
 
-/*!
+/**
  * Handle keyboard repeat
  */
 static keymask_t kbd_rptHandlerFunc(keymask_t key)
@@ -368,7 +371,7 @@ static keymask_t kbd_rptHandlerFunc(keymask_t key)
 	static ticks_t repeat_time;
 
 	/* Current repeat rate (for acceleration). */
-	static ticks_t repeat_rate; /*! Current repeat rate (for acceleration) */
+	static ticks_t repeat_rate; /** Current repeat rate (for acceleration) */
 
 	ticks_t now = timer_clock();
 
@@ -427,7 +430,7 @@ static keymask_t kbd_rptHandlerFunc(keymask_t key)
 
 MOD_DEFINE(kbd)
 
-/*!
+/**
  * Initialize keyboard ports and softtimer
  */
 void kbd_init(void)
diff --git a/drv/kbd.h b/drv/kbd.h
index b9a253c3..f6193738 100755
--- a/drv/kbd.h
+++ b/drv/kbd.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2006/06/03 13:57:36  bernie
  *#* Make keyboard repeat mask run-time configurable.
  *#*
@@ -51,18 +54,18 @@
 #define KBD_POLL_FREERTOS 2
 /* \} */
 
-/*!
+/**
  * Keyboard handler descriptor
  */
 typedef struct KbdHandler
 {
 	Node link;
-	keymask_t (*hook)(keymask_t);   /*!< Hook function */
-	int8_t pri;                     /*!< Priority in input queue */
-	uint8_t flags;                  /*!< See below for definitions */
+	keymask_t (*hook)(keymask_t);   /**< Hook function */
+	int8_t pri;                     /**< Priority in input queue */
+	uint8_t flags;                  /**< See below for definitions */
 } KbdHandler;
 
-#define KHF_RAWKEYS	BV(0)           /*!< Handler gets raw key events */
+#define KHF_RAWKEYS	BV(0)           /**< Handler gets raw key events */
 
 
 void kbd_init(void);
diff --git a/drv/kdebug.c b/drv/kdebug.c
index 729c9ec0..bd21cbbb 100755
--- a/drv/kdebug.c
+++ b/drv/kdebug.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.28  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.27  2006/06/01 12:32:06  marco
  *#* Updated include reference.
  *#*
@@ -240,7 +243,7 @@ void kdbg_init(void)
 }
 
 
-/*!
+/**
  * Output one character to the debug console
  */
 static void __kputchar(char c, UNUSED_ARG(void *, unused))
@@ -313,7 +316,7 @@ void PGM_FUNC(kputs)(const char * PGM_ATTR str)
 }
 
 
-/*!
+/**
  * Cheap function to print small integers without using printf().
  */
 int kputnum(int num)
@@ -426,7 +429,7 @@ int PGM_FUNC(__check_wall)(long *wall, int size, const char * PGM_ATTR name, con
 
 #if CONFIG_PRINTF
 
-/*!
+/**
  * Dump binary data in hex
  */
 void kdump(const void *_buf, size_t len)
diff --git a/drv/lcd_gfx.c b/drv/lcd_gfx.c
index 2054e41c..3a5135c6 100755
--- a/drv/lcd_gfx.c
+++ b/drv/lcd_gfx.c
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.5  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.4  2006/04/27 05:40:11  bernie
  *#* Naming convention fixes; Partial merge from project_grl.
  *#*
@@ -54,18 +57,18 @@
 
 #if CONFIG_LCD_SOFTINT_REFRESH
 
-	/*! Interval between softint driven lcd refresh */
+	/** Interval between softint driven lcd refresh */
 #	define LCD_REFRESH_INTERVAL 20  /* 20ms -> 50fps */
 
 #endif /* CONFIG_LCD_SOFTINT_REFRESH */
 
-/*! Number of LCD pages */
+/** Number of LCD pages */
 #define LCD_PAGES 4
 
-/*! Width of an LCD page */
+/** Width of an LCD page */
 #define LCD_PAGESIZE (LCD_WIDTH / 2)
 
-/*!
+/**
  * \name LCD I/O pins/ports
  * @{
  */
@@ -83,7 +86,7 @@
 #define LCD_PE_E2    PE6
 /*@}*/
 
-/*!
+/**
  * \name DB high nibble (DB[4-7])
  * @{
  */
@@ -94,7 +97,7 @@
 #define LCD_DATA_HI_MASK    0xF0
 /*@}*/
 
-/*!
+/**
  * \name DB low nibble (DB[0-3])
  * @{
  */
@@ -105,7 +108,7 @@
 #define LCD_DATA_LO_MASK    0xF0
 /*@}*/
 
-/*!
+/**
  * \name LCD bus control macros
  * @{
  */
@@ -121,7 +124,7 @@
 #define LCD_CLR_E(x) (PORTE &= ~(x))
 /*@}*/
 
-/*!
+/**
  * \name Chip select bits for LCD_SET_E()
  * @{
  */
@@ -129,41 +132,41 @@
 #define LCDF_E2 (BV(LCD_PE_E2))
 /*@}*/
 
-/*! Read from the LCD data bus (DB[0-7]) */
+/** Read from the LCD data bus (DB[0-7]) */
 #define LCD_READ ( \
 		((LCD_DATA_LO_PIN & LCD_DATA_LO_MASK) >> LCD_DATA_LO_SHIFT) | \
 		((LCD_DATA_HI_PIN & LCD_DATA_HI_MASK) >> LCD_DATA_HI_SHIFT) \
 	)
 
-/*! Write to the LCD data bus (DB[0-7]) */
+/** Write to the LCD data bus (DB[0-7]) */
 #define LCD_WRITE(d) \
 	do { \
 		LCD_DATA_LO_PORT = (LCD_DATA_LO_PORT & ~LCD_DATA_LO_MASK) | (((d)<<LCD_DATA_LO_SHIFT) & LCD_DATA_LO_MASK); \
 		LCD_DATA_HI_PORT = (LCD_DATA_HI_PORT & ~LCD_DATA_HI_MASK) | (((d)<<LCD_DATA_HI_SHIFT) & LCD_DATA_HI_MASK); \
 	} while (0)
 
-/*! Set data bus direction to output (write to display) */
+/** Set data bus direction to output (write to display) */
 #define LCD_DB_OUT \
 	do { \
 		LCD_DATA_LO_DDR |= LCD_DATA_LO_MASK; \
 		LCD_DATA_HI_DDR |= LCD_DATA_HI_MASK; \
 	} while (0)
 
-/*! Set data bus direction to input (read from display) */
+/** Set data bus direction to input (read from display) */
 #define LCD_DB_IN \
 	do { \
 		LCD_DATA_LO_DDR &= ~LCD_DATA_LO_MASK; \
 		LCD_DATA_HI_DDR &= ~LCD_DATA_HI_MASK; \
 	} while (0)
 
-/*! Delay for tEW (160ns) */
+/** Delay for tEW (160ns) */
 #define LCD_DELAY_WRITE \
 	do { \
 		NOP; \
 		NOP; \
 	} while (0)
 
-/*! Delay for tACC6 (180ns) */
+/** Delay for tACC6 (180ns) */
 #define LCD_DELAY_READ \
 	do { \
 		NOP; \
@@ -172,7 +175,7 @@
 	} while (0)
 
 
-/*!
+/**
  * \name 32122A Commands
  * @{
  */
@@ -199,7 +202,7 @@ MOD_DEFINE(lcd)
 #define LCDF_BUSY BV(7)
 
 #if CONFIG_LCD_WAIT
-/*!
+/**
  * \code
  *      __              __
  * RS   __\____________/__
@@ -236,7 +239,7 @@ MOD_DEFINE(lcd)
 #endif /* CONFIG_LCD_WAIT */
 
 
-/*!
+/**
  * Raster buffer to draw into.
  *
  * Bits in the bitmap bytes have vertical orientation,
@@ -246,13 +249,13 @@ DECLARE_WALL(wall_before_raster, WALL_SIZE)
 static uint8_t lcd_raster[RASTER_SIZE(LCD_WIDTH, LCD_HEIGHT)];
 DECLARE_WALL(wall_after_raster, WALL_SIZE)
 
-/*! Default LCD bitmap */
+/** Default LCD bitmap */
 struct Bitmap lcd_bitmap;
 
 
 #if CONFIG_LCD_SOFTINT_REFRESH
 
-/*! Timer for regular LCD refresh */
+/** Timer for regular LCD refresh */
 static Timer *lcd_refresh_timer;
 
 #endif /* CONFIG_LCD_SOFTINT_REFRESH */
@@ -311,7 +314,7 @@ static inline uint8_t lcd_read(uint8_t chip)
 
 	WAIT_LCD;
 
-	/*!
+	/**
 	 * \code
 	 *      __________________
 	 * A0   __/            \__
@@ -343,7 +346,7 @@ static inline void lcd_write(uint8_t c, uint8_t chip)
 {
 	WAIT_LCD;
 
-	/*!
+	/**
 	 * \code
 	 *      __________________
 	 * A0   ___/          \___
@@ -367,7 +370,7 @@ static inline void lcd_write(uint8_t c, uint8_t chip)
 }
 
 
-/*!
+/**
  * Set LCD contrast PWM.
  */
 void lcd_setPwm(int duty)
@@ -440,7 +443,7 @@ static void lcd_refreshSoftint(void)
 #endif /* CONFIG_LCD_SOFTINT_REFRESH */
 
 
-/*!
+/**
  * Initialize LCD subsystem.
  *
  * \note The PWM used for LCD contrast is initialized in drv/pwm.c
diff --git a/drv/lcd_gfx.h b/drv/lcd_gfx.h
index 98cdfe1e..77bf8f8f 100755
--- a/drv/lcd_gfx.h
+++ b/drv/lcd_gfx.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2006/04/27 05:40:11  bernie
  *#* Naming convention fixes; Partial merge from project_grl.
  *#*
diff --git a/drv/lcd_gfx_qt.cpp b/drv/lcd_gfx_qt.cpp
index 16d1eab8..48456fce 100755
--- a/drv/lcd_gfx_qt.cpp
+++ b/drv/lcd_gfx_qt.cpp
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.8  2006/05/28 12:17:57  bernie
  *#* Drop almost all the Qt3 cruft.
  *#*
@@ -144,7 +147,7 @@ DECLARE_WALL(wall_before_raster, WALL_SIZE)
 static uint8_t lcd_raster[RASTER_SIZE(EmulLCD::WIDTH, EmulLCD::HEIGHT)];
 DECLARE_WALL(wall_after_raster, WALL_SIZE)
 
-/*! Default LCD bitmap */
+/** Default LCD bitmap */
 struct Bitmap lcd_bitmap;
 
 /*extern "C"*/ void lcd_init(void)
diff --git a/drv/lcd_hd44.c b/drv/lcd_hd44.c
index ecfea365..de7bdf7a 100755
--- a/drv/lcd_hd44.c
+++ b/drv/lcd_hd44.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:00:42  bernie
  *#* Import into DevLib.
  *#*
@@ -46,10 +49,10 @@
 	#error Incomplete or missing LCD_READ/LCD_WRITE macros
 #endif
 
-/*! Flag di stato del display */
+/** Flag di stato del display */
 #define LCDF_BUSY  BV(7)
 
-/*!
+/**
  * Addresses of LCD display character positions, expanded
  * for faster access (DB7 = 1).
  */
@@ -97,7 +100,7 @@ static const uint8_t lcd_address[] =
 
 STATIC_ASSERT(countof(lcd_address) == LCD_ROWS * LCD_COLS);
 
-/*!
+/**
  * Current display position. We remember this to optimize
  * LCD output by avoiding to set the address every time.
  */
@@ -260,7 +263,7 @@ extern uint8_t Emul_LCDReadData(void);
 #endif /* ARCH_EMUL */
 
 
-/*!
+/**
  * Wait until the LCD busy flag clears.
  */
 void lcd_waitBusy(void)
@@ -274,7 +277,7 @@ void lcd_waitBusy(void)
 }
 
 
-/*!
+/**
  * Move the cursor to \a addr, only if not already there.
  */
 void lcd_moveTo(uint8_t addr)
@@ -288,7 +291,7 @@ void lcd_moveTo(uint8_t addr)
 }
 
 
-/*!
+/**
  * Write a value in LCD data register, waiting for the busy flag.
  */
 void lcd_setReg(uint8_t val)
@@ -298,7 +301,7 @@ void lcd_setReg(uint8_t val)
 }
 
 #include <cfg/debug.h>
-/*!
+/**
  * Write the character \a c on display address \a addr.
  *
  * NOTE: argh, the HD44 lcd type is a bad beast: our
@@ -324,7 +327,7 @@ void lcd_putc(uint8_t addr, uint8_t c)
 }
 
 
-/*!
+/**
  * Remap the glyph of a character.
  *
  * glyph - bitmap of 8x8 bits.
diff --git a/drv/lcd_hd44.h b/drv/lcd_hd44.h
index 0413bed6..9a0d4b12 100755
--- a/drv/lcd_hd44.h
+++ b/drv/lcd_hd44.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:00:42  bernie
  *#* Import into DevLib.
  *#*
@@ -38,7 +41,7 @@
 
 #include <cfg/compiler.h> /* For stdint types */
 
-/*!
+/**
  * \name Display dimensions (in chars)
  * \{
  */
@@ -46,19 +49,19 @@
 #define LCD_COLS  16
 /* \} */
 
-/*!
+/**
  * \name Hitachi HD44 commands.
  * \{
  */
 #define LCD_CMD_DISPLAY_INI      0x30
-//#define LCD_CMD_SETFUNC        0x38   /*!< 8 bits, 2 lines, 5x7 dots */
-#define LCD_CMD_SETFUNC          0x28   /*!< 4 bits, 2 lines, 5x7 dots */
-#define LCD_CMD_DISPLAY_ON       0x0F   /*!< Switch on display */
-#define LCD_CMD_DISPLAY_OFF      0x08   /*!< Switch off display */
-#define LCD_CMD_CLEAR            0x01   /*!< Clear display */
-#define LCD_CMD_CURSOR_BLOCK     0x0D   /*!< Show cursor (block) */
-#define LCD_CMD_CURSOR_LINE      0x0F   /*!< Show cursor (line) */
-#define LCD_CMD_CURSOR_OFF       0x0C   /*!< Hide cursor */
+//#define LCD_CMD_SETFUNC        0x38   /**< 8 bits, 2 lines, 5x7 dots */
+#define LCD_CMD_SETFUNC          0x28   /**< 4 bits, 2 lines, 5x7 dots */
+#define LCD_CMD_DISPLAY_ON       0x0F   /**< Switch on display */
+#define LCD_CMD_DISPLAY_OFF      0x08   /**< Switch off display */
+#define LCD_CMD_CLEAR            0x01   /**< Clear display */
+#define LCD_CMD_CURSOR_BLOCK     0x0D   /**< Show cursor (block) */
+#define LCD_CMD_CURSOR_LINE      0x0F   /**< Show cursor (line) */
+#define LCD_CMD_CURSOR_OFF       0x0C   /**< Hide cursor */
 #define LCD_CMD_DISPLAYMODE      0x06
 #define LCD_CMD_SET_CGRAMADDR    0x40
 #define LCD_CMD_RESET_DDRAM      0x80
@@ -68,7 +71,7 @@
 #define LCD_CMD_MOVESHIFT_RIGHT  0x04
 /*\}*/
 
-/*! Type for combined LCD cursor position (x,y). */
+/** Type for combined LCD cursor position (x,y). */
 typedef uint8_t lcdpos_t;
 
 void lcd_waitBusy(void);
diff --git a/drv/lcd_text.c b/drv/lcd_text.c
index 0527e520..232c1498 100755
--- a/drv/lcd_text.c
+++ b/drv/lcd_text.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:25  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/02/24 00:27:14  bernie
  *#* Use new naming convention for list macros.
  *#*
@@ -52,11 +55,11 @@
 #include <string.h> // strlen()
 
 
-/*! Maximum number of layers. */
+/** Maximum number of layers. */
 #define LCD_LAYERS 6
 
 #if CONFIG_KERNEL
-	/*! Semaphore to arbitrate access to the display. */
+	/** Semaphore to arbitrate access to the display. */
 	static struct Semaphore lcd_semaphore;
 	#define LOCK_LCD	sem_obtain(&lcd_semaphore)
 	#define UNLOCK_LCD	sem_release(&lcd_semaphore)
@@ -72,14 +75,14 @@ static Layer lcd_LayersPool[LCD_LAYERS];
 static LIST_TYPE(Layer) lcd_Layers;
 static LIST_TYPE(Layer) lcd_FreeLayers;
 
-/*!
+/**
  * Current cursor status.
  *
  * One of LCD_CMD_CURSOR_OFF, LCD_CMD_CURSOR_BLOCK or LCD_CMD_CURSOR_LINE.
  */
 static uint8_t lcd_CursorStatus;
 
-/*! Current cursor position, encoded as a Cursor position and status. */
+/** Current cursor position, encoded as a Cursor position and status. */
 static lcdpos_t lcd_CursorAddr;
 
 
@@ -108,7 +111,7 @@ void lcd_unlock(void)
 #endif /* CONFIG_KERNEL */
 
 
-/*!
+/**
  * Write one character to the display at the current
  * cursor prosition, then move the cursor right. The
  * cursor is wrapped to the next line when it moves
@@ -280,7 +283,7 @@ int lcd_printf(Layer *layer, lcdpos_t addr, uint8_t mode, const char *format, ..
 }
 
 
-/*!
+/**
  * Internal function to move a layer between two positions.
  *
  * \note The layer must be *already* enqueued in some list.
@@ -330,7 +333,7 @@ Layer *lcd_newLayer(char pri)
 	return layer;
 }
 
-/*!
+/**
  * Redraw the display (internal).
  *
  * \note The display must be already locked.
@@ -363,7 +366,7 @@ static void lcd_refresh(void)
 	}
 }
 
-/*!
+/**
  * Rearrange layer depth and refresh display accordingly.
  *
  * \note Setting a priority of LAYER_HIDDEN makes the layer invisible.
diff --git a/drv/lcd_text.h b/drv/lcd_text.h
index 33182972..4f138471 100755
--- a/drv/lcd_text.h
+++ b/drv/lcd_text.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/02/23 10:59:14  bernie
  *#* Documentation fixes.
  *#*
@@ -54,7 +57,7 @@
 #define LCD_CENTER     BV(1)   /* Center string in line */
 #define LCD_NOCURSOR   BV(2)   /* Scrittura senza spostamento cursore */
 
-/*! Special priority value for lcd_setLayerDepth(). */
+/** Special priority value for lcd_setLayerDepth(). */
 #define LAYER_HIDDEN   -128
 
 /* Compute LCD address from x/y coordinates */
@@ -64,21 +67,21 @@
 #define LCD_ROW2  (LCD_COLS * 2)
 #define LCD_ROW3  (LCD_COLS * 3)
 
-/*!
+/**
  * Overwrapping layer context.
  */
 typedef struct _Layer
 {
-	/*!
+	/**
 	 * Active layers are linked together in a list
 	 * sorted in top to bottom order.
 	 */
 	DECLARE_NODE_ANON(struct _Layer)
 
-	/*! Current XY address into this layer, for write operations. */
+	/** Current XY address into this layer, for write operations. */
 	lcdpos_t addr;
 
-	/*! Priority of this layer (greater in front of lesser). */
+	/** Priority of this layer (greater in front of lesser). */
 	char pri;
 
 	/**
diff --git a/drv/ntc.c b/drv/ntc.c
index 5f024037..dec27c16 100755
--- a/drv/ntc.c
+++ b/drv/ntc.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.de+veler.com/)
@@ -20,6 +20,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 17:59:47  bernie
  *#* Import into DevLib.
  *#*
@@ -35,7 +38,7 @@
 
 DB(bool ntc_initialized;)
 
-/*!
+/**
  * Find in a table of values \a orig_table of size \a size, the index which
  * value is less or equal to \a val.
  *
@@ -63,7 +66,7 @@ static size_t upper_bound(const res_t *orig_table, size_t size, res_t val)
 }
 
 
-/*!
+/**
  * Read the temperature for the NTC channel \a dev.
  * First read the resistence of the NTC through ntc_hw_read(), then,
  * for the conversion from resistance to temperature, since the formula
@@ -122,7 +125,7 @@ deg_t ntc_read(NtcDev dev)
 }
 
 
-/*!
+/**
  * Init NTC hardware.
  */
 void ntc_init(void)
diff --git a/drv/ntc.h b/drv/ntc.h
index bf221369..0ad7884f 100755
--- a/drv/ntc.h
+++ b/drv/ntc.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 17:59:47  bernie
  *#* Import into DevLib.
  *#*
@@ -38,40 +41,40 @@
 #define NTC_OPEN_CIRCUIT  -32768
 #define NTC_SHORT_CIRCUIT 32767
 
-typedef int16_t  deg_t; /*! type for celsius degrees deg_t = °C * 10 */
+typedef int16_t  deg_t; /** type for celsius degrees deg_t = °C * 10 */
 
-/*! Macro for converting from deg to deg_t type */
+/** Macro for converting from deg to deg_t type */
 #define DEG_TO_DEG_T(x)         ((deg_t)((x) * 10))
 
-/*! Macro for converting from deg_t to celsius degrees (returns only the integer part) */
+/** Macro for converting from deg_t to celsius degrees (returns only the integer part) */
 #define DEG_T_TO_INTDEG(x)      ((x) / 10)
 
-/*! Macro for converting from deg_t to celsius degrees (returns only the decimal part) */
+/** Macro for converting from deg_t to celsius degrees (returns only the decimal part) */
 #define DEG_T_TO_DECIMALDEG(x)  ((x) % 10)
 
-/*! Macro for converting from deg_t to celsius degrees (returns type is float) */
+/** Macro for converting from deg_t to celsius degrees (returns type is float) */
 #define DEG_T_TO_FLOATDEG(x)    ((x) / 10.0)
 
 
-typedef uint32_t res_t; /*! type for resistor res_t = Ohm * 100 */
-typedef float    amp_t; /*! type for defining amplifications  amp_t = A, where A is a pure number */
+typedef uint32_t res_t; /** type for resistor res_t = Ohm * 100 */
+typedef float    amp_t; /** type for defining amplifications  amp_t = A, where A is a pure number */
 
 DB(extern bool ntc_initialized;)
 
 
-/*! Describe a NTC chip */
+/** Describe a NTC chip */
 typedef struct NtcHwInfo
 {
-	const res_t *resistances; //!< resistances of the NTC (ohms * 100)
-	size_t num_resistances;   //!< number of resistances
-	deg_t degrees_min;        //!< degrees corresponding to the first entry in the table (celsius * 10)
-	deg_t degrees_step;       //!< difference in degrees between two consecutive elements in the table (celsius * 10)
+	const res_t *resistances; ///< resistances of the NTC (ohms * 100)
+	size_t num_resistances;   ///< number of resistances
+	deg_t degrees_min;        ///< degrees corresponding to the first entry in the table (celsius * 10)
+	deg_t degrees_step;       ///< difference in degrees between two consecutive elements in the table (celsius * 10)
 } NtcHwInfo;
 
-/*! Initialize the NTC module */
+/** Initialize the NTC module */
 void ntc_init(void);
 
-/*! Read a single temperature value from the NTC */
+/** Read a single temperature value from the NTC */
 deg_t ntc_read(NtcDev dev);
 
 #endif /* DRV_NTC_H */
diff --git a/drv/phase.c b/drv/phase.c
index e92bed5a..40d50bad 100755
--- a/drv/phase.c
+++ b/drv/phase.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:06:44  bernie
  *#* Import into DevLib.
  *#*
@@ -77,12 +80,12 @@
 
 #include <math.h>
 
-/*! Array  of triacs */
+/** Array  of triacs */
 static Triac triacs[TRIAC_CNT];
 
 DB(bool phase_initialized;)
 
-/*!
+/**
  * Zerocross interrupt, call when 220V cross zero.
  *
  * This function turn off all triacs that have duty < 100%
@@ -122,7 +125,7 @@ DEFINE_ZEROCROSS_ISR()
 
 
 
-/*!
+/**
  * Set duty of the triac channel \a dev (interrupt safe).
  */
 void phase_setDuty(TriacDev dev, triac_duty_t duty)
@@ -137,7 +140,7 @@ void phase_setDuty(TriacDev dev, triac_duty_t duty)
 
 
 
-/*!
+/**
  * Set duty of the triac channel \a dev (NOT INTERRUPT SAFE).
  */
 void phase_setDutyUnlock(TriacDev dev, triac_duty_t duty)
@@ -147,7 +150,7 @@ void phase_setDutyUnlock(TriacDev dev, triac_duty_t duty)
 
 
 
-/*!
+/**
  * Set power of the triac channel \a dev (interrupt safe).
  *
  * This function approsimate the sine wave to a triangular wave to compute
@@ -175,7 +178,7 @@ void phase_setPower(TriacDev dev, triac_power_t power)
 
 
 
-/*!
+/**
  * Soft int for each \a _dev triac.
  *
  * The triacs are turned on at different time to achieve phase control.
@@ -192,7 +195,7 @@ static void phase_softint(void *_dev)
 
 
 
-/*!
+/**
  * Initialize phase control driver
  */
 void phase_init(void)
diff --git a/drv/phase.h b/drv/phase.h
index 70e44e57..de5b01bd 100755
--- a/drv/phase.h
+++ b/drv/phase.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:06:44  bernie
  *#* Import into DevLib.
  *#*
@@ -58,7 +61,7 @@
 #define TRIAC_MAX_POWER 100
 #define TRIAC_POWER_K   TRIAC_MAX_DUTY * (1 / sqrt(2 * TRIAC_MAX_POWER))
 
-/*!
+/**
  * \name Types for duty and power.
  * \{
  */
@@ -69,15 +72,15 @@ typedef uint16_t triac_power_t;
 
 DB(extern bool phase_initialized;)
 
-/*!
+/**
  * \name Type for triac control.
  * \{
  */
 typedef struct Triac
 {
-	Timer  timer;      /*!< Timer for phase control. */
-	triac_duty_t duty; /*!< Duty cycle of the channel. */
-	bool   running;    /*!< True when the timer is active. */
+	Timer  timer;      /**< Timer for phase control. */
+	triac_duty_t duty; /**< Duty cycle of the channel. */
+	bool   running;    /**< True when the timer is active. */
 } Triac;
 /* \} */
 
diff --git a/drv/pwm.c b/drv/pwm.c
index 452e9413..94d3bff5 100755
--- a/drv/pwm.c
+++ b/drv/pwm.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:08:49  bernie
  *#* Import into DevLib.
  *#*
@@ -41,7 +44,7 @@
 #include <drv/pwm.h>
 #include <cfg/macros.h>
 
-/*!
+/**
  * Set duty of pwm channel \a dev.
  */
 void pwm_setDuty(PwmDev dev, pwm_duty_t duty)
@@ -51,7 +54,7 @@ void pwm_setDuty(PwmDev dev, pwm_duty_t duty)
 	pwm_hw_setDutyUnlock(dev, duty);
 }
 
-/*!
+/**
  * Initialize PWM hw.
  */
 void pwm_init(void)
diff --git a/drv/pwm.h b/drv/pwm.h
index 971ad4a8..45895995 100755
--- a/drv/pwm.h
+++ b/drv/pwm.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:08:49  bernie
  *#* Import into DevLib.
  *#*
diff --git a/drv/ser.c b/drv/ser.c
index 02e3e2d1..00988fee 100755
--- a/drv/ser.c
+++ b/drv/ser.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -28,6 +28,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.30  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.29  2006/05/18 00:39:30  bernie
  *#* ser_open(): Document a bit more.
  *#*
@@ -153,15 +156,15 @@
 
 
 /* Serial configuration parameters */
-#define SER_CTSDELAY	    70	/*!< CTS line retry interval (ms) */
-#define SER_TXPOLLDELAY	     2	/*!< Transmit buffer full retry interval (ms) */
-#define SER_RXPOLLDELAY	     2	/*!< Receive buffer empty retry interval (ms) */
+#define SER_CTSDELAY	    70	/**< CTS line retry interval (ms) */
+#define SER_TXPOLLDELAY	     2	/**< Transmit buffer full retry interval (ms) */
+#define SER_RXPOLLDELAY	     2	/**< Receive buffer empty retry interval (ms) */
 
 
 struct Serial ser_handles[SER_CNT];
 
 
-/*!
+/**
  * Inserisce il carattere c nel buffer di trasmissione.
  * Questa funzione mette il processo chiamante in attesa
  * quando il buffer e' pieno.
@@ -206,7 +209,7 @@ int ser_putchar(int c, struct Serial *port)
 }
 
 
-/*!
+/**
  * Preleva un carattere dal buffer di ricezione.
  * Questa funzione mette il processo chiamante in attesa
  * quando il buffer e' vuoto. L'attesa ha un timeout
@@ -250,7 +253,7 @@ int ser_getchar(struct Serial *port)
 }
 
 
-/*!
+/**
  * Preleva un carattere dal buffer di ricezione.
  * Se il buffer e' vuoto, ser_getchar_nowait() ritorna
  * immediatamente EOF.
@@ -266,7 +269,7 @@ int ser_getchar_nowait(struct Serial *port)
 
 
 #if CONFIG_SER_GETS
-/*!
+/**
  * Read a line long at most as size and put it
  * in buf.
  * \return number of chars read or EOF in case
@@ -278,7 +281,7 @@ int ser_gets(struct Serial *port, char *buf, int size)
 }
 
 
-/*!
+/**
  * Read a line long at most as size and put it
  * in buf, with optional echo.
  *
@@ -316,7 +319,7 @@ int ser_gets_echo(struct Serial *port, char *buf, int size, bool echo)
 #endif /* !CONFIG_SER_GETS */
 
 
-/*!
+/**
  * Read at most \a size bytes from \a port and put them in \a buf
  *
  * \return number of bytes actually read, or EOF in
@@ -339,7 +342,7 @@ int ser_read(struct Serial *port, void *buf, size_t size)
 }
 
 
-/*!
+/**
  * Write a string to serial.
  * \return 0 if OK, EOF in case of error.
  */
@@ -354,7 +357,7 @@ int ser_print(struct Serial *port, const char *s)
 }
 
 
-/*!
+/**
  * \brief Write a buffer to serial.
  *
  * \return 0 if OK, EOF in case of error.
@@ -375,7 +378,7 @@ int ser_write(struct Serial *port, const void *_buf, size_t len)
 
 
 #if CONFIG_PRINTF
-/*!
+/**
  * Formatted write
  */
 int ser_printf(struct Serial *port, const char *format, ...)
@@ -401,7 +404,7 @@ void ser_settimeouts(struct Serial *port, mtime_t rxtimeout, mtime_t txtimeout)
 #endif /* CONFIG_SER_RXTIMEOUT || CONFIG_SER_TXTIMEOUT */
 
 #if CONFIG_SER_RXTIMEOUT != -1
-/*!
+/**
  * Discard input to resynchronize with remote end.
  *
  * Discard incoming data until the port stops receiving
@@ -440,7 +443,7 @@ void ser_setparity(struct Serial *port, int parity)
 }
 
 
-/*!
+/**
  * Flush both the RX and TX buffers.
  */
 void ser_purge(struct Serial *port)
@@ -450,7 +453,7 @@ void ser_purge(struct Serial *port)
 }
 
 
-/*!
+/**
  * Wait until all pending output is completely
  * transmitted to the other end.
  *
@@ -475,7 +478,7 @@ void ser_drain(struct Serial *ser)
 }
 
 
-/*!
+/**
  * Initialize a serial port.
  *
  * \param unit  Serial unit to open. Possible values are architecture dependant.
@@ -517,7 +520,7 @@ struct Serial *ser_open(unsigned int unit)
 }
 
 
-/*!
+/**
  * Clean up serial port, disabling the associated hardware.
  */
 void ser_close(struct Serial *port)
diff --git a/drv/ser.h b/drv/ser.h
index a315562a..f9ff2ddd 100755
--- a/drv/ser.h
+++ b/drv/ser.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.27  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.26  2006/05/18 00:39:13  bernie
  *#* Add struct Serial friendly typedef.
  *#*
@@ -99,53 +102,53 @@
 #include <cfg/os.h>
 #include <appconfig.h>
 
-/*! \name Serial Error/status flags. */
+/** \name Serial Error/status flags. */
 /*\{*/
 #if CPU_AVR
 	typedef uint8_t serstatus_t;
 
 	/* Software errors */
-	#define SERRF_RXFIFOOVERRUN  BV(0)  /*!< Rx FIFO buffer overrun */
-	#define SERRF_RXTIMEOUT      BV(5)  /*!< Receive timeout */
-	#define SERRF_TXTIMEOUT      BV(6)  /*!< Transmit timeout */
+	#define SERRF_RXFIFOOVERRUN  BV(0)  /**< Rx FIFO buffer overrun */
+	#define SERRF_RXTIMEOUT      BV(5)  /**< Receive timeout */
+	#define SERRF_TXTIMEOUT      BV(6)  /**< Transmit timeout */
 
 	/*
 	 * Hardware errors.
 	 * These flags map directly to the AVR UART Status Register (USR).
 	 */
-	#define SERRF_RXSROVERRUN    BV(3)  /*!< Rx shift register overrun */
-	#define SERRF_FRAMEERROR     BV(4)  /*!< Stop bit missing */
-	#define SERRF_PARITYERROR    BV(7)  /*!< Parity error */
-	#define SERRF_NOISEERROR     0      /*!< Unsupported */
+	#define SERRF_RXSROVERRUN    BV(3)  /**< Rx shift register overrun */
+	#define SERRF_FRAMEERROR     BV(4)  /**< Stop bit missing */
+	#define SERRF_PARITYERROR    BV(7)  /**< Parity error */
+	#define SERRF_NOISEERROR     0      /**< Unsupported */
 #elif CPU_DSP56K
 	typedef uint16_t serstatus_t;
 
 	/* Software errors */
-	#define SERRF_RXFIFOOVERRUN  BV(0)  /*!< Rx FIFO buffer overrun */
-	#define SERRF_RXTIMEOUT      BV(1)  /*!< Receive timeout */
-	#define SERRF_TXTIMEOUT      BV(2)  /*!< Transmit timeout */
+	#define SERRF_RXFIFOOVERRUN  BV(0)  /**< Rx FIFO buffer overrun */
+	#define SERRF_RXTIMEOUT      BV(1)  /**< Receive timeout */
+	#define SERRF_TXTIMEOUT      BV(2)  /**< Transmit timeout */
 
 	/*
 	 * Hardware errors.
 	 * These flags map directly to the SCI Control Register.
 	 */
-	#define SERRF_PARITYERROR    BV(8)  /*!< Parity error */
-	#define SERRF_FRAMEERROR     BV(9)  /*!< Stop bit missing */
-	#define SERRF_NOISEERROR     BV(10) /*!< Noise error */
-	#define SERRF_RXSROVERRUN    BV(11) /*!< Rx shift register overrun */
+	#define SERRF_PARITYERROR    BV(8)  /**< Parity error */
+	#define SERRF_FRAMEERROR     BV(9)  /**< Stop bit missing */
+	#define SERRF_NOISEERROR     BV(10) /**< Noise error */
+	#define SERRF_RXSROVERRUN    BV(11) /**< Rx shift register overrun */
 #elif OS_HOSTED
 	typedef uint16_t serstatus_t;
 
 	/* Software errors */
-	#define SERRF_RXFIFOOVERRUN  BV(0)  /*!< Rx FIFO buffer overrun */
-	#define SERRF_RXTIMEOUT      BV(1)  /*!< Receive timeout */
-	#define SERRF_TXTIMEOUT      BV(2)  /*!< Transmit timeout */
+	#define SERRF_RXFIFOOVERRUN  BV(0)  /**< Rx FIFO buffer overrun */
+	#define SERRF_RXTIMEOUT      BV(1)  /**< Receive timeout */
+	#define SERRF_TXTIMEOUT      BV(2)  /**< Transmit timeout */
 
 	/* Hardware errors */
-	#define SERRF_RXSROVERRUN    0      /*!< Unsupported in emulated serial port. */
-	#define SERRF_FRAMEERROR     0      /*!< Unsupported in emulated serial port. */
-	#define SERRF_PARITYERROR    0      /*!< Unsupported in emulated serial port. */
-	#define SERRF_NOISEERROR     0      /*!< Unsupported in emulated serial port. */
+	#define SERRF_RXSROVERRUN    0      /**< Unsupported in emulated serial port. */
+	#define SERRF_FRAMEERROR     0      /**< Unsupported in emulated serial port. */
+	#define SERRF_PARITYERROR    0      /**< Unsupported in emulated serial port. */
+	#define SERRF_NOISEERROR     0      /**< Unsupported in emulated serial port. */
 
 #else
 	#error unknown architecture
@@ -165,7 +168,7 @@
 #define SERRF_TX  (SERRF_TXTIMEOUT)
 
 
-/*!
+/**
  * \name Parity settings for ser_setparity().
  *
  * \note Values are AVR-specific for performance reasons.
@@ -178,7 +181,7 @@
 #define SER_PARITY_ODD   3
 /*\}*/
 
-/*!
+/**
  * \name Serial hw numbers
  *
  * \{
@@ -203,27 +206,27 @@ enum
 #else
 	#error unknown architecture
 #endif
-	SER_CNT  /*!< Number of serial ports */
+	SER_CNT  /**< Number of serial ports */
 };
 /*\}*/
 
 
 struct SerialHardware;
 
-/*! Human-readable serial error descriptions */
+/** Human-readable serial error descriptions */
 extern const char * const serial_errors[8];
 
-/*! Serial handle structure */
+/** Serial handle structure */
 typedef struct Serial
 {
-	/*! Physical port number */
+	/** Physical port number */
 	unsigned int unit;
 
 #ifdef _DEBUG
 	bool is_open;
 #endif
 
-	/*!
+	/**
 	 * \name Transmit and receive FIFOs.
 	 *
 	 * Declared volatile because handled asinchronously by interrupts.
@@ -241,10 +244,10 @@ typedef struct Serial
 	mtime_t txtimeout;
 #endif
 
-	/*! Holds the flags defined above.  Will be 0 when no errors have occurred. */
+	/** Holds the flags defined above.  Will be 0 when no errors have occurred. */
 	serstatus_t status;
 
-	/*! Low-level interface to hardware. */
+	/** Low-level interface to hardware. */
 	struct SerialHardware* hw;
 } Serial;
 
@@ -273,7 +276,7 @@ extern void ser_drain(struct Serial *port);
 extern struct Serial *ser_open(unsigned int unit);
 extern void ser_close(struct Serial *port);
 
-/*!
+/**
  * \name Additional functions implemented as macros
  *
  * \{
diff --git a/drv/ser_avr.c b/drv/ser_avr.c
index 2d0ae6d0..dba54b0c 100755
--- a/drv/ser_avr.c
+++ b/drv/ser_avr.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -38,6 +38,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.32  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.31  2006/05/18 00:37:29  bernie
  *#* Use hw_ser.h instead of ubiquitous hw.h.
  *#*
@@ -145,19 +148,19 @@
 
 
 #if !CONFIG_SER_HWHANDSHAKE
-	/*!
+	/**
 	 * \name Hardware handshake (RTS/CTS).
 	 * \{
 	 */
 	#define RTS_ON      do {} while (0)
 	#define RTS_OFF     do {} while (0)
 	#define IS_CTS_ON   true
-	#define EIMSKF_CTS  0 /*!< Dummy value, must be overridden */
+	#define EIMSKF_CTS  0 /**< Dummy value, must be overridden */
 	/*\}*/
 #endif
 
 
-/*!
+/**
  * \name Overridable serial bus hooks
  *
  * These can be redefined in hw.h to implement
@@ -178,7 +181,7 @@
  * \{
  */
 #ifndef SER_UART0_BUS_TXINIT
-	/*!
+	/**
 	 * Default TXINIT macro - invoked in uart0_init()
 	 *
 	 * - Enable both the receiver and the transmitter
@@ -190,7 +193,7 @@
 #endif
 
 #ifndef SER_UART0_BUS_TXBEGIN
-	/*!
+	/**
 	 * Invoked before starting a transmission
 	 *
 	 * - Enable both the receiver and the transmitter
@@ -202,7 +205,7 @@
 #endif
 
 #ifndef SER_UART0_BUS_TXCHAR
-	/*!
+	/**
 	 * Invoked to send one character.
 	 */
 	#define SER_UART0_BUS_TXCHAR(c) do { \
@@ -211,7 +214,7 @@
 #endif
 
 #ifndef SER_UART0_BUS_TXEND
-	/*!
+	/**
 	 * Invoked as soon as the txfifo becomes empty
 	 *
 	 * - Keep both the receiver and the transmitter enabled
@@ -224,7 +227,7 @@
 #endif
 
 #ifndef SER_UART0_BUS_TXOFF
-	/*!
+	/**
 	 * \def SER_UART0_BUS_TXOFF
 	 *
 	 * Invoked after the last character has been transmitted
@@ -237,31 +240,31 @@
 #endif
 
 #ifndef SER_UART1_BUS_TXINIT
-	/*! \sa SER_UART0_BUS_TXINIT */
+	/** \sa SER_UART0_BUS_TXINIT */
 	#define SER_UART1_BUS_TXINIT do { \
 		UCSR1B = BV(RXCIE) | BV(RXEN) | BV(TXEN); \
 	} while (0)
 #endif
 #ifndef SER_UART1_BUS_TXBEGIN
-	/*! \sa SER_UART0_BUS_TXBEGIN */
+	/** \sa SER_UART0_BUS_TXBEGIN */
 	#define SER_UART1_BUS_TXBEGIN do { \
 		UCSR1B = BV(RXCIE) | BV(UDRIE) | BV(RXEN) | BV(TXEN); \
 	} while (0)
 #endif
 #ifndef SER_UART1_BUS_TXCHAR
-	/*! \sa SER_UART0_BUS_TXCHAR */
+	/** \sa SER_UART0_BUS_TXCHAR */
 	#define SER_UART1_BUS_TXCHAR(c) do { \
 		UDR1 = (c); \
 	} while (0)
 #endif
 #ifndef SER_UART1_BUS_TXEND
-	/*! \sa SER_UART0_BUS_TXEND */
+	/** \sa SER_UART0_BUS_TXEND */
 	#define SER_UART1_BUS_TXEND do { \
 		UCSR1B = BV(RXCIE) | BV(RXEN) | BV(TXEN); \
 	} while (0)
 #endif
 #ifndef SER_UART1_BUS_TXOFF
-	/*!
+	/**
 	 * \def SER_UART1_BUS_TXOFF
 	 *
 	 * \see SER_UART0_BUS_TXOFF
@@ -273,7 +276,7 @@
 /*\}*/
 
 
-/*!
+/**
  * \name Overridable SPI hooks
  *
  * These can be redefined in hw.h to implement
@@ -282,7 +285,7 @@
  * \{
  */
 #ifndef SER_SPI_BUS_TXINIT
-	/*!
+	/**
 	 * Default TXINIT macro - invoked in spi_init()
 	 * The default is no action.
 	 */
@@ -290,7 +293,7 @@
 #endif
 
 #ifndef SER_SPI_BUS_TXCLOSE
-	/*!
+	/**
 	 * Invoked after the last character has been transmitted.
 	 * The default is no action.
 	 */
@@ -344,7 +347,7 @@
 #endif
 
 
-/*!
+/**
  * \def CONFIG_SER_STROBE
  *
  * This is a debug facility that can be used to
@@ -375,7 +378,7 @@ static unsigned char spi_txbuffer[CONFIG_SPI_TXBUFSIZE];
 static unsigned char spi_rxbuffer[CONFIG_SPI_RXBUFSIZE];
 
 
-/*!
+/**
  * Internal hardware state structure
  *
  * The \a sending variable is true while the transmission
@@ -683,7 +686,7 @@ struct SerialHardware *ser_hw_getdesc(int unit)
 
 #if CONFIG_SER_HWHANDSHAKE
 
-//! This interrupt is triggered when the CTS line goes high
+/// This interrupt is triggered when the CTS line goes high
 SIGNAL(SIG_CTS)
 {
 	// Re-enable UDR empty interrupt and TX, then disable CTS interrupt
@@ -694,7 +697,7 @@ SIGNAL(SIG_CTS)
 #endif // CONFIG_SER_HWHANDSHAKE
 
 
-/*!
+/**
  * Serial 0 TX interrupt handler
  */
 SIGNAL(SIG_UART0_DATA)
@@ -730,7 +733,7 @@ SIGNAL(SIG_UART0_DATA)
 }
 
 #ifdef SER_UART0_BUS_TXOFF
-/*!
+/**
  * Serial port 0 TX complete interrupt handler.
  *
  * This IRQ is usually disabled.  The UDR-empty interrupt
@@ -765,7 +768,7 @@ SIGNAL(SIG_UART0_TRANS)
 
 #if AVR_HAS_UART1
 
-/*!
+/**
  * Serial 1 TX interrupt handler
  */
 SIGNAL(SIG_UART1_DATA)
@@ -801,7 +804,7 @@ SIGNAL(SIG_UART1_DATA)
 }
 
 #ifdef SER_UART1_BUS_TXOFF
-/*!
+/**
  * Serial port 1 TX complete interrupt handler.
  *
  * \sa port 0 TX complete handler.
@@ -826,7 +829,7 @@ SIGNAL(SIG_UART1_TRANS)
 #endif // AVR_HAS_UART1
 
 
-/*!
+/**
  * Serial 0 RX complete interrupt handler.
  *
  * This handler is interruptible.
@@ -880,7 +883,7 @@ SIGNAL(SIG_UART0_RECV)
 
 #if AVR_HAS_UART1
 
-/*!
+/**
  * Serial 1 RX complete interrupt handler.
  *
  * This handler is interruptible.
@@ -929,7 +932,7 @@ SIGNAL(SIG_UART1_RECV)
 #endif // AVR_HAS_UART1
 
 
-/*!
+/**
  * SPI interrupt handler
  */
 SIGNAL(SIG_SPI)
diff --git a/drv/ser_dsp56k.c b/drv/ser_dsp56k.c
index 55e4ddc2..ce865b99 100755
--- a/drv/ser_dsp56k.c
+++ b/drv/ser_dsp56k.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.14  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.13  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/drv/ser_i196.c b/drv/ser_i196.c
index 47bc9295..303dd400 100755
--- a/drv/ser_i196.c
+++ b/drv/ser_i196.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright (C) 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/drv/ser_p.h b/drv/ser_p.h
index ef58b261..8837543f 100755
--- a/drv/ser_p.h
+++ b/drv/ser_p.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.10  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.9  2006/02/17 22:23:06  bernie
  *#* Update POSIX serial emulator.
  *#*
diff --git a/drv/ser_posix.c b/drv/ser_posix.c
index 781c111e..3e1afd47 100755
--- a/drv/ser_posix.c
+++ b/drv/ser_posix.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/02/17 22:28:00  bernie
  *#* Rename ser_emul.c to ser_posix.c.
  *#*
@@ -55,7 +58,7 @@ static unsigned char uart1_txbuffer[CONFIG_UART1_TXBUFSIZE];
 static unsigned char uart1_rxbuffer[CONFIG_UART1_RXBUFSIZE];
 
 
-/*!
+/**
  * Internal state structure
  */
 struct EmulSerial
diff --git a/drv/ser_simple.c b/drv/ser_simple.c
index 4a57e719..9639b0d9 100755
--- a/drv/ser_simple.c
+++ b/drv/ser_simple.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/04/12 01:37:50  bernie
  *#* Import into DevLib.
  *#*
@@ -46,7 +49,7 @@
 
 #include <avr/io.h>
 
-/*!
+/**
  * Send a character over the serial line.
  *
  * \return the character sent.
@@ -71,7 +74,7 @@ int _ser_putchar(int c)
 }
 
 
-/*!
+/**
  * Get a character from the serial line.
  * If ther is no character in the buffer this function wait until
  * one is received (no timeout).
@@ -87,7 +90,7 @@ int _ser_getchar(void)
 }
 
 
-/*!
+/**
  * Get a character from the receiver buffer
  * If the buffer is empty, ser_getchar_nowait() returns
  * immediatly EOF.
@@ -102,7 +105,7 @@ void _ser_settimeouts(void)
 {
 }
 
-/*!
+/**
  * Set the baudrate.
  */
 void _ser_setbaudrate(unsigned long rate)
@@ -114,7 +117,7 @@ void _ser_setbaudrate(unsigned long rate)
 	UBRR0L = (period);
 }
 
-/*!
+/**
  * Send a string.
  */
 int _ser_print(const char *s)
@@ -130,7 +133,7 @@ void _ser_setparity(int parity)
 	UCSR0C |= (UCSR0C & ~(BV(UPM1) | BV(UPM0))) | (parity << UPM0);	
 }
 
-/*!
+/**
  * Dummy functions.
  */
 void _ser_purge(void)
@@ -138,7 +141,7 @@ void _ser_purge(void)
 	while (_ser_getchar_nowait() != EOF) {}
 }
 
-/*!
+/**
  * Initialize serial.
  */
 struct Serial * _ser_open(void)
@@ -156,7 +159,7 @@ struct Serial * _ser_open(void)
 }
 
 
-/*!
+/**
  * Clean up serial port, disabling the associated hardware.
  */
 void _ser_close(void)
diff --git a/drv/ser_simple.h b/drv/ser_simple.h
index c14e7aff..3870c3ad 100755
--- a/drv/ser_simple.h
+++ b/drv/ser_simple.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/04/12 01:37:50  bernie
  *#* Import into DevLib.
  *#*
@@ -49,20 +52,20 @@
 	typedef uint8_t serstatus_t;
 
 	/* Software errors */
-	#define SERRF_RXFIFOOVERRUN  BV(0)  /*!< Rx FIFO buffer overrun */
-	#define SERRF_RXTIMEOUT      BV(5)  /*!< Receive timeout */
-	#define SERRF_TXTIMEOUT      BV(6)  /*!< Transmit timeout */
+	#define SERRF_RXFIFOOVERRUN  BV(0)  /**< Rx FIFO buffer overrun */
+	#define SERRF_RXTIMEOUT      BV(5)  /**< Receive timeout */
+	#define SERRF_TXTIMEOUT      BV(6)  /**< Transmit timeout */
 
 	/* Hardware errors */
-	#define SERRF_RXSROVERRUN    BV(3)  /*!< Rx shift register overrun */
-	#define SERRF_FRAMEERROR     BV(4)  /*!< Stop bit missing */
-	#define SERRF_PARITYERROR    BV(7)  /*!< Parity error */
+	#define SERRF_RXSROVERRUN    BV(3)  /**< Rx shift register overrun */
+	#define SERRF_FRAMEERROR     BV(4)  /**< Stop bit missing */
+	#define SERRF_PARITYERROR    BV(7)  /**< Parity error */
 #else
 	#error unknown architecture
 #endif
 /*\}*/
 
-/*!
+/**
  * \name Serial hw numbers
  *
  * \{
@@ -79,12 +82,12 @@ enum
 #else
 	#error unknown architecture
 #endif
-	SER_CNT  /*!< Number of serial ports */
+	SER_CNT  /**< Number of serial ports */
 };
 /*\}*/
 #endif
 
-/*! \name Parity settings for ser_setparity() */
+/** \name Parity settings for ser_setparity() */
 /*\{*/
 #define SER_PARITY_NONE  0
 #define SER_PARITY_EVEN  2
@@ -92,7 +95,7 @@ enum
 /*\}*/
 
 
-/*! Serial handle structure */
+/** Serial handle structure */
 struct Serial;
 
 /* Function prototypes */
@@ -122,7 +125,7 @@ extern void _ser_purge(void);
 extern struct Serial *_ser_open(void);
 extern void _ser_close(void);
 
-/*!
+/**
  * \name Functions implemented as macros
  *
  * \{
diff --git a/drv/thermo.c b/drv/thermo.c
index 811ee25f..5ac45bb5 100755
--- a/drv/thermo.c
+++ b/drv/thermo.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 17:59:47  bernie
  *#* Import into DevLib.
  *#*
@@ -30,13 +33,13 @@
 #include <cfg/debug.h>
 
 
-/*! Interval at which thermo control is performed. */
+/** Interval at which thermo control is performed. */
 #define THERMO_INTERVAL_MS      100
 
-/*! Number of different samples we interpolate over to get the hifi temperature. */
+/** Number of different samples we interpolate over to get the hifi temperature. */
 #define THERMO_HIFI_NUM_SAMPLES 10
 
-/*! Timer for thermo-regulation. */
+/** Timer for thermo-regulation. */
 static Timer thermo_timer;
 
 typedef struct ThermoControlDev
@@ -48,11 +51,11 @@ typedef struct ThermoControlDev
 	ticks_t        expire;
 } ThermoControlDev;
 
-/*! Array of thermo-devices. */
+/** Array of thermo-devices. */
 ThermoControlDev devs[THERMO_CNT];
 
 
-/*!
+/**
  * Return the status of the specific \a dev thermo-device.
  */
 thermostatus_t thermo_status(ThermoDev dev)
@@ -61,7 +64,7 @@ thermostatus_t thermo_status(ThermoDev dev)
 }
 
 
-/*!
+/**
  * Do a single thermo control for device \a dev.
  */
 static void thermo_do(ThermoDev index)
@@ -136,7 +139,7 @@ static void thermo_do(ThermoDev index)
 }
 
 
-/*!
+/**
  * Thermo soft interrupt.
  */
 static void thermo_softint(void)
@@ -150,7 +153,7 @@ static void thermo_softint(void)
 }
 
 
-/*!
+/**
  * Set the target temperature \a temperature for a specific \a dev thermo-device.
  */
 void thermo_setTarget(ThermoDev dev, deg_t temperature)
@@ -162,7 +165,7 @@ void thermo_setTarget(ThermoDev dev, deg_t temperature)
 	kprintf("setTarget dev[%d], T[%d.%d]\n", dev, temperature / 10, temperature % 10);
 }
 
-/*!
+/**
  * Starts a thermo-regulation for channel \a dev.
  */
 void thermo_start(ThermoDev dev)
@@ -184,7 +187,7 @@ void thermo_start(ThermoDev dev)
 	devs[dev].expire = timer_clock() + thermo_hw_timeout(dev);
 }
 
-/*!
+/**
  * Stops a thermo-regulation for channel \a dev.
  */
 void thermo_stop(ThermoDev dev)
@@ -196,7 +199,7 @@ void thermo_stop(ThermoDev dev)
 }
 
 
-/*!
+/**
  * Clear errors for channel \a dev.
  */
 void thermo_clearErrors(ThermoDev dev)
@@ -206,7 +209,7 @@ void thermo_clearErrors(ThermoDev dev)
 }
 
 
-/*!
+/**
  * Read the temperature of the thermo-device \a dev using mobile mean.
  */
 deg_t thermo_read_temperature(ThermoDev dev)
@@ -221,7 +224,7 @@ deg_t thermo_read_temperature(ThermoDev dev)
 }
 
 
-/*!
+/**
  * Init thermo-control and associated hw.
  */
 void thermo_init(void)
diff --git a/drv/thermo.h b/drv/thermo.h
index 361f9661..81d96d43 100755
--- a/drv/thermo.h
+++ b/drv/thermo.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -26,6 +26,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 17:59:47  bernie
  *#* Import into DevLib.
  *#*
@@ -58,7 +61,7 @@
 void thermo_init(void);
 
 
-/*!
+/**
  * Set the target temperature at which a given device should be kept.
  *
  * \param dev Device
@@ -66,19 +69,19 @@ void thermo_init(void);
  */
 void thermo_setTarget(ThermoDev dev, deg_t temperature);
 
-/*! Start thermo control for a certain device \a dev */
+/** Start thermo control for a certain device \a dev */
 void thermo_start(ThermoDev dev);
 
-/*! Stop thermo control for a certain device \a dev */
+/** Stop thermo control for a certain device \a dev */
 void thermo_stop(ThermoDev dev);
 
-/*! Clear errors for channel \a dev */
+/** Clear errors for channel \a dev */
 void thermo_clearErrors(ThermoDev dev);
 
-/*! Return the status of the specific \a dev thermo-device. */
+/** Return the status of the specific \a dev thermo-device. */
 thermostatus_t thermo_status(ThermoDev dev);
 
-/*!
+/**
  * Return the current temperature of a device currently under thermo
  * control.
  *
diff --git a/drv/timer.c b/drv/timer.c
index 85175224..33188771 100755
--- a/drv/timer.c
+++ b/drv/timer.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.31  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.30  2006/02/24 00:26:49  bernie
  *#* Fixes for CONFIG_KERNEL.
  *#*
@@ -89,7 +92,7 @@
 #endif
 
 
-/*!
+/**
  * \def CONFIG_TIMER_STROBE
  *
  * This is a debug facility that can be used to
@@ -106,19 +109,19 @@
 #endif
 
 
-//! Master system clock (1 tick accuracy)
+/// Master system clock (1 tick accuracy)
 volatile ticks_t _clock;
 
 
 #ifndef CONFIG_TIMER_DISABLE_EVENTS
 
-/*!
+/**
  * List of active asynchronous timers.
  */
 REGISTER static List timers_queue;
 
 
-/*!
+/**
  * Add the specified timer to the software timer service queue.
  * When the delay indicated by the timer expires, the timer
  * device will execute the event associated with it.
@@ -165,7 +168,7 @@ void timer_add(Timer *timer)
 }
 
 
-/*!
+/**
  * Remove a timer from the timer queue before it has expired.
  */
 Timer *timer_abort(Timer *timer)
@@ -216,7 +219,7 @@ void timer_delayTicks(ticks_t delay)
 
 #ifndef CONFIG_TIMER_DISABLE_UDELAY
 
-/*!
+/**
  * Busy wait until the specified amount of high-precision ticks have elapsed.
  *
  * \note This function is interrupt safe, the only
@@ -243,7 +246,7 @@ void timer_busyWait(hptime_t delay)
 	}
 }
 
-/*!
+/**
  * Wait for the specified amount of time (expressed in microseconds).
  *
  * \bug In AVR arch the maximum amount of time that can be used as
@@ -263,7 +266,7 @@ void timer_delayHp(hptime_t delay)
 #endif /* CONFIG_TIMER_DISABLE_UDELAY */
 
 
-/*!
+/**
  * Timer interrupt handler. Find soft timers expired and
  * trigger corresponding events.
  */
@@ -317,7 +320,7 @@ DEFINE_TIMER_ISR
 
 MOD_DEFINE(timer)
 
-/*!
+/**
  * Initialize timer
  */
 void timer_init(void)
diff --git a/drv/timer.h b/drv/timer.h
index 867fcadf..1c361fff 100755
--- a/drv/timer.h
+++ b/drv/timer.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.31  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.30  2006/02/24 00:26:49  bernie
  *#* Fixes for CONFIG_KERNEL.
  *#*
@@ -125,7 +128,7 @@
 
 extern volatile ticks_t _clock;
 
-/*!
+/**
  * \brief Return the system tick counter (expressed in ticks)
  *
  * The result is guaranteed to increment monotonically,
@@ -155,7 +158,7 @@ INLINE ticks_t timer_clock(void)
 	return result;
 }
 
-/*!
+/**
  * Faster version of timer_clock(), to be called only when the timer
  * interrupt is disabled (DISABLE_INTS) or overridden by a
  * higher-priority or non-nesting interrupt.
@@ -167,7 +170,7 @@ INLINE ticks_t timer_clock_unlocked(void)
 	return _clock;
 }
 
-/*! Convert \a ms [ms] to ticks. */
+/** Convert \a ms [ms] to ticks. */
 INLINE ticks_t ms_to_ticks(mtime_t ms)
 {
 #if TIMER_TICKS_PER_SEC < 1000
@@ -179,7 +182,7 @@ INLINE ticks_t ms_to_ticks(mtime_t ms)
 #endif
 }
 
-/*! Convert \a us [us] to ticks. */
+/** Convert \a us [us] to ticks. */
 INLINE ticks_t us_to_ticks(utime_t us)
 {
 #if TIMER_TICKS_PER_SEC < 1000
@@ -191,7 +194,7 @@ INLINE ticks_t us_to_ticks(utime_t us)
 #endif
 }
 
-/*! Convert \a ticks [ticks] to ms. */
+/** Convert \a ticks [ticks] to ms. */
 INLINE mtime_t ticks_to_ms(ticks_t ticks)
 {
 #if TIMER_TICKS_PER_SEC < 1000
@@ -203,7 +206,7 @@ INLINE mtime_t ticks_to_ms(ticks_t ticks)
 #endif
 }
 
-/*! Convert \a ticks [ticks] to us. */
+/** Convert \a ticks [ticks] to us. */
 INLINE utime_t ticks_to_us(ticks_t ticks)
 {
 #if TIMER_TICKS_PER_SEC < 1000
@@ -215,7 +218,7 @@ INLINE utime_t ticks_to_us(ticks_t ticks)
 #endif
 }
 
-/*! Convert \a us [us] to hpticks */
+/** Convert \a us [us] to hpticks */
 INLINE hptime_t us_to_hptime(utime_t us)
 {
 #if TIMER_HW_HPTICKS_PER_SEC > 10000000UL
@@ -225,7 +228,7 @@ INLINE hptime_t us_to_hptime(utime_t us)
 #endif
 }
 
-/*! Convert \a hpticks [hptime] to usec */
+/** Convert \a hpticks [hptime] to usec */
 INLINE utime_t hptime_to_us(hptime_t hpticks)
 {
 #if TIMER_HW_HPTICKS_PER_SEC < 100000UL
@@ -256,7 +259,7 @@ INLINE void timer_udelay(utime_t delay)
 
 #include <mware/event.h>
 
-/*!
+/**
  * The timer driver supports multiple synchronous timers
  * that can trigger an event when they expire.
  *
@@ -265,27 +268,27 @@ INLINE void timer_udelay(utime_t delay)
  */
 typedef struct Timer
 {
-	Node    link;     /*!< Link into timers queue */
-	ticks_t _delay;   /*!< Timer delay in ms */
-	ticks_t tick;     /*!< Timer will expire at this tick */
-	Event   expire;   /*!< Event to execute when the timer expires */
+	Node    link;     /**< Link into timers queue */
+	ticks_t _delay;   /**< Timer delay in ms */
+	ticks_t tick;     /**< Timer will expire at this tick */
+	Event   expire;   /**< Event to execute when the timer expires */
 	DB(uint16_t magic;)
 } Timer;
 
-/*! Timer is active when Timer.magic contains this value (for debugging purposes). */
+/** Timer is active when Timer.magic contains this value (for debugging purposes). */
 #define TIMER_MAGIC_ACTIVE    0xABBA
 #define TIMER_MAGIC_INACTIVE  0xBAAB
 
 extern void timer_add(Timer *timer);
 extern Timer *timer_abort(Timer *timer);
 
-/*! Set the timer so that it calls an user hook when it expires */
+/** Set the timer so that it calls an user hook when it expires */
 INLINE void timer_set_event_softint(Timer *timer, Hook func, iptr_t user_data)
 {
 	event_initSoftInt(&timer->expire, func, user_data);
 }
 
-/*! Set the timer delay (the time before the event will be triggered) */
+/** Set the timer delay (the time before the event will be triggered) */
 INLINE void timer_setDelay(Timer *timer, ticks_t delay)
 {
 	timer->_delay = delay;
@@ -295,7 +298,7 @@ INLINE void timer_setDelay(Timer *timer, ticks_t delay)
 
 #if defined(CONFIG_KERN_SIGNALS) && CONFIG_KERN_SIGNALS
 
-/*! Set the timer so that it sends a signal when it expires */
+/** Set the timer so that it sends a signal when it expires */
 INLINE void timer_set_event_signal(Timer *timer, struct Process *proc, sigmask_t sigs)
 {
 	event_initSignal(&timer->expire, proc, sigs);
diff --git a/drv/timer_avr.c b/drv/timer_avr.c
index 877f9193..2e9c4574 100755
--- a/drv/timer_avr.c
+++ b/drv/timer_avr.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/06/12 21:37:02  marco
  *#* implemented some commands (ver and sleep)
  *#*
@@ -34,7 +37,7 @@
 #include <avr/interrupt.h>
 #include <avr/io.h>
 
-/*! HW dependent timer initialization  */
+/** HW dependent timer initialization  */
 #if (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE0)
 
 	static void timer_hw_init(void)
diff --git a/drv/timer_avr.h b/drv/timer_avr.h
index fa652b34..7442fdcb 100755
--- a/drv/timer_avr.h
+++ b/drv/timer_avr.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.28  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.27  2006/05/18 00:38:24  bernie
  *#* Use hw_cpu.h instead of ubiquitous hw.h.
  *#*
@@ -50,7 +53,7 @@
 #include <cfg/compiler.h>  /* uint8_t */
 #include <hw_cpu.h>        /* CLOCK_FREQ */
 
-/*!
+/**
  * \name Values for CONFIG_TIMER.
  *
  * Select which hardware timer interrupt to use for system clock and softtimers.
@@ -75,19 +78,19 @@
 	#define TIMER_TICKS_PER_SEC  1000
 	#define TIMER_HW_CNT         OCR_DIVISOR
 
-	//! Type of time expressed in ticks of the hardware high-precision timer
+	/// Type of time expressed in ticks of the hardware high-precision timer
 	typedef uint8_t hptime_t;
 
 #elif (CONFIG_TIMER == TIMER_ON_OVERFLOW1)
 
 	#define TIMER_PRESCALER      1
 	#define TIMER_HW_BITS        8
-	/*! This value is the maximum in overflow based timers. */
+	/** This value is the maximum in overflow based timers. */
 	#define TIMER_HW_CNT         (1 << TIMER_HW_BITS)
 	#define DEFINE_TIMER_ISR     SIGNAL(SIG_OVERFLOW1)
 	#define TIMER_TICKS_PER_SEC  ((TIMER_HW_HPTICKS_PER_SEC + TIMER_HW_CNT / 2) / TIMER_HW_CNT)
 
-	//! Type of time expressed in ticks of the hardware high precision timer
+	/// Type of time expressed in ticks of the hardware high precision timer
 	typedef uint16_t hptime_t;
 
 #elif (CONFIG_TIMER == TIMER_ON_OUTPUT_COMPARE2)
@@ -96,23 +99,23 @@
 	#define TIMER_HW_BITS        8
 	#define DEFINE_TIMER_ISR     SIGNAL(SIG_OUTPUT_COMPARE2)
 	#define TIMER_TICKS_PER_SEC  1000
-	/*! Value for OCR register in output-compare based timers. */
+	/** Value for OCR register in output-compare based timers. */
 	#define TIMER_HW_CNT         OCR_DIVISOR
 
 
-	//! Type of time expressed in ticks of the hardware high precision timer
+	/// Type of time expressed in ticks of the hardware high precision timer
 	typedef uint8_t hptime_t;
 
 #elif (CONFIG_TIMER == TIMER_ON_OVERFLOW3)
 
 	#define TIMER_PRESCALER      1
 	#define TIMER_HW_BITS        8
-	/*! This value is the maximum in overflow based timers. */
+	/** This value is the maximum in overflow based timers. */
 	#define TIMER_HW_CNT         (1 << TIMER_HW_BITS)
 	#define DEFINE_TIMER_ISR     SIGNAL(SIG_OVERFLOW3)
 	#define TIMER_TICKS_PER_SEC  ((TIMER_HW_HPTICKS_PER_SEC + TIMER_HW_CNT / 2) / TIMER_HW_CNT)
 
-	//! Type of time expressed in ticks of the hardware high precision timer
+	/// Type of time expressed in ticks of the hardware high precision timer
 	typedef uint16_t hptime_t;
 #else
 
@@ -120,16 +123,16 @@
 #endif /* CONFIG_TIMER */
 
 
-/*! Frequency of the hardware high precision timer. */
+/** Frequency of the hardware high precision timer. */
 #define TIMER_HW_HPTICKS_PER_SEC  ((CLOCK_FREQ + TIMER_PRESCALER / 2) / TIMER_PRESCALER)
 
-/*!
+/**
  * System timer: additional division after the prescaler
  * 12288000 / 64 / 192 (0..191) = 1 ms
  */
 #define OCR_DIVISOR  (((CLOCK_FREQ + TIMER_PRESCALER / 2) / TIMER_PRESCALER + TIMER_TICKS_PER_SEC / 2) / TIMER_TICKS_PER_SEC - 1)
 
-/*! Not needed, IRQ timer flag cleared automatically */
+/** Not needed, IRQ timer flag cleared automatically */
 #define timer_hw_irq() do {} while (0)
 
 
diff --git a/drv/timer_dsp56k.h b/drv/timer_dsp56k.h
index e343af4a..2e29701f 100755
--- a/drv/timer_dsp56k.h
+++ b/drv/timer_dsp56k.h
@@ -1,5 +1,5 @@
 #error This code must be revised for the new timer API
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.10  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.9  2006/02/21 21:28:02  bernie
  *#* New time handling based on TIMER_TICKS_PER_SEC to support slow timers with ticks longer than 1ms.
  *#*
@@ -58,13 +61,13 @@
 #define REG_SYSTEM_TIMER          PP_CAT(REG_TIMER_, SYSTEM_TIMER)
 #define SYSTEM_TIMER_IRQ_VECTOR   PP_CAT(IRQ_TIMER_, SYSTEM_TIMER)
 
-//! Prescaler for the system timer
+/// Prescaler for the system timer
 #define TIMER_PRESCALER           16
 
-//! Frequency of the hardware high precision timer
+/// Frequency of the hardware high precision timer
 #define TIMER_HW_HPTICKS_PER_SEC           (IPBUS_FREQ / TIMER_PRESCALER)
 
-//! Type of time expressed in ticks of the hardware high precision timer
+/// Type of time expressed in ticks of the hardware high precision timer
 typedef uint16_t hptime_t;
 
 static void system_timer_isr(UNUSED(iptr_t, arg));
diff --git a/drv/timer_i196.h b/drv/timer_i196.h
index 339cd6de..3111a6c5 100755
--- a/drv/timer_i196.h
+++ b/drv/timer_i196.h
@@ -1,5 +1,5 @@
 #error This code must be revised for the new timer API
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/02/21 21:28:02  bernie
  *#* New time handling based on TIMER_TICKS_PER_SEC to support slow timers with ticks longer than 1ms.
  *#*
@@ -39,7 +42,7 @@
 #ifndef TIMER_I196_H
 #define TIMER_I196_H
 
-/*!
+/**
  * Retrigger TIMER2, adjusting the time to account for
  * the interrupt prologue latency.
  */
diff --git a/drv/timer_posix.c b/drv/timer_posix.c
index 6204885e..650e0c97 100755
--- a/drv/timer_posix.c
+++ b/drv/timer_posix.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2006/02/21 21:28:02  bernie
  *#* New time handling based on TIMER_TICKS_PER_SEC to support slow timers with ticks longer than 1ms.
  *#*
diff --git a/drv/timer_posix.h b/drv/timer_posix.h
index 946c1125..f6b725a3 100755
--- a/drv/timer_posix.h
+++ b/drv/timer_posix.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/23 11:03:33  bernie
  *#* Documentation fix.
  *#*
diff --git a/drv/timer_qt.c b/drv/timer_qt.c
index 5ca081fc..9b7a289c 100755
--- a/drv/timer_qt.c
+++ b/drv/timer_qt.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.5  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.4  2006/05/28 12:17:57  bernie
  *#* Drop almost all the Qt3 cruft.
  *#*
diff --git a/drv/timer_qt.h b/drv/timer_qt.h
index a4772de4..b39440c2 100755
--- a/drv/timer_qt.h
+++ b/drv/timer_qt.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/21 21:28:02  bernie
  *#* New time handling based on TIMER_TICKS_PER_SEC to support slow timers with ticks longer than 1ms.
  *#*
diff --git a/drv/timer_simple.c b/drv/timer_simple.c
index 570ae429..ec263f7e 100755
--- a/drv/timer_simple.c
+++ b/drv/timer_simple.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/04/12 01:37:50  bernie
  *#* Import into DevLib.
  *#*
@@ -56,7 +59,7 @@
 #define TIMER_PRESCALER  64UL
 #define TIMER_DELAY_1MS  (255 - CLOCK_FREQ / TIMER_PRESCALER / MS_PER_SEC)
 
-/*!
+/**
  * Wait \a time ms using timer 0.
  *
  */
diff --git a/drv/timer_simple.h b/drv/timer_simple.h
index 25536305..dedc8256 100755
--- a/drv/timer_simple.h
+++ b/drv/timer_simple.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -12,6 +12,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/04/12 01:37:50  bernie
  *#* Import into DevLib.
  *#*
diff --git a/drv/timer_test.c b/drv/timer_test.c
index 0d01307f..4dd7c7d3 100755
--- a/drv/timer_test.c
+++ b/drv/timer_test.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/21 21:28:02  bernie
  *#* New time handling based on TIMER_TICKS_PER_SEC to support slow timers with ticks longer than 1ms.
  *#*
diff --git a/drv/twi.c b/drv/twi.c
index f2c73f94..d0c65374 100755
--- a/drv/twi.c
+++ b/drv/twi.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/03/20 17:49:50  bernie
  *#* Make the TWI driver more generic to work with devices other than EEPROMS.
  *#*
@@ -52,7 +55,7 @@
 #define READ_BIT BV(0)
 
 
-/*!
+/**
  * Send START condition on the bus.
  *
  * \return true on success, false otherwise.
@@ -70,7 +73,7 @@ static bool twi_start(void)
 }
 
 
-/*!
+/**
  * Send START condition and select slave for write.
  * \c id is the device id comprehensive of address left shifted by 1.
  * The LSB of \c id is ignored and reset to 0 for write operation.
@@ -104,7 +107,7 @@ bool twi_start_w(uint8_t id)
 }
 
 
-/*!
+/**
  * Send START condition and select slave for read.
  * \c id is the device id comprehensive of address left shifted by 1.
  * The LSB of \c id is ignored and set to 1 for read operation.
@@ -129,7 +132,7 @@ bool twi_start_r(uint8_t id)
 }
 
 
-/*!
+/**
  * Send STOP condition.
  */
 void twi_stop(void)
@@ -138,7 +141,7 @@ void twi_stop(void)
 }
 
 
-/*!
+/**
  * Put a single byte in master transmitter mode
  * to the selected slave device through the TWI bus.
  *
@@ -158,7 +161,7 @@ bool twi_put(const uint8_t data)
 }
 
 
-/*!
+/**
  * Send a sequence of bytes in master transmitter mode
  * to the selected slave device through the TWI bus.
  *
@@ -177,7 +180,7 @@ bool twi_send(const void *_buf, size_t count)
 }
 
 
-/*!
+/**
  * Receive a sequence of one or more bytes from the
  * selected slave device in master receive mode through
  * the TWI bus.
@@ -222,7 +225,7 @@ bool twi_recv(void *_buf, size_t count)
 }
 
 
-/*!
+/**
  * Initialize TWI module.
  */
 void twi_init(void)
diff --git a/drv/twi.h b/drv/twi.h
index 20671a46..b2b7d8b8 100755
--- a/drv/twi.h
+++ b/drv/twi.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.5  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.4  2006/03/20 17:49:49  bernie
  *#* Make the TWI driver more generic to work with devices other than EEPROMS.
  *#*
diff --git a/drv/wdt.h b/drv/wdt.h
index bfe3ce88..7ff3e8f6 100755
--- a/drv/wdt.h
+++ b/drv/wdt.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.11  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.10  2006/05/18 00:38:42  bernie
  *#* Work around missing ARCH_FREERTOS symbol.
  *#*
@@ -79,7 +82,7 @@
 	#endif
 #endif /* CONFIG_WATCHDOG */
 
-/*!
+/**
  * Reset the watchdog timer.
  */
 INLINE void wdt_reset(void)
@@ -102,7 +105,7 @@ INLINE void wdt_reset(void)
 #endif /* CONFIG_WATCHDOG */
 }
 
-/*!
+/**
  * Set watchdog timer timeout.
  *
  * \param timeout  0: 16.3ms, 7: 2.1s
diff --git a/dt/dnotifier.c b/dt/dnotifier.c
index d415c8db..5886b7fd 100755
--- a/dt/dnotifier.c
+++ b/dt/dnotifier.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -41,7 +44,7 @@
 #include <dt/dnotifier.h>
 #include <mware/list.h>
 
-/*!
+/**
  * Default update used to notify target: notify all trasparently all
  * targets in the list.
  */
@@ -50,7 +53,7 @@ static void notifier_update(DNotifier *n, dtag_t tag, dval_t val)
 	dnotify_targets(n, tag, val);
 }
 
-/*!
+/**
  * Init.
  */
 void notifier_init(DNotifier *n)
@@ -60,7 +63,7 @@ void notifier_init(DNotifier *n)
 	LIST_INIT(&n->targets);
 }
 
-/*!
+/**
  * Search in the map a tag and a val corresponding to the ones supplied.
  * If a match is found change them to the corresponding ones in the map.
  * If map is NULL the filter is trasparent and all messages sent to filter
@@ -95,7 +98,7 @@ void filter_update(DFilter *f, dtag_t tag, dval_t val)
 }
 
 
-/*!
+/**
  * Search in the table a tag corresponding to the one supplied and a val
  * that has at least the mask map supplied bits to one.
  * If a match is found change them to the corresponding ones in the map.
@@ -135,7 +138,7 @@ void filter_mask_update(DFilter *f, dtag_t tag, dval_t val)
 
 
 #define FILTER_MAGIC_ACTIVE 0xAA
-/*!
+/**
  * Init filter.
  * If \a masked is true, all the fields value in \a map must be interpreted as a mask of bits.
  */
diff --git a/dt/dnotifier.h b/dt/dnotifier.h
index 0724b82b..a7523cbc 100755
--- a/dt/dnotifier.h
+++ b/dt/dnotifier.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -45,21 +48,21 @@ struct DFilter;
 typedef void (* update_func_ptr)(struct DNotifier *, dtag_t, dval_t);
 typedef void (* update_filter_ptr)(struct DFilter *, dtag_t, dval_t);
 
-/*!
+/**
  * Base object for receive and forward messages.
  * It contains an update function used to update itslef and a list to
  * notify other DNotifer eventually connected.
  */
 typedef struct DNotifier
 {
-	//! Receive new attributes from other notifiers.
+	/// Receive new attributes from other notifiers.
 	update_func_ptr update;
 
-	//! List of target notifiers to set new attributes to.
+	/// List of target notifiers to set new attributes to.
 	List targets;
 } DNotifier;
 
-/*!
+/**
  * Map for messages.
  * Used to translate src message to dst message.
  */
@@ -70,45 +73,45 @@ typedef struct DFilterMap
 } DFilterMap;
 
 
-/*!
+/**
  * A filter is an interface between two notifier.
  * It can translate messages between them through a map (if it is not null).
  */
 typedef struct DFilter
 {
-	//! Allow creating a list of dfilter objects.
+	/// Allow creating a list of dfilter objects.
 	Node link;
 
-	//! Target of the filter
+	/// Target of the filter
 	DNotifier *target;
 
-	//! Update function called by the source dnotifier
+	/// Update function called by the source dnotifier
 	update_filter_ptr update;
 
-	//!Map for translating messages for target
+	///Map for translating messages for target
 	const DFilterMap *map;
 
-	//!Used in debug to prevent inserting this filter in more than one list
+	///Used in debug to prevent inserting this filter in more than one list
 	DB(uint8_t magic;)
 } DFilter;
 
-//! Type for filter-mask checking
+/// Type for filter-mask checking
 typedef uint16_t dfilter_mask_t;
 
-//! Filter init
+/// Filter init
 void filter_init(DFilter *f, const DFilterMap *map, bool masked, DNotifier *source, DNotifier *target);
 
-//! Filter update function without masking capabilities.
+/// Filter update function without masking capabilities.
 void filter_update(DFilter *f, dtag_t tag, dval_t val);
 
-//! Filter update function with masking capabilities.
+/// Filter update function with masking capabilities.
 void filter_mask_update(DFilter *f, dtag_t tag, dval_t val);
 
-//! Notifier init
+/// Notifier init
 void notifier_init(DNotifier *n);
 
 
-/*!
+/**
  * Macro to notify the target object.
  */
 INLINE void dnotify(DNotifier *target, dtag_t tag, dval_t val)
@@ -117,7 +120,7 @@ INLINE void dnotify(DNotifier *target, dtag_t tag, dval_t val)
 		target->update(target, tag, val);
 }
 
-/*!
+/**
  * Macro to notify all the targets of \a target object.
  */
 INLINE void dnotify_targets(DNotifier *target, dtag_t tag, dval_t val)
@@ -129,7 +132,7 @@ INLINE void dnotify_targets(DNotifier *target, dtag_t tag, dval_t val)
 }
 
 
-/*!
+/**
  * Macro that connect \a src notifier to \a tgt using \a map and passing \a opt for filtering option.
  * It declares a static filter to achieve connection and messages translation.
  * \note Due its static filter declaration, DCONNECT MUST NOT be used inside loops or in functions called multiple times.
diff --git a/dt/dtag.h b/dt/dtag.h
index 01e34f80..c89f1cc8 100755
--- a/dt/dtag.h
+++ b/dt/dtag.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -50,13 +53,13 @@
 
 #include <cfg/macros.h>
 
-/*! Type for values associated with tags. */
+/** Type for values associated with tags. */
 typedef iptr_t dval_t;
 
-/*! Type for constant values associated with tags. */
+/** Type for constant values associated with tags. */
 typedef const_iptr_t const_dval_t;
 
-/*! Type for tag */
+/** Type for tag */
 typedef enum dtag_t
 {
 	TAG_END = 0,
@@ -73,13 +76,13 @@ typedef enum dtag_t
 	TAG_ERROR,
 } dtag_t;
 
-/*! This is the basic message structure used by all dnotifiers. */
+/** This is the basic message structure used by all dnotifiers. */
 typedef struct DTagItem
 {
 	dtag_t tag;
 	dval_t val;
 } DTagItem;
 
-/*! Marker to indicate the end of a map for message filtering/translating */
+/** Marker to indicate the end of a map for message filtering/translating */
 #define TAG_END_MARKER {{TAG_END, 0}, {TAG_END, 0}}
 #endif
diff --git a/dt/dwidget.c b/dt/dwidget.c
index 970c1d64..14d9e4ef 100755
--- a/dt/dwidget.c
+++ b/dt/dwidget.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -34,7 +37,7 @@
 #include <dt/dwidget.h>
 #include <dt/dnotifier.h>
 
-/*!
+/**
  * Init the widget of \a pos and \a size on the drawing \a context.
  */
 void widget_init(DWidget *w, dpos_t pos, dpos_t size, dcontext_t *context)
diff --git a/dt/dwidget.h b/dt/dwidget.h
index a6726378..fdc4f14c 100755
--- a/dt/dwidget.h
+++ b/dt/dwidget.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -35,13 +38,13 @@
 #include <dt/dnotifier.h>
 #include <cfg/compiler.h>
 
-/*! Widget position. */
+/** Widget position. */
 typedef uint8_t dpos_t;
 
-/*! Widget drawing context. */
+/** Widget drawing context. */
 typedef iptr_t dcontext_t;
 
-/*! Widget definition. */
+/** Widget definition. */
 typedef struct DWidget
 {
 	DNotifier notifier;
diff --git a/dt/editbool.c b/dt/editbool.c
index 94a2d89c..3eb0ab8f 100755
--- a/dt/editbool.c
+++ b/dt/editbool.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -36,7 +39,7 @@
 
 #include <drv/lcd_text.h>
 
-/*!
+/**
  * Init widget.
  */
 void editbool_init(DEditBool *e, dpos_t pos, dpos_t size, dcontext_t *context, bool *value, const char *true_string, const char *false_string)
@@ -54,7 +57,7 @@ void editbool_init(DEditBool *e, dpos_t pos, dpos_t size, dcontext_t *context, b
 	e->draw = editbool_draw;
 }
 
-/*!
+/**
  * Handle the messages (edit the bool).
  */
 void editbool_update(DEditBool *e, dtag_t tag, dval_t _val)
@@ -83,7 +86,7 @@ void editbool_update(DEditBool *e, dtag_t tag, dval_t _val)
 	}
 }
 
-/*!
+/**
  * Draw the string on the context.
  */
 void editbool_draw(DEditBool *e)
diff --git a/dt/editbool.h b/dt/editbool.h
index 3f723a32..93ea5238 100755
--- a/dt/editbool.h
+++ b/dt/editbool.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
diff --git a/dt/editint.c b/dt/editint.c
index 2b95d565..a960fe91 100755
--- a/dt/editint.c
+++ b/dt/editint.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -50,7 +53,7 @@
 
 #include <drv/lcd_text.h>
 
-/*!
+/**
  * Init.
  */
 void editint_init(DEditInt *e, dpos_t pos, dpos_t size, dcontext_t *context, int *value, int min, int max)
@@ -69,7 +72,7 @@ void editint_init(DEditInt *e, dpos_t pos, dpos_t size, dcontext_t *context, int
 	e->draw = editint_draw;
 }
 
-/*!
+/**
  * Handle the messages (edit the int).
  */
 void editint_update(DEditInt *e, dtag_t tag, dval_t _val)
@@ -122,7 +125,7 @@ void editint_update(DEditInt *e, dtag_t tag, dval_t _val)
 	}
 }
 
-/*!
+/**
  * Draw the integer on the context.
  */
 void editint_draw(DEditInt *e)
diff --git a/dt/editint.h b/dt/editint.h
index af3c3964..928c2707 100755
--- a/dt/editint.h
+++ b/dt/editint.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/11/04 18:26:38  bernie
  *#* Import into DevLib.
  *#*
@@ -44,7 +47,7 @@
 #define EDIS_CURSORLEFT     BV(0)
 #define EDIS_WRAP           BV(1)
 
-/*! Type for edit style */
+/** Type for edit style */
 typedef uint16_t dstyle_t;
 
 typedef struct DEditInt
diff --git a/fonts/fixed6x8.c b/fonts/fixed6x8.c
index 2bddd779..46903b93 100755
--- a/fonts/fixed6x8.c
+++ b/fonts/fixed6x8.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/05/27 22:30:22  bernie
  *#* Move 6x8 font to fonts/.
  *#*
diff --git a/gfx/bitmap.c b/gfx/bitmap.c
index d74c7735..a40ba365 100755
--- a/gfx/bitmap.c
+++ b/gfx/bitmap.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.11  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.10  2006/05/27 17:21:15  bernie
  *#* Factor out, simplify and document clipping.
  *#*
@@ -63,7 +66,7 @@
 #endif
 
 
-/*!
+/**
  * Initialize a Bitmap structure with the provided parameters.
  *
  * \note The pen position is reset to the origin.
@@ -97,7 +100,7 @@ void gfx_bitmapInit(Bitmap *bm, uint8_t *raster, coord_t w, coord_t h)
 }
 
 
-/*!
+/**
  * Clear the whole bitmap surface to the background color.
  *
  * \note This function does \b not update the current pen position.
@@ -113,7 +116,7 @@ void gfx_bitmapClear(Bitmap *bm)
 
 #include <avr/pgmspace.h> /* FIXME: memcpy_P() */
 
-/*!
+/**
  * Copy a raster picture located in program memory in the bitmap.
  * The size of the raster to copy *must* be the same of the raster bitmap.
  *
diff --git a/gfx/charts.c b/gfx/charts.c
index 0b42185e..c6f2bfa1 100755
--- a/gfx/charts.c
+++ b/gfx/charts.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -26,6 +26,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2005/11/27 23:33:29  bernie
  *#* Reorder includes.
  *#*
@@ -79,7 +82,7 @@ void chart_setScale(Bitmap *bm, chart_x_t xmin, chart_y_t ymin, chart_x_t xmax,
 }
 
 
-/*!
+/**
  * Draw the chart axes
  */
 void chart_drawAxis(Bitmap *bm)
@@ -115,7 +118,7 @@ void chart_drawAxis(Bitmap *bm)
 }
 
 
-/*!
+/**
  * Draw a set of \a curve_cnt connected segments, whose Y coordinates
  * are identified by the \a curve_y array and X-coordinates are
  * are evenly spaced by one virtual unit.
@@ -134,7 +137,7 @@ void chart_drawCurve(Bitmap *bm, const chart_y_t *curve_y, int curve_cnt)
 }
 
 
-/*!
+/**
  * Disegna dei dot in corrispondenza delle coppie (dotsx[i];dotsy[i])
  * Se dotsx e' NULL, i punti vengono disegnati ad intervalli regolari.
  */
diff --git a/gfx/charts.h b/gfx/charts.h
index a9ae3e2c..157cd92e 100755
--- a/gfx/charts.h
+++ b/gfx/charts.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -18,6 +18,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2005/11/27 23:36:18  bernie
  *#* Use appconfig.h instead of cfg/config.h.
  *#*
@@ -49,7 +52,7 @@
 #include <gfx/gfx.h>    /* vcoord_t */
 #include <appconfig.h> /* CONFIG_ stuff */
 
-/*!
+/**
  * \name Width/height of the small ticks drawn over the axes
  * \{
  */
@@ -57,7 +60,7 @@
 #define TICKS_WIDTH      2
 /*\}*/
 
-/*!
+/**
  * \name Chart frame dimensions
  * \{
  */
diff --git a/gfx/font.h b/gfx/font.h
index 82d778ed..80bc5db4 100755
--- a/gfx/font.h
+++ b/gfx/font.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/05/27 22:31:34  bernie
  *#* Switch to a smaller default fount.
  *#*
diff --git a/gfx/gfx.h b/gfx/gfx.h
index 5fe1e300..5c2daf2b 100755
--- a/gfx/gfx.h
+++ b/gfx/gfx.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
  * Copyright 1999 Bernardo Innocenti <bernie@develer.com>
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.17  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.16  2006/05/27 17:17:34  bernie
  *#* Optimize away divisions in RAST_ADDR/MASK macros.
  *#*
@@ -79,12 +82,12 @@
 
 EXTERN_C_BEGIN
 
-/*! Common type for coordinates expressed in pixel units */
+/** Common type for coordinates expressed in pixel units */
 typedef int coord_t;
 typedef unsigned int ucoord_t;
 
 #if CONFIG_GFX_VCOORDS
-/*! Common type for coordinates expressed in logical units */
+/** Common type for coordinates expressed in logical units */
 typedef float vcoord_t;
 #endif /* CONFIG_GFX_VCOORDS */
 
@@ -138,12 +141,12 @@ struct Font;
  */
 typedef struct Bitmap
 {
-	uint8_t *raster;        /*!< Pointer to byte array to hold the data */
-	coord_t width, height;  /*!< Width/Height in pixels */
-	coord_t stride;         /*!< Bytes per row. */
-	coord_t penX, penY;     /*!< Current pen position MoveTo()/LineTo() */
+	uint8_t *raster;        /**< Pointer to byte array to hold the data */
+	coord_t width, height;  /**< Width/Height in pixels */
+	coord_t stride;         /**< Bytes per row. */
+	coord_t penX, penY;     /**< Current pen position MoveTo()/LineTo() */
 
-	Rect cr;                /*!< Clip drawing inside this rectangle */
+	Rect cr;                /**< Clip drawing inside this rectangle */
 
 #if CONFIG_GFX_TEXT
 	const struct Font *font;/**< Current font for text rendering. */
@@ -160,7 +163,7 @@ typedef struct Bitmap
 	uint8_t styles;
 #endif
 #if CONFIG_GFX_VCOORDS
-	/*!
+	/**
 	 * \name Logical coordinate system
 	 * \{
 	 */
@@ -178,10 +181,10 @@ typedef struct Bitmap
  */
 typedef struct Image
 {
-	const uint8_t *raster;   /*!< Pointer to byte array to hold the data. */
-	coord_t width;     /*!< Raster width in pixels. */
-	coord_t height;    /*!< Raster height in pixels. */
-	coord_t stride;    /*!< Bytes per row. */
+	const uint8_t *raster;   /**< Pointer to byte array to hold the data. */
+	coord_t width;     /**< Raster width in pixels. */
+	coord_t height;    /**< Raster height in pixels. */
+	coord_t stride;    /**< Bytes per row. */
 } Image;
 
 #if CONFIG_BITMAP_FMT == BITMAP_FMT_PLANAR_H_MSB
diff --git a/gfx/gfx_p.h b/gfx/gfx_p.h
index a599a8aa..738eb09e 100755
--- a/gfx/gfx_p.h
+++ b/gfx/gfx_p.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/05/27 17:17:34  bernie
  *#* Optimize away divisions in RAST_ADDR/MASK macros.
  *#*
@@ -63,7 +66,7 @@
 #define BM_ADDR(bm, x, y)  RAST_ADDR((bm)->raster, (x), (y), (bm)->stride)
 #define BM_MASK(bm, x, y)  RAST_MASK((bm)->raster, (x), (y))
 
-/*!
+/**
  * Plot a pixel in bitmap \a bm.
  *
  * \note bm is evaluated twice.
@@ -72,7 +75,7 @@
 #define BM_PLOT(bm, x, y) \
 	( *BM_ADDR(bm, x, y) |= BM_MASK(bm, x, y) )
 
-/*!
+/**
  * Clear a pixel in bitmap \a bm.
  *
  * \note bm is evaluated twice.
@@ -81,7 +84,7 @@
 #define BM_CLEAR(bm, x, y) \
 	( *BM_ADDR(bm, x, y) &= ~BM_MASK(bm, x, y) )
 
-/*!
+/**
  * Set a pixel in bitmap \a bm to the specified color.
  *
  * \note bm is evaluated twice.
@@ -95,7 +98,7 @@
 		*p = (*p & ~mask) | ((fg_pen) ? mask : 0); \
 	} while (0)
 
-/*!
+/**
  * Get the value of the pixel in bitmap \a bm.
  *
  * \return The returned value is either 0 or 1.
diff --git a/gfx/line.c b/gfx/line.c
index 41e00cc7..280ed7b3 100755
--- a/gfx/line.c
+++ b/gfx/line.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/02/10 12:26:58  bernie
  *#* Check CONFIG_* constraints.
  *#*
@@ -40,7 +43,7 @@
 	#error CONFIG_GFX_VCOORDS must be defined to either 0 or 1
 #endif
 
-/*!
+/**
  * Draw a sloped line without performing clipping.
  *
  * Parameters are the same of gfx_line().
@@ -128,7 +131,7 @@ static void gfx_lineUnclipped(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, co
 	}
 }
 
-//! Helper routine for gfx_line().
+/// Helper routine for gfx_line().
 static int gfx_findRegion(int x, int y, Rect *cr)
 {
 	int code = 0;
@@ -222,7 +225,7 @@ void gfx_line(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
 	gfx_lineUnclipped(bm, x1, y1, x2, y2);
 }
 
-/*!
+/**
  * Move the current pen position to the specified coordinates.
  *
  * The pen position is used for drawing operations such as
@@ -234,7 +237,7 @@ void gfx_moveTo(Bitmap *bm, coord_t x, coord_t y)
 	bm->penY = y;
 }
 
-/*!
+/**
  * Draw a line from the current pen position to the new coordinates.
  *
  * \note This function moves the current pen position to the
@@ -249,7 +252,7 @@ void gfx_lineTo(Bitmap *bm, coord_t x, coord_t y)
 }
 
 
-/*!
+/**
  * Draw the perimeter of an hollow rectangle.
  *
  * \note The bottom-right corner of the rectangle is drawn at (x2-1;y2-1).
@@ -269,7 +272,7 @@ void gfx_rectDraw(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
 }
 
 
-/*!
+/**
  * Fill a rectangular area with \a color.
  *
  * \note The bottom-right border of the rectangle is not drawn.
@@ -312,7 +315,7 @@ void gfx_rectFillC(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2, u
 }
 
 
-/*!
+/**
  * Draw a filled rectangle.
  *
  * \note The bottom-right border of the rectangle is not drawn.
@@ -325,7 +328,7 @@ void gfx_rectFill(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
 }
 
 
-/*!
+/**
  * Clear a rectangular area.
  *
  * \note The bottom-right border of the rectangle is not cleared.
@@ -339,7 +342,7 @@ void gfx_rectClear(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
 
 
 #if CONFIG_GFX_VCOORDS
-/*!
+/**
  * Imposta gli estremi del sistema di coordinate cartesiane rispetto
  * al rettangolo di clipping della bitmap.
  */
@@ -359,7 +362,7 @@ void gfx_setViewRect(Bitmap *bm, vcoord_t x1, vcoord_t y1, vcoord_t x2, vcoord_t
 }
 
 
-/*!
+/**
  * Transform a coordinate from the current reference system to a
  * pixel offset within the bitmap.
  */
@@ -368,7 +371,7 @@ coord_t gfx_transformX(Bitmap *bm, vcoord_t x)
 	return bm->cr.xmin + (coord_t)((x - bm->orgX) * bm->scaleX);
 }
 
-/*!
+/**
  * Transform a coordinate from the current reference system to a
  * pixel offset within the bitmap.
  */
@@ -378,7 +381,7 @@ coord_t gfx_transformY(Bitmap *bm, vcoord_t y)
 }
 
 
-/*!
+/**
  * Draw a line from (x1;y1) to (x2;y2).
  */
 void gfx_vline(Bitmap *bm, vcoord_t x1, vcoord_t y1, vcoord_t x2, vcoord_t y2)
diff --git a/gfx/text.c b/gfx/text.c
index 8e343efe..f296be78 100755
--- a/gfx/text.c
+++ b/gfx/text.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.13  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.12  2006/05/25 23:35:22  bernie
  *#* Implement correct and faster clipping for algo text.
  *#*
@@ -123,7 +126,7 @@
  */
 static bool ansi_mode = false;
 
-/*!
+/**
  * Move (imaginary) cursor to coordinates specified.
  */
 void text_setCoord(struct Bitmap *bm, int x, int y)
@@ -133,7 +136,7 @@ void text_setCoord(struct Bitmap *bm, int x, int y)
 }
 
 
-/*!
+/**
  * Move (imaginary) cursor to column and row specified.
  * Next text write will start a that row and col.
  */
@@ -148,7 +151,7 @@ void text_moveTo(struct Bitmap *bm, int row, int col)
 }
 
 
-/*!
+/**
  * Render char \a c on Bitmap \a bm.
  */
 static int text_putglyph(char c, struct Bitmap *bm)
@@ -303,7 +306,7 @@ static int text_putglyph(char c, struct Bitmap *bm)
 }
 
 
-/*!
+/**
  * Render char \c c, with (currently) limited ANSI escapes
  * emulation support and '\n' for newline.
  */
@@ -345,7 +348,7 @@ int text_putchar(char c, struct Bitmap *bm)
 }
 
 
-/*!
+/**
  * Clear the screen and reset cursor position
  */
 void text_clear(struct Bitmap *bmp)
diff --git a/gfx/text.h b/gfx/text.h
index 4f603061..3726913a 100755
--- a/gfx/text.h
+++ b/gfx/text.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/04/27 05:39:24  bernie
  *#* Enhance text rendering to arbitrary x,y coords.
  *#*
@@ -75,7 +78,7 @@
 
 #include <stdarg.h>
 
-/*!
+/**
  * \name Style flags
  * \see text_style()
  * \{
@@ -95,18 +98,18 @@
 	| STYLEF_STRIKEOUT | STYLEF_TALL)
 /*\}*/
 
-/*!
+/**
  * \name Formatting flags for text rendering
  * \see text_xprintf()
  * \{
  */
-#define TEXT_NORMAL   0       /*!< Normal mode */
-#define TEXT_FILL     BV(13)  /*!< Fill rest of line with spaces */
-#define TEXT_CENTER   BV(14)  /*!< Center string in line */
-#define TEXT_RIGHT    BV(15)  /*!< Right aligned */
+#define TEXT_NORMAL   0       /**< Normal mode */
+#define TEXT_FILL     BV(13)  /**< Fill rest of line with spaces */
+#define TEXT_CENTER   BV(14)  /**< Center string in line */
+#define TEXT_RIGHT    BV(15)  /**< Right aligned */
 /*\}*/
 
-/*! Escape sequences codes */
+/** Escape sequences codes */
 #define ANSI_ESC_CLEARSCREEN 'c'
 
 
diff --git a/gfx/text_format.c b/gfx/text_format.c
index 433794ad..875a65d2 100755
--- a/gfx/text_format.c
+++ b/gfx/text_format.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.10  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.9  2006/04/27 05:39:24  bernie
  *#* Enhance text rendering to arbitrary x,y coords.
  *#*
@@ -90,7 +93,7 @@
 #include <stdarg.h>
 #include <string.h> /* strlen() */
 
-/*!
+/**
  * Render string \a str in Bitmap \a bm at current cursor position
  *
  * \note Text formatting functions are also available with an _P suffix
@@ -111,7 +114,7 @@ int PGM_FUNC(text_puts)(const char * PGM_ATTR str, struct Bitmap *bm)
 }
 
 
-/*!
+/**
  * vprintf()-like formatter to render text in a Bitmap.
  *
  * Perform vprintf()-like formatting on the \a fmt format string using the
@@ -126,7 +129,7 @@ int PGM_FUNC(text_vprintf)(struct Bitmap *bm, const char * PGM_ATTR fmt, va_list
 	return PGM_FUNC(_formatted_write)(fmt, (void (*)(char, void *))text_putchar, bm, ap);
 }
 
-/*!
+/**
  * printf()-like formatter to render text in a Bitmap.
  *
  * Perform printf()-like formatting on the \a fmt format string.
@@ -294,7 +297,7 @@ static int text_charWidth(int c, struct TextWidthData *twd)
 	return c;
 }
 
-/*!
+/**
  * Return the width in pixels of a vprintf()-formatted string.
  */
 int PGM_FUNC(text_vwidthf)(
@@ -316,7 +319,7 @@ int PGM_FUNC(text_vwidthf)(
 }
 
 
-/*!
+/**
  * Return the width in pixels of a printf()-formatted string.
  */
 int PGM_FUNC(text_widthf)(struct Bitmap *bm, const char * PGM_ATTR fmt, ...)
diff --git a/gfx/win.c b/gfx/win.c
index 22514b74..a37f8641 100755
--- a/gfx/win.c
+++ b/gfx/win.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2006 Develer S.r.l. (http://www.develer.com/)
@@ -20,6 +20,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:26  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/10 12:25:41  bernie
  *#* Add missing header.
  *#*
diff --git a/gfx/win.h b/gfx/win.h
index 14a01681..620c7c4c 100755
--- a/gfx/win.h
+++ b/gfx/win.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2006 Develer S.r.l. (http://www.develer.com/)
@@ -20,6 +20,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/01/26 00:36:48  bernie
  *#* Const correctness for some new functions.
  *#*
diff --git a/gui/menu.c b/gui/menu.c
index 289b9b6c..a9f74ec6 100755
--- a/gui/menu.c
+++ b/gui/menu.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2006/06/03 13:58:01  bernie
  *#* Fix recursive timeout and add exit status information.
  *#*
@@ -541,7 +544,7 @@ iptr_t menu_handle(const struct Menu *menu)
 }
 
 
-/*!
+/**
  * Set flags on a menuitem.
  *
  * \param menu  Menu owner of the item to change.
@@ -561,7 +564,7 @@ int menu_setFlags(struct Menu *menu, int idx, int flags)
 }
 
 
-/*!
+/**
  * Clear flags on a menuitem.
  *
  * \param menu  Menu owner of the item to change.
diff --git a/gui/menu.h b/gui/menu.h
index 2956f076..c46c7615 100755
--- a/gui/menu.h
+++ b/gui/menu.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/06/03 13:58:02  bernie
  *#* Fix recursive timeout and add exit status information.
  *#*
@@ -77,10 +80,10 @@ typedef iptr_t (*MenuHook)(iptr_t userdata);
  */
 typedef struct MenuItem
 {
-	const_iptr_t label;    /*!< Item label (ID or ptr to string, 0 to disable) */
-	int          flags;    /*!< See MIF_#? definitions below */
-	MenuHook     hook;     /*!< Callback function (NULL to terminate item list) */
-	iptr_t       userdata; /*!< User data to be passed back to the hook */
+	const_iptr_t label;    /**< Item label (ID or ptr to string, 0 to disable) */
+	int          flags;    /**< See MIF_#? definitions below */
+	MenuHook     hook;     /**< Callback function (NULL to terminate item list) */
+	iptr_t       userdata; /**< User data to be passed back to the hook */
 } MenuItem;
 
 /**
@@ -90,20 +93,20 @@ typedef struct MenuItem
 #define MIF_EXCLUDE_MASK    0x00FF /**< Mask for mutual exclusion map (shared with priority). */
 #define MIF_PRI_MASK        0x00FF /**< Mask for priority value (shared with mutual exclusion). */
 #define MIF_PRI(x)          ((x) & MIF_PRI_MASK) /**< Set menu item priority. */
-#define MIF_EXCLUDE_0       BV(0)  /*!< Exclude item 0 when this item is checked */
-#define MIF_EXCLUDE_1       BV(1)  /*!< Exclude item 1 when this item is checked */
-#define MIF_EXCLUDE_2       BV(2)  /*!< Exclude item 2 when this item is checked */
-#define MIF_EXCLUDE_3       BV(3)  /*!< Exclude item 3 when this item is checked */
-#define MIF_EXCLUDE_4       BV(4)  /*!< Exclude item 4 when this item is checked */
-#define MIF_EXCLUDE_5       BV(5)  /*!< Exclude item 5 when this item is checked */
-#define MIF_EXCLUDE_6       BV(6)  /*!< Exclude item 6 when this item is checked */
-#define MIF_EXCLUDE_7       BV(7)  /*!< Exclude item 7 when this item is checked */
-#define MIF_CHECKED         BV(8)  /*!< Item is currently checked */
-#define MIF_CHECKIT         BV(9)  /*!< Automatically check this item when selected */
-#define MIF_TOGGLE          BV(10) /*!< Toggle MIF_CHECKED when item is selected */
-#define MIF_HIDDEN          BV(11) /*!< This menu item is not visible */
-#define MIF_DISABLED        BV(12) /*!< This menu item is not visible */
-#define MIF_RAMLABEL        BV(13) /*!< Item label is stored in RAM, not in program memory */
+#define MIF_EXCLUDE_0       BV(0)  /**< Exclude item 0 when this item is checked */
+#define MIF_EXCLUDE_1       BV(1)  /**< Exclude item 1 when this item is checked */
+#define MIF_EXCLUDE_2       BV(2)  /**< Exclude item 2 when this item is checked */
+#define MIF_EXCLUDE_3       BV(3)  /**< Exclude item 3 when this item is checked */
+#define MIF_EXCLUDE_4       BV(4)  /**< Exclude item 4 when this item is checked */
+#define MIF_EXCLUDE_5       BV(5)  /**< Exclude item 5 when this item is checked */
+#define MIF_EXCLUDE_6       BV(6)  /**< Exclude item 6 when this item is checked */
+#define MIF_EXCLUDE_7       BV(7)  /**< Exclude item 7 when this item is checked */
+#define MIF_CHECKED         BV(8)  /**< Item is currently checked */
+#define MIF_CHECKIT         BV(9)  /**< Automatically check this item when selected */
+#define MIF_TOGGLE          BV(10) /**< Toggle MIF_CHECKED when item is selected */
+#define MIF_HIDDEN          BV(11) /**< This menu item is not visible */
+#define MIF_DISABLED        BV(12) /**< This menu item is not visible */
+#define MIF_RAMLABEL        BV(13) /**< Item label is stored in RAM, not in program memory */
 /* \} */
 
 /**
@@ -111,11 +114,11 @@ typedef struct MenuItem
  */
 typedef struct Menu
 {
-	MenuItem        *items;    /*!< Array of items (end with a NULL hook) */
-	const_iptr_t     title;    /*!< Menu title (ID or ptr to string, 0 to disable) */
-	int              flags;    /*!< See MF_#? definitions below */
-	struct Bitmap   *bitmap;   /*!< Bitmap where the menu is rendered */
-	int              selected; /*!< Initial selection (written to if #MF_SAVESEL is set). */
+	MenuItem        *items;    /**< Array of items (end with a NULL hook) */
+	const_iptr_t     title;    /**< Menu title (ID or ptr to string, 0 to disable) */
+	int              flags;    /**< See MF_#? definitions below */
+	struct Bitmap   *bitmap;   /**< Bitmap where the menu is rendered */
+	int              selected; /**< Initial selection (written to if #MF_SAVESEL is set). */
 } Menu;
 
 /**
diff --git a/hw/hw_buzzer.h b/hw/hw_buzzer.h
index 08d6bc54..8a753189 100755
--- a/hw/hw_buzzer.h
+++ b/hw/hw_buzzer.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/02/10 12:31:03  bernie
  *#* Add templates for hw definitions.
  *#*
diff --git a/hw/hw_kbd.h b/hw/hw_kbd.h
index c4f684b8..1f62462b 100755
--- a/hw/hw_kbd.h
+++ b/hw/hw_kbd.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/03/22 09:51:27  bernie
  *#* Wrap C++ stuff.
  *#*
diff --git a/hw/kbd_map.h b/hw/kbd_map.h
index 30969e53..02ee13e3 100755
--- a/hw/kbd_map.h
+++ b/hw/kbd_map.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/02/10 12:31:03  bernie
  *#* Add templates for hw definitions.
  *#*
@@ -27,12 +30,12 @@
 #include <cfg/macros.h>
 
 
-/*!
+/**
  * Type for keyboard mask.
  */
 typedef uint16_t keymask_t;
 
-/*!
+/**
  * \name Keycodes.
  */
 /*@{*/
@@ -41,8 +44,8 @@ typedef uint16_t keymask_t;
 #define K_OK       BV(2)
 #define K_CANCEL   BV(3)
 
-#define K_REPEAT   BV(14) /*!< This is a repeated keyevent. */
-#define K_TIMEOUT  BV(15) /*!< Fake key event for timeouts. */
+#define K_REPEAT   BV(14) /**< This is a repeated keyevent. */
+#define K_TIMEOUT  BV(15) /**< Fake key event for timeouts. */
 /*@}*/
 
 
diff --git a/kern/file.h b/kern/file.h
index 8984af82..8229c0f7 100755
--- a/kern/file.h
+++ b/kern/file.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -49,7 +52,7 @@ typedef bool	(*CloseFunc_t)	(struct _KFile *fd);
 typedef bool	(*OpenFunc_t)	(struct _KFile *fd, const char *name, int mode);
 
 
-/*!
+/**
  * Context data for callback functions which operate on
  * pseudo files.
  */
diff --git a/kern/monitor.c b/kern/monitor.c
index d7512151..f9cda83d 100755
--- a/kern/monitor.c
+++ b/kern/monitor.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.8  2006/03/22 09:49:22  bernie
  *#* Reduce memory usage.
  *#*
diff --git a/kern/monitor.h b/kern/monitor.h
index 3703641f..86d9284b 100755
--- a/kern/monitor.h
+++ b/kern/monitor.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.5  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.4  2006/02/24 01:17:05  bernie
  *#* Update for new emulator.
  *#*
@@ -40,7 +43,7 @@
 
 #if CONFIG_KERN_MONITOR
 
-/*!
+/**
  * Start the kernel monitor. It is a special process which checks every second the stacks of the
  * running processes trying to detect stack overflows.
  *
@@ -53,7 +56,7 @@
 void monitor_start(size_t stacksize, cpustack_t *stack);
 
 
-/*!
+/**
  * Manually check if a given stack has overflown. This is used to check for stacks
  * of processes handled externally form the kernel, or for other stacks (for instance
  * the interrupt supervisor stack).
@@ -64,7 +67,7 @@ void monitor_start(size_t stacksize, cpustack_t *stack);
 size_t monitor_checkStack(cpustack_t *stack_base, size_t stack_size);
 
 
-/*! Print a report of the stack status through kdebug */
+/** Print a report of the stack status through kdebug */
 void monitor_report(void);
 
 
diff --git a/kern/msg.h b/kern/msg.h
index 3ccfb526..f46b1679 100755
--- a/kern/msg.h
+++ b/kern/msg.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -18,6 +18,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.8  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -50,7 +53,7 @@
 #include <mware/list.h>
 
 
-/*!
+/**
  * Handle queues of messages associated an action.
  *
  * A message port is an abstraction used to exchange information
@@ -186,20 +189,20 @@
  */
 typedef struct MsgPort
 {
-	List  queue;   /*!< Messages queued at this port. */
-	Event event;   /*!< Event to trigger when a message arrives. */
+	List  queue;   /**< Messages queued at this port. */
+	Event event;   /**< Event to trigger when a message arrives. */
 } MsgPort;
 
 
 typedef struct Msg
 {
-	Node     link;      /*!< Link into message port queue. */
-	MsgPort *replyPort; /*!< Port to which the msg is to be replied. */
+	Node     link;      /**< Link into message port queue. */
+	MsgPort *replyPort; /**< Port to which the msg is to be replied. */
 	/* User data may follow */
 } Msg;
 
 
-/*!
+/**
  * Lock a message port.
  *
  * This is required before reading or manipulating
@@ -219,7 +222,7 @@ INLINE void msg_lockPort(MsgPort *port)
 	proc_forbid();
 }
 
-/*!
+/**
  * Unlock a message port.
  *
  * \see msg_lockPort()
@@ -230,14 +233,14 @@ INLINE void msg_unlockPort(MsgPort *port)
 }
 
 
-/*! Initialize a message port */
+/** Initialize a message port */
 INLINE void msg_initPort(MsgPort *port, Event event)
 {
 	LIST_INIT(&port->queue);
 	port->event = event;
 }
 
-/*! Queue \a msg into \a port, triggering the associated event */
+/** Queue \a msg into \a port, triggering the associated event */
 INLINE void msg_put(MsgPort *port, Msg *msg)
 {
 	msg_portLock(port);
@@ -247,7 +250,7 @@ INLINE void msg_put(MsgPort *port, Msg *msg)
 	event_do(&port->event);
 }
 
-/*!
+/**
  * Get the first message from the queue of \a port.
  *
  * \return Pointer to the message or NULL if the port was empty.
@@ -263,7 +266,7 @@ INLINE Msg *msg_get(MsgPort *port)
 	return msg;
 }
 
-/*! Peek the first message in the queue of \a port, or NULL if the port is empty. */
+/** Peek the first message in the queue of \a port, or NULL if the port is empty. */
 INLINE Msg *msg_peek(MsgPort *port)
 {
 	Msg *msg;
@@ -277,7 +280,7 @@ INLINE Msg *msg_peek(MsgPort *port)
 	return msg;
 }
 
-/*! Send back (reply) \a msg to its sender. */
+/** Send back (reply) \a msg to its sender. */
 INLINE void msg_reply(Msg *msg)
 {
 	msg_put(msg->replyPort, msg);
diff --git a/kern/proc.c b/kern/proc.c
index ecd4ca41..f8c7fb8d 100755
--- a/kern/proc.c
+++ b/kern/proc.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2001,2004 Develer S.r.l. (http://www.develer.com/)
@@ -17,6 +17,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.31  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.30  2006/03/27 04:49:23  bernie
  *#* CPU_IDLE(): Fix for new emulator.
  *#*
@@ -118,7 +121,7 @@
 
 #include <string.h> /* memset() */
 
-/*!
+/**
  * CPU dependent context switching routines.
  *
  * \note This function *MUST* preserve also the status of the interrupts.
@@ -151,7 +154,7 @@ uint16_t Quantum;
 extern List StackFreeList;
 #endif
 
-/*! The main process (the one that executes main()). */
+/** The main process (the one that executes main()). */
 struct Process MainProcess;
 
 
@@ -194,7 +197,7 @@ void proc_init(void)
 }
 
 
-/*!
+/**
  * Create a new process, starting at the provided entry point.
  *
  * \return Process structure of new created process
@@ -283,7 +286,7 @@ struct Process *proc_new_with_name(UNUSED(const char *, name), void (*entry)(voi
 	return proc;
 }
 
-/*! Rename a process */
+/** Rename a process */
 void proc_rename(struct Process *proc, const char *name)
 {
 #if CONFIG_KERN_MONITOR
@@ -294,7 +297,7 @@ void proc_rename(struct Process *proc, const char *name)
 }
 
 
-/*!
+/**
  * System scheduler: pass CPU control to the next process in
  * the ready queue.
  *
@@ -366,7 +369,7 @@ void proc_schedule(void)
 }
 
 
-/*!
+/**
  * Terminate the current process
  */
 void proc_exit(void)
@@ -407,7 +410,7 @@ void proc_exit(void)
 }
 
 
-/*!
+/**
  * Co-operative context switch
  */
 void proc_switch(void)
@@ -423,7 +426,7 @@ void proc_switch(void)
 }
 
 
-/*!
+/**
  * Get the pointer to the current process
  */
 struct Process *proc_current(void)
@@ -431,7 +434,7 @@ struct Process *proc_current(void)
 	return CurrentProcess;
 }
 
-/*!
+/**
  * Get the pointer to the user data of the current process
  */
 iptr_t proc_current_user_data(void)
@@ -442,7 +445,7 @@ iptr_t proc_current_user_data(void)
 
 #if CONFIG_KERN_PREEMPTIVE
 
-/*!
+/**
  * Disable preemptive task switching.
  *
  * The scheduler maintains a per-process nesting counter.  Task switching is
@@ -462,7 +465,7 @@ void proc_forbid(void)
 	++CurrentProcess->forbid_cnt;
 }
 
-/*!
+/**
  * Re-enable preemptive task switching.
  *
  * \sa proc_forbid()
@@ -480,7 +483,7 @@ void proc_permit(void)
 
 #include <drv/timer.h>
 
-/*!
+/**
  * Proc scheduling test subthread 1
  */
 static void NORETURN proc_test_thread1(void)
@@ -493,7 +496,7 @@ static void NORETURN proc_test_thread1(void)
 	}
 }
 
-/*!
+/**
  * Proc scheduling test subthread 2
  */
 static void NORETURN proc_test_thread2(void)
@@ -509,7 +512,7 @@ static void NORETURN proc_test_thread2(void)
 static cpustack_t proc_test_stack1[CONFIG_KERN_DEFSTACKSIZE/sizeof(cpustack_t)];
 static cpustack_t proc_test_stack2[CONFIG_KERN_DEFSTACKSIZE/sizeof(cpustack_t)];
 
-/*!
+/**
  * Proc scheduling test
  */
 void NORETURN proc_test(void)
diff --git a/kern/proc.h b/kern/proc.h
index 386594e0..bcd0a07b 100755
--- a/kern/proc.h
+++ b/kern/proc.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2001,2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.12  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.11  2006/02/21 16:06:55  bernie
  *#* Cleanup/update process scheduling.
  *#*
@@ -76,7 +79,7 @@ void proc_rename(struct Process* proc, const char* name);
 	INLINE void proc_permit(void) { /* nop */ }
 #endif
 
-/*!
+/**
  * Execute a block of \a CODE atomically with respect to task scheduling.
  */
 #define PROC_ATOMIC(CODE) \
diff --git a/kern/proc_p.h b/kern/proc_p.h
index 7ac48176..9ab3dcbf 100755
--- a/kern/proc_p.h
+++ b/kern/proc_p.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2001, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.16  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.15  2005/11/27 23:36:19  bernie
  *#* Use appconfig.h instead of cfg/config.h.
  *#*
@@ -85,23 +88,23 @@
 
 typedef struct Process
 {
-	Node         link;        /*!< Link Process into scheduler lists */
-	cpustack_t  *stack;       /*!< Per-process SP */
-	iptr_t       user_data;   /*!< Custom data passed to the process */
+	Node         link;        /**< Link Process into scheduler lists */
+	cpustack_t  *stack;       /**< Per-process SP */
+	iptr_t       user_data;   /**< Custom data passed to the process */
 
 #if CONFIG_KERN_SIGNALS
-	sigmask_t    sig_wait;    /*!< Signals the process is waiting for */
-	sigmask_t    sig_recv;    /*!< Received signals */
+	sigmask_t    sig_wait;    /**< Signals the process is waiting for */
+	sigmask_t    sig_recv;    /**< Received signals */
 #endif
 
 #if CONFIG_KERN_PREEMPTIVE
-	int          forbid_cnt;  /*!< Nesting count for proc_forbid()/proc_permit(). */
+	int          forbid_cnt;  /**< Nesting count for proc_forbid()/proc_permit(). */
 #endif
 
 #if CONFIG_KERN_HEAP
-	uint16_t     flags;       /*!< Flags */
-	cpustack_t  *stack_base;  /*!< Base of process stack */
-	size_t       stack_size;  /*!< Size of process stack */
+	uint16_t     flags;       /**< Flags */
+	cpustack_t  *stack_base;  /**< Base of process stack */
+	size_t       stack_size;  /**< Size of process stack */
 #endif
 
 #if CONFIG_KERN_MONITOR
@@ -117,38 +120,38 @@ typedef struct Process
 } Process;
 
 
-/*!
+/**
  * \name Flags for Process.flags.
  * \{
  */
-#define PF_FREESTACK  BV(0)  /*!< Free the stack when process dies */
+#define PF_FREESTACK  BV(0)  /**< Free the stack when process dies */
 /*\}*/
 
 
-/*! Track running processes. */
+/** Track running processes. */
 extern REGISTER Process	*CurrentProcess;
 
-/*! Track ready processes. */
+/** Track ready processes. */
 extern REGISTER List     ProcReadyList;
 
 
-/*! Enqueue a task in the ready list. */
+/** Enqueue a task in the ready list. */
 #define SCHED_ENQUEUE(proc)  ADDTAIL(&ProcReadyList, &(proc)->link)
 
-/*! Schedule to another process *without* adding the current to the ready list. */
+/** Schedule to another process *without* adding the current to the ready list. */
 void proc_schedule(void);
 
 #if CONFIG_KERN_MONITOR
-	/*! Initialize the monitor */
+	/** Initialize the monitor */
 	void monitor_init(void);
 
-	/*! Register a process into the monitor */
+	/** Register a process into the monitor */
 	void monitor_add(Process *proc, const char *name, cpustack_t *stack, size_t stacksize);
 
-	/*! Unregister a process from the monitor */
+	/** Unregister a process from the monitor */
 	void monitor_remove(Process *proc);
 
-	/*! Rename a process */
+	/** Rename a process */
 	void monitor_rename(Process *proc, const char* name);
 #endif /* CONFIG_KERN_MONITOR */
 
diff --git a/kern/sem.c b/kern/sem.c
index 7b3b4729..304e64fd 100755
--- a/kern/sem.c
+++ b/kern/sem.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2001, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.12  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.11  2006/02/24 01:17:05  bernie
  *#* Update for new emulator.
  *#*
@@ -63,7 +66,7 @@ INLINE void sem_verify(struct Semaphore *s)
 }
 
 
-/*!
+/**
  * \brief Initialize a Semaphore structure.
  */
 void sem_init(struct Semaphore *s)
@@ -74,7 +77,7 @@ void sem_init(struct Semaphore *s)
 }
 
 
-/*!
+/**
  * \brief Attempt to lock a semaphore without waiting.
  *
  * \return true in case of success, false if the semaphore
@@ -103,7 +106,7 @@ bool sem_attempt(struct Semaphore *s)
 }
 
 
-/*!
+/**
  * \brief Lock a semaphore.
  *
  * If the semaphore is already owned by another process, the caller
@@ -151,7 +154,7 @@ void sem_obtain(struct Semaphore *s)
 }
 
 
-/*!
+/**
  * \brief Release a lock on a previously locked semaphore.
  *
  * If the nesting count of the semaphore reaches zero,
diff --git a/kern/sem.h b/kern/sem.h
index 2ff3a9ab..36d1e1d1 100755
--- a/kern/sem.h
+++ b/kern/sem.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2001,2004 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -53,7 +56,7 @@ typedef struct Semaphore
 	int             nest_count;
 } Semaphore;
 
-/*!
+/**
  * \name Process synchronization services
  * \{
  */
diff --git a/kern/signal.c b/kern/signal.c
index 841ac6eb..3e6fd1cb 100755
--- a/kern/signal.c
+++ b/kern/signal.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -66,6 +66,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.14  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.13  2006/02/24 01:17:05  bernie
  *#* Update for new emulator.
  *#*
@@ -117,7 +120,7 @@
 
 #if CONFIG_KERN_SIGNALS
 
-/*!
+/**
  * Check if any of the signals in \a sigs has occurred and clear them.
  * Return the signals that have occurred.
  */
@@ -135,7 +138,7 @@ sigmask_t sig_check(sigmask_t sigs)
 }
 
 
-/*!
+/**
  * Sleep until any of the signals in \a sigs occurs.
  * Return the signal(s) that have awaked the process.
  */
@@ -166,7 +169,7 @@ sigmask_t sig_wait(sigmask_t sigs)
 }
 
 
-/*!
+/**
  * Send the signals \a sigs to the process \a proc.
  * The process will be awaken if it was waiting for any of them.
  *
diff --git a/kern/signal.h b/kern/signal.h
index faca76a0..d2dfa5cf 100755
--- a/kern/signal.h
+++ b/kern/signal.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -53,18 +56,18 @@ void sig_signal(struct Process *proc, sigmask_t sig);
 sigmask_t sig_wait(sigmask_t sigs);
 
 
-/*!
+/**
  * \name Signal definitions
  * \{
  */
-#define SIG_USER0    BV(0)  /*!< Free for user usage */
-#define SIG_USER1    BV(1)  /*!< Free for user usage */
-#define SIG_USER2    BV(2)  /*!< Free for user usage */
-#define SIG_USER3    BV(3)  /*!< Free for user usage */
-#define SIG_SYSTEM4  BV(4)  /*!< Reserved for system use */
-#define SIG_SYSTEM5  BV(5)  /*!< Reserved for system use */
-#define SIG_SYSTEM6  BV(6)  /*!< Reserved for system use */
-#define SIG_SINGLE   BV(7)  /*!< Used to wait for a single event */
+#define SIG_USER0    BV(0)  /**< Free for user usage */
+#define SIG_USER1    BV(1)  /**< Free for user usage */
+#define SIG_USER2    BV(2)  /**< Free for user usage */
+#define SIG_USER3    BV(3)  /**< Free for user usage */
+#define SIG_SYSTEM4  BV(4)  /**< Reserved for system use */
+#define SIG_SYSTEM5  BV(5)  /**< Reserved for system use */
+#define SIG_SYSTEM6  BV(6)  /**< Reserved for system use */
+#define SIG_SINGLE   BV(7)  /**< Used to wait for a single event */
 /*\}*/
 
 #endif /* KERN_SIGNAL_H */
diff --git a/kern/switch_dsp56k.c b/kern/switch_dsp56k.c
index 59f9788f..60f6fd2f 100755
--- a/kern/switch_dsp56k.c
+++ b/kern/switch_dsp56k.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/02/24 01:17:05  bernie
  *#* Update for new emulator.
  *#*
diff --git a/mware/cmd_hunk.h b/mware/cmd_hunk.h
index e0416be7..e4059657 100755
--- a/mware/cmd_hunk.h
+++ b/mware/cmd_hunk.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Giovanni Bajo
@@ -43,6 +43,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/06/01 12:27:39  marco
  *#* Added utilities for protocols
  *#*
diff --git a/mware/crc.c b/mware/crc.c
index a239908b..e3cdfb6b 100755
--- a/mware/crc.c
+++ b/mware/crc.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003,2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.5  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.4  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -30,7 +33,7 @@
 
 #include "crc.h"
 
-/*!
+/**
  * crctab calculated by Mark G. Mendel, Network Systems Corporation
  */
 const uint16_t crc16tab[256] = {
diff --git a/mware/crc.h b/mware/crc.h
index 468b89d8..0ae4a53e 100755
--- a/mware/crc.h
+++ b/mware/crc.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -24,6 +24,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -57,7 +60,7 @@ extern "C" {
 extern const uint16_t crc16tab[256];
 
 
-/*!
+/**
  * \brief Compute the updated CRC16 value for one octet (macro version)
  *
  * \note This version is only intended for old/broken compilers.
@@ -70,7 +73,7 @@ extern const uint16_t crc16tab[256];
 
 
 #ifdef INLINE
-/*!
+/**
  * \brief Compute the updated CRC16 value for one octet (macro version)
  */
 INLINE uint16_t updcrc16(uint8_t c, uint16_t oldcrc)
@@ -80,7 +83,7 @@ INLINE uint16_t updcrc16(uint8_t c, uint16_t oldcrc)
 #endif // INLINE
 
 
-/*!
+/**
  * This function implements the CRC 16 calculation on a buffer.
  *
  * \param crc  Current CRC16 value.
diff --git a/mware/event.c b/mware/event.c
index 51bc8fdd..5a8ed6a2 100755
--- a/mware/event.c
+++ b/mware/event.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/02/10 12:24:42  bernie
  *#* Fix standalone build.
  *#*
diff --git a/mware/event.h b/mware/event.h
index c81b3eab..11ba5c40 100755
--- a/mware/event.h
+++ b/mware/event.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -18,6 +18,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2006/03/20 17:52:22  bernie
  *#* Add missing forward declaration.
  *#*
@@ -91,7 +94,7 @@
 #endif
 
 
-//! User defined callback type
+/// User defined callback type
 typedef void (*Hook)(void *);
 
 typedef struct Event
@@ -118,11 +121,11 @@ void event_hook_ignore(Event *event);
 void event_hook_signal(Event *event);
 void event_hook_softint(Event *event);
 
-/*! Initialize the event \a e as a no-op */
+/** Initialize the event \a e as a no-op */
 #define event_initNone(e) \
 	((e)->action = event_hook_ignore)
 
-/*! Same as event_initNone(), but returns the initialized event */
+/** Same as event_initNone(), but returns the initialized event */
 INLINE Event event_createNone(void);
 INLINE Event event_createNone(void)
 {
@@ -131,11 +134,11 @@ INLINE Event event_createNone(void)
 	return e;
 }
 
-/*! Initialize the event \a e with a software interrupt (call function \a f, with parameter \a u) */
+/** Initialize the event \a e with a software interrupt (call function \a f, with parameter \a u) */
 #define event_initSoftInt(e,f,u) \
 	((e)->action = event_hook_softint,(e)->Ev.Int.func = (f), (e)->Ev.Int.user_data = (u))
 
-/*! Same as event_initSoftInt(), but returns the initialized event */
+/** Same as event_initSoftInt(), but returns the initialized event */
 INLINE Event event_createSoftInt(Hook func, void *user_data)
 {
 	Event e;
@@ -148,11 +151,11 @@ INLINE Event event_createSoftInt(Hook func, void *user_data)
 
 #if defined(CONFIG_KERN_SIGNALS) && CONFIG_KERN_SIGNALS
 
-/*! Initialize the event \a e with a signal (send signal \a s to process \a p) */
+/** Initialize the event \a e with a signal (send signal \a s to process \a p) */
 #define event_initSignal(e,p,s) \
 	((e)->action = event_hook_signal,(e)->Ev.Sig.sig_proc = (p), (e)->Ev.Sig.sig_bit = (s))
 
-/*! Same as event_initSignal(), but returns the initialized event */
+/** Same as event_initSignal(), but returns the initialized event */
 INLINE Event event_createSignal(struct Process *proc, sigbit_t bit)
 {
 	Event e;
@@ -164,7 +167,7 @@ INLINE Event event_createSignal(struct Process *proc, sigbit_t bit)
 
 #endif
 
-/*! Trigger an event */
+/** Trigger an event */
 INLINE void event_do(struct Event *e)
 {
 	e->action(e);
diff --git a/mware/fifobuf.h b/mware/fifobuf.h
index 7ee1e70b..2b749d8f 100755
--- a/mware/fifobuf.h
+++ b/mware/fifobuf.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -43,6 +43,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.22  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.21  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -123,7 +126,7 @@ typedef struct FIFOBuffer
 	)
 
 
-/*!
+/**
  * Check whether the fifo is empty
  *
  * \note Calling fifo_isempty() is safe while a concurrent
@@ -140,7 +143,7 @@ INLINE bool fifo_isempty(const FIFOBuffer *fb)
 }
 
 
-/*!
+/**
  * Check whether the fifo is full
  *
  * \note Calling fifo_isfull() is safe while a concurrent
@@ -162,7 +165,7 @@ INLINE bool fifo_isfull(const FIFOBuffer *fb)
 }
 
 
-/*!
+/**
  * Pop a character from the fifo buffer.
  *
  * \note Calling \c fifo_push() on a full buffer is undefined.
@@ -195,7 +198,7 @@ INLINE void fifo_push(FIFOBuffer *fb, unsigned char c)
 }
 
 
-/*!
+/**
  * Pop a character from the fifo buffer.
  *
  * \note Calling \c fifo_pop() on an empty buffer is undefined.
@@ -224,7 +227,7 @@ INLINE unsigned char fifo_pop(FIFOBuffer *fb)
 }
 
 
-/*!
+/**
  * Make the fifo empty, discarding all its current contents.
  */
 INLINE void fifo_flush(FIFOBuffer *fb)
@@ -247,7 +250,7 @@ INLINE void fifo_flush(FIFOBuffer *fb)
 
 #else /* CPU_REG_BITS < CPU_BITS_PER_PTR */
 
-	/*!
+	/**
 	 * Similar to fifo_isempty(), but with stronger guarantees for
 	 * concurrent access between user and interrupt code.
 	 *
@@ -263,7 +266,7 @@ INLINE void fifo_flush(FIFOBuffer *fb)
 	}
 
 
-	/*!
+	/**
 	 * Similar to fifo_push(), but with stronger guarantees for
 	 * concurrent access between user and interrupt code.
 	 *
@@ -284,7 +287,7 @@ INLINE void fifo_flush(FIFOBuffer *fb)
 		return c;
 	}
 
-	/*!
+	/**
 	 * Similar to fifo_flush(), but with stronger guarantees for
 	 * concurrent access between user and interrupt code.
 	 *
@@ -300,7 +303,7 @@ INLINE void fifo_flush(FIFOBuffer *fb)
 #endif /* CPU_REG_BITS < BITS_PER_PTR */
 
 
-/*!
+/**
  * Thread safe version of fifo_isfull()
  */
 INLINE bool fifo_isfull_locked(const FIFOBuffer *_fb)
@@ -311,7 +314,7 @@ INLINE bool fifo_isfull_locked(const FIFOBuffer *_fb)
 }
 
 
-/*!
+/**
  * FIFO Initialization.
  */
 INLINE void fifo_init(FIFOBuffer *fb, unsigned char *buf, size_t size)
diff --git a/mware/formatwr.c b/mware/formatwr.c
index 8a2e57e1..d69e352c 100755
--- a/mware/formatwr.c
+++ b/mware/formatwr.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -53,6 +53,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.18  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.17  2005/11/04 17:43:27  bernie
  *#* Fix for LP64 architectures; Add some more tests.
  *#*
@@ -91,12 +94,12 @@
 #include <appconfig.h> /* CONFIG_ macros */
 
 #ifndef CONFIG_PRINTF_N_FORMATTER
-	/*! Disable the arcane %n formatter. */
+	/** Disable the arcane %n formatter. */
 	#define CONFIG_PRINTF_N_FORMATTER 0
 #endif
 
 #ifndef CONFIG_PRINTF_OCTAL_FORMATTER
-	/*! Disable the %o formatter. */
+	/** Disable the %o formatter. */
 	#define CONFIG_PRINTF_OCTAL_FORMATTER 0
 #endif
 
@@ -320,7 +323,7 @@ CLEAN_UP:
 
 #endif /* CONFIG_PRINTF > PRINTF_NOFLOAT */
 
-/*!
+/**
  * This routine forms the core and entry of the formatter.
  *
  * The conversion performed conforms to the ANSI specification for "printf".
diff --git a/mware/formatwr.h b/mware/formatwr.h
index 740cb1ae..48aa385a 100755
--- a/mware/formatwr.h
+++ b/mware/formatwr.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -12,6 +12,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.11  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.10  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -50,7 +53,7 @@
 #include <appconfig.h>
 #include <cfg/cpu.h>    /* CPU_HARVARD */
 
-/*!
+/**
  * \name _formatted_write() configuration
  * \{
  */
@@ -62,7 +65,7 @@
 /* \} */
 
 #ifndef CONFIG_PRINTF_RETURN_COUNT
-	/*! Enable/disable _formatted_write return value */
+	/** Enable/disable _formatted_write return value */
 	#define CONFIG_PRINTF_RETURN_COUNT 1
 #endif
 
diff --git a/mware/hashtable.c b/mware/hashtable.c
index cd9a7b6e..73f6a16d 100755
--- a/mware/hashtable.c
+++ b/mware/hashtable.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -61,6 +61,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2006/06/01 12:27:39  marco
  *#* Added utilities for protocols
  *#*
@@ -80,7 +83,7 @@ typedef const void** HashNodePtr;
 #define NODE_EMPTY(node)               (!*(node))
 #define HT_HAS_INTERNAL_KEY(ht)        (CONFIG_HT_OPTIONAL_INTERNAL_KEY && ht->flags.key_internal)
 
-/*! For hash tables with internal keys, compute the pointer to the internal key for a given \a node. */
+/** For hash tables with internal keys, compute the pointer to the internal key for a given \a node. */
 INLINE uint8_t *key_internal_get_ptr(struct HashTable *ht, HashNodePtr node)
 {
 	uint8_t* key_buf = ht->key_data.mem;
diff --git a/mware/hashtable.h b/mware/hashtable.h
index 45bea146..727bca68 100755
--- a/mware/hashtable.h
+++ b/mware/hashtable.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -31,6 +31,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2006/06/01 12:27:39  marco
  *#* Added utilities for protocols
  *#*
@@ -43,23 +46,23 @@
 #include <cfg/macros.h>
 #include <cfg/debug.h>
 
-/*!
+/**
  * Enable/disable support to declare special hash tables which maintain a copy of
  * the key internally instead of relying on the hook to extract it from the data.
  */
 #define CONFIG_HT_OPTIONAL_INTERNAL_KEY      1
 
-//! Maximum length of the internal key (use (2^n)-1 for slight speedup)
+/// Maximum length of the internal key (use (2^n)-1 for slight speedup)
 #define INTERNAL_KEY_MAX_LENGTH     15
 
-/*!
+/**
  * Hook to get the key from \a data, which is an element of the hash table. The
  * key must be returned together with \a key_length (in words).
  */
 typedef const void *(*hook_get_key)(const void *data, uint8_t *key_length);
 
 
-/*!
+/**
  * Hash table description
  *
  * \note This structures MUST NOT be accessed directly. Its definition is
@@ -71,19 +74,19 @@ typedef const void *(*hook_get_key)(const void *data, uint8_t *key_length);
  */
 struct HashTable
 {
-	const void **mem;            //!< Buckets of data
-	uint16_t max_elts_log2;      //!< Log2 of the size of the table
+	const void **mem;            ///< Buckets of data
+	uint16_t max_elts_log2;      ///< Log2 of the size of the table
 	struct {
-		bool key_internal : 1;   //!< true if the key is copied internally
+		bool key_internal : 1;   ///< true if the key is copied internally
 	} flags;
 	union {
-		hook_get_key hook;       //!< Hook to get the key
-		uint8_t *mem;            //!< Pointer to the key memory
+		hook_get_key hook;       ///< Hook to get the key
+		uint8_t *mem;            ///< Pointer to the key memory
 	} key_data;
 };
 
 
-//! Iterator to walk the hash table
+/// Iterator to walk the hash table
 typedef struct
 {
 	const void** pos;
@@ -91,7 +94,7 @@ typedef struct
 } HashIterator;
 
 
-/*!
+/**
  * Declare a hash table in the current scope
  *
  * \param name Variable name
@@ -106,13 +109,13 @@ typedef struct
 	static const void* name##_nodes[1 << UINT32_LOG2(size)]; \
 	struct HashTable name = { name##_nodes, UINT32_LOG2(size), { false }, hook_gk }
 
-/*! Exactly like \c DECLARE_HASHTABLE, but the variable will be declared as static. */
+/** Exactly like \c DECLARE_HASHTABLE, but the variable will be declared as static. */
 #define DECLARE_HASHTABLE_STATIC(name, size, hook_gk) \
 	static const void* name##_nodes[1 << UINT32_LOG2(size)]; \
 	static struct HashTable name = { name##_nodes, UINT32_LOG2(size), { false }, { hook_gk } }
 
 #if CONFIG_HT_OPTIONAL_INTERNAL_KEY
-	/*! Declare a hash table with internal copies of the keys. This version does not
+	/** Declare a hash table with internal copies of the keys. This version does not
 	 *  require a hook, nor it requires the user to allocate static memory for the keys.
 	 *  It is mostly suggested for tables whose keys are computed on the fly and need
 	 *  to be stored somewhere.
@@ -122,14 +125,14 @@ typedef struct
 		static const void* name##_nodes[1 << UINT32_LOG2(size)]; \
 		struct HashTable name = { name##_nodes, UINT32_LOG2(size), { true }, name##_keys }
 
-	/*! Exactly like \c DECLARE_HASHTABLE_INTERNALKEY, but the variable will be declared as static. */
+	/** Exactly like \c DECLARE_HASHTABLE_INTERNALKEY, but the variable will be declared as static. */
 	#define DECLARE_HASHTABLE_INTERNALKEY_STATIC(name, size) \
 		static uint8_t name##_keys[(1 << UINT32_LOG2(size)) * (INTERNAL_KEY_MAX_LENGTH + 1)]; \
 		static const void* name##_nodes[1 << UINT32_LOG2(size)]; \
 		static struct HashTable name = { name##_nodes, UINT32_LOG2(size), { true }, name##_keys }
 #endif
 
-/*!
+/**
  * Initialize (and clear) a hash table in a memory buffer.
  *
  * \param ht Hash table declared with \c DECLARE_HASHTABLE
@@ -140,7 +143,7 @@ typedef struct
  */
 void ht_init(struct HashTable* ht);
 
-/*!
+/**
  * Insert an element into the hash table
  *
  * \param ht Handle of the hash table
@@ -159,7 +162,7 @@ void ht_init(struct HashTable* ht);
  */
 bool ht_insert(struct HashTable* ht, const void* data);
 
-/*!
+/**
  * Insert an element into the hash table
  *
  * \param ht Handle of the hash table
@@ -180,7 +183,7 @@ bool ht_insert(struct HashTable* ht, const void* data);
  */
 bool ht_insert_with_key(struct HashTable* ht, const void* key, uint8_t key_length, const void* data);
 
-/*!
+/**
  * Find an element in the hash table
  *
  * \param ht Handle of the hash table
@@ -190,13 +193,13 @@ bool ht_insert_with_key(struct HashTable* ht, const void* key, uint8_t key_lengt
  */
 const void* ht_find(struct HashTable* ht, const void* key, uint8_t key_length);
 
-/*! Similar to \c ht_insert_with_key() but \a key is an ASCIIZ string */
+/** Similar to \c ht_insert_with_key() but \a key is an ASCIIZ string */
 #define ht_insert_str(ht, key, data)         ht_insert_with_key(ht, key, strlen(key), data)
 
-/*! Similar to \c ht_find() but \a key is an ASCIIZ string */
+/** Similar to \c ht_find() but \a key is an ASCIIZ string */
 #define ht_find_str(ht, key)                 ht_find(ht, key, strlen(key))
 
-//! Get an iterator to the begin of the hash table \a ht
+/// Get an iterator to the begin of the hash table \a ht
 INLINE HashIterator ht_iter_begin(struct HashTable* ht)
 {
 	HashIterator h;
@@ -210,7 +213,7 @@ INLINE HashIterator ht_iter_begin(struct HashTable* ht)
 	return h;
 }
 
-/*!
+/**
  * Get an iterator to the (exclusive) end of the hash table \a ht
  *
  * \note Like in STL, the end iterator is not a valid iterator (you
@@ -226,18 +229,18 @@ INLINE HashIterator ht_iter_end(struct HashTable* ht)
 	return h;
 }
 
-//! Compare \a it1 and \a it2 for equality
+/// Compare \a it1 and \a it2 for equality
 INLINE bool ht_iter_cmp(HashIterator it1, HashIterator it2)
 {
 	ASSERT(it1.end == it2.end);
 	return it1.pos == it2.pos;
 }
 
-//! Get the element within the hash table \a ht pointed by the iterator \a iter
+/// Get the element within the hash table \a ht pointed by the iterator \a iter
 INLINE const void* ht_iter_get(HashIterator iter)
 { return *iter.pos; }
 
-/*! Return an iterator pointing to the element following \a h
+/** Return an iterator pointing to the element following \a h
  *
  * \note The order of the elements visited during the iteration is casual,
  * and depends on the implementation.
diff --git a/mware/heap.c b/mware/heap.c
index b1dbb72b..e152a39d 100755
--- a/mware/heap.c
+++ b/mware/heap.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.8  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -210,7 +213,7 @@ void *heap_calloc(struct Heap* h, size_t size)
 	return mem;
 }
 
-/*!
+/**
  * Free a block of memory, determining its size automatically.
  *
  * \param h    Heap from which the block was allocated.
diff --git a/mware/heap.h b/mware/heap.h
index bbae968b..9f0ed920 100755
--- a/mware/heap.h
+++ b/mware/heap.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -20,6 +20,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.7  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.6  2005/11/27 23:36:19  bernie
  *#* Use appconfig.h instead of cfg/config.h.
  *#*
@@ -54,20 +57,20 @@
 
 struct _MemChunk;
 
-//! A heap
+/// A heap
 struct Heap
 {
-	struct _MemChunk *FreeList;     //!< Head of the free list
+	struct _MemChunk *FreeList;     ///< Head of the free list
 };
 
 
-//! Initialize \a heap within the buffer pointed by \a memory which is of \a size bytes
+/// Initialize \a heap within the buffer pointed by \a memory which is of \a size bytes
 void heap_init(struct Heap* heap, void* memory, size_t size);
 
-//! Allocate a chunk of memory of \a size bytes from the heap
+/// Allocate a chunk of memory of \a size bytes from the heap
 void *heap_allocmem(struct Heap* heap, size_t size);
 
-//! Free a chunk of memory of \a size bytes from the heap
+/// Free a chunk of memory of \a size bytes from the heap
 void heap_freemem(struct Heap* heap, void *mem, size_t size);
 
 
diff --git a/mware/hex.c b/mware/hex.c
index 2a456021..02f9e475 100755
--- a/mware/hex.c
+++ b/mware/hex.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2006/02/10 11:30:48  bernie
  *#* C++ fixes.
  *#*
diff --git a/mware/hex.h b/mware/hex.h
index edf05a04..8a0f8296 100755
--- a/mware/hex.h
+++ b/mware/hex.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
diff --git a/mware/kfile.h b/mware/kfile.h
index 3e1f469a..bbad769b 100755
--- a/mware/kfile.h
+++ b/mware/kfile.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/mware/list.h b/mware/list.h
index 8d89b4d6..e8dec766 100755
--- a/mware/list.h
+++ b/mware/list.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.20  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.19  2006/03/20 17:50:29  bernie
  *#* Fix typo.
  *#*
@@ -80,7 +83,7 @@
 #include <cfg/compiler.h> /* INLINE */
 #include <cfg/debug.h> /* ASSERT() */
 
-/*!
+/**
  * This structure represents a node for bidirectional lists.
  *
  * Data is usually appended to nodes by making them the first
@@ -92,7 +95,7 @@ typedef struct _Node
 	struct _Node *pred;
 } Node;
 
-/*!
+/**
  * Head of a doubly-linked list of \c Node structs.
  *
  * Lists must be initialized with LIST_INIT() prior to use.
@@ -117,7 +120,7 @@ typedef struct _PriNode
 } PriNode;
 
 
-/*!
+/**
  * Template for a naked node in a list of \a T structures.
  *
  * To be used as data member in other structures:
@@ -150,11 +153,11 @@ typedef struct _PriNode
 #define DECLARE_NODE_ANON(T) \
 	T *succ; T *pred;
 
-/*! Declare a typesafe node for structures of type \a T. */
+/** Declare a typesafe node for structures of type \a T. */
 #define DECLARE_NODE_TYPE(T) \
 	typedef struct T##Node { T *succ; T *pred; } T##Node
 
-/*! Template for a list of \a T structures. */
+/** Template for a list of \a T structures. */
 #define DECLARE_LIST_TYPE(T) \
 	DECLARE_NODE_TYPE(T); \
 	typedef struct T##List { \
@@ -165,14 +168,14 @@ typedef struct _PriNode
 #define NODE_TYPE(T) T##Node
 #define LIST_TYPE(T) T##List
 
-/*!
+/**
  * Get a pointer to the first node in a list.
  *
  * If \a l is empty, result points to l->tail.
  */
 #define LIST_HEAD(l) ((l)->head.succ)
 
-/*!
+/**
  * Get a pointer to the last node in a list.
  *
  * If \a l is empty, result points to l->head.
@@ -186,7 +189,7 @@ typedef struct _PriNode
 	#define TYPEOF_OR_VOIDPTR(type) void *
 #endif
 
-/*!
+/**
  * Iterate over all nodes in a list.
  *
  * This macro generates a "for" statement using the following parameters:
@@ -200,7 +203,7 @@ typedef struct _PriNode
 		(n) = (TYPEOF_OR_VOIDPTR(n))(((Node *)(n))->succ) \
 	)
 
-/*!
+/**
  * Iterate backwards over all nodes in a list.
  *
  * This macro generates a "for" statement using the following parameters:
@@ -214,7 +217,7 @@ typedef struct _PriNode
 		(n) = (TYPEOF_OR_VOIDPTR(n))(((Node *)(n))->pred) \
 	)
 
-/*! Initialize a list. */
+/** Initialize a list. */
 #define LIST_INIT(l) \
 	do { \
 		(l)->head.succ = (TYPEOF_OR_VOIDPTR((l)->head.succ)) &(l)->tail; \
@@ -224,7 +227,7 @@ typedef struct _PriNode
 	} while (0)
 
 #ifdef _DEBUG
-	/*! Make sure that a list is valid (it was initialized and is not corrupted). */
+	/** Make sure that a list is valid (it was initialized and is not corrupted). */
 	#define LIST_ASSERT_VALID(l) \
 		do { \
 			Node *n, *pred; \
@@ -247,7 +250,7 @@ typedef struct _PriNode
 	#define INVALIDATE_NODE(n) do {} while (0)
 #endif
 
-/*! Add node to list head. */
+/** Add node to list head. */
 #define ADDHEAD(l,n) \
 	do { \
 		ASSERT(l); \
@@ -258,7 +261,7 @@ typedef struct _PriNode
 		(n)->pred->succ = (n); \
 	} while (0)
 
-/*! Add node to list tail. */
+/** Add node to list tail. */
 #define ADDTAIL(l,n) \
 	do { \
 		ASSERT(l); \
@@ -269,7 +272,7 @@ typedef struct _PriNode
 		(l)->tail.pred = (n); \
 	} while (0)
 
-/*!
+/**
  * Insert node \a n before node \a ln.
  *
  * \note You can't pass in a list header as \a ln, but
@@ -283,7 +286,7 @@ typedef struct _PriNode
 		(ln)->pred = (n); \
 	} while (0)
 
-/*!
+/**
  * Remove \a n from whatever list it is in.
  *
  * \note Removing a node that has not previously been
@@ -296,7 +299,7 @@ typedef struct _PriNode
 		INVALIDATE_NODE(n); \
 	} while (0)
 
-/*! Tell whether a list is empty. */
+/** Tell whether a list is empty. */
 #define LIST_EMPTY(l)  ( (void *)((l)->head.succ) == (void *)(&(l)->tail) )
 
 /**
@@ -316,7 +319,7 @@ typedef struct _PriNode
 	} while (0)
 
 
-/*!
+/**
  * Unlink a node from the head of the list \a l.
  *
  * \return Pointer to node, or NULL if the list was empty.
@@ -336,7 +339,7 @@ INLINE Node *list_remHead(List *l)
 	return n;
 }
 
-/*!
+/**
  * Unlink a node from the tail of the list \a l.
  *
  * \return Pointer to node, or NULL if the list was empty.
diff --git a/mware/msg.c b/mware/msg.c
index 76c66437..f046064e 100755
--- a/mware/msg.c
+++ b/mware/msg.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -15,6 +15,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2005/03/01 23:31:02  bernie
  *#* String table and localization stuff.
  *#*
@@ -22,7 +25,7 @@
 
 #include "msg.h"
 
-/*!
+/**
  * Array of pointers to localized strings. Should be filled
  * by localization stuff, but not for now.
  */
@@ -41,7 +44,7 @@ const char *msg_strings[MSG_COUNT] = {
  */
 
 
-/*!
+/**
  * Untranslated constant strings used more than once are
  * grouped here to save ROM space.
  */
diff --git a/mware/parser.c b/mware/parser.c
index 0b2c8738..7356315e 100755
--- a/mware/parser.c
+++ b/mware/parser.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2006 Develer S.r.l. (http://www.develer.com/)
@@ -29,6 +29,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/06/01 12:27:39  marco
  *#* Added utilities for protocols
  *#*
@@ -47,14 +50,14 @@
 
 #define MAX_COMMANDS_NUMBER  128  // 64
 
-//! Hashtable hook to extract the key from a command
+/// Hashtable hook to extract the key from a command
 static const void* get_key_from_command(const void* cmd, uint8_t* length);
 
-//! Hashtable that handles the commands that can be executed
+/// Hashtable that handles the commands that can be executed
 DECLARE_HASHTABLE_STATIC(commands, MAX_COMMANDS_NUMBER, get_key_from_command);
 
 
-/*!
+/**
  * \brief Tokenize one word at a time from a text.
  *
  * This function is similar to strtok, but does not use any implicit
@@ -91,7 +94,7 @@ static bool get_word(const char **begin, const char **end)
 }
 
 
-/*!
+/**
  * \brief Command arguments parser.
  *
  * Using the format pointed by the argument fmt
@@ -216,7 +219,7 @@ static int printResult(struct Serial *ser, const char *fmt, parms result[])
 }
 #endif /* UNUSED_CODE */
 
-//! Hook provided by the parser for matching of command names (TAB completion) for readline
+/// Hook provided by the parser for matching of command names (TAB completion) for readline
 const char* parser_rl_match(UNUSED_ARG(void *,dummy), const char *word, int word_len)
 {
 	HashIterator cur;
diff --git a/mware/parser.h b/mware/parser.h
index 9ad6567d..22cff8b8 100755
--- a/mware/parser.h
+++ b/mware/parser.h
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2006/06/12 21:37:02  marco
  *#* implemented some commands (ver and sleep)
  *#*
@@ -35,10 +38,10 @@
  */
 typedef enum
 {
-	RC_ERROR  = -1, //!< Reply with error.
-	RC_OK     = 0,  //!< No reply (ignore reply arguments).
-	RC_REPLY  = 1,   //!< Reply command arguments.
-	RC_SKIP   = 2    //!< Skip following commands
+	RC_ERROR  = -1, ///< Reply with error.
+	RC_OK     = 0,  ///< No reply (ignore reply arguments).
+	RC_REPLY  = 1,   ///< Reply command arguments.
+	RC_SKIP   = 2    ///< Skip following commands
 } ResultCode;
 
 /** union that contains parameters passed to and from commands */
@@ -108,7 +111,7 @@ const char* parser_rl_match(void* dummy, const char* word, int word_len);
 bool parser_process_line(const char* line);
 
 
-/*!
+/**
  * Execute a command with its arguments, and fetch its results.
  *
  * \param templ Template of the command to be executed
diff --git a/mware/pgm.h b/mware/pgm.h
index 8f5b878d..5f10d002 100755
--- a/mware/pgm.h
+++ b/mware/pgm.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -170,7 +170,7 @@
 #define PROGMEM         /* nothing */
 #endif
 
-/*!
+/**
  * \name Types for variables stored in program memory (harvard processors).
  * \{
  */
@@ -183,7 +183,7 @@ typedef PROGMEM int32_t pgm_int32_t;
 typedef PROGMEM uint32_t pgm_uint32_t;
 /*\}*/
 
-/*!
+/**
  * \name PGM support macros.
  *
  * These macros enable dual compilation of code for both program
diff --git a/mware/pool.h b/mware/pool.h
index 87e4abc5..89bb559c 100755
--- a/mware/pool.h
+++ b/mware/pool.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/mware/readline.c b/mware/readline.c
index 86c1dfd8..873b14a7 100755
--- a/mware/readline.c
+++ b/mware/readline.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -45,6 +45,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/06/01 12:27:39  marco
  *#* Added utilities for protocols
  *#*
@@ -58,14 +61,14 @@
 #include <stdio.h>
 
 
-//! Enable compilation of the unit test code
+/// Enable compilation of the unit test code
 #define DEBUG_UNIT_TEST       0
 
-//! Enable dump of the history after each line
+/// Enable dump of the history after each line
 #define DEBUG_DUMP_HISTORY    0
 
 
-/*! Special keys (escape sequences converted to a single code) */
+/** Special keys (escape sequences converted to a single code) */
 enum RL_KEYS {
 	SPECIAL_KEYS = 0x1000,
 
@@ -117,12 +120,12 @@ enum RL_KEYS {
 	KEY_F10, KEY_F11, KEY_F12,
 };
 
-/*! Check if \a c is a separator between words.
+/** Check if \a c is a separator between words.
  *  \note Parameter \a c is evaluated multiple times
  */
 #define IS_WORD_SEPARATOR(c) ((c) == ' ' || (c) == '\0')
 
-//! Write the string \a txt to the IO output (without any kind of termination)
+/// Write the string \a txt to the IO output (without any kind of termination)
 INLINE void rl_puts(const struct RLContext* ctx, const char* txt)
 {
 	if (!ctx->put)
@@ -132,14 +135,14 @@ INLINE void rl_puts(const struct RLContext* ctx, const char* txt)
 		ctx->put(*txt++, ctx->put_param);
 }
 
-//! Write character \a ch to the IO output.
+/// Write character \a ch to the IO output.
 INLINE void rl_putc(const struct RLContext* ctx, char ch)
 {
 	if (ctx->put)
 		ctx->put(ch, ctx->put_param);
 }
 
-/*! Read a character from the IO into \a ch. This function also takes
+/** Read a character from the IO into \a ch. This function also takes
  *  care of converting the ANSI escape sequences into one of the codes
  *  defined in \c RL_KEYS.
  */
@@ -226,19 +229,19 @@ static bool pop_history(struct RLContext* ctx, int total_len)
 	return true;
 }
 
-//! Check if index \a i points to the begin of the history.
+/// Check if index \a i points to the begin of the history.
 INLINE bool is_history_begin(struct RLContext* ctx, int i)
 { return ctx->history + i == ctx->real_history; }
 
-//! Check if index \a i points to the (exclusive) end of history
+/// Check if index \a i points to the (exclusive) end of history
 INLINE bool is_history_end(struct RLContext* ctx, int i)
 { return ctx->history + i == ctx->real_history + HISTORY_SIZE; }
 
-//! Check if index \a i points to the (exclusive) end of history, or somewhere past the end.
+/// Check if index \a i points to the (exclusive) end of history, or somewhere past the end.
 INLINE bool is_history_past_end(struct RLContext* ctx, int i)
 { return ctx->history + i >= ctx->real_history + HISTORY_SIZE; }
 
-/*! Insert \a num_chars characters from \a ch into the history buffer at the
+/** Insert \a num_chars characters from \a ch into the history buffer at the
  *  position indicated by \a curpos. If needed, remove old history to make room.
  *  Returns true if everything was successful, false if there was no room to
  *  add the characters.
@@ -263,14 +266,14 @@ static bool insert_chars(struct RLContext* ctx, size_t *curpos, const char* ch,
 	return true;
 }
 
-//! Insert a single character \a ch into the buffer (with the same semantic of \c insert_chars())
+/// Insert a single character \a ch into the buffer (with the same semantic of \c insert_chars())
 static bool insert_char(struct RLContext* ctx, size_t *curpos, char ch)
 {
 	return insert_chars(ctx, curpos, &ch, 1);
 }
 
 #if DEBUG_DUMP_HISTORY
-//! Dump the internal history of a context (used only for debug purposes)
+/// Dump the internal history of a context (used only for debug purposes)
 static void dump_history(struct RLContext* ctx)
 {
 	int k;
@@ -291,7 +294,7 @@ static void dump_history(struct RLContext* ctx)
 }
 #endif /* DEBUG_DUMP_HISTORY */
 
-//! Complete the current word. Return false if no unambiguous completion was found
+/// Complete the current word. Return false if no unambiguous completion was found
 static bool complete_word(struct RLContext *ctx, size_t *curpos)
 {
 	const char* completed_word;
@@ -420,7 +423,7 @@ const char* rl_readline(struct RLContext* ctx)
 
 #if DEBUG_UNIT_TEST
 
-/*! Perform the unit test for the readline library */
+/** Perform the unit test for the readline library */
 void rl_test(void);
 
 #if HISTORY_SIZE != 32
@@ -435,7 +438,7 @@ static int test_getc(void* data)
 	return *test_getc_ptr++;
 }
 
-/*! Perform a readline test. The function pipes the characters from \a input_buffer
+/** Perform a readline test. The function pipes the characters from \a input_buffer
  *  through the I/O to \c rl_readline(). After the whole string is sent, \c do_test()
  *  checks if the current history within the context match \a expected_history.
  */
diff --git a/mware/readline.h b/mware/readline.h
index d875daa4..a46ad513 100755
--- a/mware/readline.h
+++ b/mware/readline.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright (C) 2004 Giovanni Bajo
@@ -22,6 +22,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.2  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.1  2006/06/01 12:27:39  marco
  *#* Added utilities for protocols
  *#*
diff --git a/mware/rle.c b/mware/rle.c
index 4cda86aa..c52b2101 100755
--- a/mware/rle.c
+++ b/mware/rle.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -16,6 +16,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -30,7 +33,7 @@
 #include "rle.h"
 
 
-/*!
+/**
  * Run-length encode \a len bytes from the \a input buffer
  * to the \a output buffer.
  */
@@ -98,7 +101,7 @@ int rle(unsigned char *output, const unsigned char *input, int len)
 }
 
 
-/*!
+/**
  * Run-length decode from the \a input buffer to the \a output
  * buffer.
  *
diff --git a/mware/rle.h b/mware/rle.h
index 63bac11b..04b47f46 100755
--- a/mware/rle.h
+++ b/mware/rle.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -14,6 +14,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.4  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.3  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/mware/sprintf.c b/mware/sprintf.c
index 6ce8e0da..53cb9205 100755
--- a/mware/sprintf.c
+++ b/mware/sprintf.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2002, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.11  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.10  2005/04/11 19:10:28  bernie
  *#* Include top-level headers from cfg/ subdir.
  *#*
@@ -98,7 +101,7 @@ int PGM_FUNC(sprintf)(char *str, const char * fmt, ...)
 	return result;
 }
 
-/*!
+/**
  * State information for __sn_put_char()
  */
 struct __sn_state
@@ -107,7 +110,7 @@ struct __sn_state
 	size_t len;
 };
 
-/*!
+/**
  * formatted_write() callback used [v]snprintf().
  */
 static void __sn_put_char(char c, void *ptr)
diff --git a/mware/sprintf_test.c b/mware/sprintf_test.c
index 697a544e..4517214f 100755
--- a/mware/sprintf_test.c
+++ b/mware/sprintf_test.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.6  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.5  2005/11/04 17:47:26  bernie
  *#* Fix one warning.
  *#*
diff --git a/mware/strtol10.c b/mware/strtol10.c
index 67ac010d..1f6d7055 100755
--- a/mware/strtol10.c
+++ b/mware/strtol10.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2005/04/11 18:10:45  bernie
  *#* Doxygen fixes.
  *#*
@@ -23,7 +26,7 @@
 
 #include "strtol10.h"
 
-/*!
+/**
  * Convert a formatted base-10 ASCII number to unsigned long binary representation.
  *
  * Unlike the standard strtoul(), this function has an interface
@@ -58,7 +61,7 @@ bool strtoul10(const char *first, const char *last, unsigned long *val)
 }
 
 
-/*!
+/**
  * Convert a formatted base-10 ASCII number to signed long binary representation.
  *
  * \see strtoul10()
diff --git a/mware/strtol10.h b/mware/strtol10.h
index ab44f5c7..f577fccf 100755
--- a/mware/strtol10.h
+++ b/mware/strtol10.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.3  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.2  2005/04/11 19:10:28  bernie
  *#* Include top-level headers from cfg/ subdir.
  *#*
@@ -29,7 +32,7 @@
 bool strtoul10(const char *first, const char *last, unsigned long *val);
 bool strtol10(const char *first, const char *last, long *val);
 
-/*!
+/**
  * Replacement for standard library function atol().
  */
 INLINE long atol(const char *str)
@@ -39,7 +42,7 @@ INLINE long atol(const char *str)
 	return val;
 }
 
-/*!
+/**
  * Replacement for standard library function atoi().
  */
 INLINE int atoi(const char *str)
diff --git a/mware/xmodem.c b/mware/xmodem.c
index 2b9651df..4f89bcd3 100755
--- a/mware/xmodem.c
+++ b/mware/xmodem.c
@@ -1,5 +1,5 @@
 #error This module has not been revised for the API changes in several DevLib modules
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -28,6 +28,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.10  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.9  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
@@ -71,22 +74,22 @@
 #include <string.h> /* for memset() */
 
 
-/*!
+/**
  * \name Protocol control codes
  * \{
  */
-#define XM_SOH  0x01  /*!< Start Of Header (128-byte block) */
-#define XM_STX  0x02  /*!< Start Of Header (1024-byte block) */
-#define XM_EOT  0x04  /*!< End Of Transmission */
-#define XM_ACK  0x06  /*!< Acknowledge block */
-#define XM_NAK  0x15  /*!< Negative Acknowledge */
-#define XM_C    0x43  /*!< Request CRC-16 transmission */
-#define XM_CAN  0x18  /*!< CANcel transmission */
+#define XM_SOH  0x01  /**< Start Of Header (128-byte block) */
+#define XM_STX  0x02  /**< Start Of Header (1024-byte block) */
+#define XM_EOT  0x04  /**< End Of Transmission */
+#define XM_ACK  0x06  /**< Acknowledge block */
+#define XM_NAK  0x15  /**< Negative Acknowledge */
+#define XM_C    0x43  /**< Request CRC-16 transmission */
+#define XM_CAN  0x18  /**< CANcel transmission */
 /*\}*/
 
-#define XM_MAXRETRIES     15  /*!< Max retries before giving up */
-#define XM_MAXCRCRETRIES   7  /*!< Max retries before switching to BCC */
-#define XM_BUFSIZE      1024  /*!< Size of block buffer */
+#define XM_MAXRETRIES     15  /**< Max retries before giving up */
+#define XM_MAXCRCRETRIES   7  /**< Max retries before switching to BCC */
+#define XM_BUFSIZE      1024  /**< Size of block buffer */
 
 
 #if (ARCH & ARCH_BOOT)
@@ -106,7 +109,7 @@
 #endif /* ARCH_BOOT */
 
 
-/*!
+/**
  * Decode serial driver errors and print them on the display.
  */
 static void print_serial_error(struct Serial *port, int retries)
@@ -131,7 +134,7 @@ static void print_serial_error(struct Serial *port, int retries)
 }
 
 
-/*!
+/**
  * \brief Receive a file using the XModem protocol.
  *
  * \param port Serial port to use for transfer
@@ -347,7 +350,7 @@ bool xmodem_recv(struct Serial *port, KFile *fd)
 }
 
 
-/*!
+/**
  * \brief Transmit a file using the XModem protocol.
  *
  * \param port Serial port to use for transfer
diff --git a/mware/xmodem.h b/mware/xmodem.h
index 4bf6c733..e83f836e 100755
--- a/mware/xmodem.h
+++ b/mware/xmodem.h
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.5  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.4  2005/11/04 16:20:02  bernie
  *#* Fix reference to README.devlib in header.
  *#*
diff --git a/os/hptime.c b/os/hptime.c
index 995c8d9e..71e920ca 100755
--- a/os/hptime.c
+++ b/os/hptime.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
@@ -13,6 +13,9 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.8  2006/07/19 12:56:28  bernie
+ *#* Convert to new Doxygen style.
+ *#*
  *#* Revision 1.7  2006/07/19 12:53:58  bernie
  *#* Documentation fixes.
  *#*
diff --git a/rules.mk b/rules.mk
index 1bcf5c66..e764924e 100755
--- a/rules.mk
+++ b/rules.mk
@@ -10,6 +10,9 @@
 # Author: Bernardo Innocenti <bernie@develer.com>
 #
 # $Log$
+# Revision 1.4  2006/07/19 12:56:24  bernie
+# Convert to new Doxygen style.
+#
 # Revision 1.3  2006/05/27 22:42:24  bernie
 # Search for verstag.h in app subdirs first.
 #
@@ -191,6 +194,7 @@ flash_$(1): $(OUTDIR)/$(1).s19 flash_$(1)_local
 	if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U flash:w:$$< ; then \
 	     $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U flash:w:$$< ; \
 	fi
+	#avarice --mkII -j usb --erase --program --verify --file images/triface.elf
 
 .PHONY: flash_$(1)_local
 flash_$(1)_local:
diff --git a/verstag.c b/verstag.c
index 33a05d75..f0afc47e 100755
--- a/verstag.c
+++ b/verstag.c
@@ -1,4 +1,4 @@
-/*!
+/**
  * \file
  * <!--
  * Copyright 2004, 2005 Develer S.r.l. (http://www.develer.com/)
diff --git a/verstag.h b/verstag.h
index 527e9dc6..a1f37ac3 100755
--- a/verstag.h
+++ b/verstag.h
@@ -38,7 +38,7 @@
 	#error unknown architecture
 #endif
 
-/*!
+/**
  * If _SNAPSHOT is defined, \c VERS_TAG contains the build date
  * date instead of a numeric version string.
  */
@@ -53,7 +53,7 @@
 #define __STRINGIZE(x) #x
 #define _STRINGIZE(x) __STRINGIZE(x)
 
-/*! Build application version string (i.e.: "1.7.0") */
+/** Build application version string (i.e.: "1.7.0") */
 #define MAKE_VERS(maj,min,rev) _STRINGIZE(maj) "." _STRINGIZE(min) "." _STRINGIZE(rev) VERS_LETTER VERS_DBG
 #ifdef _SNAPSHOT
 	#define VERS_TAG "snapshot" " " __DATE__ " " __TIME__ " " VERS_LETTER " " VERS_DBG
@@ -61,18 +61,18 @@
 	#define VERS_TAG MAKE_VERS(VERS_MAJOR,VERS_MINOR,VERS_REV)
 #endif
 
-/*! Build application version string suitable for MS windows resource files (i.e.: "1, 7, 0, 1") */
+/** Build application version string suitable for MS windows resource files (i.e.: "1, 7, 0, 1") */
 #define MAKE_RCVERS(maj,min,rev,bld) _STRINGIZE(maj) ", " _STRINGIZE(min) ", " _STRINGIZE(rev) ", " _STRINGIZE(bld)
 #define RCVERSION_TAG MAKE_VERS(VERS_MAJOR,VERS_MINOR,VERS_REV)
 
-/*! The revision string (contains VERS_TAG) */
+/** The revision string (contains VERS_TAG) */
 extern const char vers_tag[];
 
-/*! Sequential build number (contains VERS_BUILD) */
+/** Sequential build number (contains VERS_BUILD) */
 extern const int vers_build_nr;
 //extern const char vers_build_str[];
 
-/*! Hostname of the machine used to build this binary (contains VERS_HOST) */
+/** Hostname of the machine used to build this binary (contains VERS_HOST) */
 extern const char vers_host[];
 
 #endif /* DEVLIB_VERSTAG_H */
-- 
2.25.1