From d230d8eaae24d3f705b49790098509f214ef6c5e Mon Sep 17 00:00:00 2001
From: Radu Toma <radustoma@yahoo.com>
Date: Sat, 30 Nov 2013 14:51:35 -0600
Subject: sparc/leon3: Add doxygen.

---
 c/src/lib/libbsp/sparc/leon3/gnatsupp/gnatsupp.c          |  8 ++++++--
 c/src/lib/libbsp/sparc/leon3/include/bsp.h                |  4 ++++
 .../lib/libbsp/sparc/leon3/leon_open_eth/leon_open_eth.c  | 11 +++++++----
 c/src/lib/libbsp/sparc/leon3/smp/getcpuid.c               |  6 +++---
 c/src/lib/libbsp/sparc/leon3/smp/smp_leon3.c              |  6 +++---
 c/src/lib/libbsp/sparc/leon3/startup/bsppredriver.c       |  9 +++++++--
 c/src/lib/libbsp/sparc/leon3/startup/setvec.c             | 15 ++++++++++-----
 7 files changed, 40 insertions(+), 19 deletions(-)

diff --git a/c/src/lib/libbsp/sparc/leon3/gnatsupp/gnatsupp.c b/c/src/lib/libbsp/sparc/leon3/gnatsupp/gnatsupp.c
index 4fe9320cff..4b1056fe4c 100644
--- a/c/src/lib/libbsp/sparc/leon3/gnatsupp/gnatsupp.c
+++ b/c/src/lib/libbsp/sparc/leon3/gnatsupp/gnatsupp.c
@@ -1,6 +1,10 @@
+/**
+ * @file
+ * @ingroup sparc_leon3
+ * @brief Support for gnat/rtems interrupts and exception handling
+ */
+
 /*
- *
- * Support for gnat/rtems interrupts and exception handling.
  * Jiri Gaisler, ESA/ESTEC, 17-02-1999.
  */
 
diff --git a/c/src/lib/libbsp/sparc/leon3/include/bsp.h b/c/src/lib/libbsp/sparc/leon3/include/bsp.h
index ecac2d4ff5..4f4c22b88d 100644
--- a/c/src/lib/libbsp/sparc/leon3/include/bsp.h
+++ b/c/src/lib/libbsp/sparc/leon3/include/bsp.h
@@ -1,3 +1,7 @@
+/**
+ * @defgroup sparc_leon3 Sparc Leon3 Handler
+ */
+
 /*  bsp.h
  *
  *  This include file contains all SPARC simulator definitions.
diff --git a/c/src/lib/libbsp/sparc/leon3/leon_open_eth/leon_open_eth.c b/c/src/lib/libbsp/sparc/leon3/leon_open_eth/leon_open_eth.c
index f8e700cf4b..fe7986522c 100644
--- a/c/src/lib/libbsp/sparc/leon3/leon_open_eth/leon_open_eth.c
+++ b/c/src/lib/libbsp/sparc/leon3/leon_open_eth/leon_open_eth.c
@@ -1,7 +1,10 @@
-/*
- *  LEON3 Opencores Ethernet MAC Configuration Information
- *
- *  COPYRIGHT (c) 2004.
+/**
+ * @file
+ * @ingroup sparc_leon3
+ * @brief LEON3 Opencores Ethernet MAC Configuration Information
+ */
+
+/*  COPYRIGHT (c) 2004.
  *  Gaisler Research
  *
  *  The license and distribution terms for this file may be
diff --git a/c/src/lib/libbsp/sparc/leon3/smp/getcpuid.c b/c/src/lib/libbsp/sparc/leon3/smp/getcpuid.c
index 824278db61..099a83b925 100644
--- a/c/src/lib/libbsp/sparc/leon3/smp/getcpuid.c
+++ b/c/src/lib/libbsp/sparc/leon3/smp/getcpuid.c
@@ -1,7 +1,7 @@
 /**
- *  @file
- *
- *  LEON3 SMP Obtain CPU Core Number
+ * @file
+ * @ingroup sparc_leon3
+ * @brief LEON3 SMP Obtain CPU Core Number
  */
 
 /*
diff --git a/c/src/lib/libbsp/sparc/leon3/smp/smp_leon3.c b/c/src/lib/libbsp/sparc/leon3/smp/smp_leon3.c
index 262116f4e9..07c6d24fa1 100644
--- a/c/src/lib/libbsp/sparc/leon3/smp/smp_leon3.c
+++ b/c/src/lib/libbsp/sparc/leon3/smp/smp_leon3.c
@@ -1,7 +1,7 @@
 /**
- *  @file
- *
- *  LEON3 SMP BSP Support
+ * @file
+ * @ingroup sparc_leon3
+ * @brief LEON3 SMP BSP Support
  */
 
 /*
diff --git a/c/src/lib/libbsp/sparc/leon3/startup/bsppredriver.c b/c/src/lib/libbsp/sparc/leon3/startup/bsppredriver.c
index b6788bccce..b395b17ee3 100644
--- a/c/src/lib/libbsp/sparc/leon3/startup/bsppredriver.c
+++ b/c/src/lib/libbsp/sparc/leon3/startup/bsppredriver.c
@@ -1,5 +1,10 @@
-/*  Installs the BSP pre-driver hook
- *
+/**
+ * @file
+ * @ingroup sparc_leon3
+ * @brief Installs the BSP pre-driver hook
+ */
+
+/*
  *  COPYRIGHT (c) 2011
  *  Aeroflex Gaisler
  *
diff --git a/c/src/lib/libbsp/sparc/leon3/startup/setvec.c b/c/src/lib/libbsp/sparc/leon3/startup/setvec.c
index d5f69ee0b6..f9201891d6 100644
--- a/c/src/lib/libbsp/sparc/leon3/startup/setvec.c
+++ b/c/src/lib/libbsp/sparc/leon3/startup/setvec.c
@@ -1,6 +1,10 @@
-/*  set_vector
- *
- *  This routine installs an interrupt vector on the SPARC simulator.
+/**  
+ * @file
+ * @ingroup sparc_leon3
+ * @brief Install an interrupt vector on SPARC
+ */
+
+/*  This routine installs an interrupt vector on the SPARC simulator.
  *
  *  INPUT PARAMETERS:
  *    handler - interrupt handler entry point
@@ -12,8 +16,9 @@
  *
  *  RETURNS:
  *    address of previous interrupt handler
- *
- *  COPYRIGHT (c) 1989-1998.
+ */ 
+
+/*  COPYRIGHT (c) 1989-1998.
  *  On-Line Applications Research Corporation (OAR).
  *
  *  The license and distribution terms for this file may be
-- 
cgit v1.2.3