i386/pc386: Add doxygen file headers.

c/src/lib/libbsp/i386/pc386/3c509/3c509.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup pc386_3c509
+ *
+ * @brief 3C509 PC card support.
+ */
+
 /*
  * Copyright (c) 1993 Herb Peyerl (hpeyerl@novatel.ca) All rights reserved.
  *
@@ -47,6 +55,14 @@
  *		nao@tom-yam.or.jp
  */
 
+/**
+ * @defgroup pc386_3c509 3C509 Support
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief 3C509 support.
+ */
+
 /*
 typedef unsigned short u_short;
 typedef unsigned long  u_long;

c/src/lib/libbsp/i386/pc386/3c509/elink.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ * 
+ * @ingroup pc386_3c509
+ *
+ * @brief EtherLink definitions.
+ */
+
 /*
  * Copyright (c) 1994 Charles Hannum.  All rights reserved.
  *

c/src/lib/libbsp/i386/pc386/console/exar17d15x.h

@@ -1,8 +1,9 @@
 /**
- * @file bsp/exar17d15x.h
+ * @file
  *
- *  This file provides the interface to the Exar Multiport
- *  PCI UART controller.
+ * @ingroup i386_pc386
+ *
+ * @brief Exar Multiport PCI UART interface.
  */
 
 /*

c/src/lib/libbsp/i386/pc386/console/i386kbd.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ * 
+ * @ingroup i386_pc386
+ *
+ * @brief I386 keyboard definitions.
+ */
+
 /*
  *  linux/include/asm-i386/keyboard.h
  *

c/src/lib/libbsp/i386/pc386/console/kd.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief KD definitions.
+ */
+
 /*
  *  by: Rosimildo da Silva:  rdasilva@connecttel.com
  *

c/src/lib/libbsp/i386/pc386/console/keyboard.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief Keyboard definitions.
+ */
+
 /*
  *  Submitted by: Rosimildo da Silva:  rdasilva@connecttel.com
  */

c/src/lib/libbsp/i386/pc386/console/ps2_drv.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief Paux driver routines.
+ */
+
 #ifndef __paux_drv__
 #define __paux_drv__
 /***************************************************************************

c/src/lib/libbsp/i386/pc386/console/ps2_mouse.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief Keyboard and mouse definitions.
+ */
+
 /*
  *	include/linux/pc_keyb.h
  *	PC Keyboard And Keyboard Controller

c/src/lib/libbsp/i386/pc386/console/rtd316.h

@@ -1,10 +1,9 @@
 /**
- *  @file bsp/rtd316.h
+ * @file
  *
- *  @brief RTD316 Driver Interface Definition
+ * @ingroup i386_pc386
  *
- *  This file provides the interface to the RTD316 Dual
- *  serial port utility module.
+ * @brief RTD316 driver interface defintions.
  */
 
 /*

c/src/lib/libbsp/i386/pc386/console/vgacons.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief VGA definitions.
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2011.
  *  On-Line Applications Research Corporation (OAR).

c/src/lib/libbsp/i386/pc386/include/bsp.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief Global BSP definitions.
+ */
+
 /*-------------------------------------------------------------------------+
 | bsp.h v1.1 - PC386 BSP - 1997/08/07
 +--------------------------------------------------------------------------+
@@ -53,6 +61,14 @@ extern "C" {
 #include <libcpu/cpu.h>
 #include <rtems/bspIo.h>
 
+/**
+ * @degroup pc386_i386 PC386 Support
+ *
+ * @ingroup bsp_i386
+ *
+ * @brief PC386 support.
+ */
+
 #define BSP_HAS_FRAME_BUFFER 1
 
 /*

c/src/lib/libbsp/i386/pc386/include/crt.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief CRT controller definitions.
+ */
+
 /*
  * crt.h  - This file contains definitions for constants related to PC console.
  *          More information can be found at

c/src/lib/libbsp/i386/pc386/include/tm27.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief Implementation of interrupt mechanisms for Time Test 27.
+ */
+
 /*
  *  tm27.h
  *

c/src/lib/libbsp/i386/pc386/include/wd80x3.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup i386_pc386
+ *
+ * @brief DP8390 Ethernet controller definitions.
+ */
+
 /*
  *  Information about the DP8390 Ethernet controller.
  */