bsps/sparc: Add files to Doxygen groups

Update #3707.

bsps/sparc/include/bsp/gnatcommon.h

@@ -1,3 +1,18 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplGnat
+ *
+ * @brief This header file provides interfaces of the
+ *   gnat/rtems interrupts and exception handling.
+ */
+
+/**
+ * @defgroup RTEMSImplGnat GNAT/RTEMS interrupts and exception handling
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #ifndef __GNATCOMMON_H
 #define __GNATCOMMON_H
 

bsps/sparc/include/bsp/gr_leon4_n2x.h

@@ -1,7 +1,15 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
-/*  GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver
+/**
+ * @file
  *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This header file provides interfaces of the
+ *   GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver.
+ */
+
+/*
  *  COPYRIGHT (c) 2013.
  *  Cobham Gaisler AB.
  *

bsps/sparc/include/drvmgr/leon2_amba_bus.h

@@ -1,7 +1,15 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
-/*  LEON2 Hardcoded bus driver interface.
+/**
+ * @file
  *
+ * @ingroup RTEMSBSPsSPARCLEON2
+ *
+ * @brief This header file provides interfaces of the
+ *   LEON2 Hardcoded bus driver.
+ */
+
+/*
  *  COPYRIGHT (c) 2008.
  *  Cobham Gaisler AB.
  *

bsps/sparc/leon3/clock/ckinit.c

@@ -1,13 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the Clock Driver implementation.
+ */
+
 /*
- *  Clock Tick Device Driver
- *
- *  This routine initializes LEON timer 1 which used for the clock tick.
- *
- *  The tick frequency is directly programmed to the configured number of
- *  microseconds per tick.
- *
  *  COPYRIGHT (c) 1989-2006.
  *  On-Line Applications Research Corporation (OAR).
  *

bsps/sparc/leon3/console/printk_support.c

@@ -1,10 +1,15 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the definition of ::BSP_output_char and
+ *   ::BSP_poll_char.
+ */
+
 /*
- *  This file contains the TTY driver for the serial ports on the LEON.
- *
- *  This driver uses the termios pseudo driver.
- *
  *  COPYRIGHT (c) 1989-1999.
  *  On-Line Applications Research Corporation (OAR).
  *

bsps/sparc/leon3/start/bspstart.c

@@ -1,11 +1,15 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
-/*
- *  This set of routines starts the application.  It includes application,
- *  board, and monitor specific initialization and configuration.
- *  The generic CPU dependent initialization has been performed
- *  before any of these are invoked.
+/**
+ * @file
  *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the implementation of bsp_start() and
+ *   definitions of BSP-specific objects.
+ */
+
+/*
  *  COPYRIGHT (c) 2011
  *  Aeroflex Gaisler
  *

bsps/sparc/leon3/start/cache.c

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the implementation of the Cache Manager.
+ */
+
 /*
  * Copyright (c) 2014 embedded brains GmbH & Co. KG
  *

bsps/sparc/leon3/start/cpucounter.c

@@ -1,5 +1,13 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the implementation of the CPU Counter.
+ */
+
 /*
  * Copyright (C) 2014, 2018 embedded brains GmbH & Co. KG
  *

bsps/sparc/leon3/start/eirq.c

@@ -1,8 +1,15 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
-/*
- *  GRLIB/LEON3 extended interrupt controller
+/**
+ * @file
  *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the implementation of the interrupt
+ *   controller support.
+ */
+
+/*
  *  Copyright (C) 2021 embedded brains GmbH & Co. KG
  *
  *  COPYRIGHT (c) 2011

bsps/sparc/shared/irq/bsp_isr_handler.c

@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains the implementation of
+ *   _SPARC_Interrupt_dispatch().
+ */
+
 /*
  *  COPYRIGHT (c) 2015
  *  Cobham Gaisler