[rtems commit] arm/xilinx-zynq: Improve Doxygen file comments

[Sebastian Huber]

Module:    rtems
Branch:    master
Commit:    49720a90d851705d630cc3e688c7ee89665a52fa
Changeset: http://git.rtems.org/rtems/commit/?id=49720a90d851705d630cc3e688c7ee89665a52fa

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Tue May 23 16:09:08 2023 +0200

arm/xilinx-zynq: Improve Doxygen file comments

---

 bsps/arm/xilinx-zynq/console/console-config.c | 12 ++++++++++--
 bsps/arm/xilinx-zynq/console/debug-console.c  | 13 +++++++++++--
 bsps/arm/xilinx-zynq/start/bspreset.c         | 12 ++++++++++--
 bsps/arm/xilinx-zynq/start/bspstart.c         | 13 +++++++++++--
 bsps/arm/xilinx-zynq/start/bspstarthooks.c    | 13 +++++++++++--
 bsps/arm/xilinx-zynq/start/bspstartmmu.c      | 13 +++++++++++--
 bsps/shared/dev/serial/zynq-uart-polled.c     | 13 +++++++++++--
 7 files changed, 75 insertions(+), 14 deletions(-)

diff --git a/bsps/arm/xilinx-zynq/console/console-config.c b/bsps/arm/xilinx-zynq/console/console-config.c
index 1f2abf572d..d22ceb557d 100644
--- a/bsps/arm/xilinx-zynq/console/console-config.c
+++ b/bsps/arm/xilinx-zynq/console/console-config.c
@@ -1,6 +1,14 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the definition of ::zynq_uart_instances.
+ */
+
+/*
  * Copyright (C) 2013, 2017 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/bsps/arm/xilinx-zynq/console/debug-console.c b/bsps/arm/xilinx-zynq/console/debug-console.c
index b96a651175..6e89ad0323 100644
--- a/bsps/arm/xilinx-zynq/console/debug-console.c
+++ b/bsps/arm/xilinx-zynq/console/debug-console.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the definition of ::BSP_output_char and
+ *   ::BSP_poll_char.
+ */
+
+/*
  * Copyright (C) 2013, 2017 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/bsps/arm/xilinx-zynq/start/bspreset.c b/bsps/arm/xilinx-zynq/start/bspreset.c
index 58bb95fa8e..f8cc3b6999 100644
--- a/bsps/arm/xilinx-zynq/start/bspreset.c
+++ b/bsps/arm/xilinx-zynq/start/bspreset.c
@@ -1,6 +1,14 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the implementation of bsp_reset().
+ */
+
+/*
  * Copyright (C) 2013 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/bsps/arm/xilinx-zynq/start/bspstart.c b/bsps/arm/xilinx-zynq/start/bspstart.c
index 34fd9ce34e..89926ce1f3 100644
--- a/bsps/arm/xilinx-zynq/start/bspstart.c
+++ b/bsps/arm/xilinx-zynq/start/bspstart.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the implementation of zynq_clock_cpu_1x()
+ *   and bsp_start().
+ */
+
+/*
  * Copyright (C) 2013, 2015 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/bsps/arm/xilinx-zynq/start/bspstarthooks.c b/bsps/arm/xilinx-zynq/start/bspstarthooks.c
index a1e635a0de..de6a4ccd54 100644
--- a/bsps/arm/xilinx-zynq/start/bspstarthooks.c
+++ b/bsps/arm/xilinx-zynq/start/bspstarthooks.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the implementation of bsp_start_hook_0()
+ *   and bsp_start_hook_1().
+ */
+
+/*
  * Copyright (C) 2013, 2014 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/bsps/arm/xilinx-zynq/start/bspstartmmu.c b/bsps/arm/xilinx-zynq/start/bspstartmmu.c
index 1290bd4c08..04d7586c1b 100644
--- a/bsps/arm/xilinx-zynq/start/bspstartmmu.c
+++ b/bsps/arm/xilinx-zynq/start/bspstartmmu.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the implementation of
+ *   zynq_setup_mmu_and_cache().
+ */
+
+/*
  * Copyright (C) 2013 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/bsps/shared/dev/serial/zynq-uart-polled.c b/bsps/shared/dev/serial/zynq-uart-polled.c
index cf0fead2d4..7d5dd8ff1a 100644
--- a/bsps/shared/dev/serial/zynq-uart-polled.c
+++ b/bsps/shared/dev/serial/zynq-uart-polled.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsARMZynq
  *
+ * @brief This source file contains the implementation of the polled Zynq UART
+ *   support.
+ */
+
+/*
  * Copyright (C) 2013, 2017 embedded brains GmbH & Co. KG
  *
  * Redistribution and use in source and binary forms, with or without