summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2023-02-16 08:59:19 +0100
committerSebastian Huber <sebastian.huber@embedded-brains.de>2023-02-16 08:59:19 +0100
commit4099d9f59df08cc90e96adb1ea33df42cf83e6cc (patch)
treeb139af2e32db3f61a6faf1d8aebd982b43cb8c2f
parentmodules: Update rtems-docs (diff)
downloadrtems-central-4099d9f59df08cc90e96adb1ea33df42cf83e6cc.tar.bz2
applconfig: Add Doxygen file to a group
-rw-r--r--rtemsspec/applconfig.py5
-rw-r--r--rtemsspec/tests/test_applconfig.py8
2 files changed, 13 insertions, 0 deletions
diff --git a/rtemsspec/applconfig.py b/rtemsspec/applconfig.py
index caef370a..132ee905 100644
--- a/rtemsspec/applconfig.py
+++ b/rtemsspec/applconfig.py
@@ -364,5 +364,10 @@ def generate(config: dict, group_uids: List[str],
sphinx_content.write(group_config["target"])
_generate(group, options, config["enabled-source"], doxygen_content)
doxygen_content.content.prepend_copyrights_and_licenses()
+ doxygen_content.content.prepend([
+ "/**", " * @file", " *", " * @ingroup RTEMSImplDoxygen", " *",
+ " * @brief This header file documents "
+ "the application configuration options.", " */", ""
+ ])
doxygen_content.content.prepend_spdx_license_identifier()
doxygen_content.write(config["doxygen-target"])
diff --git a/rtemsspec/tests/test_applconfig.py b/rtemsspec/tests/test_applconfig.py
index a6c11acc..5135cd5f 100644
--- a/rtemsspec/tests/test_applconfig.py
+++ b/rtemsspec/tests/test_applconfig.py
@@ -447,6 +447,14 @@ description m
with open(doxygen_h, "r") as src:
content = """/* SPDX-License-Identifier: BSD-2-Clause */
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file documents the application configuration options.
+ */
+
/*
* Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
*