Convert some comments to proper Doxygen syntax.

[coreboot.git] / src / superio / smsc / lpc47b272 / lpc47b272_early_serial.c

diff --git a/src/superio/smsc/lpc47b272/lpc47b272_early_serial.c b/src/superio/smsc/lpc47b272/lpc47b272_early_serial.c
index c1f15bf25ea4ddb33d9891a71be0a0cf1b88c36d..0c31b3a9356a46e148ab66229078e3ab698a5629 100644 (file)
--- a/src/superio/smsc/lpc47b272/lpc47b272_early_serial.c
+++ b/src/superio/smsc/lpc47b272/lpc47b272_early_serial.c
@@ -23,38 +23,26 @@
 #include <arch/romcc_io.h>
 #include "lpc47b272.h"
 
-/*
- * Function:           pnp_enter_conf_state
- * Parameters:         dev - high 8 bits = Super I/O port
- * Return Value:       None
- * Description:        Enable access to the LPC47B272's configuration registers.
- */
+/** Enable access to the LPC47B272's configuration registers. */
 static inline void pnp_enter_conf_state(device_t dev)
 {
        unsigned port = dev>>8;
        outb(0x55, port);
 }
 
-/*
- * Function:           pnp_exit_conf_state
- * Parameters:         dev - high 8 bits = Super I/O port
- * Return Value:       None
- * Description:        Disable access to the LPC47B272's configuration registers.
- */
+/** Disable access to the LPC47B272's configuration registers. */
 static void pnp_exit_conf_state(device_t dev)
 {
        unsigned port = dev>>8;
        outb(0xaa, port);
 }
 
-/*
- * Function:           lpc47b272_enable_serial
- * Parameters:         dev - high 8 bits = Super I/O port,
- *                           low 8 bits = logical device number (per lpc47b272.h)
- *                     iobase - processor I/O port address to assign to this serial device
- * Return Value:       bool
- * Description:        Configure the base I/O port of the specified serial device
- *                     and enable the serial device.
+/**
+ * Configure the base I/O port of the specified serial device and enable the
+ * serial device.
+ *
+ * @param dev High 8 bits = Super I/O port, low 8 bits = logical device number.
+ * @param iobase Processor I/O port address to assign to this serial device.
  */
 static void lpc47b272_enable_serial(device_t dev, unsigned iobase)
 {