cpukit/include/pci: Manual header file clean up

7 files changed, 61 insertions, 9 deletions

diff --git a/cpukit/include/pci/access.h b/cpukit/include/pci/access.h
index 4337db30c3..51530a09b6 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 1f55c85971..16f0844758 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 e374e2e2d4..523ef09e9e 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 f05c8257c6..f09ebec585 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 3dd7678279..f11cbc829a 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 62ee0dad7d..8fc542c7ec 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 7622201fd6..98fcc5cab9 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