lib: Add missing file headers for doxygen generation

Add file header on missing .c and *h files to display brief
in documentation.

Signed-off-by: Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>

lib/compiler/armcc/errno.h

@@ -9,6 +9,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	armcc/errno.h
+ * @brief	ARMCC specific error definitions.
+ */
+
 #ifndef __METAL_ARMCC_ERRNO__H__
 #define __METAL_ARMCC_ERRNO__H__
 

lib/compiler/iar/errno.h

@@ -8,6 +8,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	iar/errno.h
+ * @brief	IAR specific error definitions.
+ */
+
 #ifndef __METAL_IAR_ERRNO__H__
 #define __METAL_IAR_ERRNO__H__
 

lib/device.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	device.c
+ * @brief	libmetal bus abstraction definitions.
+ */
+
 #include <string.h>
 #include <metal/assert.h>
 #include <metal/device.h>

lib/dma.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	dma.c
+ * @brief	Libmetal DMA primitives definitions.
+ */
+
 #include <metal/errno.h>
 #include <string.h>
 #include <metal/device.h>

lib/init.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	init.c
+ * @brief	Libmetal initialization.
+ */
+
 #include <string.h>
 #include <metal/sys.h>
 

lib/io.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	io.c
+ * @brief	Libmetal I/O access primitives definition.
+ */
+
 #include <limits.h>
 #include <metal/errno.h>
 #include <metal/io.h>

lib/irq.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	irq.c
+ * @brief	Libmetal interrupt primitives definition.
+ */
+
 #include <metal/errno.h>
 #include <metal/irq.h>
 #include <metal/irq_controller.h>

lib/log.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	log.c
+ * @brief	Libmetal Logging primitives definition.
+ */
+
 #include <stdarg.h>
 #include <stdio.h>
 

lib/softirq.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	softirq.c
+ * @brief	Libmetal soft interrupt primitives definition.
+ */
+
 #include <metal/atomic.h>
 #include <metal/errno.h>
 #include <metal/irq.h>

lib/system/nuttx/io.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	nuttx/io.c
+ * @brief	NuttX libmetal io operations
+ */
+
 #include <stddef.h>
 #include <metal/cache.h>
 #include <metal/io.h>

lib/version.c

@@ -4,6 +4,11 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 
+/**
+ * @file	version.c
+ * @brief	Libmetal version information definition.
+ */
+
 #include <metal/config.h>
 
 int metal_ver_major(void)