leon2_doxygen_1

c/src/lib/libbsp/sparc/leon2/clock/ckinit.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Clock Tick Device Driver
+ */
+
 /*
  *  Clock Tick Device Driver
  *

c/src/lib/libbsp/sparc/leon2/console/console.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief TTY driver driver for the serial ports on the LEON console
+ */
+
 /*
  *  This file contains the TTY driver for the serial ports on the LEON.
  *

c/src/lib/libbsp/sparc/leon2/console/debugputs.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief TTY driver for the serial ports on the LEON
+ */
+
 /*
  *  This file contains the TTY driver for the serial ports on the LEON.
  *

c/src/lib/libbsp/sparc/leon2/gnatsupp/gnatsupp.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Support for gnat/rtems iterrupts and exception handling
+ */
+
 /*
  *
  * Support for gnat/rtems interrupts and exception handling.

c/src/lib/libbsp/sparc/leon2/include/bsp.h

@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup sparc_leon2 Sparc Leon2 Handler
+ * @ingroup bsp_kit
+ * @brief Handles Sparc Leon2 simulator
+ */
+
 /*  bsp.h
  *
  *  This include file contains all SPARC simulator definitions.

c/src/lib/libbsp/sparc/leon2/include/bsp/irq.h

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Interrupts definitions
+ */
+
 /* LEON2 generic shared IRQ setup
  *
  * Based on libbsp/shared/include/irq.h.

c/src/lib/libbsp/sparc/leon2/include/cchip.h

@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup cchip Companion Chip handler
+ * @ingroup sparc_leon2
+ * @brief Register all drivers supported by the Companion Chip board
+ */
+
 #ifndef __CCHIP_H__
 #define __CCHIP_H__
 

c/src/lib/libbsp/sparc/leon2/include/leon.h

@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup leon1 Leon-1 Handler
+ * @ingroup sparc_leon2
+ * @brief Handlers Leon-1
+ */
+
 /*  erc32.h
  *
  *  This include file contains information pertaining to the LEON-1.

c/src/lib/libbsp/sparc/leon2/include/rasta.h

@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @defgroup leon2_rasta Rasta Handler
+ * @ingroup sparc_leon2
+ * @brief Handles Rasta
+ */
+
 #ifndef __RASTA_H__
 #define __RASTA_H__
 

c/src/lib/libbsp/sparc/leon2/include/tm27.h

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Implementations for interrupt mechanisms for Time Test 27
+ */
+
 /*
  *  tm27.h
  *

c/src/lib/libbsp/sparc/leon2/leon_smc91111/leon_smc91111.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief SMC91111 Driver
+ */
+
 #include <rtems.h>
 
 #include <bsp.h>

c/src/lib/libbsp/sparc/leon2/pci/pci.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Basic PCI Io functions
+ */
+
 /*
  * pci.c :  this file contains basic PCI Io functions.
  *

c/src/lib/libbsp/sparc/leon2/rasta/rasta.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup leon2_rasta
+ * @brief GR-RASTA-IO PCI board driver
+ */
+
 /*
  *  GR-RASTA-IO PCI board driver
  *

c/src/lib/libbsp/sparc/leon2/startup/bspdelay.c

@@ -1,7 +1,7 @@
 /**
- *  @file
- *
- *  LEON2 BSP Delay Method
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON2 BSP Delay Method
  */
 
 /*

c/src/lib/libbsp/sparc/leon2/startup/bspidle.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON2 Idle Thread 
+ */
+
 /*
  *  LEON2 Idle Thread with power-down function
  *

c/src/lib/libbsp/sparc/leon2/startup/bsppredriver.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Installs BSP pre-driver hook
+ */
+
 /*  Installs the BSP pre-driver hook
  *
  *  COPYRIGHT (c) 2011

c/src/lib/libbsp/sparc/leon2/startup/bspstart.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON2 Cache Snooping Support
+ */
+
 /*
  *  LEON2 Cache Snooping Support
  *

c/src/lib/libbsp/sparc/leon2/startup/setvec.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Installs an interrupt vector on the SPARC simulator
+ */
+
 /*  set_vector
  *
  *  This routine installs an interrupt vector on the SPARC simulator.

c/src/lib/libbsp/sparc/leon2/startup/spurious.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief LEON Spurious Trap Handler
+ */
+
 /*
  *  LEON Spurious Trap Handler
  *

c/src/lib/libbsp/sparc/leon2/timer/timer.c

@@ -1,3 +1,9 @@
+/**
+ * @file
+ * @ingroup sparc_leon2
+ * @brief Implement a benchmark timer using timer 2
+ */
+
 /*  timer.c
  *
  *  This file implements a benchmark timer using timer 2.