[rtems commit] cpukit/include/pci: Manual header file clean up

[Joel Sherrill]

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

Author:    Joel Sherrill <joel at rtems.org>
Date:      Thu Mar 24 16:58:09 2022 -0500

cpukit/include/pci: Manual header file clean up

---

 cpukit/include/pci/access.h         | 13 +++++++++++--
 cpukit/include/pci/cfg.h            |  9 ++++++++-
 cpukit/include/pci/cfg_auto.h       |  9 ++++++++-
 cpukit/include/pci/cfg_peripheral.h |  9 ++++++++-
 cpukit/include/pci/cfg_read.h       | 12 ++++++++++--
 cpukit/include/pci/cfg_static.h     |  9 ++++++++-
 cpukit/include/pci/irq.h            |  9 ++++++++-
 7 files changed, 61 insertions(+), 9 deletions(-)

diff --git a/cpukit/include/pci/access.h b/cpukit/include/pci/access.h
index 4337db3..51530a0 100644
--- a/cpukit/include/pci/access.h
+++ b/cpukit/include/pci/access.h
@@ -1,6 +1,15 @@
-/* Routines to access PCI memory/configuration space and other PCI related
- * functions the PCI Library provides.
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @brief PCI Access Methods
  *
+ * Routines to access PCI memory/configuration space and other PCI related
+ * functions the PCI Library provides.
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be
diff --git a/cpukit/include/pci/cfg.h b/cpukit/include/pci/cfg.h
index 1f55c85..16f0844 100644
--- a/cpukit/include/pci/cfg.h
+++ b/cpukit/include/pci/cfg.h
@@ -1,5 +1,12 @@
-/* PCI Configuration Library
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
  *
+ * @brief PCI Configuration Library
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be
diff --git a/cpukit/include/pci/cfg_auto.h b/cpukit/include/pci/cfg_auto.h
index e374e2e..523ef09 100644
--- a/cpukit/include/pci/cfg_auto.h
+++ b/cpukit/include/pci/cfg_auto.h
@@ -1,5 +1,12 @@
-/* PCI Auto Configuration Library
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
  *
+ * @brief PCI Auto Configuration Library
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be
diff --git a/cpukit/include/pci/cfg_peripheral.h b/cpukit/include/pci/cfg_peripheral.h
index f05c825..f09ebec 100644
--- a/cpukit/include/pci/cfg_peripheral.h
+++ b/cpukit/include/pci/cfg_peripheral.h
@@ -1,5 +1,12 @@
-/* PCI Peripheral Configuration Library
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
  *
+ * @brie PCI Peripheral Configuration Libraryf
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be
diff --git a/cpukit/include/pci/cfg_read.h b/cpukit/include/pci/cfg_read.h
index 3dd7678..f11cbc8 100644
--- a/cpukit/include/pci/cfg_read.h
+++ b/cpukit/include/pci/cfg_read.h
@@ -1,6 +1,14 @@
-/* PCI Read Configuration Library. Read current config that bootloader/BIOS
- * has setup.
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @brief PCI Read Configuration Library
  *
+ * Read current config where bootloader/BIOS has setup.
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be
diff --git a/cpukit/include/pci/cfg_static.h b/cpukit/include/pci/cfg_static.h
index 62ee0da..8fc542c 100644
--- a/cpukit/include/pci/cfg_static.h
+++ b/cpukit/include/pci/cfg_static.h
@@ -1,5 +1,12 @@
-/* Static PCI Auto Configuration Library
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
  *
+ * @brief Static PCI Auto Configuration Library
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be
diff --git a/cpukit/include/pci/irq.h b/cpukit/include/pci/irq.h
index 7622201..98fcc5c 100644
--- a/cpukit/include/pci/irq.h
+++ b/cpukit/include/pci/irq.h
@@ -1,5 +1,12 @@
-/* PCI IRQ Library
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
  *
+ * @brief PCI IRQ Library
+ */
+
+/*
  * COPYRIGHT (c) 2010 Cobham Gaisler AB.
  *
  * The license and distribution terms for this file may be