You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by xi...@apache.org on 2021/03/23 02:28:59 UTC

[incubator-nuttx] 10/16: arch: arm: include: nxstyle fixes

This is an automated email from the ASF dual-hosted git repository.

xiaoxiang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-nuttx.git

commit c39339a7a89e7a6738dcee96b2ce2e72010273e7
Author: Alin Jerpelea <al...@sony.com>
AuthorDate: Sun Mar 21 11:37:01 2021 +0100

    arch: arm: include: nxstyle fixes
    
    nxstyle fixes to pass CI
    
    Signed-off-by: Alin Jerpelea <al...@sony.com>
---
 arch/arm/include/a1x/a10_irq.h                   |  34 ++--
 arch/arm/include/a1x/chip.h                      |  26 +--
 arch/arm/include/a1x/irq.h                       |  30 +--
 arch/arm/include/am335x/am335x_irq.h             |  35 ++--
 arch/arm/include/am335x/chip.h                   |  28 +--
 arch/arm/include/am335x/irq.h                    |  32 +--
 arch/arm/include/arch.h                          |   2 +-
 arch/arm/include/arm/irq.h                       |   4 +-
 arch/arm/include/arm/syscall.h                   |   2 +-
 arch/arm/include/armv6-m/irq.h                   |   8 +-
 arch/arm/include/armv6-m/syscall.h               |   2 +-
 arch/arm/include/armv7-a/irq.h                   |   2 +-
 arch/arm/include/armv7-a/syscall.h               |   2 +-
 arch/arm/include/armv7-m/irq.h                   |   2 +-
 arch/arm/include/armv7-m/irq_cmnvector.h         |   2 +-
 arch/arm/include/armv7-m/irq_lazyfpu.h           |   2 +-
 arch/arm/include/armv7-m/nvicpri.h               |  14 +-
 arch/arm/include/armv7-m/syscall.h               |   2 +-
 arch/arm/include/armv7-r/irq.h                   |   2 +-
 arch/arm/include/armv7-r/syscall.h               |   2 +-
 arch/arm/include/armv8-m/irq.h                   |   2 +-
 arch/arm/include/armv8-m/irq_cmnvector.h         |   2 +-
 arch/arm/include/armv8-m/irq_lazyfpu.h           |   2 +-
 arch/arm/include/armv8-m/nvicpri.h               |  14 +-
 arch/arm/include/armv8-m/syscall.h               |   2 +-
 arch/arm/include/c5471/irq.h                     |   2 +-
 arch/arm/include/cxd56xx/adc.h                   |   2 +-
 arch/arm/include/cxd56xx/audio.h                 |   2 +-
 arch/arm/include/cxd56xx/battery_ioctl.h         |   2 +-
 arch/arm/include/cxd56xx/chip.h                  |   2 +-
 arch/arm/include/cxd56xx/crashdump.h             |   2 +-
 arch/arm/include/cxd56xx/irq.h                   |   2 +-
 arch/arm/include/cxd56xx/pin.h                   |   4 +-
 arch/arm/include/cxd56xx/pm.h                    |   4 +-
 arch/arm/include/cxd56xx/scu.h                   |   2 +-
 arch/arm/include/cxd56xx/timer.h                 |   2 +-
 arch/arm/include/cxd56xx/usbdev.h                |   2 +-
 arch/arm/include/dm320/irq.h                     |   2 +-
 arch/arm/include/efm32/chip.h                    |  22 +--
 arch/arm/include/efm32/efm32g_irq.h              |   7 +-
 arch/arm/include/efm32/efm32gg_irq.h             |   4 +-
 arch/arm/include/efm32/efm32tg_irq.h             |   4 +-
 arch/arm/include/efm32/irq.h                     |  70 +++----
 arch/arm/include/elf.h                           |  12 +-
 arch/arm/include/eoss3/chip.h                    |   2 +-
 arch/arm/include/eoss3/irq.h                     |   2 +-
 arch/arm/include/imx1/irq.h                      |   2 +-
 arch/arm/include/imx6/chip.h                     |   5 +-
 arch/arm/include/imx6/irq.h                      |   7 +-
 arch/arm/include/imxrt/chip.h                    |  31 +--
 arch/arm/include/imxrt/imxrt102x_irq.h           |  82 ++++++--
 arch/arm/include/imxrt/imxrt105x_irq.h           |  43 ++--
 arch/arm/include/imxrt/imxrt106x_irq.h           |  45 ++---
 arch/arm/include/imxrt/irq.h                     |  40 ++--
 arch/arm/include/inttypes.h                      |   2 +-
 arch/arm/include/kinetis/chip.h                  |  38 ++--
 arch/arm/include/kinetis/irq.h                   |  47 ++---
 arch/arm/include/kinetis/kinetis_dma.h           |  43 ++--
 arch/arm/include/kinetis/kinetis_dmamux.h        |  39 ++--
 arch/arm/include/kinetis/kinetis_k20irq.h        |  33 ++--
 arch/arm/include/kinetis/kinetis_k28irq.h        |  37 ++--
 arch/arm/include/kinetis/kinetis_k40irq.h        |  37 ++--
 arch/arm/include/kinetis/kinetis_k60irq.h        |  37 ++--
 arch/arm/include/kinetis/kinetis_k64irq.h        |  37 ++--
 arch/arm/include/kinetis/kinetis_k66irq.h        |  38 ++--
 arch/arm/include/kinetis/kinetis_lpuart.h        |  48 +++--
 arch/arm/include/kinetis/kinetis_mcg.h           |  87 +++++----
 arch/arm/include/kinetis/kinetis_pmc.h           |  40 ++--
 arch/arm/include/kinetis/kinetis_sim.h           |  61 +++---
 arch/arm/include/kl/chip.h                       |  38 ++--
 arch/arm/include/kl/irq.h                        |  92 ++++-----
 arch/arm/include/lc823450/chip.h                 |   2 +-
 arch/arm/include/lc823450/clk.h                  |   2 +-
 arch/arm/include/lc823450/irq.h                  |   2 +-
 arch/arm/include/limits.h                        |   2 +-
 arch/arm/include/lpc17xx_40xx/chip.h             |  52 +++--
 arch/arm/include/lpc17xx_40xx/irq.h              |   3 +-
 arch/arm/include/lpc17xx_40xx/lpc176x_irq.h      |  19 +-
 arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h |  15 +-
 arch/arm/include/lpc214x/irq.h                   |   2 +-
 arch/arm/include/lpc2378/irq.h                   |   6 +-
 arch/arm/include/lpc31xx/irq.h                   |   2 +-
 arch/arm/include/lpc43xx/chip.h                  |  80 ++++----
 arch/arm/include/lpc43xx/irq.h                   |  45 ++---
 arch/arm/include/lpc54xx/chip.h                  |  41 ++--
 arch/arm/include/lpc54xx/irq.h                   |  29 +--
 arch/arm/include/lpc54xx/lpc546x_irq.h           |  14 +-
 arch/arm/include/max326xx/chip.h                 |  48 ++---
 arch/arm/include/max326xx/irq.h                  |  37 ++--
 arch/arm/include/max326xx/max32620_30_irq.h      |  38 ++--
 arch/arm/include/max326xx/max32660_irq.h         |  42 ++--
 arch/arm/include/moxart/irq.h                    |   2 +-
 arch/arm/include/nrf52/chip.h                    |  34 ++--
 arch/arm/include/nrf52/irq.h                     |  33 ++--
 arch/arm/include/nrf52/nrf52_irq.h               |  14 +-
 arch/arm/include/nuc1xx/chip.h                   |  43 ++--
 arch/arm/include/nuc1xx/irq.h                    |  43 ++--
 arch/arm/include/nuc1xx/nuc120_irq.h             |  32 +--
 arch/arm/include/rp2040/irq.h                    |   2 +-
 arch/arm/include/s32k1xx/chip.h                  |  32 +--
 arch/arm/include/s32k1xx/s32k11x_irq.h           |  29 +--
 arch/arm/include/s32k1xx/s32k14x_irq.h           |  29 +--
 arch/arm/include/sam34/chip.h                    | 103 ++++++----
 arch/arm/include/sam34/irq.h                     |  37 ++--
 arch/arm/include/sam34/sam3u_irq.h               |  34 ++--
 arch/arm/include/sam34/sam3x_irq.h               |  34 ++--
 arch/arm/include/sam34/sam4cm_irq.h              |  34 ++--
 arch/arm/include/sam34/sam4e_irq.h               |  36 ++--
 arch/arm/include/sam34/sam4l_irq.h               |  42 ++--
 arch/arm/include/sam34/sam4s_irq.h               |  34 ++--
 arch/arm/include/sama5/chip.h                    | 238 +++++++++++++++--------
 arch/arm/include/sama5/irq.h                     |  30 +--
 arch/arm/include/sama5/sama5d2_irq.h             |  54 ++---
 arch/arm/include/sama5/sama5d3_irq.h             |  34 ++--
 arch/arm/include/sama5/sama5d4_irq.h             |  34 ++--
 arch/arm/include/samd2l2/chip.h                  |  69 ++++---
 arch/arm/include/samd2l2/irq.h                   |  41 ++--
 arch/arm/include/samd2l2/sam_adc.h               |   6 +-
 arch/arm/include/samd2l2/samd20_irq.h            |  34 ++--
 arch/arm/include/samd2l2/samd21_irq.h            |  34 ++--
 arch/arm/include/samd2l2/saml21_irq.h            |  34 ++--
 arch/arm/include/samd5e5/chip.h                  |  43 ++--
 arch/arm/include/samd5e5/irq.h                   |  37 ++--
 arch/arm/include/samd5e5/samd5e5_irq.h           |  35 ++--
 arch/arm/include/samv7/chip.h                    |  38 ++--
 arch/arm/include/samv7/irq.h                     |  37 ++--
 arch/arm/include/samv7/same70_irq.h              |  38 ++--
 arch/arm/include/samv7/samv71_irq.h              |  38 ++--
 arch/arm/include/spinlock.h                      |   2 +-
 arch/arm/include/stdarg.h                        |   3 +-
 arch/arm/include/stm32/chip.h                    |  68 ++++---
 arch/arm/include/stm32/irq.h                     |  41 ++--
 arch/arm/include/stm32/stm32f10xxx_irq.h         |   2 +-
 arch/arm/include/stm32/stm32f20xxx_irq.h         |   2 +-
 arch/arm/include/stm32/stm32f30xxx_irq.h         |   2 +-
 arch/arm/include/stm32/stm32f33xxx_irq.h         |   2 +-
 arch/arm/include/stm32/stm32f37xxx_irq.h         |   2 +-
 arch/arm/include/stm32/stm32f40xxx_irq.h         |  36 ++--
 arch/arm/include/stm32/stm32g4xxxx_irq.h         |  26 +--
 arch/arm/include/stm32/stm32l15xxx_irq.h         |   2 +-
 arch/arm/include/stm32f0l0g0/chip.h              |   2 +-
 arch/arm/include/stm32f0l0g0/irq.h               |   2 +-
 arch/arm/include/stm32f0l0g0/stm32f0_irq.h       |   2 +-
 arch/arm/include/stm32f0l0g0/stm32g0_irq.h       |   2 +-
 arch/arm/include/stm32f0l0g0/stm32l0_irq.h       |  41 ++--
 arch/arm/include/stm32f7/chip.h                  | 224 +++++++++++++--------
 arch/arm/include/stm32f7/irq.h                   |   2 +-
 arch/arm/include/stm32f7/stm32f72xx73xx_irq.h    |   2 +-
 arch/arm/include/stm32f7/stm32f74xx75xx_irq.h    |   2 +-
 arch/arm/include/stm32f7/stm32f76xx77xx_irq.h    |   2 +-
 arch/arm/include/stm32h7/chip.h                  |  20 +-
 arch/arm/include/stm32h7/irq.h                   |   2 +-
 arch/arm/include/stm32h7/stm32h7x3xx_irq.h       |  30 +--
 arch/arm/include/stm32h7/stm32h7x7xx_irq.h       |   2 +-
 arch/arm/include/stm32l4/chip.h                  |   2 +-
 arch/arm/include/stm32l4/irq.h                   |   2 +-
 arch/arm/include/stm32l4/stm32l4x3xx_irq.h       |   2 +-
 arch/arm/include/stm32l4/stm32l4x5xx_irq.h       |   2 +-
 arch/arm/include/stm32l4/stm32l4x6xx_irq.h       |   2 +-
 arch/arm/include/stm32l4/stm32l4xrxx_irq.h       |   2 +-
 arch/arm/include/stm32l5/chip.h                  |  16 +-
 arch/arm/include/stm32l5/irq.h                   |   8 +-
 arch/arm/include/stm32l5/stm32l562xx_irq.h       |  20 +-
 arch/arm/include/stm32l5/stm32l5_irq.h           |  42 ++--
 arch/arm/include/str71x/irq.h                    |  28 +--
 arch/arm/include/syscall.h                       |   2 +-
 arch/arm/include/tiva/cc13x0_irq.h               |   2 +-
 arch/arm/include/tiva/cc13x2_cc26x2_irq.h        |   2 +-
 arch/arm/include/tiva/chip.h                     |   2 +-
 arch/arm/include/tiva/irq.h                      |  30 +--
 arch/arm/include/tiva/lm3s_irq.h                 |  33 ++--
 arch/arm/include/tiva/lm4f_irq.h                 |  33 ++--
 arch/arm/include/tiva/tm4c_irq.h                 |  33 ++--
 arch/arm/include/tms570/chip.h                   |  84 +++++---
 arch/arm/include/tms570/irq.h                    |  41 ++--
 arch/arm/include/tms570/tms570ls04x03x_irq.h     |  37 ++--
 arch/arm/include/types.h                         |   2 +-
 arch/arm/include/xmc4/chip.h                     |  38 ++--
 arch/arm/include/xmc4/irq.h                      |  36 ++--
 arch/arm/include/xmc4/xmc4500_irq.h              |  16 +-
 arch/arm/include/xmc4/xmc4700_irq.h              |  16 +-
 arch/arm/include/xmc4/xmc4800_irq.h              |  16 +-
 182 files changed, 2461 insertions(+), 2030 deletions(-)

diff --git a/arch/arm/include/a1x/a10_irq.h b/arch/arm/include/a1x/a10_irq.h
index 85691e6..3ec3b10 100644
--- a/arch/arm/include/a1x/a10_irq.h
+++ b/arch/arm/include/a1x/a10_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/a1x/a10_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_A1X_A10_IRQ_H
 #define __ARCH_ARM_INCLUDE_A1X_A10_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts numbers */
 
@@ -173,21 +173,21 @@
 
 #define NR_IRQS            (A1X_IRQ_NINT + A1X_PIO_NINT)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/a1x/chip.h b/arch/arm/include/a1x/chip.h
index 521d1b1..f7c15e7 100644
--- a/arch/arm/include/a1x/chip.h
+++ b/arch/arm/include/a1x/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/a1x/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_A1X_CHIP_H
 #define __ARCH_ARM_INCLUDE_A1X_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* A1X Family */
 
@@ -39,16 +39,16 @@
 #  error Unrecognized A1X chip
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Functions Prototypes
- ************************************************************************************/
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_A1X_CHIP_H */
diff --git a/arch/arm/include/a1x/irq.h b/arch/arm/include/a1x/irq.h
index e5cb970..04be0da 100644
--- a/arch/arm/include/a1x/irq.h
+++ b/arch/arm/include/a1x/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/a1x/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,18 +16,18 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_A1X_IRQ_H
 #define __ARCH_ARM_INCLUDE_A1X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/a1x/chip.h>
@@ -40,19 +40,19 @@
 #  error Unrecognized A1X chip
 #endif
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -62,9 +62,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/am335x/am335x_irq.h b/arch/arm/include/am335x/am335x_irq.h
index 178afad..aa6c3d4 100644
--- a/arch/arm/include/am335x/am335x_irq.h
+++ b/arch/arm/include/am335x/am335x_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/am335x/am335x_irq.h
  *
  *   Copyright (C) 2019 Petro Karashchenko. All rights reserved.
@@ -31,24 +31,25 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_AM335X_AM335X_IRQ_H
 #define __ARCH_ARM_INCLUDE_AM335X_AM335X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts numbers */
+
 /* Interrupt number list */
 
 #define AM335X_IRQ_EMU                  (0) /* Emulation interrupt */
@@ -320,21 +321,21 @@
                                          AM335X_NGPIO0IRQS + AM335X_NGPIO1IRQS + \
                                          AM335X_NGPIO2IRQS + AM335X_NGPIO3IRQS )
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/am335x/chip.h b/arch/arm/include/am335x/chip.h
index b919124..3f3d49f 100644
--- a/arch/arm/include/am335x/chip.h
+++ b/arch/arm/include/am335x/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/am335x/chip.h
  *
  *   Copyright (C) 2018 Petro Karashchenko. All rights reserved.
@@ -31,20 +31,20 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_AM335X_CHIP_H
 #define __ARCH_ARM_INCLUDE_AM335X_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* AM335X Family */
 
@@ -54,16 +54,16 @@
 #  error Unrecognized AM335X chip
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_AM335X_CHIP_H */
diff --git a/arch/arm/include/am335x/irq.h b/arch/arm/include/am335x/irq.h
index 72b65e9..8c78c47 100644
--- a/arch/arm/include/am335x/irq.h
+++ b/arch/arm/include/am335x/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/am335x/irq.h
  *
  *   Copyright (C) 2019 Petro Karashchenko. All rights reserved.
@@ -31,26 +31,22 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_AM335X_IRQ_H
 #define __ARCH_ARM_INCLUDE_AM335X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/am335x/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
-
 /* Chip-Specific External interrupts */
 
 #if defined(CONFIG_ARCH_CHIP_AM335X)
@@ -59,15 +55,19 @@
 #  error Unrecognized AM335X chip
 #endif
 
-/****************************************************************************************
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -77,9 +77,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/arch.h b/arch/arm/include/arch.h
index 46d47b8..4ddbb53 100644
--- a/arch/arm/include/arch.h
+++ b/arch/arm/include/arch.h
@@ -37,7 +37,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #ifdef CONFIG_PIC
diff --git a/arch/arm/include/arm/irq.h b/arch/arm/include/arm/irq.h
index 5a79821..6c7f3ae 100644
--- a/arch/arm/include/arm/irq.h
+++ b/arch/arm/include/arm/irq.h
@@ -35,7 +35,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format:
@@ -172,7 +172,7 @@ struct xcptcontext
  * leave_critical section(), are probably what you really want.
  */
 
- /* Save the current interrupt enable state & disable IRQs. */
+/* Save the current interrupt enable state & disable IRQs. */
 
 static inline irqstate_t up_irq_save(void)
 {
diff --git a/arch/arm/include/arm/syscall.h b/arch/arm/include/arm/syscall.h
index bd5d86c..f7be3c1 100644
--- a/arch/arm/include/arm/syscall.h
+++ b/arch/arm/include/arm/syscall.h
@@ -36,7 +36,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define SYS_syscall 0x00
diff --git a/arch/arm/include/armv6-m/irq.h b/arch/arm/include/armv6-m/irq.h
index 21ac8ea..45ce521 100644
--- a/arch/arm/include/armv6-m/irq.h
+++ b/arch/arm/include/armv6-m/irq.h
@@ -40,10 +40,14 @@
 #include <arch/chip/chip.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
+
 /* Configuration ************************************************************/
-/* If this is a kernel build, how many nested system calls should we support? */
+
+/* If this is a kernel build,
+ * how many nested system calls should we support?
+ */
 
 #ifndef CONFIG_SYS_NNEST
 #  define CONFIG_SYS_NNEST 2
diff --git a/arch/arm/include/armv6-m/syscall.h b/arch/arm/include/armv6-m/syscall.h
index cf5a1e9..da96e1f 100644
--- a/arch/arm/include/armv6-m/syscall.h
+++ b/arch/arm/include/armv6-m/syscall.h
@@ -36,7 +36,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* This is the value used as the argument to the SVC instruction.  It is not
diff --git a/arch/arm/include/armv7-a/irq.h b/arch/arm/include/armv7-a/irq.h
index c9247c4..fc40750 100644
--- a/arch/arm/include/armv7-a/irq.h
+++ b/arch/arm/include/armv7-a/irq.h
@@ -38,7 +38,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format:
diff --git a/arch/arm/include/armv7-a/syscall.h b/arch/arm/include/armv7-a/syscall.h
index 6ea02ae..a235a04 100644
--- a/arch/arm/include/armv7-a/syscall.h
+++ b/arch/arm/include/armv7-a/syscall.h
@@ -36,7 +36,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define SYS_syscall 0x00
diff --git a/arch/arm/include/armv7-m/irq.h b/arch/arm/include/armv7-m/irq.h
index 9520e6d..7cca75b 100644
--- a/arch/arm/include/armv7-m/irq.h
+++ b/arch/arm/include/armv7-m/irq.h
@@ -47,7 +47,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Configuration ************************************************************/
diff --git a/arch/arm/include/armv7-m/irq_cmnvector.h b/arch/arm/include/armv7-m/irq_cmnvector.h
index 5117d8b..93b3835 100644
--- a/arch/arm/include/armv7-m/irq_cmnvector.h
+++ b/arch/arm/include/armv7-m/irq_cmnvector.h
@@ -26,7 +26,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format: */
diff --git a/arch/arm/include/armv7-m/irq_lazyfpu.h b/arch/arm/include/armv7-m/irq_lazyfpu.h
index 0837e7c..d632d4c 100644
--- a/arch/arm/include/armv7-m/irq_lazyfpu.h
+++ b/arch/arm/include/armv7-m/irq_lazyfpu.h
@@ -26,7 +26,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format: */
diff --git a/arch/arm/include/armv7-m/nvicpri.h b/arch/arm/include/armv7-m/nvicpri.h
index 59c34fa..e081aaf 100644
--- a/arch/arm/include/armv7-m/nvicpri.h
+++ b/arch/arm/include/armv7-m/nvicpri.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/armv7-m/nvicpri.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_ARM7_M_NVICPRI_H
 #define __ARCH_ARM_INCLUDE_ARM7_M_NVICPRI_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <arch/chip/chip.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* If CONFIG_ARMV7M_USEBASEPRI is selected, then interrupts will be disabled
  * by setting the BASEPRI register to NVIC_SYSH_DISABLE_PRIORITY so that most
diff --git a/arch/arm/include/armv7-m/syscall.h b/arch/arm/include/armv7-m/syscall.h
index 6e9f57d..83e809f 100644
--- a/arch/arm/include/armv7-m/syscall.h
+++ b/arch/arm/include/armv7-m/syscall.h
@@ -36,7 +36,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* This is the value used as the argument to the SVC instruction.  It is not
diff --git a/arch/arm/include/armv7-r/irq.h b/arch/arm/include/armv7-r/irq.h
index 771a3f0..ebb5fdd 100644
--- a/arch/arm/include/armv7-r/irq.h
+++ b/arch/arm/include/armv7-r/irq.h
@@ -38,7 +38,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format:
diff --git a/arch/arm/include/armv7-r/syscall.h b/arch/arm/include/armv7-r/syscall.h
index 7381ce6..e86170f 100644
--- a/arch/arm/include/armv7-r/syscall.h
+++ b/arch/arm/include/armv7-r/syscall.h
@@ -36,7 +36,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define SYS_syscall 0x00
diff --git a/arch/arm/include/armv8-m/irq.h b/arch/arm/include/armv8-m/irq.h
index 20eaff3..df03f7a 100644
--- a/arch/arm/include/armv8-m/irq.h
+++ b/arch/arm/include/armv8-m/irq.h
@@ -47,7 +47,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Configuration ************************************************************/
diff --git a/arch/arm/include/armv8-m/irq_cmnvector.h b/arch/arm/include/armv8-m/irq_cmnvector.h
index 4c784e7..9956374 100644
--- a/arch/arm/include/armv8-m/irq_cmnvector.h
+++ b/arch/arm/include/armv8-m/irq_cmnvector.h
@@ -26,7 +26,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format: */
diff --git a/arch/arm/include/armv8-m/irq_lazyfpu.h b/arch/arm/include/armv8-m/irq_lazyfpu.h
index 33af6d8..1f3f0c7 100644
--- a/arch/arm/include/armv8-m/irq_lazyfpu.h
+++ b/arch/arm/include/armv8-m/irq_lazyfpu.h
@@ -26,7 +26,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ Stack Frame Format: */
diff --git a/arch/arm/include/armv8-m/nvicpri.h b/arch/arm/include/armv8-m/nvicpri.h
index 56aafb1..c2b2d91 100644
--- a/arch/arm/include/armv8-m/nvicpri.h
+++ b/arch/arm/include/armv8-m/nvicpri.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/armv8-m/nvicpri.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_ARM8_M_NVICPRI_H
 #define __ARCH_ARM_INCLUDE_ARM8_M_NVICPRI_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <arch/chip/chip.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* If CONFIG_ARMV8M_USEBASEPRI is selected, then interrupts will be disabled
  * by setting the BASEPRI register to NVIC_SYSH_DISABLE_PRIORITY so that most
diff --git a/arch/arm/include/armv8-m/syscall.h b/arch/arm/include/armv8-m/syscall.h
index 03ad475..458c33a 100644
--- a/arch/arm/include/armv8-m/syscall.h
+++ b/arch/arm/include/armv8-m/syscall.h
@@ -36,7 +36,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* This is the value used as the argument to the SVC instruction.  It is not
diff --git a/arch/arm/include/c5471/irq.h b/arch/arm/include/c5471/irq.h
index 7c06f41..d378321 100644
--- a/arch/arm/include/c5471/irq.h
+++ b/arch/arm/include/c5471/irq.h
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* C5471 Interrupts */
diff --git a/arch/arm/include/cxd56xx/adc.h b/arch/arm/include/cxd56xx/adc.h
index 6817f0a..a4dba22 100644
--- a/arch/arm/include/cxd56xx/adc.h
+++ b/arch/arm/include/cxd56xx/adc.h
@@ -45,7 +45,7 @@
 #include <nuttx/analog/ioctl.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define ANIOC_USER                 (AN_FIRST + AN_NCMDS)
diff --git a/arch/arm/include/cxd56xx/audio.h b/arch/arm/include/cxd56xx/audio.h
index a6c95cd..df0a869 100644
--- a/arch/arm/include/cxd56xx/audio.h
+++ b/arch/arm/include/cxd56xx/audio.h
@@ -57,7 +57,7 @@
 #include <stdbool.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Mic channel max. */
diff --git a/arch/arm/include/cxd56xx/battery_ioctl.h b/arch/arm/include/cxd56xx/battery_ioctl.h
index 971d45c..9b811f4 100644
--- a/arch/arm/include/cxd56xx/battery_ioctl.h
+++ b/arch/arm/include/cxd56xx/battery_ioctl.h
@@ -43,7 +43,7 @@
 #include <nuttx/fs/ioctl.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* ioctl commands */
diff --git a/arch/arm/include/cxd56xx/chip.h b/arch/arm/include/cxd56xx/chip.h
index c9cc33b..c1afb4d 100644
--- a/arch/arm/include/cxd56xx/chip.h
+++ b/arch/arm/include/cxd56xx/chip.h
@@ -22,7 +22,7 @@
 #define __ARCH_ARM_INCLUDE_CXD56XX_CHIP_H
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define CXD56M4_SYSH_PRIORITY_MIN     0xe0 /* All bits[7:5] set is minimum priority */
diff --git a/arch/arm/include/cxd56xx/crashdump.h b/arch/arm/include/cxd56xx/crashdump.h
index 2f2e8c9..58351ce 100644
--- a/arch/arm/include/cxd56xx/crashdump.h
+++ b/arch/arm/include/cxd56xx/crashdump.h
@@ -47,7 +47,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Configuration ************************************************************/
diff --git a/arch/arm/include/cxd56xx/irq.h b/arch/arm/include/cxd56xx/irq.h
index e48a727..325d2f0 100644
--- a/arch/arm/include/cxd56xx/irq.h
+++ b/arch/arm/include/cxd56xx/irq.h
@@ -34,7 +34,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/cxd56xx/pin.h b/arch/arm/include/cxd56xx/pin.h
index 8cfc36a..2785d94 100644
--- a/arch/arm/include/cxd56xx/pin.h
+++ b/arch/arm/include/cxd56xx/pin.h
@@ -28,10 +28,10 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
-/* Pin number Definitions */
+/* Pin number Prototypes */
 
 #define PIN_RTC_CLK_IN          (0)
 
diff --git a/arch/arm/include/cxd56xx/pm.h b/arch/arm/include/cxd56xx/pm.h
index 430a991..e542e40 100644
--- a/arch/arm/include/cxd56xx/pm.h
+++ b/arch/arm/include/cxd56xx/pm.h
@@ -43,7 +43,7 @@
 #include <queue.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Boot Cause definitions */
@@ -138,7 +138,7 @@ struct pm_cpu_wakelock_s
   uint32_t info;
 };
 
-/* Definitions for pmic notify */
+/* Prototypes for pmic notify */
 
 enum pmic_notify_e
 {
diff --git a/arch/arm/include/cxd56xx/scu.h b/arch/arm/include/cxd56xx/scu.h
index d161592..c9b352e 100644
--- a/arch/arm/include/cxd56xx/scu.h
+++ b/arch/arm/include/cxd56xx/scu.h
@@ -45,7 +45,7 @@
 #include <nuttx/fs/ioctl.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define _SCUIOCBASE   (0xa000)
diff --git a/arch/arm/include/cxd56xx/timer.h b/arch/arm/include/cxd56xx/timer.h
index c294212..7534500 100644
--- a/arch/arm/include/cxd56xx/timer.h
+++ b/arch/arm/include/cxd56xx/timer.h
@@ -43,7 +43,7 @@
 #include <nuttx/timers/timer.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Set callback handler
diff --git a/arch/arm/include/cxd56xx/usbdev.h b/arch/arm/include/cxd56xx/usbdev.h
index 916be87..650dcda 100644
--- a/arch/arm/include/cxd56xx/usbdev.h
+++ b/arch/arm/include/cxd56xx/usbdev.h
@@ -41,7 +41,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* BOARDIOC_USBDEV_SETNOTIFYSIG signal value ********************************/
diff --git a/arch/arm/include/dm320/irq.h b/arch/arm/include/dm320/irq.h
index 4e80b62..3b9f7f87 100644
--- a/arch/arm/include/dm320/irq.h
+++ b/arch/arm/include/dm320/irq.h
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* DM320 Interrupts */
diff --git a/arch/arm/include/efm32/chip.h b/arch/arm/include/efm32/chip.h
index 8eb60e8..f6bdf29 100644
--- a/arch/arm/include/efm32/chip.h
+++ b/arch/arm/include/efm32/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/efm32/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,29 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_EFM32_CHIP_H
 #define __ARCH_ARM_INCLUDE_EFM32_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* EFM32 EnergyMicro ****************************************************************/
+/* EFM32 EnergyMicro ********************************************************/
 
 /* Tiny Gecko with 32KiB FLASH and 4KiB RAM in a QFN64 package */
 
 #if defined(CONFIG_ARCH_CHIP_EFM32TG840F32)
 
-/* Gecko with 128KiB FLASH and 16KiB SRAM in LQFP100 (EFM32G880F128) or BGA112
- * (EFM32G890F128) package
+/* Gecko with 128KiB FLASH and 16KiB SRAM in LQFP100 (EFM32G880F128) or
+ * BGA112 (EFM32G890F128) package
  */
 
 #elif defined(CONFIG_ARCH_CHIP_EFM32G880F128) || \
@@ -55,7 +55,7 @@
 #  error "Unsupported EFM32 chip"
 #endif
 
-/* NVIC priority levels *************************************************************/
+/* NVIC priority levels *****************************************************/
 
 #define NVIC_SYSH_PRIORITY_MIN     0xe0 /* Bits [7:5] set in minimum priority */
 #define NVIC_SYSH_PRIORITY_DEFAULT 0x80 /* Midpoint is the default */
diff --git a/arch/arm/include/efm32/efm32g_irq.h b/arch/arm/include/efm32/efm32g_irq.h
index 089109f..57cdd63 100644
--- a/arch/arm/include/efm32/efm32g_irq.h
+++ b/arch/arm/include/efm32/efm32g_irq.h
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
@@ -42,7 +42,8 @@
  *
  * External interrupts (vectors >= 16)
  */
-                                                         /* IRQ# Source      */
+
+                                                         /* IRQ# Source     */
 #define EFM32_IRQ_DMA        (EFM32_IRQ_INTERRUPTS + 0)  /*  0   DMA         */
 #define EFM32_IRQ_GPIO_EVEN  (EFM32_IRQ_INTERRUPTS + 1)  /*  1   GPIO_EVEN   */
 #define EFM32_IRQ_TIMER0     (EFM32_IRQ_INTERRUPTS + 2)  /*  2   TIMER0      */
@@ -95,7 +96,7 @@ extern "C"
 #endif
 
 /****************************************************************************
- * Public Functions
+ * Public Functions Prototypes
  ****************************************************************************/
 
 #undef EXTERN
diff --git a/arch/arm/include/efm32/efm32gg_irq.h b/arch/arm/include/efm32/efm32gg_irq.h
index f8b8560..8cea3c3 100644
--- a/arch/arm/include/efm32/efm32gg_irq.h
+++ b/arch/arm/include/efm32/efm32gg_irq.h
@@ -45,7 +45,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
@@ -119,7 +119,7 @@ extern "C"
 #endif
 
 /****************************************************************************
- * Public Functions
+ * Public Functions Prototypes
  ****************************************************************************/
 
 #undef EXTERN
diff --git a/arch/arm/include/efm32/efm32tg_irq.h b/arch/arm/include/efm32/efm32tg_irq.h
index 039f56c..265a64b 100644
--- a/arch/arm/include/efm32/efm32tg_irq.h
+++ b/arch/arm/include/efm32/efm32tg_irq.h
@@ -45,7 +45,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
@@ -103,7 +103,7 @@ extern "C"
 #endif
 
 /****************************************************************************
- * Public Functions
+ * Public Functions Prototypes
  ****************************************************************************/
 
 #undef EXTERN
diff --git a/arch/arm/include/efm32/irq.h b/arch/arm/include/efm32/irq.h
index ae768a8..809a157 100644
--- a/arch/arm/include/efm32/irq.h
+++ b/arch/arm/include/efm32/irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/efm32/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,30 +16,41 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_EFM32_IRQ_H
 #define __ARCH_ARM_INCLUDE_EFM32_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
 #include <nuttx/irq.h>
 #include <arch/efm32/chip.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+#if defined(CONFIG_EFM32_EFM32TG)
+#  include <arch/efm32/efm32tg_irq.h>
+#elif defined(CONFIG_EFM32_EFM32G)
+#  include <arch/efm32/efm32g_irq.h>
+#elif defined(CONFIG_EFM32_EFM32GG)
+#  include <arch/efm32/efm32gg_irq.h>
+#else
+#  error "Unsupported EFM32 chip"
+#endif
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits in
+ *  the NVIC.  This does, however, waste several words of memory in the IRQ
  * to handle mapping tables.
  */
 
@@ -59,25 +70,18 @@
 #define EFM32_IRQ_PENDSV      (14) /* Vector 14: Pendable system service request */
 #define EFM32_IRQ_SYSTICK     (15) /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define EFM32_IRQ_INTERRUPTS  (16) /* Vector number of the first external interrupt */
 
-#if defined(CONFIG_EFM32_EFM32TG)
-#  include <arch/efm32/efm32tg_irq.h>
-#elif defined(CONFIG_EFM32_EFM32G)
-#  include <arch/efm32/efm32g_irq.h>
-#elif defined(CONFIG_EFM32_EFM32GG)
-#  include <arch/efm32/efm32gg_irq.h>
-#else
-#  error "Unsupported EFM32 chip"
-#endif
-
 #ifdef CONFIG_EFM32_GPIO_IRQ
-/* If GPIO interrupt support is enabled then up to 16 additional GPIO interrupt
- * sources are available.  There are actually only two physical interrupt lines:
- * GPIO_EVEN and GPIO_ODD.  However, from the software point of view, there are
- * 16-additional interrupts generated from a second level of decoding.
+/* If GPIO interrupt support is enabled then up to 16 additional GPIO
+ * interrupt sources are available.  There are actually only two physical
+ * interrupt lines: GPIO_EVEN and GPIO_ODD.  However, from the software point
+ * of view, there are 16-additional interrupts generated from a second level
+ * of decoding.
  */
 
 #  define EFM32_IRQ_EXTI0   (EFM32_IRQ_NVECTORS + 0)  /* Port[n], pin0 external interrupt */
@@ -102,13 +106,13 @@
 #  define NR_IRQS           EFM32_IRQ_NVECTORS        /* Total number of interrupts */
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -119,9 +123,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/elf.h b/arch/arm/include/elf.h
index f6207b7..fb87e2c 100644
--- a/arch/arm/include/elf.h
+++ b/arch/arm/include/elf.h
@@ -26,14 +26,15 @@
 #define __ARCH_ARM_INCLUDE_ELF_H
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* 4.3.1 ELF Identification.  Should have:
  *
  * e_machine         = EM_ARM
  * e_ident[EI_CLASS] = ELFCLASS32
- * e_ident[EI_DATA]  = ELFDATA2LSB (little endian) or ELFDATA2MSB (big endian)
+ * e_ident[EI_DATA]  = ELFDATA2LSB (little endian) or
+ *                     ELFDATA2MSB (big endian)
  */
 
 #if 0 /* Defined in include/elf32.h */
@@ -65,9 +66,10 @@
  * S (when used on its own) is the address of the symbol.
  * A is the addend for the relocation.
  * P is the address of the place being relocated (derived from r_offset).
- * Pa is the adjusted address of the place being relocated, defined as (P & 0xFFFFFFFC).
- * T is 1 if the target symbol S has type STT_FUNC and the symbol addresses a Thumb instruction;
- *   it is 0 otherwise.
+ * Pa is the adjusted address of the place being relocated, defined as
+ *    (P & 0xFFFFFFFC).
+ * T is 1 if the target symbol S has type STT_FUNC and the symbol addresses
+ *   a Thumb instruction; it is 0 otherwise.
  * B(S) is the addressing origin of the output segment defining the symbol S.
  * GOT_ORG is the addressing origin of the Global Offset Table
  * GOT(S) is the address of the GOT entry for the symbol S.
diff --git a/arch/arm/include/eoss3/chip.h b/arch/arm/include/eoss3/chip.h
index 1fee037..4c80933 100644
--- a/arch/arm/include/eoss3/chip.h
+++ b/arch/arm/include/eoss3/chip.h
@@ -28,7 +28,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* EOS S3 Support 8 Levels of priority.
diff --git a/arch/arm/include/eoss3/irq.h b/arch/arm/include/eoss3/irq.h
index 133ab48..d4c7afc 100644
--- a/arch/arm/include/eoss3/irq.h
+++ b/arch/arm/include/eoss3/irq.h
@@ -28,7 +28,7 @@
 #include <arch/eoss3/chip.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Common Processor Exceptions (vectors 0-15) */
diff --git a/arch/arm/include/imx1/irq.h b/arch/arm/include/imx1/irq.h
index 0935a09..125e13e 100644
--- a/arch/arm/include/imx1/irq.h
+++ b/arch/arm/include/imx1/irq.h
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* i.MX1 Interrupts */
diff --git a/arch/arm/include/imx6/chip.h b/arch/arm/include/imx6/chip.h
index 88a3178..a5fd39f 100644
--- a/arch/arm/include/imx6/chip.h
+++ b/arch/arm/include/imx6/chip.h
@@ -28,8 +28,9 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
+
 /* The i.MX6 6Quad and 6Dual/DualLite are the only support i.MX6 family
  * members.  Individual differences between members of the families are not
  * accounted for.
@@ -108,7 +109,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Public Functions
+ * Public Functions Prototypes
  ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_IMX6_CHIP_H */
diff --git a/arch/arm/include/imx6/irq.h b/arch/arm/include/imx6/irq.h
index 93bee02..be6c8d3 100644
--- a/arch/arm/include/imx6/irq.h
+++ b/arch/arm/include/imx6/irq.h
@@ -18,8 +18,8 @@
  *
  ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- & through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_IMX6_IRQ_H
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* The Global Interrupt Controller (GIC) collects up to 128 interrupt
@@ -47,6 +47,7 @@
  */
 
 /* Private Peripheral Interrupts (PPI) **************************************/
+
 /* Each Cortex-A9 processor has private interrupts, ID0-ID15, that can only
  * be triggered by software. These interrupts are aliased so that there is
  * no requirement for a requesting Cortex-A9 processor to determine its own
diff --git a/arch/arm/include/imxrt/chip.h b/arch/arm/include/imxrt/chip.h
index 0843f83..6c3422d 100644
--- a/arch/arm/include/imxrt/chip.h
+++ b/arch/arm/include/imxrt/chip.h
@@ -1,4 +1,4 @@
-/*****************************************************************************
+/****************************************************************************
  * arch/arm/include/imxrt/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- *****************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_IMXRT_CHIP_H
 #define __ARCH_ARM_INCLUDE_IMXRT_CHIP_H
 
-/*****************************************************************************
+/****************************************************************************
  * Included Files
- *****************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/*****************************************************************************
- * Pre-processor Definitions
- *****************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
@@ -77,7 +77,8 @@
 #  error "Unknown i.MX RT chip type"
 #endif
 
-/* NVIC priority levels ******************************************************
+/* NVIC priority levels *****************************************************/
+
 /* Each priority field holds an 8-bit priority value, 0-15. The lower the
  * value, the greater the priority of the corresponding interrupt.  The i.MX
  * RT processor implements only bits[7:4] of each field, bits[3:0] read as
@@ -89,16 +90,16 @@
 #define NVIC_SYSH_PRIORITY_MAX        0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP       0x40 /* Two bits of interrupt pri used */
 
-/*****************************************************************************
+/****************************************************************************
  * Public Types
- *****************************************************************************/
+ ****************************************************************************/
 
-/*****************************************************************************
+/****************************************************************************
  * Public Data
- *****************************************************************************/
+ ****************************************************************************/
 
-/*****************************************************************************
- * Public Functions
- *****************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_IMXRT_CHIP_H */
diff --git a/arch/arm/include/imxrt/imxrt102x_irq.h b/arch/arm/include/imxrt/imxrt102x_irq.h
index ceca8a3..2918b57 100644
--- a/arch/arm/include/imxrt/imxrt102x_irq.h
+++ b/arch/arm/include/imxrt/imxrt102x_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/imxrt/imxrt102x_irq.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -32,24 +32,24 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_IMXRT_IMXRT102X_IRQ_H
 #define __ARCH_ARM_INCLUDE_IMXRT_IMXRT102X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* External interrupts (priority levels >= 256) *****************************************/
+/* External interrupts (priority levels >= 256) *****************************/
 
 #define IMXRT_IRQ_EDMA0_16     (IMXRT_IRQ_EXTINT + 0)   /* eDMA Channel 0/16 Transfer Complete */
 #define IMXRT_IRQ_EDMA1_17     (IMXRT_IRQ_EXTINT + 1)   /* eDMA Channel 1/17 Transfer Complete */
@@ -91,10 +91,14 @@
 #define IMXRT_IRQ_CAN2         (IMXRT_IRQ_EXTINT + 37)  /* CAN2 interrupt */
 #define IMXRT_IRQ_CM7FR        (IMXRT_IRQ_EXTINT + 38)  /* FlexRAM address fault */
 #define IMXRT_IRQ_KPP          (IMXRT_IRQ_EXTINT + 39)  /* Keypad Interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 40)  RESERVED */
 #define IMXRT_IRQ_GPRIRQ       (IMXRT_IRQ_EXTINT + 41)  /* Notify cores on exception while boot */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 42)  RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 43)  RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 44)  RESERVED */
 #define IMXRT_IRQ_WDOG2        (IMXRT_IRQ_EXTINT + 45)  /* Watchdog Timer reset */
 #define IMXRT_IRQ_SNVS         (IMXRT_IRQ_EXTINT + 46)  /* SNVS Functional Interrupt */
@@ -103,8 +107,10 @@
 #define IMXRT_IRQ_CSU          (IMXRT_IRQ_EXTINT + 49)  /* CSU Interrupt Request 1 */
 #define IMXRT_IRQ_DCP          (IMXRT_IRQ_EXTINT + 50)  /* DCP channel/CRC interrupts (channel != 0) */
 #define IMXRT_IRQ_DCP0         (IMXRT_IRQ_EXTINT + 51)  /* DCP channel 0 interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 52)  RESERVED */
 #define IMXRT_IRQ_TRNG         (IMXRT_IRQ_EXTINT + 53)  /* TRNG Interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 54)  RESERVED */
 #define IMXRT_IRQ_BEE          (IMXRT_IRQ_EXTINT + 55)  /* BEE IRQ */
 #define IMXRT_IRQ_SAI1         (IMXRT_IRQ_EXTINT + 56)  /* SAI1 interrupt (RX/TX) */
@@ -113,15 +119,19 @@
 #define IMXRT_IRQ_SAI3TX       (IMXRT_IRQ_EXTINT + 59)  /* SAI3 TX interrupt (RX/TX) */
 #define IMXRT_IRQ_SPDIF        (IMXRT_IRQ_EXTINT + 60)  /* SPDIF interrupt */
 #define IMXRT_IRQ_PMU          (IMXRT_IRQ_EXTINT + 61)  /* Brown-out event 1.1, 2.5 or 3.0 regulators */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 62)  RESERVED */
 #define IMXRT_IRQ_TEMP         (IMXRT_IRQ_EXTINT + 63)  /* Temperature Monitor */
 #define IMXRT_IRQ_TEMPPANIC    (IMXRT_IRQ_EXTINT + 64)  /* TempSensor panic */
 #define IMXRT_IRQ_USBPHY0      (IMXRT_IRQ_EXTINT + 65)  /* USBPHY (UTMI0) interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 66)  RESERVED */
 #define IMXRT_IRQ_ADC1         (IMXRT_IRQ_EXTINT + 67)  /* ADC1 interrupt */
 #define IMXRT_IRQ_ADC2         (IMXRT_IRQ_EXTINT + 68)  /* ADC2 interrupt */
 #define IMXRT_IRQ_DCDC         (IMXRT_IRQ_EXTINT + 69)  /* DCDC interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 70)  RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 71)  RESERVED */
 #define IMXRT_IRQ_GPIO1_0      (IMXRT_IRQ_EXTINT + 72)  /* GPIO1 INT0 interrupt */
 #define IMXRT_IRQ_GPIO1_1      (IMXRT_IRQ_EXTINT + 73)  /* GPIO1 INT1 interrupt */
@@ -137,11 +147,14 @@
 #define IMXRT_IRQ_GPIO2_16_31  (IMXRT_IRQ_EXTINT + 83)  /* GPIO2 INT16-31 interrupt */
 #define IMXRT_IRQ_GPIO3_0_15   (IMXRT_IRQ_EXTINT + 84)  /* GPIO3 INT0-15 interrupt */
 #define IMXRT_IRQ_GPIO3_16_31  (IMXRT_IRQ_EXTINT + 85)  /* GPIO3 INT16-31 interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 86)  RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 87)  RESERVED */
 #define IMXRT_IRQ_GPIO5_0_15   (IMXRT_IRQ_EXTINT + 88)  /* GPIO5 INT0-15 interrupt */
 #define IMXRT_IRQ_GPIO5_16_31  (IMXRT_IRQ_EXTINT + 89)  /* GPIO5 INT16-31 interrupt */
 #define IMXRT_IRQ_FLEXIO1      (IMXRT_IRQ_EXTINT + 90)  /* FlexIO Interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 91)  RESERVED */
 #define IMXRT_IRQ_WDOG1        (IMXRT_IRQ_EXTINT + 92)  /* Watchdog Timer reset */
 #define IMXRT_IRQ_RTWDOG       (IMXRT_IRQ_EXTINT + 93)  /* Watchdog Timer reset */
@@ -150,6 +163,7 @@
 #define IMXRT_IRQ_CCM_2        (IMXRT_IRQ_EXTINT + 96)  /* CCM interrupt 2 */
 #define IMXRT_IRQ_GPC          (IMXRT_IRQ_EXTINT + 97)  /* GPC interrupt 1 */
 #define IMXRT_IRQ_SRC          (IMXRT_IRQ_EXTINT + 98)  /* SRC interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 99)  RESERVED */
 #define IMXRT_IRQ_GPT1         (IMXRT_IRQ_EXTINT + 100) /* GPT1 interrupt */
 #define IMXRT_IRQ_GPT2         (IMXRT_IRQ_EXTINT + 101) /* GPT2 interrupt */
@@ -158,11 +172,13 @@
 #define IMXRT_IRQ_FLEXPWM1_2   (IMXRT_IRQ_EXTINT + 104) /* FLEXPWM1 capture/compare/reload 2 interrupt */
 #define IMXRT_IRQ_FLEXPWM1_3   (IMXRT_IRQ_EXTINT + 105) /* FLEXPWM1 capture/compare/reload 3 interrupt */
 #define IMXRT_IRQ_FLEXPWM1_F   (IMXRT_IRQ_EXTINT + 106) /* FLEXPWM1 fault interrupt OR reload error */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 107) RESERVED */
 #define IMXRT_IRQ_FLEXSPI      (IMXRT_IRQ_EXTINT + 108) /* FlexSPI interrupt */
 #define IMXRT_IRQ_SEMC         (IMXRT_IRQ_EXTINT + 109) /* SEMC interrupt */
 #define IMXRT_IRQ_USDHC1       (IMXRT_IRQ_EXTINT + 110) /* USDHC1 interrupt */
 #define IMXRT_IRQ_USDHC2       (IMXRT_IRQ_EXTINT + 111) /* USDHC2 interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 112) RESERVED */
 #define IMXRT_IRQ_USBOTG1      (IMXRT_IRQ_EXTINT + 113) /* USBO2 USB OTG1 interrupt */
 #define IMXRT_IRQ_ENET         (IMXRT_IRQ_EXTINT + 114) /* ENET MAC 0 interrupt */
@@ -178,49 +194,73 @@
 #define IMXRT_IRQ_ACMP2        (IMXRT_IRQ_EXTINT + 124) /* ACMP2 interrupt */
 #define IMXRT_IRQ_ACMP3        (IMXRT_IRQ_EXTINT + 125) /* ACMP3 interrupt */
 #define IMXRT_IRQ_ACMP4        (IMXRT_IRQ_EXTINT + 126) /* ACMP4 interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 127) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 128) RESERVED */
 #define IMXRT_IRQ_ENC1         (IMXRT_IRQ_EXTINT + 129) /* ENC1 interrupt */
 #define IMXRT_IRQ_ENC2         (IMXRT_IRQ_EXTINT + 130) /* ENC2 interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 131) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 132) RESERVED */
 #define IMXRT_IRQ_QTIMER1      (IMXRT_IRQ_EXTINT + 133) /* QTIMER1 timer 0-3 interrupt */
 #define IMXRT_IRQ_QTIMER2      (IMXRT_IRQ_EXTINT + 134) /* QTIMER2 timer 0-3 interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 135) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 136) RESERVED */
 #define IMXRT_IRQ_FLEXPWM2_0   (IMXRT_IRQ_EXTINT + 137) /* FLEXPWM2 capture/compare/reload 0 interrupt */
 #define IMXRT_IRQ_FLEXPWM2_1   (IMXRT_IRQ_EXTINT + 138) /* FLEXPWM2 capture/compare/reload 1 interrupt */
 #define IMXRT_IRQ_FLEXPWM2_2   (IMXRT_IRQ_EXTINT + 139) /* FLEXPWM2 capture/compare/reload 1 interrupt */
 #define IMXRT_IRQ_FLEXPWM2_3   (IMXRT_IRQ_EXTINT + 140) /* FLEXPWM2 capture/compare/reload 3 interrupt */
 #define IMXRT_IRQ_FLEXPWM2_F   (IMXRT_IRQ_EXTINT + 141) /* FLEXPWM2 fault interrupt */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 142) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 143) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 144) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 146) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 147) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 148) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 149) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 150) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 151) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 152) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 153) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 154) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 155) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 156) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 157) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 158) RESERVED */
+
 /* RESERVED                    (IMXRT_IRQ_EXTINT + 159) RESERVED */
 
 #define IMXRT_IRQ_NEXTINT      160
 
-/* GPIO second level interrupt **********************************************************/
+/* GPIO second level interrupt **********************************************/
 
 #define IMXRT_GPIO_IRQ_FIRST   (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT)
 #define _IMXRT_GPIO1_0_15_BASE IMXRT_GPIO_IRQ_FIRST
 
 #ifdef CONFIG_IMXRT_GPIO1_0_15_IRQ
   /* GPIO1 has dedicated interrupts for pins 0-7
-   * REVISIT:  I am assuming that you really cannot use the dedicated and the multiplex
+   * REVISIT:
+   * I am assuming that you really cannot use the dedicated and the multiplex
    * interrupts concurrently.
    */
 
@@ -431,25 +471,25 @@
                                 IMXRT_GPIO3_NIRQS + IMXRT_GPIO5_NIRQS)
 #define IMXRT_GPIO_IRQ_LAST    (_IMXRT_GPIO1_0_15_BASE + IMXRT_GPIO_NIRQS)
 
-/* Total number of IRQ numbers **********************************************************/
+/* Total number of IRQ numbers **********************************************/
 
 #define NR_IRQS                (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT + IMXRT_GPIO_NIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/imxrt/imxrt105x_irq.h b/arch/arm/include/imxrt/imxrt105x_irq.h
index b6a5c18..8f9a134 100644
--- a/arch/arm/include/imxrt/imxrt105x_irq.h
+++ b/arch/arm/include/imxrt/imxrt105x_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/imxrt/imxrt105x_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,24 +16,24 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_IMXRT_IMXRT105X_IRQ_H
 #define __ARCH_ARM_INCLUDE_IMXRT_IMXRT105X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* External interrupts (priority levels >= 256) *****************************************/
+/* External interrupts (priority levels >= 256) *****************************/
 
 #define IMXRT_IRQ_EDMA0_16     (IMXRT_IRQ_EXTINT + 0)   /* eDMA Channel 0/16 Transfer Complete */
 #define IMXRT_IRQ_EDMA1_17     (IMXRT_IRQ_EXTINT + 1)   /* eDMA Channel 1/17 Transfer Complete */
@@ -197,14 +197,15 @@
 
 #define IMXRT_IRQ_NEXTINT      160
 
-/* GPIO second level interrupt **********************************************************/
+/* GPIO second level interrupt **********************************************/
 
 #define IMXRT_GPIO_IRQ_FIRST   (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT)
 #define _IMXRT_GPIO1_0_15_BASE IMXRT_GPIO_IRQ_FIRST
 
 #ifdef CONFIG_IMXRT_GPIO1_0_15_IRQ
   /* GPIO1 has dedicated interrupts for pins 0-7
-   * REVISIT:  I am assuming that you really cannot use the dedicated and the multiplex
+   * REVISIT:
+   * I am assuming that you really cannot use the dedicated and the multiplex
    * interrupts concurrently.
    */
 
@@ -465,25 +466,25 @@
                                 IMXRT_GPIO5_NIRQS)
 #define IMXRT_GPIO_IRQ_LAST    (_IMXRT_GPIO1_0_15_BASE + IMXRT_GPIO_NIRQS)
 
-/* Total number of IRQ numbers **********************************************************/
+/* Total number of IRQ numbers **********************************************/
 
 #define NR_IRQS                (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT + IMXRT_GPIO_NIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/imxrt/imxrt106x_irq.h b/arch/arm/include/imxrt/imxrt106x_irq.h
index 183ceb3..00d443c 100644
--- a/arch/arm/include/imxrt/imxrt106x_irq.h
+++ b/arch/arm/include/imxrt/imxrt106x_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/imxrt/imxrt106x_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,24 +16,24 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_IMXRT_IMXRT106X_IRQ_H
 #define __ARCH_ARM_INCLUDE_IMXRT_IMXRT106X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* External interrupts (priority levels >= 256) *****************************************/
+/* External interrupts (priority levels >= 256) *****************************/
 
 #define IMXRT_IRQ_EDMA0_16     (IMXRT_IRQ_EXTINT + 0)   /* eDMA Channel 0/16 Transfer Complete */
 #define IMXRT_IRQ_EDMA1_17     (IMXRT_IRQ_EXTINT + 1)   /* eDMA Channel 1/17 Transfer Complete */
@@ -190,21 +190,22 @@
 #define IMXRT_IRQ_ENET2_1588   (IMXRT_IRQ_EXTINT + 153) /* ENET2 MAC 0 1588 Timer Interrupt */
 #define IMXRT_IRQ_CAN3         (IMXRT_IRQ_EXTINT + 154) /* CAN3 interrupt */
 #define IMXRT_IRQ_RESERVED155  (IMXRT_IRQ_EXTINT + 155) /* Reserved */
-#define IMXRT_IRQ_FLEXIO3      (IMXRT_IRQ_EXTINT + 156)  /* IPI compare interrupt */
+#define IMXRT_IRQ_FLEXIO3      (IMXRT_IRQ_EXTINT + 156) /* IPI compare interrupt */
 #define IMXRT_IRQ_GPIO_6789    (IMXRT_IRQ_EXTINT + 157) /* GPIO {6789} or'ed Interrupt */
 #define IMXRT_IRQ_RESERVED158  (IMXRT_IRQ_EXTINT + 158) /* Reserved */
 #define IMXRT_IRQ_RESERVED159  (IMXRT_IRQ_EXTINT + 159) /* Reserved */
 
 #define IMXRT_IRQ_NEXTINT      160
 
-/* GPIO second level interrupt **********************************************************/
+/* GPIO second level interrupt **********************************************/
 
 #define IMXRT_GPIO_IRQ_FIRST   (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT)
 #define _IMXRT_GPIO1_0_15_BASE IMXRT_GPIO_IRQ_FIRST
 
 #ifdef CONFIG_IMXRT_GPIO1_0_15_IRQ
   /* GPIO1 has dedicated interrupts for pins 0-7
-   * REVISIT:  I am assuming that you really cannot use the dedicated and the multiplex
+   * REVISIT:
+   * I am assuming that you really cannot use the dedicated and the multiplex
    * interrupts concurrently.
    */
 
@@ -671,25 +672,25 @@
                                 IMXRT_GPIO9_NIRQS )
 #define IMXRT_GPIO_IRQ_LAST    (_IMXRT_GPIO1_0_15_BASE + IMXRT_GPIO_NIRQS)
 
-/* Total number of IRQ numbers **********************************************************/
+/* Total number of IRQ numbers **********************************************/
 
 #define NR_IRQS                (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT + IMXRT_GPIO_NIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/imxrt/irq.h b/arch/arm/include/imxrt/irq.h
index 6c4affa..98353ae 100644
--- a/arch/arm/include/imxrt/irq.h
+++ b/arch/arm/include/imxrt/irq.h
@@ -18,23 +18,33 @@
  *
  ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_IMXRT_IRQ_H
 #define __ARCH_ARM_INCLUDE_IMXRT_IRQ_H
 
-/*****************************************************************************
+/****************************************************************************
  * Included Files
- *****************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/imxrt/chip.h>
 
-/*****************************************************************************
- * Pre-processor Definitions
- *****************************************************************************/
+#if defined(CONFIG_ARCH_FAMILY_IMXRT102x)
+#  include <arch/imxrt/imxrt102x_irq.h>
+#elif defined(CONFIG_ARCH_FAMILY_IMXRT105x)
+#  include <arch/imxrt/imxrt105x_irq.h>
+#elif defined(CONFIG_ARCH_FAMILY_IMXRT106x)
+#  include <arch/imxrt/imxrt106x_irq.h>
+#else
+#  error Unrecognized i.MX RT architecture
+#endif
+
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words
@@ -44,11 +54,11 @@
 /* Common Processor Exceptions (vectors 0-15) */
 
 #define IMXRT_IRQ_RESERVED       (0) /* Reserved vector .. only used with
-                                        CONFIG_DEBUG_FEATURES */
+                                      * CONFIG_DEBUG_FEATURES */
 
-                                     /* Vector  0: Reset stack pointer value */
+                                     /* Vector 0: Reset stack pointer value */
 
-                                     /* Vector  1: Reset (not handled by IRQ) */
+                                     /* Vector 1: Reset(not handled by IRQ) */
 
 #define IMXRT_IRQ_NMI            (2) /* Vector  2: Non-Maskable Int (NMI) */
 #define IMXRT_IRQ_HARDFAULT      (3) /* Vector  3: Hard fault */
@@ -68,16 +78,6 @@
 
 #define IMXRT_IRQ_EXTINT        (16) /* Vector number of the first ext int */
 
-#if defined(CONFIG_ARCH_FAMILY_IMXRT102x)
-#  include <arch/imxrt/imxrt102x_irq.h>
-#elif defined(CONFIG_ARCH_FAMILY_IMXRT105x)
-#  include <arch/imxrt/imxrt105x_irq.h>
-#elif defined(CONFIG_ARCH_FAMILY_IMXRT106x)
-#  include <arch/imxrt/imxrt106x_irq.h>
-#else
-#  error Unrecognized i.MX RT architecture
-#endif
-
 /****************************************************************************
  * Public Types
  ****************************************************************************/
diff --git a/arch/arm/include/inttypes.h b/arch/arm/include/inttypes.h
index f47ac32..b06561d 100644
--- a/arch/arm/include/inttypes.h
+++ b/arch/arm/include/inttypes.h
@@ -41,7 +41,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define PRId8       "d"
diff --git a/arch/arm/include/kinetis/chip.h b/arch/arm/include/kinetis/chip.h
index 887cdf5..435ec2a3 100644
--- a/arch/arm/include/kinetis/chip.h
+++ b/arch/arm/include/kinetis/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,14 +16,14 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_CHIP_H
 #define __ARCH_ARM_INCLUDE_KINETIS_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/kinetis/kinetis_dma.h>
@@ -33,9 +33,9 @@
 #include <arch/kinetis/kinetis_pmc.h>
 #include <arch/kinetis/kinetis_lpuart.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
@@ -1581,10 +1581,12 @@
 #  error "Unsupported Kinetis chip"
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-15. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:4] of each field, bits[3:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-15. The lower the value,
+ * the greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:4] of each field, bits[3:0] read as zero and ignore
+ * writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN     0xf0 /* All bits[7:4] set is minimum priority */
@@ -1592,16 +1594,16 @@
 #define NVIC_SYSH_PRIORITY_MAX     0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP    0x10 /* Steps between supported priority values */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_KINETIS_CHIP_H */
diff --git a/arch/arm/include/kinetis/irq.h b/arch/arm/include/kinetis/irq.h
index a956211..b57389a 100644
--- a/arch/arm/include/kinetis/irq.h
+++ b/arch/arm/include/kinetis/irq.h
@@ -18,26 +18,27 @@
  *
  ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather, only
+ * indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_IRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <nuttx/irq.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits in
+ * the NVIC.  This does, however, waste several words of memory in the IRQ
  * to handle mapping tables.
  */
 
@@ -58,7 +59,9 @@
 #define KINETIS_IRQ_PENDSV        (14)  /* Vector 14: Pendable system service request */
 #define KINETIS_IRQ_SYSTICK       (15)  /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define KINETIS_IRQ_FIRST        (16) /* Vector number of the first external interrupt */
 
@@ -75,22 +78,22 @@
 #elif defined(CONFIG_ARCH_FAMILY_K66)
 #  include <arch/kinetis/kinetis_k66irq.h>
 #else
-  /* The interrupt vectors for other parts are defined in other documents and may or
-   * may not be the same as above (the family members are all very similar)  This
-   * error just means that you have to look at the document and determine for yourself
-   * if the vectors are the same.
-   */
+/* The interrupt vectors for other parts are defined in other documents and
+ * may or may not be the same as above (the family members are all very
+ * similar)  This error just means that you have to look at the document and
+ * determine for yourself if the vectors are the same.
+ */
 
 #  error "No IRQ numbers for this Kinetis K part"
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -101,9 +104,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_dma.h b/arch/arm/include/kinetis/kinetis_dma.h
index f3d1418..b4da077 100644
--- a/arch/arm/include/kinetis/kinetis_dma.h
+++ b/arch/arm/include/kinetis/kinetis_dma.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_dma.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -31,26 +31,27 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMA_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMA_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* Note: It is envisioned that in the long term as a chip is added. The author of
- * the new chip definitions will either find the exact configuration in an existing
- * chip define and add the new chip to it Or add the DMA feature configuration
- * #defines to the chip ifdef list below. In either case the author should mark
- * it as "Verified to Document Number:" taken from the reference manual.
+/* Note: It is envisioned that in the long term as a chip is added. The
+ * author of the new chip definitions will either find the exact
+ * configuration in an existing chip define and add the new chip to it Or add
+ * the DMA feature configuration #defines to the chip ifdef list below. In
+ * either case the author should mark it as "Verified to Document Number:"
+ * taken from the reference manual.
  */
 
 /* DMA Register Configuration
@@ -72,9 +73,12 @@
  * KINETIS_DMA_HAS_DCHPRI_CHPRI_BITS          - DMA has 4 bit DCHPRI[DCHPRI]
  * KINETIS_DMA_HAS_DCHPRI_GRPPRI              - DMA has DCHPRI[GRPPRI]
  * KINETIS_DMA_HAS_EARS                       - DMA has EARS Register
- * KINETIS_DMA_HAS_TCD_CITER1_LINKCH_BITS     - DMA has 4 bit TCD_CITER[LINKCH]
- * KINETIS_DMA_HAS_TCD_CSR_MAJORLINKCH_BITS   - DMA has 4 bit TCD_CSR[MAJORLINKCH]
- * KINETIS_DMA_HAS_TCD_BITER1_LINKCH_BITS     - DMA has 4 bit TCD_BITER[LINKCH]
+ * KINETIS_DMA_HAS_TCD_CITER1_LINKCH_BITS     - DMA has 4 bit
+ *                                                  TCD_CITER[LINKCH]
+ * KINETIS_DMA_HAS_TCD_CSR_MAJORLINKCH_BITS   - DMA has 4 bit
+ *                                                  TCD_CSR[MAJORLINKCH]
+ * KINETIS_DMA_HAS_TCD_BITER1_LINKCH_BITS     - DMA has 4 bit
+ *                                                  TCD_BITER[LINKCH]
  */
 
 /* Describe the version of the DMA
@@ -119,7 +123,6 @@
 
 #  define KINETIS_DMA_VERSION KINETIS_DMA_VERSION_01
 
-
 /* MK66F N/X 1M0/2M0 V MD/LQ 18
  *
  *  --------------- ------- --- ------- ------- ------ ------ ------ -----
@@ -135,15 +138,17 @@
 #elif defined(CONFIG_ARCH_CHIP_MK66FN2M0VMD18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VMD18) || \
       defined(CONFIG_ARCH_CHIP_MK66FN2M0VLQ18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VLQ18)
 
-/* Verified to Document Number: Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 */
+/* Verified to Document Number:
+ * Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015
+ */
 
 #  define KINETIS_DMA_VERSION KINETIS_DMA_VERSION_02
 #else
 #  define KINETIS_DMA_VERSION KINETIS_DMA_VERSION_UKN
 #endif
 
-/* Use the catch all configuration for the DMA based on the implementations in nuttx
- * prior 8/10/2018
+/* Use the catch all configuration for the DMA based on
+ * the implementations in nuttx prior 8/10/2018
  */
 
 #if KINETIS_DMA_VERSION == KINETIS_DMA_VERSION_UKN
diff --git a/arch/arm/include/kinetis/kinetis_dmamux.h b/arch/arm/include/kinetis/kinetis_dmamux.h
index 5777b32..113064b 100644
--- a/arch/arm/include/kinetis/kinetis_dmamux.h
+++ b/arch/arm/include/kinetis/kinetis_dmamux.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_dmamux.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -31,31 +31,34 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMAMUX_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMAMUX_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-
-/* Note: It is envisioned that in the long term as a chip is added. The author of
- * the new chip definitions will either find the exact configuration in an existing
- * chip define and add the new chip to it Or add the DMAMUX feature configuration
- * #defines to the chip ifdef list below. In either case the author should mark
- * it as "Verified to Document Number:" taken from the reference manual.
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* Note:
+ * It is envisioned that in the long term as a chip is added. The author of
+ * the new chip definitions will either find the exact configuration in an
+ * existing chip define and add the new chip to it Or add the DMAMUX feature
+ * configuration #defines to the chip ifdef list below. In either case the
+ * author should mark it as "Verified to Document Number:" taken from the
+ * reference manual.
  */
 
 /* DMAMUX Register Configuration
  *
- * KINETIS_DMAMUX_HAS_MONOTONIC_CHCFG    0|1    - SoC has reg in 0,1,2..KINETIS_NDMACH
+ * KINETIS_DMAMUX_HAS_MONOTONIC_CHCFG    0|1
+ *   - SoC has reg in 0,1,2..KINETIS_NDMACH
  */
 
 /* Describe the version of the DMA
@@ -115,7 +118,9 @@
 #elif defined(CONFIG_ARCH_CHIP_MK66FN2M0VMD18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VMD18) || \
       defined(CONFIG_ARCH_CHIP_MK66FN2M0VLQ18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VLQ18)
 
-/* Verified to Document Number: Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 */
+/* Verified to Document Number:
+ * Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015
+ */
 
 #  define KINETIS_DMAMUX_VERSION KINETIS_DMAMUX_VERSION_02
 
@@ -123,8 +128,8 @@
 #  define KINETIS_DMAMUX_VERSION KINETIS_DMAMUX_VERSION_UKN
 #endif
 
-/* Use the catch all configuration for the DMAMUX based on the implementations in
- * nuttx prior 8/10/2018
+/* Use the catch all configuration for the DMAMUX based on the
+ * implementations in nuttx prior 8/10/2018
  */
 
 #if KINETIS_DMA_VERSION == KINETIS_DMAMUX_VERSION_01
diff --git a/arch/arm/include/kinetis/kinetis_k20irq.h b/arch/arm/include/kinetis/kinetis_k20irq.h
index 384b0b2..e46bcad 100644
--- a/arch/arm/include/kinetis/kinetis_k20irq.h
+++ b/arch/arm/include/kinetis/kinetis_k20irq.h
@@ -1,4 +1,4 @@
-/**************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_k20irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- *************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather, only indirectly
  * through nuttx/irq.h
@@ -25,26 +25,26 @@
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K20IRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K20IRQ_H
 
-/**************************************************************************************
+/****************************************************************************
  * Included Files
- *************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/**************************************************************************************
- * Pre-processor Definitions
- *************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
  * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file
  *
  * External interrupts (vectors >= 16)
  *
- * K20 Family *************************************************************************
+ * K20 Family ***************************************************************
  *
  * The interrupt vectors  for the following parts is defined in Freescale
  * document K20P64M72SF1RM
@@ -148,19 +148,20 @@
 #define KINETIS_IRQ_SWI      (KINETIS_IRQ_FIRST + 94)  /* 94: Software interrupt */
 
 #define KINETIS_IRQ_NEXTINTS 95                        /* 95 Non core IRQs */
+
 #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 111 vectors */
 
 /* EXTI interrupts (Do not use IRQ numbers) */
 
 #define NR_IRQS              KINETIS_IRQ_NVECTORS
 
-/**************************************************************************************
+/****************************************************************************
  * Public Types
- *************************************************************************************/
+ ****************************************************************************/
 
-/**************************************************************************************
+/****************************************************************************
  * Public Data
- *************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -171,9 +172,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/**************************************************************************************
- * Public Functions
- *************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_k28irq.h b/arch/arm/include/kinetis/kinetis_k28irq.h
index c0c4749..0c8bbdd 100644
--- a/arch/arm/include/kinetis/kinetis_k28irq.h
+++ b/arch/arm/include/kinetis/kinetis_k28irq.h
@@ -1,4 +1,4 @@
-/*********************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_k28irq.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -31,35 +31,35 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ********************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K28IRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K28IRQ_H
 
-/*********************************************************************************************
+/****************************************************************************
  * Included Files
- ********************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/*********************************************************************************************
- * Pre-processor Definitions
- ********************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
  * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file
  *
  * External interrupts (vectors >= 16)
  *
- * K28 Family ********************************************************************************
+ * K28 Family ***************************************************************
  *
  * The interrupt vectors  for the following parts is defined in Freescale
  * document K28P210M150SF5RM
@@ -186,19 +186,20 @@
 #define KINETIS_IRQ_RESVD106 (KINETIS_IRQ_FIRST + 106) /* 106: Reserved */
 
 #define KINETIS_IRQ_NEXTINTS 107                       /* 107 Non core IRQs */
+
 #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 123 vectors */
 
 /* EXTI interrupts (Do not use IRQ numbers) */
 
 #define NR_IRQS              KINETIS_IRQ_NVECTORS
 
-/*********************************************************************************************
+/****************************************************************************
  * Public Types
- ********************************************************************************************/
+ ****************************************************************************/
 
-/*********************************************************************************************
+/****************************************************************************
  * Public Data
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -209,9 +210,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/*********************************************************************************************
- * Public Functions
- ********************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_k40irq.h b/arch/arm/include/kinetis/kinetis_k40irq.h
index fa6938e..b33a844 100644
--- a/arch/arm/include/kinetis/kinetis_k40irq.h
+++ b/arch/arm/include/kinetis/kinetis_k40irq.h
@@ -1,4 +1,4 @@
-/*************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_k40irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,35 +16,35 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_40KIRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_40KIRQ_H
 
-/*************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/*************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
  * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file
  *
  * External interrupts (vectors >= 16)
  *
- * K40 Family ************************************************************************
+ * K40 Family ***************************************************************
  *
  * The interrupt vectors  for the following parts is defined in Freescale
  * document K40P144M100SF2RM
@@ -148,19 +148,20 @@
 #define KINETIS_IRQ_SWI      (KINETIS_IRQ_FIRST + 94)  /* 94: Software interrupt */
 
 #define KINETIS_IRQ_NEXTINTS 95                        /* 95 Non core IRQs */
+
 #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 111 vectors */
 
 /* EXTI interrupts (Do not use IRQ numbers) */
 
 #define NR_IRQS              KINETIS_IRQ_NVECTORS
 
-/*************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/*************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -171,9 +172,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/*************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_k60irq.h b/arch/arm/include/kinetis/kinetis_k60irq.h
index 7ba22a1..6b134a5 100644
--- a/arch/arm/include/kinetis/kinetis_k60irq.h
+++ b/arch/arm/include/kinetis/kinetis_k60irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_k60irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,35 +16,35 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_60KIRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_60KIRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
  * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file
  *
  * External interrupts (vectors >= 16)
  *
- * K60 Family ************************************************************************
+ * K60 Family ***************************************************************
  *
  * The interrupt vectors  for the following parts is defined in Freescale
  * document K60P144M100SF2RM
@@ -148,19 +148,20 @@
 #define KINETIS_IRQ_SWI      (KINETIS_IRQ_FIRST + 94)  /* 94: Software interrupt */
 
 #define KINETIS_IRQ_NEXTINTS 95                        /* 95 Non core IRQs */
+
 #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 111 vectors */
 
 /* EXTI interrupts (Do not use IRQ numbers) */
 
 #define NR_IRQS              KINETIS_IRQ_NVECTORS
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -171,9 +172,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_k64irq.h b/arch/arm/include/kinetis/kinetis_k64irq.h
index 898fa5d..e72ec12 100644
--- a/arch/arm/include/kinetis/kinetis_k64irq.h
+++ b/arch/arm/include/kinetis/kinetis_k64irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_k64irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,35 +16,35 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_64KIRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_64KIRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
  * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file
  *
  * External interrupts (vectors >= 16)
  *
- * K60 Family ************************************************************************
+ * K60 Family ***************************************************************
  *
  * The interrupt vectors  for the following parts is defined in Freescale
  * document K64P144M120SF5RM.pdf
@@ -138,19 +138,20 @@
 #define KINETIS_IRQ_EMACMISC (KINETIS_IRQ_FIRST + 85)  /* 85: Ethernet MAC error and misc interrupt */
 
 #define KINETIS_IRQ_NEXTINTS 86                        /* 86 Non core IRQs */
+
 #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 102 vectors */
 
 /* EXTI interrupts (Do not use IRQ numbers) */
 
 #define NR_IRQS              KINETIS_IRQ_NVECTORS
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -161,9 +162,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_k66irq.h b/arch/arm/include/kinetis/kinetis_k66irq.h
index 957e9de..d20e523 100644
--- a/arch/arm/include/kinetis/kinetis_k66irq.h
+++ b/arch/arm/include/kinetis/kinetis_k66irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_k66irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,35 +16,35 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K66IRQ_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K66IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
  * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file
  *
  * External interrupts (vectors >= 16)
  *
- * K66 Family ************************************************************************
+ * K66 Family ***************************************************************
  *
  * The interrupt vectors  for the following parts is defined in Freescale
  * document K66P144M180SF5RMV2
@@ -152,21 +152,21 @@
 #define KINETIS_IRQ_CAN1RW   (KINETIS_IRQ_FIRST + 98)  /* 98: CAN1 Receive Warning */
 #define KINETIS_IRQ_CAN1WU   (KINETIS_IRQ_FIRST + 99)  /* 99: CAN1 Wake UP */
 
-
 #define KINETIS_IRQ_NEXTINTS 100                       /* 100 Non core IRQs*/
+
 #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 116 vectors */
 
 /* EXTI interrupts (Do not use IRQ numbers) */
 
 #define NR_IRQS              KINETIS_IRQ_NVECTORS
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -177,9 +177,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/kinetis/kinetis_lpuart.h b/arch/arm/include/kinetis/kinetis_lpuart.h
index 9c9ff70..c856fdc 100644
--- a/arch/arm/include/kinetis/kinetis_lpuart.h
+++ b/arch/arm/include/kinetis/kinetis_lpuart.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_lpuart.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -31,36 +31,38 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_LPUART_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_LPUART_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
 #include "chip.h"
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-
-/* Note: It is envisioned that in the long term as a chip is added. The author of
- * the new chip definitions will either find the exact configuration in an existing
- * chip define and add the new chip to it Or add the LPUART feature configuration
- * #defines to the chip ifdef list below. In either case the author should mark
- * it as "Verified to Document Number:" taken from the reference manual.
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* Note:
+ * It is envisioned that in the long term as a chip is added. The author of
+ * the new chip definitions will either find the exact configuration in an
+ * existing chip define and add the new chip to it Or add the LPUART feature
+ * configuration #defines to the chip ifdef list below. In either case the
+ * author should mark it as "Verified to Document Number:" taken from the
+ * reference manual.
  *
  * To maintain backward compatibility to the version of NuttX prior to
- * 2/22/2017, the catch all KINETIS_LPUART_VERSION_UKN configuration is assigned
- * to all the chips that did not have any conditional compilation based on
- * KINETIS_K64 or KINETIS_K66. This is  a "No worse" than the original code solution.
- * N.B. Each original chip "if"definitions have been left intact so that the
- * complete legacy definitions prior to 2/22/2017 may be filled in completely when
- * vetted.
+ * 2/22/2017, the catch all KINETIS_LPUART_VERSION_UKN configuration is
+ * assigned to all the chips that did not have any conditional compilation
+ * based on KINETIS_K64 or KINETIS_K66. This is  a "No worse" than the
+ * original code solution. N.B. Each original chip "if"definitions have been
+ * left intact so that the complete legacy definitions prior to 2/22/2017 may
+ * be filled in completely when vetted.
  */
 
 /* LPUART Register Configuration
@@ -138,7 +140,9 @@
 #elif defined(CONFIG_ARCH_CHIP_MK28FN2M0VMI15) || \
       defined(CONFIG_ARCH_CHIP_MK28FN2M0CAU15R)
 
-/* Verified to Document Number: Verified to Document Number: K28P210M150SF5RM Rev. 4, August 2017 */
+/* Verified to Document Number:
+ * Verified to Document Number: K28P210M150SF5RM Rev. 4, August 2017
+ */
 
 #  define KINETIS_LPUART_VERSION KINETIS_LPUART_VERSION_01
 
@@ -256,7 +260,9 @@
 #  error "Unsupported Kinetis chip"
 #endif
 
-/* Use the catch all configuration for the LPUART based on the implementations in nuttx prior 2/3/2017 */
+/* Use the catch all configuration for the LPUART based on the
+ * implementations in nuttx prior 2/3/2017
+ */
 
 #if KINETIS_LPUART_VERSION == KINETIS_LPUART_VERSION_UKN
 
diff --git a/arch/arm/include/kinetis/kinetis_mcg.h b/arch/arm/include/kinetis/kinetis_mcg.h
index a5caf49..05979d2 100644
--- a/arch/arm/include/kinetis/kinetis_mcg.h
+++ b/arch/arm/include/kinetis/kinetis_mcg.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_mcg.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,47 +16,53 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_MCG_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_MCG_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-
-/* Note: It is envisioned that in the long term as a chip is added. The author of
- * the new chip definitions will either find the exact configuration in an existing
- * chip define and add the new chip to it Or add the MCG feature configuration
- * #defines to the chip ifdef list below. In either case the author should mark
- * it as "Verified to Document Number:" taken from the reference manual.
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* Note:
+ * It is envisioned that in the long term as a chip is added. The author of
+ * the new chip definitions will either find the exact configuration in an
+ * existing chip define and add the new chip to it Or add the MCG feature
+ * configuration #defines to the chip ifdef list below. In either case the
+ * author should mark it as "Verified to Document Number:" taken from the
+ * reference manual.
  *
  * To maintain backward compatibility to the version of NuttX prior to
  * 2/5/2017, the catch all KINETIS_MCG_VERSION_UKN configuration is assigned
  * to all the chips that did not have any conditional compilation based on
- * NEW_MCG or KINETIS_K64. This is  a "No worse" than the original code solution.
- * N.B. Each original chip "if"definitions have been left intact so that the
- * complete legacy definitions prior to 2/5/2017 may be filled in completely when
- * vetted.
+ * NEW_MCG or KINETIS_K64. This is  a "No worse" than the original code
+ * solution. N.B. Each original chip "if"definitions have been left intact so
+ * that the complete legacy definitions prior to 2/5/2017 may be filled in
+ * completely when vetted.
  */
 
 /* MCG Configuration Parameters
  *
  * KINETIS_MCG_PLL_REF_MIN           - OSCCLK/PLL_R minimum
  * KINETIS_MCG_PLL_REF_MAX           - OSCCLK/PLL_R maximum
- * KINETIS_MCG_PLL_INTERNAL_DIVBY    - The PLL clock is divided by n before VCO divider
- * KINETIS_MCG_HAS_PLL_EXTRA_DIVBY   - Is PLL clock divided by n before MCG PLL/FLL
+ * KINETIS_MCG_PLL_INTERNAL_DIVBY    - The PLL clock is divided by n
+ *                                     before VCO divider
+ * KINETIS_MCG_HAS_PLL_EXTRA_DIVBY   - Is PLL clock divided by n
+ *                                     before MCG PLL/FLL
  *                                     clock selection in the SIM module
  * KINETIS_MCG_FFCLK_DIVBY           - MCGFFCLK divided by n
- * KINETIS_MCG_HAS_IRC_48M           -  Has 48MHz internal oscillator
- * KINETIS_MCG_HAS_LOW_FREQ_IRC      - Has LTRIMRNG, LFRIM, LSTRIM and bit MC[LIRC_DIV2]
- * KINETIS_MCG_HAS_HIGH_FREQ_IRC     - Has HCTRIM, HTTRIM, HFTRIM and bit MC[HIRCEN]
+ * KINETIS_MCG_HAS_IRC_48M           - Has 48MHz internal oscillator
+ * KINETIS_MCG_HAS_LOW_FREQ_IRC      - Has LTRIMRNG, LFRIM,
+ *                                     LSTRIM and bit MC[LIRC_DIV2]
+ * KINETIS_MCG_HAS_HIGH_FREQ_IRC     - Has HCTRIM, HTTRIM,
+ *                                     HFTRIM and bit MC[HIRCEN]
  * KINETIS_MCG_HAS_PLL_INTERNAL_MODE - Has PEI mode or PBI mode
  * KINETIS_MCG_HAS_RESET_IS_BLPI     - Has Reset clock mode is BLPI
  *
@@ -65,7 +71,8 @@
  * KINETIS_MCG_HAS_C1                - SoC has C1 Register
  * KINETIS_MCG_HAS_C1_IREFS          - SoC has C1[IREFS]
  * KINETIS_MCG_HAS_C1_FRDIV          - SoC has C1[FRDIV]
- * KINETIS_MCG_C1_FRDIV_MAX          - C1[FRDIV] maximum value 5=1024, 6=1280 7=1536
+ * KINETIS_MCG_C1_FRDIV_MAX          - C1[FRDIV] maximum value
+ *                                     5=1024, 6=1280 7=1536
  * KINETIS_MCG_HAS_C2                - SoC has C2 Register
  * KINETIS_MCG_HAS_C2_HGO            - SoC has C2[HGO]
  * KINETIS_MCG_HAS_C2_RANGE          - SoC has C2[RANG]
@@ -75,13 +82,16 @@
  * KINETIS_MCG_HAS_C4                - SoC has C4 Register
  * KINETIS_MCG_HAS_C5                - SoC has C5 Register
  * KINETIS_MCG_HAS_C5_PRDIV          - SoC has C5[PRDIV]
- * KINETIS_MCG_C5_PRDIV_BASE         - PRDIV base value corresponding to 0 in C5[PRDIV]
+ * KINETIS_MCG_C5_PRDIV_BASE         - PRDIV base value
+ *                                     corresponding to 0 in C5[PRDIV]
  * KINETIS_MCG_C5_PRDIV_MAX          - The Maximum value of C5[PRVDIV])
- * KINETIS_MCG_C5_PRDIV_BITS         - Has n bits of phase-locked loop (PLL) PRDIV (register C5[PRDIV]
+ * KINETIS_MCG_C5_PRDIV_BITS         - Has n bits of phase-locked loop
+ *                                     (PLL) PRDIV (register C5[PRDIV]
  * KINETIS_MCG_HAS_C5_PLLREFSEL0     - SoC has C5[PLLREFSEL0]
  * KINETIS_MCG_HAS_C6                - SoC has C6 Register
  * KINETIS_MCG_HAS_C6_VDIV           - SoC has C6[VDIV]
- * KINETIS_MCG_C6_VDIV_BASE          - VDIV base value corresponding to 0 in C6[VDIV]
+ * KINETIS_MCG_C6_VDIV_BASE          - VDIV base value
+ *                                     corresponding to 0 in C6[VDIV]
  * KINETIS_MCG_C6_VDIV_MAX           - The Maximum value of C6[VDIV]
  * KINETIS_MCG_HAS_C6_CME            - SoC has C6[CME]
  * KINETIS_MCG_HAS_C6_PLLS           - SoC has C6[PLLS]
@@ -112,12 +122,14 @@
  * KINETIS_MCG_HAS_C10               - SoC has C10 Register
  * KINETIS_MCG_HAS_C10_LOCS1         - SoC has C10[LOCS1]
  * KINETIS_MCG_HAS_C11               - SoC has C11 Register
- * KINETIS_MCG_HAS_C11_PLL1OSC1      - SoC has C1[PRDIV1], C11[PLLSTEN1], C11[PLLCLKEN1], C11[PLLREFSEL1],
+ * KINETIS_MCG_HAS_C11_PLL1OSC1      - SoC has C1[PRDIV1], C11[PLLSTEN1],
+ *                                     C11[PLLCLKEN1], C11[PLLREFSEL1],
  * KINETIS_MCG_HAS_C11_PLLCS         - SoC has C11[PLLCS]
  * KINETIS_MCG_HAS_C11_PLLREFSEL1    - SoC has C11[PLLREFSEL1]
  * KINETIS_MCG_HAS_C12               - SoC has C12 Register
  * KINETIS_MCG_HAS_S2                - SoC has S2 Register
- * KINETIS_MCG_HAS_S2_PLL1OSC1       - SoC has S2[LOCS2], S2[OSCINIT1], S2[LOCK1], S2[LOLS1]
+ * KINETIS_MCG_HAS_S2_PLL1OSC1       - SoC has S2[LOCS2],
+ *                                     S2[OSCINIT1], S2[LOCK1], S2[LOLS1]
  * KINETIS_MCG_HAS_S2_PLLCST         - SoC has S2[PLLCST]
  */
 
@@ -192,7 +204,9 @@
 
 #elif defined(CONFIG_ARCH_CHIP_MK28FN2M0VMI15) || defined(CONFIG_ARCH_CHIP_MK28FN2M0CAU15R)
 
-/* Verified to Document Number: K28P210M150SF5RM Rev. 4, August 2017 */
+/* Verified to Document Number:
+ * K28P210M150SF5RM Rev. 4, August 2017
+ */
 
 #  define KINETIS_MCG_VERSION KINETIS_MCG_VERSION_06
 
@@ -201,9 +215,10 @@
 #  define KINETIS_MCG_PLL_REF_MIN            8000000   /* OSCCLK/PLL_R minimum */
 #  define KINETIS_MCG_PLL_REF_MAX            16000000  /* OSCCLK/PLL_R maximum */
 
-/* TODO: The following configuration parameters have not been verified.  They were
- * taken wholesale from the K66F.  The K66F is very similar and, most likely, the
- * settings are corred.
+/* TODO:
+ * The following configuration parameters have not been verified.  They were
+ * taken wholesale from the K66F.  The K66F is very similar and, most likely,
+ * the settings are corred.
  */
 
 #  define KINETIS_MCG_PLL_INTERNAL_DIVBY     2         /* The PLL clock is divided by 2 before VCO divider */
@@ -546,7 +561,9 @@
 #elif defined(CONFIG_ARCH_CHIP_MK66FN2M0VMD18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VMD18) || \
       defined(CONFIG_ARCH_CHIP_MK66FN2M0VLQ18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VLQ18)
 
-/* Verified to Document Number: Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 */
+/* Verified to Document Number:
+ * Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015
+ */
 
 #  define KINETIS_MCG_VERSION KINETIS_MCG_VERSION_06
 
@@ -646,7 +663,9 @@
 #  error "Unsupported Kinetis chip"
 #endif
 
-/* Use the catch all configuration for the MCG based on the implementations in nuttx prior 2/3/2017 */
+/* Use the catch all configuration for the MCG based on
+ * the implementations in nuttx prior 2/3/2017
+ */
 
 #if KINETIS_MCG_VERSION == KINETIS_MCG_VERSION_UKN
 
diff --git a/arch/arm/include/kinetis/kinetis_pmc.h b/arch/arm/include/kinetis/kinetis_pmc.h
index 37b77c6..7a03c13 100644
--- a/arch/arm/include/kinetis/kinetis_pmc.h
+++ b/arch/arm/include/kinetis/kinetis_pmc.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_pmc.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,34 +16,36 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_PMC_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_PMC_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-
-/* Note: It is envisioned that in the long term as a chip is added. The author of
- * the new chip definitions will either find the exact configuration in an existing
- * chip define and add the new chip to it Or add the PMC feature configuration
- * #defines to the chip ifdef list below. In either case the author should mark
- * it as "Verified to Document Number:" taken from the reference manual.
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* Note:
+ * It is envisioned that in the long term as a chip is added. The author of
+ * the new chip definitions will either find the exact configuration in an
+ * existing chip define and add the new chip to it Or add the PMC feature
+ * configuration #defines to the chip ifdef list below. In either case the
+ * author should mark it as "Verified to Document Number:" taken from the
+ * reference manual.
  *
  * To maintain backward compatibility to the version of NuttX prior to
  * 2/22/2017, the catch all KINETIS_PMC_VERSION_UKN configuration is assigned
  * to all the chips that did not have any conditional compilation based on
- * KINETIS_K64 or KINETIS_K66. This is  a "No worse" than the original code solution.
- * N.B. Each original chip "if"definitions have been left intact so that the
- * complete legacy definitions prior to 2/22/2017 may be filled in completely when
- * vetted.
+ * KINETIS_K64 or KINETIS_K66. This is  a "No worse" than the original code
+ * solution. N.B. Each original chip "if"definitions have been left intact so
+ * that the complete legacy definitions prior to 2/22/2017 may be filled in
+ * completely when vetted.
  */
 
 /* PMC Register Configuration
@@ -323,8 +325,8 @@
 #  error "Unsupported Kinetis chip"
 #endif
 
-/* Use the catch all configuration for the PMC based on the implementations in
- * NuttX prior to 2/3/2017
+/* Use the catch all configuration for the PMC based on
+ * the implementations in NuttX prior to 2/3/2017
  */
 
 #if KINETIS_PMC_VERSION == KINETIS_PMC_VERSION_UKN
diff --git a/arch/arm/include/kinetis/kinetis_sim.h b/arch/arm/include/kinetis/kinetis_sim.h
index 2960f50..a665d59 100644
--- a/arch/arm/include/kinetis/kinetis_sim.h
+++ b/arch/arm/include/kinetis/kinetis_sim.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kinetis/kinetis_sim.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,34 +16,36 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_SIM_H
 #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_SIM_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-
-/* Note: It is envisioned that in the long term as a chip is added. The author of
- * the new chip definitions will either find the exact configuration in an existing
- * chip define and add the new chip to it Or add the SIM feature configuration
- * #defines to the chip ifdef list below. In either case the author should mark
- * it as "Verified to Document Number:" taken from the reference manual.
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* Note:
+ * It is envisioned that in the long term as a chip is added. The author of
+ * the new chip definitions will either find the exact configuration in an
+ * existing chip define and add the new chip to it Or add the SIM feature
+ * configuration #defines to the chip ifdef list below. In either case the
+ * author should mark it as "Verified to Document Number:" taken from the
+ * reference manual.
  *
  * To maintain backward compatibility to the version of NuttX prior to
- * 2/16/2017, the catch all KINETIS_SIM_VERSION_UKN configuration is assigned
- * to all the chips that did not have any conditional compilation based on
- * KINETIS_K64 or KINETIS_K66. This is  a "No worse" than the original code solution.
- * N.B. Each original chip "if"definitions have been left intact so that the
- * complete legacy definitions prior to 2/16/2017 may be filled in completely when
- * vetted.
+ * 2/16/2017, the catch all KINETIS_SIM_VERSION_UKN configuration is
+ * assigned to all the chips that did not have any conditional compilation
+ * based on KINETIS_K64 or KINETIS_K66. This is  a "No worse" than the
+ * original code solution. N.B. Each original chip "if"definitions have been
+ * left intact so that the complete legacy definitions prior to 2/16/2017 may
+ * be filled in completely when vetted.
  */
 
 /* SIM Register Configuration
@@ -95,7 +97,8 @@
  * KINETIS_SIM_HAS_SOPT4_FTM0FLT3          -  SoC has SOPT4[FTM0FLT3]
  * KINETIS_SIM_HAS_SOPT4_FTM0TRG0SRC       -  SoC has SOPT4[FTM0TRG0SRC]
  * KINETIS_SIM_HAS_SOPT4_FTM0TRG1SRC       -  SoC has SOPT4[FTM0TRG1SRC]
- * KINETIS_SIM_HAS_SOPT4_FTM1CH0SRC        -  SoC has SOPT4[FTM1CH0SRC] 1, 3 if SOF
+ * KINETIS_SIM_HAS_SOPT4_FTM1CH0SRC        -  SoC has SOPT4[FTM1CH0SRC]
+ *                                                 1, 3 if SOF
  * KINETIS_SIM_HAS_SOPT4_FTM1FLT0          -  SoC has SOPT4[FTM1FLT0]
  * KINETIS_SIM_HAS_SOPT4_FTM1FLT1          -  SoC has SOPT4[FTM1FLT1]
  * KINETIS_SIM_HAS_SOPT4_FTM1FLT2          -  SoC has SOPT4[FTM1FLT2]
@@ -143,10 +146,14 @@
  * KINETIS_SIM_HAS_SOPT7_ADC1TRGSEL        -  SoC has n SOPT7[ADC1TRGSEL]
  * KINETIS_SIM_HAS_SOPT7_ADC2TRGSEL        -  SoC has n SOPT7[ADC2TRGSEL]
  * KINETIS_SIM_HAS_SOPT7_ADC3TRGSEL        -  SoC has n SOPT7[ADC3TRGSEL]
- * KINETIS_SIM_SOPT7_ADC0ALTTRGEN          -  SoC has ADC0 alternate trigger enable
- * KINETIS_SIM_SOPT7_ADC1ALTTRGEN          -  SoC has ADC1 alternate trigger enable
- * KINETIS_SIM_SOPT7_ADC2ALTTRGEN          -  SoC has ADC2 alternate trigger enable
- * KINETIS_SIM_SOPT7_ADC3ALTTRGEN          -  SoC has ADC3 alternate trigger enable
+ * KINETIS_SIM_SOPT7_ADC0ALTTRGEN          -  SoC has ADC0
+ *                                            alternate trigger enable
+ * KINETIS_SIM_SOPT7_ADC1ALTTRGEN          -  SoC has ADC1
+ *                                            alternate trigger enable
+ * KINETIS_SIM_SOPT7_ADC2ALTTRGEN          -  SoC has ADC2
+ *                                            alternate trigger enable
+ * KINETIS_SIM_SOPT7_ADC3ALTTRGEN          -  SoC has ADC3
+ *                                            alternate trigger enable
  * KINETIS_SIM_HAS_SOPT8                   -  SoC has SOPT8 Register
  * KINETIS_SIM_HAS_SOPT8_FTM0SYNCBIT       -  SoC has SOPT8[FTM0SYNCBIT]
  * KINETIS_SIM_HAS_SOPT8_FTM1SYNCBIT       -  SoC has SOPT8[FTM1SYNCBIT]
@@ -260,8 +267,10 @@
  * KINETIS_SIM_HAS_FCFG1_FTFDIS            -  SoC has FCFG1[FTFDIS]
  * KINETIS_SIM_HAS_FCFG1_NVMSIZE           -  SoC has FCFG1[NVMSIZE]
  * KINETIS_SIM_HAS_FCFG2                   -  SoC has FCFG2 Register
- * KINETIS_SIM_HAS_FCFG2_MAXADDR0          -  SoC has n bit of FCFG2[MAXADDR0]
- * KINETIS_SIM_HAS_FCFG2_MAXADDR1          -  SoC has n bit of FCFG2[MAXADDR1]
+ * KINETIS_SIM_HAS_FCFG2_MAXADDR0          -  SoC has n bit of
+ *                                            FCFG2[MAXADDR0]
+ * KINETIS_SIM_HAS_FCFG2_MAXADDR1          -  SoC has n bit of
+ *                                            FCFG2[MAXADDR1]
  * KINETIS_SIM_HAS_FCFG2_PFLSH             -  SoC has FCFG2[PFLSH]
  * KINETIS_SIM_HAS_FCFG2_SWAPPFLSH         -  SoC has FCFG2[SWAPPFLSH]
  * KINETIS_SIM_HAS_UIDH                    -  SoC has UIDH Register
diff --git a/arch/arm/include/kl/chip.h b/arch/arm/include/kl/chip.h
index ac9c5f4..18a7421 100644
--- a/arch/arm/include/kl/chip.h
+++ b/arch/arm/include/kl/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kl/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_KL_CHIP_H
 #define __ARCH_ARM_INCLUDE_KL_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
@@ -153,10 +153,12 @@
 #  error "Unsupported Kinetis chip"
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-15. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:6] of each field, bits[5:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-15. The lower the value, the
+ * greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:6] of each field, bits[5:0] read as zero and ignore
+ * writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN     0xc0 /* All bits[7:6] set is minimum priority */
@@ -164,15 +166,15 @@
 #define NVIC_SYSH_PRIORITY_MAX     0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP    0x40 /* Steps between supported priority values */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 #endif /* __ARCH_ARM_INCLUDE_KL_CHIP_H */
diff --git a/arch/arm/include/kl/irq.h b/arch/arm/include/kl/irq.h
index 8194966..e544e02 100644
--- a/arch/arm/include/kl/irq.h
+++ b/arch/arm/include/kl/irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/kl/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,41 +16,43 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_KL_IRQ_H
 #define __ARCH_ARM_INCLUDE_KL_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <nuttx/irq.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-/* IRQ numbers **********************************************************************/
-/* The IRQ numbers corresponds directly to vector numbers and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* IRQ numbers **************************************************************/
+
+/* The IRQ numbers corresponds directly to vector numbers and hence map
+ * directly to bits in the NVIC.  This does, however, waste several words of
+ * memory in the IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
 
 #define KL_IRQ_RESERVED      (0)   /* Reserved vector (only used with CONFIG_DEBUG_FEATURES) */
-                                        /* Vector  0: Reset stack pointer value */
-                                        /* Vector  1: Reset (not handler as an IRQ) */
+                                   /* Vector  0: Reset stack pointer value */
+                                   /* Vector  1: Reset (not handler as an IRQ) */
 #define KL_IRQ_NMI           (2)   /* Vector  2: Non-Maskable Interrupt (NMI) */
 #define KL_IRQ_HARDFAULT     (3)   /* Vector  3: Hard fault */
-                                        /* Vectors 4-10: Reserved */
+                                   /* Vectors 4-10: Reserved */
 #define KL_IRQ_SVCALL        (11)  /* Vector 11: SVC call */
-                                        /* Vector 12-13: Reserved */
+                                   /* Vector 12-13: Reserved */
 #define KL_IRQ_PENDSV        (14)  /* Vector 14: Pendable system service request */
 #define KL_IRQ_SYSTICK       (15)  /* Vector 15: System tick */
 
@@ -58,10 +60,10 @@
 
 #define KL_IRQ_EXTINT        (16)
 
-/* K40 Family ***********************************************************************
+/* K40 Family ***************************************************************
  *
- * The interrupt vectors  for the following parts is defined in Freescale document
- * K40P144M100SF2RM
+ * The interrupt vectors  for the following parts is defined in Freescale
+ * document K40P144M100SF2RM
  */
 
 #if defined(CONFIG_ARCH_CHIP_MKL25Z128) || defined(CONFIG_ARCH_CHIP_MKL25Z64)
@@ -99,12 +101,13 @@
 #  define KL_IRQ_PORTA         (46)  /* Vector 46: GPIO Port A */
 #  define KL_IRQ_PORTD         (47)  /* Vector 47: GPIO Port D */
 
-/* Note that the total number of IRQ numbers supported is equal to the number of
- * valid interrupt vectors.  This is wasteful in that certain tables are sized by
- * this value.  There are only 94 valid interrupts so, potentially the number of
- * IRQs to could be reduced to 94.  However, equating IRQ numbers with vector numbers
- * also simplifies operations on NVIC registers and (at least in my state of mind
- * now) seems to justify the waste.
+/* Note that the total number of IRQ numbers supported is equal to the
+ * number of valid interrupt vectors.  This is wasteful in that certain
+ * tables are sized by this value.  There are only 94 valid interrupts so,
+ * potentially the number of IRQs to could be reduced to 94.  However,
+ * equating IRQ numbers with vector numbers also simplifies operations on
+ * NVIC registers and (at least in my state of mind now) seems to justify
+ * the waste.
  */
 
 #  define NR_IRQS              (48) /* 64 interrupts but 48 IRQ numbers */
@@ -144,33 +147,34 @@
 #  define KL_IRQ_PORTA         (46)  /* Vector 46: GPIO Port A */
 #  define KL_IRQ_PORTD         (47)  /* Vector 47: GPIO Port D */
 
-/* Note that the total number of IRQ numbers supported is equal to the number of
- * valid interrupt vectors.  This is wasteful in that certain tables are sized by
- * this value.  There are only 94 valid interrupts so, potentially the number of
- * IRQs to could be reduced to 94.  However, equating IRQ numbers with vector numbers
- * also simplifies operations on NVIC registers and (at least in my state of mind
- * now) seems to justify the waste.
+/* Note that the total number of IRQ numbers supported is equal to the
+ * number of valid interrupt vectors.  This is wasteful in that certain
+ * tables are sized by this value.  There are only 94 valid interrupts so,
+ * potentially the number of IRQs to could be reduced to 94.  However,
+ * equating IRQ numbers with vector numbers also simplifies operations on
+ * NVIC registers and (at least in my state of mind now) seems to justify
+ * the waste.
  */
 
 #  define NR_IRQS              (48) /* 64 interrupts but 48 IRQ numbers */
 
 #else
-  /* The interrupt vectors for other parts are defined in other documents and may or
-   * may not be the same as above (the family members are all very similar)  This
-   * error just means that you have to look at the document and determine for yourself
-   * if the vectors are the same.
-   */
+/* The interrupt vectors for other parts are defined in other documents and
+ * may or may not be the same as above (the family members are all very
+ * similar)  This error just means that you have to look at the document and
+ * determine for yourself if the vectors are the same.
+ */
 
 #  error "No IRQ numbers for this Kinetis L part"
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -181,9 +185,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/lc823450/chip.h b/arch/arm/include/lc823450/chip.h
index f8e8050..d6423d8 100644
--- a/arch/arm/include/lc823450/chip.h
+++ b/arch/arm/include/lc823450/chip.h
@@ -28,7 +28,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* NVIC priority levels *****************************************************/
diff --git a/arch/arm/include/lc823450/clk.h b/arch/arm/include/lc823450/clk.h
index 2c7ccc5..5e90a61 100644
--- a/arch/arm/include/lc823450/clk.h
+++ b/arch/arm/include/lc823450/clk.h
@@ -26,7 +26,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define LC823450_CLOCKS \
diff --git a/arch/arm/include/lc823450/irq.h b/arch/arm/include/lc823450/irq.h
index dd5b22e..72d8115 100644
--- a/arch/arm/include/lc823450/irq.h
+++ b/arch/arm/include/lc823450/irq.h
@@ -33,7 +33,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Processor Exceptions (vectors 0-15) */
diff --git a/arch/arm/include/limits.h b/arch/arm/include/limits.h
index 55ad8c5..64daced 100644
--- a/arch/arm/include/limits.h
+++ b/arch/arm/include/limits.h
@@ -26,7 +26,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 #define CHAR_BIT    8
diff --git a/arch/arm/include/lpc17xx_40xx/chip.h b/arch/arm/include/lpc17xx_40xx/chip.h
index faa36ac..bece30c 100644
--- a/arch/arm/include/lpc17xx_40xx/chip.h
+++ b/arch/arm/include/lpc17xx_40xx/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/lpc17xx_40xx/chip.h
  *
  *   Copyright (C) 2010-2011, 2013 Gregory Nutt. All rights reserved.
@@ -32,20 +32,20 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_LPC17XX_40XX_CHIP_H
 #define __ARCH_ARM_INCLUDE_LPC17XX_40XX_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
@@ -217,6 +217,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1773)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (128*1024) /* 128Kb */
 #  define LPC17_40_SRAM_SIZE        (40*1024)  /*  40Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (32*1024)
@@ -233,6 +234,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1774)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (128*1024) /* 128Kb */
 #  define LPC17_40_SRAM_SIZE        (40*1024)  /*  40Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (32*1024)
@@ -249,6 +251,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1776)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (256*1024) /* 256Kb */
 #  define LPC17_40_SRAM_SIZE        (80*1024)  /*  80Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -265,6 +268,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1777)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (512*1024) /* 512Kb */
 #  define LPC17_40_SRAM_SIZE        (96*1024)  /*  96Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -281,6 +285,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1778)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (512*1024) /* 512Kb */
 #  define LPC17_40_SRAM_SIZE        (96*1024)  /*  64Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -297,6 +302,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1785)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (256*1024) /* 256Kb */
 #  define LPC17_40_SRAM_SIZE        (80*1024)  /*  80Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -313,6 +319,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1786)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (256*1024) /* 256Kb */
 #  define LPC17_40_SRAM_SIZE        (80*1024)  /*  80Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -329,6 +336,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1787)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (512*1024) /* 512Kb */
 #  define LPC17_40_SRAM_SIZE        (96*1024)  /*  96Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -345,6 +353,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC1788)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (512*1024) /* 512Kb */
 #  define LPC17_40_SRAM_SIZE        (96*1024)  /*  96Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -361,6 +370,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC4072)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (64*1024)  /*  64Kb */
 #  define LPC17_40_SRAM_SIZE        (24*1024)  /*  24Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (16*1024)
@@ -377,6 +387,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC4074)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (128*1024) /* 128Kb */
 #  define LPC17_40_SRAM_SIZE        (40*1024)  /*  40Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (32*1024)
@@ -393,6 +404,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC4076)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (256*1024) /* 256Kb */
 #  define LPC17_40_SRAM_SIZE        (80*1024)  /*  80Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -409,6 +421,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC4078)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (512*1024) /* 512Kb */
 #  define LPC17_40_SRAM_SIZE        (96*1024)  /*  96Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -425,6 +438,7 @@
 #elif defined(CONFIG_ARCH_CHIP_LPC4088)
 #  undef  LPC176x                      /* Not LPC175/6 family */
 #  define LPC178x_40xx              1  /* LPC177/8 or LPC40xx family */
+
 #  define LPC17_40_FLASH_SIZE       (512*1024) /* 512Kb */
 #  define LPC17_40_SRAM_SIZE        (96*1024)  /*  64Kb */
 #  define LPC17_40_CPUSRAM_SIZE     (64*1024)
@@ -442,10 +456,12 @@
 #  error "Unsupported LPC17xx/LPC40xx chip"
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-31. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:3] of each field, bits[2:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-31. The lower the value, the
+ * greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:3] of each field, bits[2:0] read as zero and ignore
+ * writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN     0xf8 /* All bits[7:3] set is minimum priority */
@@ -453,16 +469,16 @@
 #define NVIC_SYSH_PRIORITY_MAX     0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP    0x08 /* Five bits of interrupt priority used */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_LPC17XX_40XX_CHIP_H */
diff --git a/arch/arm/include/lpc17xx_40xx/irq.h b/arch/arm/include/lpc17xx_40xx/irq.h
index 77de3b8..bb4e608 100644
--- a/arch/arm/include/lpc17xx_40xx/irq.h
+++ b/arch/arm/include/lpc17xx_40xx/irq.h
@@ -35,8 +35,9 @@
 #include <arch/lpc17xx_40xx/chip.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
+
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
diff --git a/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h b/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h
index d5c04f4..6da827d 100644
--- a/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h
+++ b/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h
@@ -18,8 +18,8 @@
  *
  ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly
- * through nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_LPC17XX_40XX_LPC176X_IRQ_H
@@ -30,8 +30,9 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
+
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
@@ -122,9 +123,9 @@
 #define LPC17_40_IRQ_NEXTINT        (35)
 #define LPC17_40_IRQ_NIRQS          (LPC17_40_IRQ_EXTINT+LPC17_40_IRQ_NEXTINT)
 
-/* GPIO interrupts.  The LPC17xx/LPC40xx supports several interrupts on ports 0 and
- * 2 (only).  We go through some special efforts to keep the number of IRQs
- * to a minimum in this sparse interrupt case.
+/* GPIO interrupts.  The LPC17xx/LPC40xx supports several interrupts on ports
+ * 0 and 2 (only).  We go through some special efforts to keep the number of
+ * IRQs to a minimum in this sparse interrupt case.
  *
  * 28 interrupts on Port 0:  p0.0 - p0.11, p0.15-p0.30
  * 14 interrupts on Port 2:  p2.0 - p2.13
@@ -136,7 +137,7 @@
 #  define LPC17_40_VALID_GPIOINT0  (0x7fff8ffful) /* GPIO port 0 interrupt set */
 #  define LPC17_40_VALID_GPIOINT2  (0x00003ffful) /* GPIO port 2 interrupt set */
 
-   /* Set 1: 12 interrupts p0.0-p0.11 */
+/* Set 1: 12 interrupts p0.0-p0.11 */
 
 #  define LPC17_40_VALID_GPIOINT0L  (0x00000ffful)
 #  define LPC17_40_VALID_SHIFT0L    (0)
@@ -156,7 +157,7 @@
 #  define LPC17_40_IRQ_P0p11        (LPC17_40_VALID_FIRST0L+11)
 #  define LPC17_40_VALID_NIRQS0L    (12)
 
-   /* Set 2: 16 interrupts p0.15-p0.30 */
+/* Set 2: 16 interrupts p0.15-p0.30 */
 
 #  define LPC17_40_VALID_GPIOINT0H  (0x7fff8000ull)
 #  define LPC17_40_VALID_SHIFT0H    (15)
@@ -180,7 +181,7 @@
 #  define LPC17_40_IRQ_P0p30        (LPC17_40_VALID_FIRST0H+15)
 #  define LPC17_40_VALID_NIRQS0H    (16)
 
-   /* Set 3: 14 interrupts p2.0-p2.13 */
+/* Set 3: 14 interrupts p2.0-p2.13 */
 
 #  define LPC17_40_VALID_GPIOINT2   (0x00003ffful)
 #  define LPC17_40_VALID_SHIFT2     (0)
diff --git a/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h b/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h
index 4a627a5..4c55268 100644
--- a/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h
+++ b/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h
@@ -46,7 +46,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
@@ -156,8 +156,9 @@
 #define LPC17_40_IRQ_NEXTINT       (41)
 #define LPC17_40_IRQ_NIRQS         (LPC17_40_IRQ_EXTINT+LPC17_40_IRQ_NEXTINT)
 
-/* GPIO interrupts.  The LPC177x_8x supports several interrupts on ports 0 and
- * 2 (only).  We go through some special efforts to keep the number of IRQs
+/* GPIO interrupts.
+ * The LPC177x_8x supports several interrupts on ports 0 and 2 (only).
+ * We go through some special efforts to keep the number of IRQs
  * to a minimum in this sparse interrupt case.
  *
  * 31 interrupts on Port 0:  p0.0 - p0.30
@@ -170,7 +171,7 @@
 #  define LPC17_40_VALID_GPIOINT0   (0xfffffffful) /* GPIO port 0 interrupt set */
 #  define LPC17_40_VALID_GPIOINT2   (0xfffffffful) /* GPIO port 2 interrupt set */
 
-   /* Set 1: 16 interrupts p0.0-p0.15 */
+/* Set 1: 16 interrupts p0.0-p0.15 */
 
 #  define LPC17_40_VALID_SHIFT0L    (0)
 #  define LPC17_40_VALID_FIRST0L    (LPC17_40_IRQ_EXTINT+LPC17_40_IRQ_NEXTINT)
@@ -193,7 +194,7 @@
 #  define LPC17_40_IRQ_P0p15        (LPC17_40_VALID_FIRST0L+15)
 #  define LPC17_40_VALID_NIRQS0L    (16)
 
-   /* Set 2: 16 interrupts p0.16-p0.31 */
+/* Set 2: 16 interrupts p0.16-p0.31 */
 
 #  define LPC17_40_VALID_SHIFT0H    (16)
 #  define LPC17_40_VALID_FIRST0H    (LPC17_40_VALID_FIRST0L+LPC17_40_VALID_NIRQS0L)
@@ -216,7 +217,7 @@
 #  define LPC17_40_IRQ_P0p31        (LPC17_40_VALID_FIRST0H+15)
 #  define LPC17_40_VALID_NIRQS0H    (16)
 
-   /* Set 3: 16 interrupts p2.0-p2.15 */
+/* Set 3: 16 interrupts p2.0-p2.15 */
 
 #  define LPC17_40_VALID_SHIFT2L    (0)
 #  define LPC17_40_VALID_FIRST2L    (LPC17_40_VALID_FIRST0H+LPC17_40_VALID_NIRQS0H)
@@ -239,7 +240,7 @@
 #  define LPC17_40_IRQ_P2p15        (LPC17_40_VALID_FIRST2L+15)
 #  define LPC17_40_VALID_NIRQS2L    (16)
 
-   /* Set 4: 16 interrupts p2.16 - p2.31 */
+/* Set 4: 16 interrupts p2.16 - p2.31 */
 
 #  define LPC17_40_VALID_SHIFT2H    (16)
 #  define LPC17_40_VALID_FIRST2H    (LPC17_40_VALID_FIRST2L+LPC17_40_VALID_NIRQS2L)
diff --git a/arch/arm/include/lpc214x/irq.h b/arch/arm/include/lpc214x/irq.h
index 493b433..b14f82f 100644
--- a/arch/arm/include/lpc214x/irq.h
+++ b/arch/arm/include/lpc214x/irq.h
@@ -34,7 +34,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* LPC214X Interrupts */
diff --git a/arch/arm/include/lpc2378/irq.h b/arch/arm/include/lpc2378/irq.h
index 4b324da..05b75ad 100644
--- a/arch/arm/include/lpc2378/irq.h
+++ b/arch/arm/include/lpc2378/irq.h
@@ -55,7 +55,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* LPC2378 Interrupts */
@@ -94,12 +94,12 @@
 #define I2C2_IRQ      30 /* I2C 2 */
 #define I2S_IRQ       31 /* I2S */
 
-
 #define IRQ_SYSTIMER  TIMER0_IRQ
 
 #define NR_IRQS             32
 
-/* There are 32 vectored interrupts.  If vectored interrupts are enabled, the
+/* There are 32 vectored interrupts.
+ * If vectored interrupts are enabled, the
  * following will be used by the system.
  */
 #define SYSTIMER_VEC  0 /* System timer */
diff --git a/arch/arm/include/lpc31xx/irq.h b/arch/arm/include/lpc31xx/irq.h
index 4ac8b1a..482bc28 100644
--- a/arch/arm/include/lpc31xx/irq.h
+++ b/arch/arm/include/lpc31xx/irq.h
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* LPC31XX Interrupts */
diff --git a/arch/arm/include/lpc43xx/chip.h b/arch/arm/include/lpc43xx/chip.h
index b923a9d..a5a9ce3 100644
--- a/arch/arm/include/lpc43xx/chip.h
+++ b/arch/arm/include/lpc43xx/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/lpc43xx/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_LPC43XX_CHIP_H
 #define __ARCH_ARM_INCLUDE_LPC43XX_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Per the data sheet: LPC4350/30/20/10 Rev. 3.2 — 4 June 2012 */
 
@@ -65,33 +65,41 @@
 /* Get customizations for each supported chip.
  *
  * SRAM Resources
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * Local SRAM            LPC4310  LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * BANK 0 (0x1000 0000)     96Kb    96Kb   128Kb   128Kb    32Kb    32Kb    32Kb
- * BANK 1 (0x1008 0000)     40Kb    40Kb    72Kb    72Kb    40Kb    40Kb    40Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * SUBTOTAL                136Kb   136Kb   200Kb   200Kb    72Kb    72Kb    72Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * AHB SRAM              LPC4310  LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * BANK 0 (0x2000 0000)     16Kb    48Kb   48Kb    48Kb     48Kb    48Kb    48Kb
- * BANK 1 (0x2000 8000)             NOTE 1 NOTE 1  NOTE 1  NOTE 1  NOTE 1  NOTE 1
- * BANK 2 (0x2000 c000)     16Kb    16Kb   16Kb    16Kb    16Kb    16Kb     16Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * SUBTOTAL                 32Kb    64Kb   64Kb    64Kb     64Kb    64Kb    64Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * TOTAL                   168Kb   200Kb  264Kb   264Kb    136Kb   136Kb   136Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
+ * --------------- -------- ------- ------- ------- ------- ------- -------
+ * Local SRAM      LPC4310  LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337
+ * --------------- -------- ------- ------- ------- ------- ------- -------
+ * BANK 0          96Kb    96Kb   128Kb   128Kb    32Kb    32Kb    32Kb
+ * (0x1000 0000)
+ * BANK 1          40Kb    40Kb    72Kb    72Kb    40Kb    40Kb    40Kb
+ * (0x1008 0000)
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * SUBTOTAL        136Kb   136Kb   200Kb   200Kb    72Kb    72Kb    72Kb
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * AHB SRAM        LPC4310  LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * BANK 0          16Kb    48Kb   48Kb    48Kb     48Kb    48Kb    48Kb
+ * (0x2000 0000)
+ * BANK 1                   NOTE 1 NOTE 1  NOTE 1  NOTE 1  NOTE 1  NOTE 1
+ * (0x2000 8000)
+ * BANK 2          16Kb    16Kb   16Kb    16Kb    16Kb    16Kb     16Kb
+ * (0x2000 c000)
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * SUBTOTAL        32Kb    64Kb   64Kb    64Kb     64Kb    64Kb    64Kb
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * TOTAL           168Kb   200Kb  264Kb   264Kb    136Kb   136Kb   136Kb
+ * -------------- -------- ------- ------- ------- ------- ------- -------
  *
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * FLASH                 LPC4310  LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * BANK A (0x1a00 0000)                                    256Kb   512Kb   512Kb
- * BANK B (0x1b00 8000)                                    256Kb   512Kb   512Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
- * TOTAL                   None    None    None    None    512Kb  1024Kb   1024Kb
- * --------------------- -------- ------- ------- ------- ------- ------- -------
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * FLASH          LPC4310  LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * BANK A                                           256Kb   512Kb   512Kb
+ * (0x1a00 0000)
+ * BANK B                                           256Kb   512Kb   512Kb
+ * (0x1b00 8000)
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+ * TOTAL            None    None    None    None    512Kb  1024Kb   1024Kb
+ * -------------- -------- ------- ------- ------- ------- ------- -------
+
  *
  * NOTE 1: The 64Kb of AHB of SRAM on the LPC4350/30/20 span all AHB SRAM
  * banks but are treated as two banks of 48 an 16Kb by the NuttX memory
@@ -674,10 +682,10 @@
 #  error "Unsupported LPC43xx chip"
 #endif
 
-/* NVIC priority levels *************************************************************/
+/* NVIC priority levels *****************************************************/
 
-/* Each priority field holds a priority value, 0-31. The lower the value, the greater
- * the priority of the corresponding interrupt.
+/* Each priority field holds a priority value, 0-31. The lower the value, the
+ * greater the priority of the corresponding interrupt.
  *
  * The Cortex-M4 core supports up to 53 interrupts an 8 prgrammable interrupt
  * priority levels; The Cortex-M0 core supports up to 32 interrupts with 4
diff --git a/arch/arm/include/lpc43xx/irq.h b/arch/arm/include/lpc43xx/irq.h
index dd3f3e1..46e4b69 100644
--- a/arch/arm/include/lpc43xx/irq.h
+++ b/arch/arm/include/lpc43xx/irq.h
@@ -1,4 +1,4 @@
-/********************************************************************************************
+/****************************************************************************
  * arch/arm/include/lpc43xx/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ********************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather,
  * only indirectly through nuttx/irq.h
@@ -25,21 +25,22 @@
 #ifndef __ARCH_ARM_INCLUDE_LPC43XX_IRQ_H
 #define __ARCH_ARM_INCLUDE_LPC43XX_IRQ_H
 
-/********************************************************************************************
+/****************************************************************************
  * Included Files
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #  include <stdint.h>
 #endif
 
-/********************************************************************************************
- * Pre-processor Definitions
- ********************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to bits in
- * the NVIC.  This does, however, waste several words of memory in the IRQ to handle mapping
- * tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits in
+ * the NVIC.  This does, however, waste several words of memory in the IRQ to
+ * handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -114,8 +115,8 @@
 #define LPC43M4_IRQ_NEXTINT       (53)
 #define LPC43M4_IRQ_NIRQS         (LPC43_IRQ_EXTINT+LPC43M4_IRQ_NEXTINT)
 
-/* Total number of IRQ numbers (This will need to be revisited if/when the Cortex-M0 is
- * supported)
+/* Total number of IRQ numbers (This will need to be revisited
+ * if/when the Cortex-M0 is supported)
  */
 
 #define NR_IRQS                   LPC43M4_IRQ_NIRQS
@@ -163,33 +164,33 @@
 #define LPC43M0_IRQ_NEXTINT       (30)
 #define LPC43M0_IRQ_NIRQS         (LPC43_IRQ_EXTINT+LPC43M0_IRQ_NEXTINT)
 
-/* Total number of IRQ numbers (This will need to be revisited if/when the Cortex-M0 is
- * supported)
+/* Total number of IRQ numbers
+ * (This will need to be revisited if/when the Cortex-M0 is supported)
  */
 
 #if 0
 #define NR_IRQS                   LPC43M0_IRQ_NIRQS
 #endif
 
-/********************************************************************************************
+/****************************************************************************
  * Public Types
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 typedef void (*vic_vector_t)(uint32_t *regs);
 #endif
 
-/********************************************************************************************
+/****************************************************************************
  * Inline functions
- ********************************************************************************************/
+ ****************************************************************************/
 
-/********************************************************************************************
+/****************************************************************************
  * Public Data
- ********************************************************************************************/
+ ****************************************************************************/
 
-/********************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/lpc54xx/chip.h b/arch/arm/include/lpc54xx/chip.h
index 2b4546b..87c6f76 100644
--- a/arch/arm/include/lpc54xx/chip.h
+++ b/arch/arm/include/lpc54xx/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/lpc54xx/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,37 +16,40 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_LPC54XX_CHIP_H
 #define __ARCH_ARM_INCLUDE_LPC54XX_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ***********************************************************************************
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
 /* LPC546xx Family Options.
  *
  * Family   CPU Flash  SRAM  FS  HS  Ether- CAN CAN LCD Package
  *          MHz (Kb)   (Kb)  USB USB net    2.0 FD
  * LPC54628 220   512    200 X   X   X      X   X   X   BGA180
  * LPC54618 180 <=512  <=200 X   X   X      X   X   X   BGA180, LQFP208
- * LPC54616 180 <=512  <=200 X   X   X      X   X       BGA100, BGA180, LQFP100, LQFP208
+ * LPC54616 180 <=512  <=200 X   X   X      X   X       BGA100, BGA180,
+ *                                                      LQFP100, LQFP208
  * LPC54608 180   512    200 X   X   X      X       X   BGA180, LQFP208
  * LPC54607 180 <=512  <=200 X   X   X                  BGA180, LQFP208
- * LPC54606 180 <=512  <=200 X   X   X      X           BGA100, BGA180, LQFP100, LQFP208
+ * LPC54606 180 <=512  <=200 X   X   X      X           BGA100, BGA180,
+ *                                                      LQFP100, LQFP208
  * LPC54605 180 <=512  <=200 X   X                      BGA180
  */
 
-/* NVIC priority levels *************************************************************/
+/* NVIC priority levels *****************************************************/
 
-/* Each priority field holds a priority value, 0-31. The lower the value, the greater
- * the priority of the corresponding interrupt.
+/* Each priority field holds a priority value, 0-31. The lower the value, the
+ * greater the priority of the corresponding interrupt.
  *
  * The Cortex-M4 core supports 8 programmable interrupt priority levels.
  */
@@ -56,16 +59,16 @@
 #define NVIC_SYSH_PRIORITY_MAX          0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP         0x20 /* Steps between priorities */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_LPC43XX_CHIP_H */
diff --git a/arch/arm/include/lpc54xx/irq.h b/arch/arm/include/lpc54xx/irq.h
index 4339983..fbf566f 100644
--- a/arch/arm/include/lpc54xx/irq.h
+++ b/arch/arm/include/lpc54xx/irq.h
@@ -1,4 +1,4 @@
-/********************************************************************************************
+/****************************************************************************
  * arch/arm/include/lpc54xx/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ********************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather,
  * only indirectly through nuttx/irq.h
@@ -25,21 +25,22 @@
 #ifndef __ARCH_ARM_INCLUDE_LPC54XX_IRQ_H
 #define __ARCH_ARM_INCLUDE_LPC54XX_IRQ_H
 
-/********************************************************************************************
+/****************************************************************************
  * Included Files
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #  include <stdint.h>
 #endif
 
-/********************************************************************************************
- * Pre-processor Definitions
- ********************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to bits in
- * the NVIC.  This does, however, waste several words of memory in the IRQ to handle mapping
- * tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits in
+ * the NVIC.  This does, however, waste several words of memory in the IRQ to
+ * handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -68,16 +69,16 @@
 #  error "Unsupported LPC54 MCU"
 #endif
 
-/********************************************************************************************
+/****************************************************************************
  * Public Types
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 typedef void (*vic_vector_t)(uint32_t *regs);
 
-/********************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
diff --git a/arch/arm/include/lpc54xx/lpc546x_irq.h b/arch/arm/include/lpc54xx/lpc546x_irq.h
index e7a7a2d..2cd6f32 100644
--- a/arch/arm/include/lpc54xx/lpc546x_irq.h
+++ b/arch/arm/include/lpc54xx/lpc546x_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/lpc54xx/lpc546x_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,18 +16,18 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_LPC54XX_LPC543X_IRQ_H
 #define __ARCH_ARM_INCLUDE_LPC54XX_LPC543X_IRQ_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Cortex-M4 External interrupts (vectors >= 16) */
 
diff --git a/arch/arm/include/max326xx/chip.h b/arch/arm/include/max326xx/chip.h
index c270e78..9a3a13d 100644
--- a/arch/arm/include/max326xx/chip.h
+++ b/arch/arm/include/max326xx/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/max326xx/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,27 +16,27 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_MAX326XX_CHIP_H
 #define __ARCH_ARM_INCLUDE_MAX326XX_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* Get customizations for each supported MAX326xx family.  Only sizes and numbers of
- * things are provided here.  See arch/arm/src/max326xx/Kconfig for other, boolean
- * configuration settings.
+/* Get customizations for each supported MAX326xx family.  Only sizes and
+ * numbers of things are provided here.  See arch/arm/src/max326xx/Kconfig
+ * for other, boolean configuration settings.
  *
- * MAX326xx Families are determined by sharing a common User Guide for the chip
- * specification:
+ * MAX326xx Families are determined by sharing a common User Guide for the
+ * chip specification:
  *
  *   MAX32620/32621 Family:  MAX32620 Rev C, User Guide, AN6242, Rev 2, 2/17
  *   MAX32630/32632 Family:  MAX32630 Rev B, User Guide, AN6349, Rev 0, 10/16
@@ -174,10 +174,12 @@
 #  error Unrecognized MAX326XX chip
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0x00-0xe0. The lower the value, the
- * greater the priority of the corresponding interrupt. The processor implements only
- * bits[7:4] of each field, bits[6:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0x00-0xe0. The lower the
+ * value, the greater the priority of the corresponding interrupt. The
+ * processor implements only bits[7:4] of each field, bits[6:0] read as zero
+ * and ignore writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN      0xe0 /* All bits[7:5] set is minimum priority */
@@ -185,16 +187,16 @@
 #define NVIC_SYSH_PRIORITY_MAX      0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP     0x20 /* Eight priority levels in steps 0x20 */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_MAX326XX_CHIP_H */
diff --git a/arch/arm/include/max326xx/irq.h b/arch/arm/include/max326xx/irq.h
index db08258..91b7e28 100644
--- a/arch/arm/include/max326xx/irq.h
+++ b/arch/arm/include/max326xx/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/max326xx/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_MAX326_IRQ_H
 #define __ARCH_ARM_INCLUDE_MAX326_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/max326xx/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Common Processor Exceptions (vectors 0-15) */
@@ -70,15 +71,15 @@
 #  error "Unsupported MAX326XX family"
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -88,9 +89,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/max326xx/max32620_30_irq.h b/arch/arm/include/max326xx/max32620_30_irq.h
index 27fdddd..4dd04bf 100644
--- a/arch/arm/include/max326xx/max32620_30_irq.h
+++ b/arch/arm/include/max326xx/max32620_30_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************************
+/****************************************************************************
  * arch/arm/include/max326xx/max32620_30_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_MAX326XX_MAX32610_30_IRQ_H
 #define __ARCH_ARM_INCLUDE_MAX326XX_MAX32610_30_IRQ_H
 
-/************************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts (vectors >= 16) */
 
@@ -92,7 +92,9 @@
 
 #define MAX326_IRQ_NVECTORS   (MAX326_IRQ_EXTINT + MAX326_IRQ_NEXTINT)
 
-/* If GPIO pin interrupts are used then there is a second level of interrupt decode */
+/* If GPIO pin interrupts are used then there is a second level of interrupt
+ * decode
+ */
 
 #ifdef CONFIG_MAX326XX_GPIOIRQ
 #warning Missing logic
@@ -104,21 +106,21 @@
 
 #define NR_IRQS               (MAX326_IRQ_NVECTORS + MAX326_IRQ_NPININT)
 
-/************************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Inline functions
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/max326xx/max32660_irq.h b/arch/arm/include/max326xx/max32660_irq.h
index 9288fdf..03493b6 100644
--- a/arch/arm/include/max326xx/max32660_irq.h
+++ b/arch/arm/include/max326xx/max32660_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************************
+/****************************************************************************
  * arch/arm/include/max326xx/max32660_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_MAX326XX_MAX32660_IRQ_H
 #define __ARCH_ARM_INCLUDE_MAX326XX_MAX32660_IRQ_H
 
-/************************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts (vectors >= 16) */
 
@@ -67,10 +67,14 @@
 #define MAX326_IRQ_NEXTINT    55
 #define MAX326_IRQ_NVECTORS   (MAX326_IRQ_EXTINT + MAX326_IRQ_NEXTINT)
 
-/* If GPIO pin interrupts are used then there is a second level of interrupt decode */
+/* If GPIO pin interrupts are used then there is a second level of
+ * interrupt decode
+ */
 
 #ifdef CONFIG_MAX326XX_GPIOIRQ
-/* Up to 14 pins are available as interrupt sources, depending on the MAX32660 package */
+/* Up to 14 pins are available as interrupt sources,
+ * depending on the MAX32660 package
+ */
 
 #  define MAX326_IRQ_P0_0     (MAX326_IRQ_NEXTINT + 0)
 #  define MAX326_IRQ_P0_1     (MAX326_IRQ_NEXTINT + 1)
@@ -98,21 +102,21 @@
 
 #define NR_IRQS               (MAX326_IRQ_NVECTORS + MAX326_IRQ_NPININT)
 
-/************************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Inline functions
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/moxart/irq.h b/arch/arm/include/moxart/irq.h
index 4796641..31d289c 100644
--- a/arch/arm/include/moxart/irq.h
+++ b/arch/arm/include/moxart/irq.h
@@ -30,7 +30,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /****************************************************************************
diff --git a/arch/arm/include/nrf52/chip.h b/arch/arm/include/nrf52/chip.h
index d0f055f..a02df82 100644
--- a/arch/arm/include/nrf52/chip.h
+++ b/arch/arm/include/nrf52/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/nrf52/chip.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -31,25 +31,25 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_NRF52_CHIP_H
 #define __ARCH_ARM_INCLUDE_NRF52_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ***********************************************************************************
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* NVIC priority levels *************************************************************/
+/* NVIC priority levels *****************************************************/
 
-/* Each priority field holds a priority value, 0-31. The lower the value, the greater
- * the priority of the corresponding interrupt.
+/* Each priority field holds a priority value, 0-31. The lower the value,
+ * the greater the priority of the corresponding interrupt.
  *
  * The Cortex-M4 core supports 8 programmable interrupt priority levels.
  */
@@ -59,16 +59,16 @@
 #define NVIC_SYSH_PRIORITY_MAX          0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP         0x20 /* Steps between priorities */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_NRF52_CHIP_H */
diff --git a/arch/arm/include/nrf52/irq.h b/arch/arm/include/nrf52/irq.h
index 31c0dc4..7cce4dd 100644
--- a/arch/arm/include/nrf52/irq.h
+++ b/arch/arm/include/nrf52/irq.h
@@ -1,4 +1,4 @@
-/********************************************************************************************
+/****************************************************************************
  * arch/arm/include/nrf52/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ********************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather,
  * only indirectly through nuttx/irq.h
@@ -25,21 +25,22 @@
 #ifndef __ARCH_ARM_INCLUDE_NRF52_IRQ_H
 #define __ARCH_ARM_INCLUDE_NRF52_IRQ_H
 
-/********************************************************************************************
+/****************************************************************************
  * Included Files
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #  include <stdint.h>
 #endif
 
-/********************************************************************************************
- * Pre-processor Definitions
- ********************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to bits in
- * the NVIC.  This does, however, waste several words of memory in the IRQ to handle mapping
- * tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits in
+ * the NVIC.  This does, however, waste several words of memory in the IRQ to
+ * handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -62,9 +63,9 @@
 
 /* Cortex-M4 External interrupts (vectors >= 16) */
 
-/********************************************************************************************
+/****************************************************************************
  * Included Files
- ********************************************************************************************/
+ ****************************************************************************/
 
 #if defined(CONFIG_ARCH_FAMILY_NRF52)
 #  include <arch/nrf52/nrf52_irq.h>
@@ -72,16 +73,16 @@
 #  error "Unsupported NRF52XX MCU"
 #endif
 
-/********************************************************************************************
+/****************************************************************************
  * Public Types
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 typedef void (*vic_vector_t)(uint32_t *regs);
 
-/********************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ********************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
diff --git a/arch/arm/include/nrf52/nrf52_irq.h b/arch/arm/include/nrf52/nrf52_irq.h
index b337fa5..5e723ae 100644
--- a/arch/arm/include/nrf52/nrf52_irq.h
+++ b/arch/arm/include/nrf52/nrf52_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/nrf52/nrf52_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,18 +16,18 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_NRF52_NRF52_IRQ_H
 #define __ARCH_ARM_INCLUDE_NRF52_NRF52_IRQ_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Cortex-M4 External interrupts (vectors >= 16) */
 
diff --git a/arch/arm/include/nuc1xx/chip.h b/arch/arm/include/nuc1xx/chip.h
index b054e74..258e841 100644
--- a/arch/arm/include/nuc1xx/chip.h
+++ b/arch/arm/include/nuc1xx/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/nuc1xx/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,23 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
-
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_NUC1XX_CHIP_H
 #define __ARCH_ARM_INCLUDE_NUC1XX_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
-/* Chip capabilities ****************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
+/* Chip capabilities ********************************************************/
+
 /* NUC100 Advanced Line (Low Density) */
 
 #if defined(CONFIG_ARCH_CHIP_NUC100LC1BN) /* Flash 32K SRAM 4K, LQFP48 package */
@@ -620,10 +621,12 @@
 #  error "Unrecognized NUC1XX chip"
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-3. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:6] of each field, bits[5:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-3. The lower the value, the
+ * greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:6] of each field, bits[5:0] read as zero and
+ * ignore writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN     0xc0 /* All bits[7:6] set is minimum priority */
@@ -631,13 +634,13 @@
 #define NVIC_SYSH_PRIORITY_MAX     0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP    0x40 /* Five bits of interrupt priority used */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -648,9 +651,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/nuc1xx/irq.h b/arch/arm/include/nuc1xx/irq.h
index 963e532..54e1d03 100644
--- a/arch/arm/include/nuc1xx/irq.h
+++ b/arch/arm/include/nuc1xx/irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/nuc1xx/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_NUC1XX_IRQ_H
 #define __ARCH_ARM_INCLUDE_NUC1XX_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/nuc1xx/chip.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -54,7 +55,9 @@
 #define NUC_IRQ_PENDSV        (14) /* Vector 14: Pendable system service request */
 #define NUC_IRQ_SYSTICK       (15) /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define NUC_IRQ_INTERRUPT     (16)
 
@@ -64,13 +67,13 @@
 #  error "Unrecognized/unsupported NUC chip"
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -81,9 +84,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/nuc1xx/nuc120_irq.h b/arch/arm/include/nuc1xx/nuc120_irq.h
index a6e5444..ddcb5d0c 100644
--- a/arch/arm/include/nuc1xx/nuc120_irq.h
+++ b/arch/arm/include/nuc1xx/nuc120_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/nuc1xx/nuc120_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_NUC1XX_NUC120_IRQ_H
 #define __ARCH_ARM_INCLUDE_NUC1XX_NUC120_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* NUC120 IRQ numbers */
 
@@ -70,13 +70,13 @@
 
 #define NR_IRQS        (48)
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -87,9 +87,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/rp2040/irq.h b/arch/arm/include/rp2040/irq.h
index 37600f1..a8b776f 100644
--- a/arch/arm/include/rp2040/irq.h
+++ b/arch/arm/include/rp2040/irq.h
@@ -34,7 +34,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/s32k1xx/chip.h b/arch/arm/include/s32k1xx/chip.h
index c21009d..1af309d 100644
--- a/arch/arm/include/s32k1xx/chip.h
+++ b/arch/arm/include/s32k1xx/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/s32k1xx/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,25 +16,25 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_S32K1XX_CHIP_H
 #define __ARCH_ARM_INCLUDE_S32K1XX_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* NVIC priority levels *************************************************************/
+/* NVIC priority levels *****************************************************/
 
-/* Each priority field holds a priority value. The lower the value, the greater the
- * priority of the corresponding interrupt.
+/* Each priority field holds a priority value. The lower the value, the
+ * greater the priority of the corresponding interrupt.
  */
 
 #if defined(CONFIG_ARCH_CORTEXM4)
@@ -55,16 +55,16 @@
 
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************/
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_S32K1XX_CHIP_H */
diff --git a/arch/arm/include/s32k1xx/s32k11x_irq.h b/arch/arm/include/s32k1xx/s32k11x_irq.h
index d5cfc64..f6ed467 100644
--- a/arch/arm/include/s32k1xx/s32k11x_irq.h
+++ b/arch/arm/include/s32k1xx/s32k11x_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/s32k1xx/s32k11x_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,28 +16,29 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_S32K1XX_S32K11XX_IRQ_H
 #define __ARCH_ARM_INCLUDE_S32K1XX_S32K11XX_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -53,7 +54,9 @@
 #define S32K1XX_IRQ_PENDSV        (14) /* Vector 14: Pendable system service request */
 #define S32K1XX_IRQ_SYSTICK       (15) /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define S32K1XX_IRQ_INTERRUPT     (16)
 
diff --git a/arch/arm/include/s32k1xx/s32k14x_irq.h b/arch/arm/include/s32k1xx/s32k14x_irq.h
index bd7fe3c..bbc8f9a 100644
--- a/arch/arm/include/s32k1xx/s32k14x_irq.h
+++ b/arch/arm/include/s32k1xx/s32k14x_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/s32k1xx/s32k14x_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,28 +16,29 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_S32K1XX_S32K14XX_IRQ_H
 #define __ARCH_ARM_INCLUDE_S32K1XX_S32K14XX_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -56,7 +57,9 @@
 #define S32K1XX_IRQ_PENDSV        (14)   /* Vector 14: Pendable system service request */
 #define S32K1XX_IRQ_SYSTICK       (15)   /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define S32K1XX_IRQ_INTERRUPT     (16)   /* Vector number of the first external interrupt */
 
diff --git a/arch/arm/include/sam34/chip.h b/arch/arm/include/sam34/chip.h
index 8586f88..5fb4af6 100644
--- a/arch/arm/include/sam34/chip.h
+++ b/arch/arm/include/sam34/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,24 +16,25 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_CHIP_H
 #define __ARCH_ARM_INCLUDE_SAM34_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
-/* AT91SAM3U Family *****************************************************************/
+/* AT91SAM3U Family *********************************************************/
+
 /* FEATURE      SAM3U4E  SAM3U2E  SAM3U1E  SAM3U4C  SAM3U2C  SAM3U1C
  * ----------- -------- -------- -------- -------- -------- --------
  * Flash        2x128KB  128KB    64KB     2x128KB  128KB    64KB
@@ -189,7 +190,8 @@
 #  define SAM34_NUDPFS                0             /* No USB full speed device */
 #  define SAM34_NUHPFS                0             /* No USB full speed embedded host */
 
-/* AT91SAM3X/3A Families ************************************************************/
+/* AT91SAM3X/3A Families ****************************************************/
+
 /* FEATURE      SAM3X8E  SAM3X8C  SAM3X4E  SAM3X4C  SAM3A8C  SAM3A4C
  * ------------ -------- -------- -------- -------- -------- --------
  * Flash        2x256KB  2x256KB  2x128KB  2x128KB  2x256KB  2x128KB
@@ -340,7 +342,8 @@
 #  define SAM34_NUDPFS                0             /* No USB full speed device */
 #  define SAM34_NUHPFS                0             /* No USB full speed embedded host */
 
-/* AT91SAM4C Family *****************************************************************/
+/* AT91SAM4C Family *********************************************************/
+
 /* FEATURE     SAM4CMP16B
  * ----------- ---------
  * Flash        1024KB
@@ -389,7 +392,8 @@
 #  define SAM32_NUDPFS                0            /* No USB full speed device */
 #  define SAM32_NUHPFS                0            /* No USB full speed embedded host */
 
-/* AT91SAM4L Family *****************************************************************/
+/* AT91SAM4L Family *********************************************************/
+
 /* Sub-family differences:
  *
  *   FEATURE                 ATSAM4LCxx    ATSAM4LSxx
@@ -526,23 +530,39 @@
 #  define SAM34_NUDPFS                1             /* 1 USB full speed device */
 #  define SAM34_NUHPFS                0             /* No USB full speed embedded host */
 
-/* AT91SAM4S Family *****************************************************************/
-/*
- * FEATURE       SAM4SD32C SAM4SD32B SAM4SD16C SAM4SD16B SAM4SA16C SAM4SA16B SAM4S16C SAM4S16B SAM4S8C SAM4S8B SAM4S4C
- * ------------- --------- --------- --------- --------- --------- --------- -------- -------- ------- ------- -------
- * Flash         2x1MB     2x1MB     2x512KB   1x1MB     1x1MB     1x1MB     1x1MB    1x1MB    1x512KB 1x512KB 1x256KB
- * SRAM          160KB     160KB     160KB     160KB     160KB     160KB     128KB    128KB    128KB   128KB   64KB
- * HCACHE        2KB       2KB       2KB       2KB       2KB       2KB       -        -        -       -       -
- * Pins          100       64        100       64        100       64        100      64       100     64      100
- * No. PIOs      79        47        79        47        79        47        79       47       79      47      79
- * Ext. BUS      Yes       No        Yes       No        Yes       No        Yes      No       Yes     No      Yes
- * 12-bit ADC    16 ch     11 ch     16 ch     11 ch     16 ch     11 ch     16 ch    11 ch    16 ch   11 ch   16 ch
- * 12-bit DAC    2 ch      2 ch      2 ch      2 ch      2 ch      2 ch      2 ch     2 ch     2 ch    2 ch    2 ch
- * Timer Counter 6 ch      3 ch      6 ch      3 ch      6 ch      3 ch      6 ch     3 ch     6 ch    3 ch    6 ch
- * PDC           22 ch     22 ch     22 ch     22 ch     22 ch     22 ch     22 ch    22 ch    22 ch   22 ch   22 ch
- * USART         2         2         2         2         2         2         2        2        2       2       2
- * UART          2         2         2         2         2         2         2        2        2       2       2
- * HSMCI         Yes       Yes       Yes       Yes       Yes       Yes       Yes      Yes      Yes     Yes     Yes
+/* AT91SAM4S Family *********************************************************/
+
+/* FEATURE       SAM4SD32C SAM4SD32B SAM4SD16C SAM4SD16B SAM4SA16C SAM4SA16B
+ * ------------- --------- --------- --------- --------- --------- ---------
+ * Flash         2x1MB     2x1MB     2x512KB   1x1MB     1x1MB     1x1MB
+ * SRAM          160KB     160KB     160KB     160KB     160KB     160KB
+ * HCACHE        2KB       2KB       2KB       2KB       2KB       2KB
+ * Pins          100       64        100       64        100       64
+ * No. PIOs      79        47        79        47        79        47
+ * Ext. BUS      Yes       No        Yes       No        Yes       No
+ * 12-bit ADC    16 ch     11 ch     16 ch     11 ch     16 ch     11 ch
+ * 12-bit DAC    2 ch      2 ch      2 ch      2 ch      2 ch      2 ch
+ * Timer Counter 6 ch      3 ch      6 ch      3 ch      6 ch      3 ch
+ * PDC           22 ch     22 ch     22 ch     22 ch     22 ch     22 ch
+ * USART         2         2         2         2         2         2
+ * UART          2         2         2         2         2         2
+ * HSMCI         Yes       Yes       Yes       Yes       Yes       Yes
+ *
+ * FEATURE       SAM4S16C SAM4S16B SAM4S8C SAM4S8B SAM4S4C
+ * ------------- -------- -------- ------- ------- -------
+ * Flash         1x1MB    1x1MB    1x512KB 1x512KB 1x256KB
+ * SRAM          128KB    128KB    128KB   128KB   64KB
+ * HCACHE        -        -        -       -       -
+ * Pins          100      64       100     64      100
+ * No. PIOs      79       47       79      47      79
+ * Ext. BUS      Yes      No       Yes     No      Yes
+ * 12-bit ADC    16 ch    11 ch    16 ch   11 ch   16 ch
+ * 12-bit DAC    2 ch     2 ch     2 ch    2 ch    2 ch
+ * Timer Counter 6 ch     3 ch     6 ch    3 ch    6 ch
+ * PDC           22 ch    22 ch    22 ch   22 ch   22 ch
+ * USART         2        2        2       2       2
+ * UART          2        2        2       2       2
+ * HSMCI         Yes      Yes      Yes     Yes     Yes
  */
 
 #elif defined(CONFIG_ARCH_CHIP_ATSAM4SD32C)
@@ -765,7 +785,8 @@
 #  define SAM34_NUDPFS                1             /* 1 USB full speed device */
 #  define SAM34_NUHPFS                0             /* No USB full speed embedded host */
 
-/* AT91SAM4E Family *****************************************************************/
+/* AT91SAM4E Family *********************************************************/
+
 /* FEATURE     SAM4E16E  SAM4E8E  SAM4E16C SAM4E8C
  * ----------- --------- -------- -------- --------
  * Flash        1024KB   512KB    1024KB   512KB
@@ -879,10 +900,12 @@
 #  error "Unknown SAM3/4 chip type"
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-15. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:4] of each field, bits[3:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-15. The lower the value, the
+ * greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:4] of each field, bits[3:0] read as zero and ignore
+ * writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN        0xf0 /* All bits[7:4] set is minimum priority */
@@ -890,16 +913,16 @@
 #define NVIC_SYSH_PRIORITY_MAX        0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP       0x10 /* Four bits of interrupt priority used */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_SAM34_CHIP_H */
diff --git a/arch/arm/include/sam34/irq.h b/arch/arm/include/sam34/irq.h
index 10ff9c0..da33129 100644
--- a/arch/arm/include/sam34/irq.h
+++ b/arch/arm/include/sam34/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/sam34/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Common Processor Exceptions (vectors 0-15) */
@@ -77,15 +78,15 @@
 #  error Unrecognized SAM architecture
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -95,9 +96,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/sam34/sam3u_irq.h b/arch/arm/include/sam34/sam3u_irq.h
index 8a65773..9e537f9 100644
--- a/arch/arm/include/sam34/sam3u_irq.h
+++ b/arch/arm/include/sam34/sam3u_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/sam3u_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM3U_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_SAM3U_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAM3U Peripheral Identifiers */
 
@@ -226,21 +226,21 @@
 #define NR_IRQS               (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \
                                SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sam34/sam3x_irq.h b/arch/arm/include/sam34/sam3x_irq.h
index cc94a86..18b2907 100644
--- a/arch/arm/include/sam34/sam3x_irq.h
+++ b/arch/arm/include/sam34/sam3x_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/sam3x_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM3X_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_SAM3X_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAM3X Peripheral Identifiers */
 
@@ -381,21 +381,21 @@
                                SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \
                                SAM_NGPIODIRQS + SAM_NGPIOEIRQS + SAM_NGPIOFIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sam34/sam4cm_irq.h b/arch/arm/include/sam34/sam4cm_irq.h
index 9dda0f1..959ef7d 100644
--- a/arch/arm/include/sam34/sam4cm_irq.h
+++ b/arch/arm/include/sam34/sam4cm_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/sam4cm_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4CM_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_SAM4CM_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAM4CM Peripheral Identifiers */
 
@@ -255,17 +255,17 @@
 #define NR_IRQS              (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \
                               SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -276,9 +276,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/sam34/sam4e_irq.h b/arch/arm/include/sam34/sam4e_irq.h
index 6dad711..fda375c 100644
--- a/arch/arm/include/sam34/sam4e_irq.h
+++ b/arch/arm/include/sam34/sam4e_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/sam4e_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4E_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_SAM4E_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAM4E Peripheral Identifiers */
 
@@ -81,7 +81,7 @@
                                     /* 46: Reserved */
 #define NR_PIDS               (47)  /* Number of peripheral identifiers */
 
-/* External interrupts (priority levels >= 256*/
+/* External interrupts (priority levels >= 256 */
 
 #define SAM_IRQ_SUPC          (SAM_IRQ_EXTINT+SAM_PID_SUPC)   /* Supply Controller */
 #define SAM_IRQ_RSTC          (SAM_IRQ_EXTINT+SAM_PID_RSTC)   /* Reset Controller */
@@ -289,21 +289,21 @@
                                SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \
                                SAM_NGPIODIRQS + SAM_NGPIOEIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sam34/sam4l_irq.h b/arch/arm/include/sam34/sam4l_irq.h
index 8127231..c4390f1 100644
--- a/arch/arm/include/sam34/sam4l_irq.h
+++ b/arch/arm/include/sam34/sam4l_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/sam4l_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,26 +16,28 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4L_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_SAM4L_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* SAM4L Peripheral Identifiers.  NOTE:  Interrupts are not tied to the DMA peripheral
- * identifiers in the SAM4L as they were with the SAM3U.  However, for consistency, those
- * peripheral identifiers are defined in this file as well.
+/* SAM4L Peripheral Identifiers.
+ * NOTE:
+ * Interrupts are not tied to the DMA peripheral identifiers in the SAM4L as
+ * they were with the SAM3U.  However, for consistency, those peripheral
+ * identifiers are defined in this file as well.
  */
 
 #define SAM_PID_USART0_RHR     (0)   /* DIR=RX REGISTER: USART0 RHR */
@@ -287,21 +289,21 @@
 #define NR_IRQS               (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \
                                SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sam34/sam4s_irq.h b/arch/arm/include/sam34/sam4s_irq.h
index e8b9d60..5ed484f 100644
--- a/arch/arm/include/sam34/sam4s_irq.h
+++ b/arch/arm/include/sam34/sam4s_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sam34/sam4s_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4S_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAM34_SAM4S_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAM4S Peripheral Identifiers */
 
@@ -237,21 +237,21 @@
 #define NR_IRQS              (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \
                               SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sama5/chip.h b/arch/arm/include/sama5/chip.h
index 136a1b3..68b3770 100644
--- a/arch/arm/include/sama5/chip.h
+++ b/arch/arm/include/sama5/chip.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/sama5/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,49 +16,78 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_SAMA5_CHIP_H
 #define __ARCH_ARM_INCLUDE_SAMA5_CHIP_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
+
 /* SAMA5D2 Family
  *
- *                           SAMA5D21  SAMA5D22  SAMA5D23  SAMA5D24  SAMA5D26  SAMA5D27  SAMA5D28
- * ------------------------- --------- --------- --------- --------- --------- --------- ---------
- * Pin Count                 196       196       196       256       289       289       289
- * Max. Operating Frequency  500 MHz   500 MHz   500 MHz   500 MHz   500 MHz   500 MHz   500 MHz
- * CPU                       Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5
- * Max I/O Pins              72        72        72        105       128       128       128
- * USB Transceiver           1         1         1         1         1         1         1
- * USB Speed                 Hi-Speed  Hi-Speed  Hi-Speed  Hi-Speed  Hi-Speed  Hi-Speed  Hi-Speed
- * USB Interface             2         2         2         3         3         3         3
- * SPI                       6         6         6         7         7         7         7
- * QuadSPI                   2         2         2         2         2         2         2
- * TWIHS (I2C)               6         6         6         7         7         7         7
- * UART                      9         9         9         10        10        10        10
- * CAN                       -         1         1         -         -         2         2
- * SDIO/SD/MMC               1         1         1         2         2         2         2
- * I2SC                      2         2         2         2         2         2         2
- * SSC                       2         2         2         2         2         2         2
- * Class D                   1         1         1         2         2         2         2
- * PDMIC                     1         1         1         2         2         2         2
- * Camera Interface          1         1         1         1         1         1         1
- * ADC Inputs                5         5         5         12        12        12        12
- * AESB                      -         1         1         1         -         1         1
- * SRAM (Kbytes)             128       128       128       128       128       128       128
- * DDR Bus                   16-bit    16-bit    16-bit    16/32-bit 16/32-bit 16/32-bit 16/32-bit
- * Timers                    6         6         6         6         6         6         6
- * Tamper pins               6         6         6         2         8         8         8
- * Packages                  BGA196    BGA196    BGA196    BGA256    BGA289    BGA289    BGA289
+ *                           SAMA5D21  SAMA5D22  SAMA5D23  SAMA5D24
+ * ------------------------- --------- --------- --------- ---------
+ * Pin Count                 196       196       196       256
+ * Max. Operating Frequency  500 MHz   500 MHz   500 MHz   500 MHz
+ * CPU                       Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5
+ * Max I/O Pins              72        72        72        105
+ * USB Transceiver           1         1         1         1
+ * USB Speed                 Hi-Speed  Hi-Speed  Hi-Speed  Hi-Speed
+ * USB Interface             2         2         2         3
+ * SPI                       6         6         6         7
+ * QuadSPI                   2         2         2         2
+ * TWIHS (I2C)               6         6         6         7
+ * UART                      9         9         9         10
+ * CAN                       -         1         1         -
+ * SDIO/SD/MMC               1         1         1         2
+ * I2SC                      2         2         2         2
+ * SSC                       2         2         2         2
+ * Class D                   1         1         1         2
+ * PDMIC                     1         1         1         2
+ * Camera Interface          1         1         1         1
+ * ADC Inputs                5         5         5         1
+ * AESB                      -         1         1         1
+ * SRAM (Kbytes)             128       128       128       128
+ * DDR Bus                   16-bit    16-bit    16-bit    16/32-bit
+ * Timers                    6         6         6         6
+ * Tamper pins               6         6         6         2
+ * Packages                  BGA196    BGA196    BGA196    BGA256
+ *
+ *                           SAMA5D26  SAMA5D27  SAMA5D28
+ * ------------------------- --------- --------- ---------
+ * Pin Count                 289       289       289
+ * Max. Operating Frequency  500 MHz   500 MHz   500 MHz
+ * CPU                       Cortex-A5 Cortex-A5 Cortex-A5
+ * Max I/O Pins              128       128       128
+ * USB Transceiver           1         1         1
+ * USB Speed                 Hi-Speed  Hi-Speed  Hi-Speed
+ * USB Interface             3         3         3
+ * SPI                       7         7         7
+ * QuadSPI                   2         2         2
+ * TWIHS (I2C)               7         7         7
+ * UART                      10        10        10
+ * CAN                       -         2         2
+ * SDIO/SD/MMC               2         2         2
+ * I2SC                      2         2         2
+ * SSC                       2         2         2
+ * Class D                   2         2         2
+ * PDMIC                     2         2         2
+ * Camera Interface          1         1         1
+ * ADC Inputs                12        12        12
+ * AESB                      -         1         1
+ * SRAM (Kbytes)             128       128       128
+ * DDR Bus                   16/32-bit 16/32-bit 16/32-bit
+ * Timers                    6         6         6
+ * Tamper pins               8         8         8
+ * Packages                  BGA289    BGA289    BGA289
  */
 
 #if defined(CONFIG_ARCH_CHIP_ATSAMA5D21) || defined(CONFIG_ARCH_CHIP_ATSAMA5D22) || \
@@ -79,48 +108,91 @@
 
 /* SAMA5D3 Family
  *
- *                           ATSAMA5D31    ATSAMA5D33    ATSAMA5D34    ATSAMA5D35    ATSAMA5D36
- * ------------------------- ------------- ------------- ------------- ------------- -------------
- * Pin Count                 324           324           324           324           324
- * Max. Operating Frequency  536 MHz       536 MHz       536 MHz       536 MHz       536 MHz
- * CPU                       Cortex-A5     Cortex-A5     Cortex-A5     Cortex-A5     Cortex-A5
- * Max I/O Pins              160           160           160           160           160
- * Ext Interrupts            160           160           160           160           160
- * USB Transceiver           3             3             3             3             3
- * USB Speed                 Hi-Speed      Hi-Speed      Hi-Speed      Hi-Speed      Hi-Speed
- * USB Interface             Host, Device  Host, Device  Host, Device  Host, Device  Host, Device
- * SPI                       6             6             6             6             6
- * TWI (I2C)                 3             3             3             3             3
- * UART                      7             5             5             7             7
- * CAN                       -             -             2             2             2
- * LIN                       4             4             4             4             4
- * SSC                       2             2             2             2             2
- * Ethernet                  1             1             1             2             2
- * SD / eMMC                 3             2             3             2             3
- * Graphic LCD               Yes           Yes           Yes           -             Yes
- * Camera Interface          Yes           Yes           Yes           Yes           Yes
- * ADC channels              12            12            12            12            12
- * ADC Resolution (bits)     12            12            12            12            12
- * ADC Speed (ksps)          440           440           440           440           1000
- * Resistive Touch Screen    Yes           Yes           Yes           Yes           Yes
- * Crypto Engine             AES/DES/      AES/DES/      AES/DES/      AES/DES/      AES/DES/
- *                           SHA/TRNG      SHA/TRNG      SHA/TRNG      SHA/TRNG      SHA/TRNG
- * SRAM (Kbytes)             128           128           128           128           128
- * External Bus Interface    1             1             1             1             1
- * DRAM Memory               DDR2/LPDDR,   DDR2/LPDDR,   DDR2/LPDDR,   DDR2/LPDDR,   DDR2/LPDDR,
- *                           SDRAM/LPSDR   SDRAM/LPSDR   DDR2/LPDDR,   DDR2/LPDDR,   DDR2/LPDDR,
- * NAND Interface            Yes           Yes           Yes           Yes           Yes
- * Temp. Range (deg C)       -40 to 85     -40 to 85     -40 to 85     -40 to 85     -40 to 105
- * I/O Supply Class          1.8/3.3       1.8/3.3       1.8/3.3       1.8/3.3       1.8/3.3
- * Operating Voltage (Vcc)   1.08 to 1.32  1.08 to 1.32  1.08 to 1.32  1.08 to 1.322 1.08 to 1.32
- * FPU                       Yes           Yes           Yes           Yes           Yes
- * MPU / MMU                 No/Yes        No/Yes        No/Yes        No/Yes        No/Yes
- * Timers                    5             5             5             6             6
- * Output Compare channels   6             6             6             6             6
- * Input Capture Channels    6             6             6             6             6
- * PWM Channels              4             4             4             4             4
- * 32kHz RTC                 Yes           Yes           Yes           Yes           Yes
- * Packages                  LFBGA324_A    LFBGA324_A    LFBGA324_A    LFBGA324_A    LFBGA324_A
+ *                           ATSAMA5D31    ATSAMA5D33    ATSAMA5D34
+ * ------------------------- ------------- ------------- -------------
+ * Pin Count                 324           324           324
+ * Max. Operating Frequency  536 MHz       536 MHz       536 MHz
+ * CPU                       Cortex-A5     Cortex-A5     Cortex-A5
+ * Max I/O Pins              160           160           160
+ * Ext Interrupts            160           160           160
+ * USB Transceiver           3             3             3
+ * USB Speed                 Hi-Speed      Hi-Speed      Hi-Speed
+ * USB Interface             Host, Device  Host, Device  Host, Device
+ * SPI                       6             6             6
+ * TWI (I2C)                 3             3             3
+ * UART                      7             5             5
+ * CAN                       -             -             2
+ * LIN                       4             4             4
+ * SSC                       2             2             2
+ * Ethernet                  1             1             1
+ * SD / eMMC                 3             2             3
+ * Graphic LCD               Yes           Yes           Yes
+ * Camera Interface          Yes           Yes           Yes
+ * ADC channels              12            12            12
+ * ADC Resolution (bits)     12            12            12
+ * ADC Speed (ksps)          440           440           440
+ * Resistive Touch Screen    Yes           Yes           Yes
+ * Crypto Engine             AES/DES/      AES/DES/      AES/DES/
+ *                           SHA/TRNG      SHA/TRNG      SHA/TRNG
+ * SRAM (Kbytes)             128           128           128
+ * External Bus Interface    1             1             1
+ * DRAM Memory               DDR2/LPDDR,   DDR2/LPDDR,   DDR2/LPDDR,
+ *                           SDRAM/LPSDR   SDRAM/LPSDR   DDR2/LPDDR,
+ * NAND Interface            Yes           Yes           Yes
+ * Temp. Range (deg C)       -40 to 85     -40 to 85     -40 to 85
+ * I/O Supply Class          1.8/3.3       1.8/3.3       1.8/3.3
+ * Operating Voltage (Vcc)   1.08 to 1.32  1.08 to 1.32  1.08 to 1.32
+ * FPU                       Yes           Yes           Yes
+ * MPU / MMU                 No/Yes        No/Yes        No/Yes
+ * Timers                    5             5             5
+ * Output Compare channels   6             6             6
+ * Input Capture Channels    6             6             6
+ * PWM Channels              4             4             4
+ * 32kHz RTC                 Yes           Yes           Yes
+ * Packages                  LFBGA324_A    LFBGA324_A    LFBGA324_A
+ *
+ *                           ATSAMA5D35    ATSAMA5D36
+ * ------------------------- ------------- -------------
+ * Pin Count                 324           324
+ * Max. Operating Frequency  536 MHz       536 MHz
+ * CPU                       Cortex-A5     Cortex-A5
+ * Max I/O Pins              160           160
+ * Ext Interrupts            160           160
+ * USB Transceiver           3             3
+ * USB Speed                 Hi-Speed      Hi-Speed
+ * USB Interface             Host, Device  Host, Device
+ * SPI                       6             6
+ * TWI (I2C)                 3             3
+ * UART                      7             7
+ * CAN                       2             2
+ * LIN                       4             4
+ * SSC                       2             2
+ * Ethernet                  2             2
+ * SD / eMMC                 2             3
+ * Graphic LCD               -             Yes
+ * Camera Interface          Yes           Yes
+ * ADC channels              12            12
+ * ADC Resolution (bits)     12            12
+ * ADC Speed (ksps)          440           1000
+ * Resistive Touch Screen    Yes           Yes
+ * Crypto Engine             AES/DES/      AES/DES/
+ *                           SHA/TRNG      SHA/TRNG
+ * SRAM (Kbytes)             128           128
+ * External Bus Interface    1             1
+ * DRAM Memory               DDR2/LPDDR,   DDR2/LPDDR,
+ *                           DDR2/LPDDR,   DDR2/LPDDR,
+ * NAND Interface            Yes           Yes
+ * Temp. Range (deg C)       -40 to 85     -40 to 105
+ * I/O Supply Class          1.8/3.3       1.8/3.3
+ * Operating Voltage (Vcc)   1.08 to 1.322 1.08 to 1.32
+ * FPU                       Yes           Yes
+ * MPU / MMU                 No/Yes        No/Yes
+ * Timers                    6             6
+ * Output Compare channels   6             6
+ * Input Capture Channels    6             6
+ * PWM Channels              4             4
+ * 32kHz RTC                 Yes           Yes
+ * Packages                  LFBGA324_A    LFBGA324_A
  */
 
 #elif defined(CONFIG_ARCH_CHIP_ATSAMA5D31)
@@ -189,16 +261,16 @@
 #  error Unrecognized SAMAD5 chip
 #endif
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
- * Public Functions
- ****************************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_SAMA5_CHIP_H */
diff --git a/arch/arm/include/sama5/irq.h b/arch/arm/include/sama5/irq.h
index bf27161..acb42af 100644
--- a/arch/arm/include/sama5/irq.h
+++ b/arch/arm/include/sama5/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sama5/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,25 +16,25 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMA5_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMA5_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/sama5/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Chip-Specific External interrupts */
 
@@ -48,15 +48,15 @@
 #  error Unrecognized SAMA5 family
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -66,9 +66,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/sama5/sama5d2_irq.h b/arch/arm/include/sama5/sama5d2_irq.h
index 37f9d64..610f47a 100644
--- a/arch/arm/include/sama5/sama5d2_irq.h
+++ b/arch/arm/include/sama5/sama5d2_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sama5/sama5d2_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMA5_SAMA5D2_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMA5_SAMA5D2_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAMA5D2 Peripheral Identifiers */
 
@@ -188,13 +188,14 @@
 #define SAM_IRQ_MCAN00         SAM_PID_MCAN00    /* MCAN controller 0, Interrupt 0 */
 #define SAM_IRQ_MCAN10         SAM_PID_MCAN10    /* MCAN controller 1, Interrupt 0 */
 #define SAM_IRQ_CLASSD         SAM_PID_CLASSD    /* Audio Class D Amplifier */
-
-                                                 /* Special Function Register (no interrupt) */
-
-                                                 /* Secured Advanced Interrupt Controller (no interrupt) */
-
-                                                 /* Advanced Interrupt Controller (no interrupt) */
-
+                                                 /* Special Function Register
+                                                  * (no interrupt) */
+                                                 /* Secured Advanced Interrupt
+                                                  * Controller
+                                                  * (no interrupt) */
+                                                 /* Advanced Interrupt
+                                                  * Controller
+                                                  * (no interrupt) */
 #define SAM_IRQ_L2CC           SAM_PID_L2CC      /* L2 Cache Controller */
 #define SAM_IRQ_MCAN01         SAM_PID_MCAN01    /* MCAN controller 0, Interrupt 1 */
 #define SAM_IRQ_MCAN11         SAM_PID_MCAN11    /* MCAN controller 1, Interrupt 1 */
@@ -209,9 +210,8 @@
 #define SAM_IRQ_SYS            SAM_PID_SYS       /* System Controller Interrupt PMC, RTC, RSTC */
 #define SAM_IRQ_ACC            SAM_PID_ACC       /* Analog Comparator */
 #define SAM_IRQ_RXLP           SAM_PID_RXLP      /* UART Low-Power */
-
-                                                 /* Special Function Register BackUp (no interrupt) */
-
+                                                 /* Special Function
+                                                  * Register BackUp (no interrupt) */
                                                  /* Chip ID (no interrupt) */
 
 #define SAM_IRQ_NINT           (SAM_PID_RXLP + 1)
@@ -381,21 +381,21 @@
                                SAM_NPIOAIRQS + SAM_NPIOBIRQS + SAM_NPIOCIRQS + \
                                SAM_NPIODIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sama5/sama5d3_irq.h b/arch/arm/include/sama5/sama5d3_irq.h
index d08eba6..b952902 100644
--- a/arch/arm/include/sama5/sama5d3_irq.h
+++ b/arch/arm/include/sama5/sama5d3_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sama5/sama5d3_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMA5_SAMA5D3_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMA5_SAMA5D3_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAMA5D3 Peripheral Identifiers */
 
@@ -347,21 +347,21 @@
                                SAM_NPIOAIRQS + SAM_NPIOBIRQS + SAM_NPIOCIRQS + \
                                SAM_NPIODIRQS + SAM_NPIOEIRQS )
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/sama5/sama5d4_irq.h b/arch/arm/include/sama5/sama5d4_irq.h
index dedbb62..8799c36 100644
--- a/arch/arm/include/sama5/sama5d4_irq.h
+++ b/arch/arm/include/sama5/sama5d4_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/sama5/sama5d4_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMA5_SAMA5D4_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMA5_SAMA5D4_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAMA5D3 Peripheral Identifiers */
 
@@ -390,21 +390,21 @@
                                SAM_NPIOAIRQS + SAM_NPIOBIRQS + SAM_NPIOCIRQS + \
                                SAM_NPIODIRQS + SAM_NPIOEIRQS )
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/samd2l2/chip.h b/arch/arm/include/samd2l2/chip.h
index 2513314..22f4b55 100644
--- a/arch/arm/include/samd2l2/chip.h
+++ b/arch/arm/include/samd2l2/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd2l2/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,28 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_CHIP_H
 #define __ARCH_ARM_INCLUDE_SAMD2L2_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
-/* SAMD20 Family ********************************************************************/
+/* SAMD20 Family ************************************************************/
+
 /* FEATURE             SAM D20J          SAM D20G           SAM D20E
  * ------------------- ------------------ ------------------ --------
  * No. of pins         64                 48                 32
- * Flash               256/128/64/32/16KB 256/128/64/32/16KB 256/128/64/32/16KB
+ * Flash               256/128/64/        256/128/64/        256/128/64/
+ *                     32/16KB            32/16KB            32/16KB
  * SRAM                32/16/8/4/2KB      32/16/8/4/2KB      32/16/8/4/2KB
  * Max. Freq.          48MHz              48MHz              48MHz
  * Event channels      8                  8                  8
@@ -49,7 +51,8 @@
  * DAC channels        1                  1                  1
  * RTC                 Yes                Yes                Yes
  * RTC alarms          1                  1                  1
- * RTC compare         1 32-bit/2 16-bit  1 32-bit/2 16-bit  1 32-bit/2 16-bit
+ * RTC compare         1 32-bit/          1 32-bit/          1 32-bit/
+ *                     2 16-bit           2 16-bit           2 16-bit
  * External interrupts 16                 16                 16
  * PTC X an Y          16x16              12x10              10x6
  * Packages            QFN/TQFP           QFN/TQFP           QFN/TQFP
@@ -328,7 +331,7 @@
 #  define SAMD2L2_NADC              20            /* 20 ADC channels */
 #  define SAMD2L2_NCMP              2             /* 2 Comparators */
 #  define SAMD2L2_NDAC              1             /* 1 DAC channel */
-#  define SAMD2L2_NOPAMP              0             /* No OpAmps */
+#  define SAMD2L2_NOPAMP            0             /* No OpAmps */
 #  define SAMD2L2_RTC               1             /* Have RTC */
 #  define SAMD2L2_NALARMS           1             /* 1 RTC alarm */
 #  define SAMD2L2_NRTCMP            1             /* RTC compare: 1 32-bit/2 16-bit */
@@ -338,7 +341,8 @@
 #  define SAMD2L2_WDT               1             /* Have watchdog timer */
 #endif
 
-/* SAMD21 Family ********************************************************************/
+/* SAMD21 Family ************************************************************/
+
 /* FEATURE             SAM D21J          SAM D21G           SAM D21E
  * ------------------- ------------------ ------------------ --------
  * No. of pins         64                 48                 32
@@ -360,11 +364,13 @@
  * DAC channels        1                  1                  1
  * RTC                 Yes                Yes                Yes
  * RTC alarms          1                  1                  1
- * RTC compare         1 32-bit/2 16-bit  1 32-bit/2 16-bit  1 32-bit/2 16-bit
+ * RTC compare         1 32-bit/          1 32-bit/          1 32-bit/
+ *                     2 16-bit           2 16-bit           2 16-bit
  * External interrupts 16                 16                 16
  * PTC X an Y          16x16              12x10              10x6
  * Packages            QFN/TQFP           QFN/TQFP/WLCSP     QFN/TQFP/UFBGA
- * Oscillators         XOSC32, XOSC, OSC32K, OSCULP32K, OSC8M, DFLL48M, and FDPLL96M
+ * Oscillators         XOSC32, XOSC, OSC32K, OSCULP32K, OSC8M,
+ *                                                  DFLL48M, and FDPLL96M
  * SW Debug interface  Yes                Yes                Yes
  * Watchdog timer      Yes                Yes                Yes
  */
@@ -643,7 +649,7 @@
 #  define SAMD2L2_NADC              20            /* 20 ADC channels */
 #  define SAMD2L2_NCMP              2             /* 2 Comparators */
 #  define SAMD2L2_NDAC              1             /* 1 DAC channel */
-#  define SAMD2L2_NOPAMP              3             /* 3 OpAmps */
+#  define SAMD2L2_NOPAMP            3             /* 3 OpAmps */
 #  define SAMD2L2_RTC               1             /* Have RTC */
 #  define SAMD2L2_NALARMS           1             /* 1 RTC alarm */
 #  define SAMD2L2_NRTCMP            1             /* RTC compare: 1 32-bit/2 16-bit */
@@ -653,7 +659,8 @@
 #  define SAMD2L2_WDT               1             /* Have watchdog timer */
 #endif
 
-/* SAML21 Family ********************************************************************/
+/* SAML21 Family ************************************************************/
+
 /* FEATURE             SAM L21J          SAM L21G           SAM L21E
  * ------------------- ------------------ ------------------ --------
  * No. of pins         64                 48                 32
@@ -679,12 +686,14 @@
  * OPAMP               3                  3                  3
  * RTC                 Yes                Yes                Yes
  * RTC alarms          1                  1                  1
- * RTC compare         1 32-bit/2 16-bit  1 32-bit/2 16-bit  1 32-bit/2 16-bit
+ * RTC compare         1 32-bit/          1 32-bit/          1 32-bit/
+ *                     2 16-bit           2 16-bit           2 16-bit
  * External interrupts 16                 16                 16
  * PTC X an Y          12x16              8x12               6x10
  *                     16x12              12x8               10x6
  * Packages            QFN/TQFP           QFN/TQFP           QFN/TQFP
- * Oscillators         XOSC32, XOSC, OSC32K, OSCULP32K, OSC16M, DFLL48M, and FDPLL96M
+ * Oscillators         XOSC32, XOSC, OSC32K, OSCULP32K,
+ *                                     OSC16M, DFLL48M, and FDPLL96M
  * SW Debug interface  Yes                Yes                Yes
  * Watchdog timer      Yes                Yes                Yes
  */
@@ -952,10 +961,12 @@
 #  define SAMD2L2_WDT               1             /* Have watchdog timer */
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-3. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:6] of each field, bits[5:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-3. The lower the value, the
+ * greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:6] of each field, bits[5:0] read as zero and ignore
+ * writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN      0xc0 /* All bits[7:6] set is minimum priority */
@@ -963,16 +974,16 @@
 #define NVIC_SYSH_PRIORITY_MAX      0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP     0x40 /* Five bits of interrupt priority used */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_SAMD2L2_CHIP_H */
diff --git a/arch/arm/include/samd2l2/irq.h b/arch/arm/include/samd2l2/irq.h
index f866ad0..683ffb0 100644
--- a/arch/arm/include/samd2l2/irq.h
+++ b/arch/arm/include/samd2l2/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd2l2/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMD2L2_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/samd2l2/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -54,7 +55,9 @@
 #define SAM_IRQ_PENDSV        (14) /* Vector 14: Pendable system service request */
 #define SAM_IRQ_SYSTICK       (15) /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define SAM_IRQ_INTERRUPT     (16) /* Vector number of the first external interrupt */
 
@@ -70,15 +73,15 @@
 #  error Unrecognized SAMD/L architecture
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -88,9 +91,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/samd2l2/sam_adc.h b/arch/arm/include/samd2l2/sam_adc.h
index 83a4112..b547593 100644
--- a/arch/arm/include/samd2l2/sam_adc.h
+++ b/arch/arm/include/samd2l2/sam_adc.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd2l2/sam_adc.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,13 +16,13 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_SRC_SAMD2L2_SAM_ADC_H
 #define __ARCH_ARM_SRC_SAMD2L2_SAM_ADC_H
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IOCTL definitions */
diff --git a/arch/arm/include/samd2l2/samd20_irq.h b/arch/arm/include/samd2l2/samd20_irq.h
index 976d5bb..ad3c0dd 100644
--- a/arch/arm/include/samd2l2/samd20_irq.h
+++ b/arch/arm/include/samd2l2/samd20_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd2l2/samd20_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_SAMD20_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMD2L2_SAMD20_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts */
 
@@ -92,21 +92,21 @@
 
 #define NR_IRQS            (SAM_IRQ_INTERRUPT + SAM_IRQ_NINTS + SAM_IRQ_NEXTINTS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/samd2l2/samd21_irq.h b/arch/arm/include/samd2l2/samd21_irq.h
index e08753a..716211b 100644
--- a/arch/arm/include/samd2l2/samd21_irq.h
+++ b/arch/arm/include/samd2l2/samd21_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd2l2/samd21_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,27 +16,27 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
 /* References:
  *   "Atmel SAM D21E / SAM D21G / SAM D21J SMART ARM-Based Microcontroller
  *   Datasheet", Atmel-42181E–SAM-D21_Datasheet–02/2015
  */
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_SAMD21_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMD2L2_SAMD21_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts */
 
@@ -100,17 +100,17 @@
 
 #define NR_IRQS            (SAM_IRQ_INTERRUPT + SAM_IRQ_NINTS + SAM_IRQ_NEXTINTS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline Functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -121,9 +121,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/samd2l2/saml21_irq.h b/arch/arm/include/samd2l2/saml21_irq.h
index b11fba1..dbca21a 100644
--- a/arch/arm/include/samd2l2/saml21_irq.h
+++ b/arch/arm/include/samd2l2/saml21_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd2l2/saml21_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_SAML21_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMD2L2_SAML21_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts */
 
@@ -100,17 +100,17 @@
 
 #define NR_IRQS            (SAM_IRQ_INTERRUPT + SAM_IRQ_NINTS + SAM_IRQ_NEXTINTS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline Functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -121,9 +121,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/samd5e5/chip.h b/arch/arm/include/samd5e5/chip.h
index 2cae696..8bc06a9 100644
--- a/arch/arm/include/samd5e5/chip.h
+++ b/arch/arm/include/samd5e5/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd5e5/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,23 +16,24 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD5E5_CHIP_H
 #define __ARCH_ARM_INCLUDE_SAMD5E5_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* Get customizations for each supported chip.  Only sizes and numbers of things are
- * provided here.  See arch/arm/src/samd5e5/Kconfig for other, boolean configuration
+/* Get customizations for each supported chip.
+ * Only sizes and numbers of things are provided here.
+ * See arch/arm/src/samd5e5/Kconfig for other, boolean configuration
  * settings.
  */
 
@@ -612,10 +613,12 @@
 #  error Unrecognized SAMD5x/Ex chip
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0x00-0xe0. The lower the value, the
- * greater the priority of the corresponding interrupt. The processor implements only
- * bits[7:4] of each field, bits[6:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0x00-0xe0. The lower the
+ * value, the greater the priority of the corresponding interrupt.
+ * The processor implements only bits[7:4] of each field, bits[6:0] read as
+ * zero and ignore writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN      0xe0 /* All bits[7:5] set is minimum priority */
@@ -623,16 +626,16 @@
 #define NVIC_SYSH_PRIORITY_MAX      0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP     0x20 /* Eight priority levels in steps 0x20 */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_SAMD5E5_CHIP_H */
diff --git a/arch/arm/include/samd5e5/irq.h b/arch/arm/include/samd5e5/irq.h
index a370657..95324f9 100644
--- a/arch/arm/include/samd5e5/irq.h
+++ b/arch/arm/include/samd5e5/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd5e5/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD5E5_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMD5E5_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/samd5e5/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Common Processor Exceptions (vectors 0-15) */
@@ -67,15 +68,15 @@
 #  error "Unsupported SAMD5/E5 family"
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -85,9 +86,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/samd5e5/samd5e5_irq.h b/arch/arm/include/samd5e5/samd5e5_irq.h
index 4fe3a24..37e3829 100644
--- a/arch/arm/include/samd5e5/samd5e5_irq.h
+++ b/arch/arm/include/samd5e5/samd5e5_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************************
+/****************************************************************************
  * arch/arm/include/samd5e5/samd5e5_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMD5E5_SAM4L_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMD5E5_SAM4L_IRQ_H
 
-/************************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* External interrupts (vectors >= 16) */
 
@@ -195,23 +195,24 @@
 #define SAM_IRQ_SDHC1          (SAM_IRQ_EXTINT + 136)  /* 136 SDHC1: SDHC1, TIMER */
 
 #define SAM_IRQ_NEXTINT        137                     /* Total number of external interrupt numbers */
+
 #define NR_IRQS                (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT) /* The number of vectors */
 
-/************************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Inline functions
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/samv7/chip.h b/arch/arm/include/samv7/chip.h
index 04eea7b..086b9c2 100644
--- a/arch/arm/include/samv7/chip.h
+++ b/arch/arm/include/samv7/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/samv7/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_SAMV7_CHIP_H
 #define __ARCH_ARM_INCLUDE_SAMV7_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Get customizations for each supported chip */
 
@@ -371,10 +371,12 @@
 #  error "Unknown SAMV7 chip type"
 #endif
 
-/* NVIC priority levels *************************************************************/
-/* Each priority field holds a priority value, 0-15. The lower the value, the greater
- * the priority of the corresponding interrupt. The processor implements only
- * bits[7:6] of each field, bits[5:0] read as zero and ignore writes.
+/* NVIC priority levels *****************************************************/
+
+/* Each priority field holds a priority value, 0-15. The lower the value, the
+ * greater the priority of the corresponding interrupt. The processor
+ * implements only bits[7:6] of each field, bits[5:0] read as zero and ignore
+ * writes.
  */
 
 #define NVIC_SYSH_PRIORITY_MIN        0xc0 /* All bits[7:6] set is minimum priority */
@@ -382,16 +384,16 @@
 #define NVIC_SYSH_PRIORITY_MAX        0x00 /* Zero is maximum priority */
 #define NVIC_SYSH_PRIORITY_STEP       0x40 /* Two bits of interrupt priority used */
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_SAMV7_CHIP_H */
diff --git a/arch/arm/include/samv7/irq.h b/arch/arm/include/samv7/irq.h
index 02d1179..94bbef1 100644
--- a/arch/arm/include/samv7/irq.h
+++ b/arch/arm/include/samv7/irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samv7/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMV7_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMV7_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/samv7/chip.h>
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Common Processor Exceptions (vectors 0-15) */
@@ -70,15 +71,15 @@
 #  error Unrecognized SAMV7 architecture
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 #define EXTERN extern "C"
@@ -88,9 +89,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/samv7/same70_irq.h b/arch/arm/include/samv7/same70_irq.h
index 2f6bf12..d740225 100644
--- a/arch/arm/include/samv7/same70_irq.h
+++ b/arch/arm/include/samv7/same70_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samv7/same70_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMV7_SAME70_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMV7_SAME70_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAMV71 Peripheral Identifiers */
 
@@ -107,7 +107,7 @@
 
 #define NR_PIDS               (69)  /* Number of peripheral identifiers */
 
-/* External interrupts (priority levels >= 256*/
+/* External interrupts (priority levels >= 256 */
 
 #define SAM_IRQ_SUPC          (SAM_IRQ_EXTINT+SAM_PID_SUPC)   /* Supply Controller */
 #define SAM_IRQ_RSTC          (SAM_IRQ_EXTINT+SAM_PID_RSTC)   /* Reset Controller */
@@ -162,9 +162,11 @@
 #define SAM_IRQ_TC9           (SAM_IRQ_EXTINT+SAM_PID_TC9)    /* Timer Counter 9 */
 #define SAM_IRQ_TC10          (SAM_IRQ_EXTINT+SAM_PID_TC10)   /* Timer Counter 10 */
 #define SAM_IRQ_TC11          (SAM_IRQ_EXTINT+SAM_PID_TC11)   /* Timer Counter 11 */
+
 #define SAM_IRQ_RESERVED53    (SAM_IRQ_EXTINT+SAM_PID_RESERVED53) /* Reserved */
 #define SAM_IRQ_RESERVED54    (SAM_IRQ_EXTINT+SAM_PID_RESERVED54) /* Reserved */
 #define SAM_IRQ_RESERVED55    (SAM_IRQ_EXTINT+SAM_PID_RESERVED55) /* Reserved */
+
 #define SAM_IRQ_AES           (SAM_IRQ_EXTINT+SAM_PID_AES)    /* AES */
 #define SAM_IRQ_TRNG          (SAM_IRQ_EXTINT+SAM_PID_TRNG)   /* True Random Number Generator */
 #define SAM_IRQ_XDMAC         (SAM_IRQ_EXTINT+SAM_PID_XDMAC)  /* Central DMA Controller */
@@ -388,21 +390,21 @@
                                SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \
                                SAM_NGPIODIRQS + SAM_NGPIOEIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/samv7/samv71_irq.h b/arch/arm/include/samv7/samv71_irq.h
index a669405..3ce9317 100644
--- a/arch/arm/include/samv7/samv71_irq.h
+++ b/arch/arm/include/samv7/samv71_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************
+/****************************************************************************
  * arch/arm/include/samv7/samv71_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,22 +16,22 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through
- * nuttx/irq.h
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
  */
 
 #ifndef __ARCH_ARM_INCLUDE_SAMV7_SAMV71_IRQ_H
 #define __ARCH_ARM_INCLUDE_SAMV7_SAMV71_IRQ_H
 
-/****************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* SAMV71 Peripheral Identifiers */
 
@@ -107,7 +107,7 @@
 
 #define NR_PIDS               (69)  /* Number of peripheral identifiers */
 
-/* External interrupts (priority levels >= 256*/
+/* External interrupts (priority levels >= 256 */
 
 #define SAM_IRQ_SUPC          (SAM_IRQ_EXTINT+SAM_PID_SUPC)   /* Supply Controller */
 #define SAM_IRQ_RSTC          (SAM_IRQ_EXTINT+SAM_PID_RSTC)   /* Reset Controller */
@@ -164,7 +164,9 @@
 #define SAM_IRQ_TC11          (SAM_IRQ_EXTINT+SAM_PID_TC11)   /* Timer Counter 11 */
 #define SAM_IRQ_MLB0          (SAM_IRQ_EXTINT+SAM_PID_MLB0)   /* MediaLB IRQ 0 */
 #define SAM_IRQ_MLB1          (SAM_IRQ_EXTINT+SAM_PID_MLB1)   /* MediaLB IRQ 1 */
+
 #define SAM_IRQ_RESERVED55    (SAM_IRQ_EXTINT+SAM_PID_RESERVED55) /* Reserved */
+
 #define SAM_IRQ_AES           (SAM_IRQ_EXTINT+SAM_PID_AES)    /* AES */
 #define SAM_IRQ_TRNG          (SAM_IRQ_EXTINT+SAM_PID_TRNG)   /* True Random Number Generator */
 #define SAM_IRQ_XDMAC         (SAM_IRQ_EXTINT+SAM_PID_XDMAC)  /* Central DMA Controller */
@@ -388,21 +390,21 @@
                                SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \
                                SAM_NGPIODIRQS + SAM_NGPIOEIRQS)
 
-/****************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Inline functions
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/spinlock.h b/arch/arm/include/spinlock.h
index 5072e90..55c12c8 100644
--- a/arch/arm/include/spinlock.h
+++ b/arch/arm/include/spinlock.h
@@ -48,7 +48,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Spinlock states */
diff --git a/arch/arm/include/stdarg.h b/arch/arm/include/stdarg.h
index 6cf07bc..26b9088 100644
--- a/arch/arm/include/stdarg.h
+++ b/arch/arm/include/stdarg.h
@@ -26,8 +26,9 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
+
 /* This should work with any modern gcc (newer than 3.4 or so) */
 
 #define va_start(v,l)   __builtin_va_start(v,l)
diff --git a/arch/arm/include/stm32/chip.h b/arch/arm/include/stm32/chip.h
index d798ad2..f155df6 100644
--- a/arch/arm/include/stm32/chip.h
+++ b/arch/arm/include/stm32/chip.h
@@ -1,4 +1,4 @@
-/**************************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- **************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_STM32_CHIP_H
 #define __ARCH_ARM_INCLUDE_STM32_CHIP_H
 
-/**************************************************************************************************
+/****************************************************************************
  * Included Files
- **************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/**************************************************************************************************
- * Pre-processor Definitions
- **************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Check the STM32 family configuration.
  * It must be done in arch/arm/src/stm32/Kconfig !
@@ -117,7 +117,7 @@
  * The chip-specific pin-mapping is defined in the chip datasheet.
  */
 
-/* STM32L EnergyLite Line *************************************************************************/
+/* STM32L EnergyLite Line ***************************************************/
 
 /* STM32L151XX -- No LCD
  * STM32L152XX -- With LCD
@@ -521,7 +521,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F100 Value Line **************************************************************************/
+/* STM32 F100 Value Line ****************************************************/
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F100C8) || defined(CONFIG_ARCH_CHIP_STM32F100CB) \
  || defined(CONFIG_ARCH_CHIP_STM32F100R8) || defined(CONFIG_ARCH_CHIP_STM32F100RB)
@@ -531,7 +531,9 @@
 #  define STM32_NGTIMNDMA                0   /* No 16-bit general timers without DMA */
 #  define STM32_NBTIM                    2   /* 2 basic timers: TIM6, TIM7 */
 
-/* TODO: there are also 3 additional timers (15-17) that don't fit any existing category */
+/* TODO: there are also 3 additional timers (15-17)
+ * that don't fit any existing category
+ */
 
 #  define STM32_NDMA                     1   /* DMA1 */
 #  define STM32_NSPI                     2   /* SPI1-2 */
@@ -558,7 +560,9 @@
 #  define STM32_NGTIMNDMA                0   /* No 16-bit general timers without DMA */
 #  define STM32_NBTIM                    2   /* 2 basic timers: TIM6, TIM7 */
 
-/* TODO: there are also 3 additional timers (15-17) that don't fit any existing category */
+/* TODO: there are also 3 additional timers (15-17)
+ * that don't fit any existing category
+ */
 
 #  define STM32_NDMA                     1   /* DMA1 */
 #  define STM32_NSPI                     2   /* SPI1-2 */
@@ -578,7 +582,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F100 High-density value Line *************************************************************/
+/* STM32 F100 High-density value Line ***************************************/
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F100RC) || defined(CONFIG_ARCH_CHIP_STM32F100RD) \
  || defined(CONFIG_ARCH_CHIP_STM32F100RE)
@@ -588,7 +592,9 @@
 #  define STM32_NGTIMNDMA                0   /* No 16-bit general timers without DMA */
 #  define STM32_NBTIM                    2   /* 2 basic timers: TIM6, TIM7 */
 
-/* TODO: there are also 6 additional timers (12-17) that don't fit any existing category */
+/* TODO: there are also 6 additional timers (12-17)
+ * that don't fit any existing category
+ */
 
 #  define STM32_NDMA                     2   /* DMA1-2 */
 #  define STM32_NSPI                     3   /* SPI1-3 */
@@ -616,7 +622,9 @@
 #  define STM32_NGTIMNDMA                0   /* No 16-bit general timers without DMA */
 #  define STM32_NBTIM                    2   /* 2 basic timers: TIM6, TIM7 */
 
-/* TODO: there are also 6 additional timers (12-17) that don't fit any existing category */
+/* TODO: there are also 6 additional timers (12-17)
+ * that don't fit any existing category
+ */
 
 #  define STM32_NDMA                     2   /* DMA1-2 */
 #  define STM32_NSPI                     3   /* SPI1-3 */
@@ -636,7 +644,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F102x8/102xB Medium Density USB Access Family ********************************************/
+/* STM32 F102x8/102xB Medium Density USB Access Family **********************/
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F102CB)
 #  define STM32_NFSMC                    1   /* FSMC */
@@ -662,7 +670,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F103 Low Density Family ******************************************************************/
+/* STM32 F103 Low Density Family ********************************************/
 
 /* STM32F103C4 & STM32F103C6 */
 
@@ -688,7 +696,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F103 Medium Density Performance Line *****************************************************/
+/* STM32 F103 Medium Density Performance Line *******************************/
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F103T8) || defined(CONFIG_ARCH_CHIP_STM32F103TB)
 #  define STM32_NFSMC                    0   /* No FSMC */
@@ -762,10 +770,10 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F103 High Density Family *****************************************************************/
+/* STM32 F103 High Density Family *******************************************/
 
-/* STM32F103RC, STM32F103RD, and STM32F103RE are all provided in 64 pin packages and
- * differ only in the available FLASH and SRAM.
+/* STM32F103RC, STM32F103RD, and STM32F103RE are all provided in 64 pin
+ * packages and differ only in the available FLASH and SRAM.
  */
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F103RC) || defined(CONFIG_ARCH_CHIP_STM32F103RD) || \
@@ -793,8 +801,8 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32F103VC, STM32F103VD, and STM32F103VE are all provided in 100 pin packages and differ
- * only in the available FLASH and SRAM.
+/* STM32F103VC, STM32F103VD, and STM32F103VE are all provided in 100 pin
+ * packages and differ only in the available FLASH and SRAM.
  */
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F103VC) || defined(CONFIG_ARCH_CHIP_STM32F103VE)
@@ -821,8 +829,8 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32F103ZC, STM32F103ZD, and STM32F103ZE are all provided in 144 pin packages and differ
- * only in the available FLASH and SRAM.
+/* STM32F103ZC, STM32F103ZD, and STM32F103ZE are all provided in 144 pin
+ * packages and differ only in the available FLASH and SRAM.
  */
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F103ZE)
@@ -849,7 +857,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F105/F107 Connectivity Line **************************************************************/
+/* STM32 F105/F107 Connectivity Line ****************************************/
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F105VB)
 #  define STM32_NFSMC                    1   /* FSMC */
@@ -923,7 +931,7 @@
 #  define STM32_NRNG                     0   /* No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* No digital camera interface (DCMI) */
 
-/* STM32 F2 Family ********************************************************************************/
+/* STM32 F2 Family **********************************************************/
 
 #elif defined(CONFIG_ARCH_CHIP_STM32F205RG)  /* UFBGA-176 1024Kb FLASH 128Kb SRAM */
 #  define STM32_NFSMC                    0   /* No FSMC */
@@ -1028,7 +1036,7 @@
 #  define STM32_NRNG                     1   /* Random number generator (RNG) */
 #  define STM32_NDCMI                    1   /* Digital camera interface (DCMI) */
 
-/* STM23 F3 Family ********************************************************************************/
+/* STM23 F3 Family **********************************************************/
 
 /* Part Numbering: STM32Fssscfxxx
  *
@@ -1553,7 +1561,7 @@
 #  define STM32_NRNG                     0   /* (0) No random number generator (RNG) */
 #  define STM32_NDCMI                    0   /* (0) No digital camera interface (DCMI) */
 
-/* STM23 F4 Family ********************************************************************************/
+/* STM23 F4 Family **********************************************************/
 
 /* STM32F01xB/C Family Differences:
  *
@@ -2606,7 +2614,7 @@
 #  error "Unsupported STM32 chip"
 #endif
 
-/* Peripheral IP versions *************************************************************************/
+/* Peripheral IP versions ***************************************************/
 
 /* Peripheral IP versions are invariant and should be decided here, not in
  * Kconfig.
@@ -2644,7 +2652,7 @@
 #  error "Did not resolve peripheral IP versions!"
 #endif
 
-/* NVIC priority levels ***************************************************************************/
+/* NVIC priority levels *****************************************************/
 
 #define NVIC_SYSH_PRIORITY_MIN     0xf0 /* All bits set in minimum priority */
 #define NVIC_SYSH_PRIORITY_DEFAULT 0x80 /* Midpoint is the default */
diff --git a/arch/arm/include/stm32/irq.h b/arch/arm/include/stm32/irq.h
index 240cd30..3f29c71 100644
--- a/arch/arm/include/stm32/irq.h
+++ b/arch/arm/include/stm32/irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather,
  * only indirectly through nuttx/irq.h
@@ -25,21 +25,22 @@
 #ifndef __ARCH_ARM_INCLUDE_STM32_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <nuttx/irq.h>
 #include <arch/stm32/chip.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -58,13 +59,15 @@
 #define STM32_IRQ_PENDSV        (14) /* Vector 14: Pendable system service request */
 #define STM32_IRQ_SYSTICK       (15) /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define STM32_IRQ_FIRST         (16) /* Vector number of the first external interrupt */
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #if defined(CONFIG_STM32_STM32L15XX)
 #  include <arch/stm32/stm32l15xxx_irq.h>
@@ -86,13 +89,13 @@
 #  error "Unsupported STM32 chip"
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -103,9 +106,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/stm32/stm32f10xxx_irq.h b/arch/arm/include/stm32/stm32f10xxx_irq.h
index 22bfbe4..22c623b 100644
--- a/arch/arm/include/stm32/stm32f10xxx_irq.h
+++ b/arch/arm/include/stm32/stm32f10xxx_irq.h
@@ -33,7 +33,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32/stm32f20xxx_irq.h b/arch/arm/include/stm32/stm32f20xxx_irq.h
index aa83433..26160b1 100644
--- a/arch/arm/include/stm32/stm32f20xxx_irq.h
+++ b/arch/arm/include/stm32/stm32f20xxx_irq.h
@@ -33,7 +33,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32/stm32f30xxx_irq.h b/arch/arm/include/stm32/stm32f30xxx_irq.h
index ed17603..e8acfd9 100644
--- a/arch/arm/include/stm32/stm32f30xxx_irq.h
+++ b/arch/arm/include/stm32/stm32f30xxx_irq.h
@@ -33,7 +33,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32/stm32f33xxx_irq.h b/arch/arm/include/stm32/stm32f33xxx_irq.h
index 7b91fd4..892b6aa 100644
--- a/arch/arm/include/stm32/stm32f33xxx_irq.h
+++ b/arch/arm/include/stm32/stm32f33xxx_irq.h
@@ -49,7 +49,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32/stm32f37xxx_irq.h b/arch/arm/include/stm32/stm32f37xxx_irq.h
index ee57857..6c00b24 100644
--- a/arch/arm/include/stm32/stm32f37xxx_irq.h
+++ b/arch/arm/include/stm32/stm32f37xxx_irq.h
@@ -49,7 +49,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32/stm32f40xxx_irq.h b/arch/arm/include/stm32/stm32f40xxx_irq.h
index 3fb7764..c2ac5e9 100644
--- a/arch/arm/include/stm32/stm32f40xxx_irq.h
+++ b/arch/arm/include/stm32/stm32f40xxx_irq.h
@@ -1,7 +1,8 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32/stm32f40xxx_irq.h
  *
- *   Copyright (C) 2009, 2014-2015, 2017-2018 Gregory Nutt. All rights reserved.
+ *   Copyright (C) 2009, 2014-2015, 2017-2018 Gregory Nutt.
+ *   All rights reserved.
  *   Copyright (C) 2016 Omni Hoverboards Inc. All rights reserved.
  *   Author: Gregory Nutt <gn...@nuttx.org>
  *           David Sidrane <da...@nscdg.com>
@@ -34,7 +35,7 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather,
  * only indirectly through nuttx/irq.h
@@ -43,23 +44,24 @@
 #ifndef __ARCH_ARM_INCLUDE_STM32_STM32F40XXX_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32_STM32F40XXX_IRQ_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <nuttx/irq.h>
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
- * in nuttx/arch/arm/include/stm32/irq.h
+ * Processor Exceptions (vectors 0-15). These common definitions can
+ * be found in nuttx/arch/arm/include/stm32/irq.h
  *
  * External interrupts (vectors >= 16)
  */
@@ -340,13 +342,13 @@
 #  define NR_IRQS                (STM32_IRQ_FIRST+93)
 #endif
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
diff --git a/arch/arm/include/stm32/stm32g4xxxx_irq.h b/arch/arm/include/stm32/stm32g4xxxx_irq.h
index 5f22484..adf4f80 100644
--- a/arch/arm/include/stm32/stm32g4xxxx_irq.h
+++ b/arch/arm/include/stm32/stm32g4xxxx_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32/stm32g4xxxx_irq.h
  *
  *  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  *  License for the specific language governing permissions and limitations
  *  under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather, only indirectly
  * through nuttx/irq.h
@@ -25,16 +25,16 @@
 #ifndef __ARCH_ARM_INCLUDE_STM32_STM32G4XXXX_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32_STM32G4XXXX_IRQ_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <nuttx/irq.h>
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ numbers correspond to the vector numbers and hence
  * map directly to bits in the NVIC.  This does, however, waste several words
@@ -170,13 +170,13 @@
 #define STM32_IRQ_NEXTINT         (102)
 #define NR_IRQS                   (STM32_IRQ_FIRST + 102)
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -187,9 +187,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/stm32/stm32l15xxx_irq.h b/arch/arm/include/stm32/stm32l15xxx_irq.h
index 26d006e..e145052 100644
--- a/arch/arm/include/stm32/stm32l15xxx_irq.h
+++ b/arch/arm/include/stm32/stm32l15xxx_irq.h
@@ -33,7 +33,7 @@
 #include <nuttx/irq.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /*  IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f0l0g0/chip.h b/arch/arm/include/stm32f0l0g0/chip.h
index 2ee739c..ff5d0c9 100644
--- a/arch/arm/include/stm32f0l0g0/chip.h
+++ b/arch/arm/include/stm32f0l0g0/chip.h
@@ -45,7 +45,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Get customizations for each supported chip */
diff --git a/arch/arm/include/stm32f0l0g0/irq.h b/arch/arm/include/stm32f0l0g0/irq.h
index 5c59483..401e683 100644
--- a/arch/arm/include/stm32f0l0g0/irq.h
+++ b/arch/arm/include/stm32f0l0g0/irq.h
@@ -35,7 +35,7 @@
 #include <arch/stm32f0l0g0/chip.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f0l0g0/stm32f0_irq.h b/arch/arm/include/stm32f0l0g0/stm32f0_irq.h
index 2d0e348..d02cee0 100644
--- a/arch/arm/include/stm32f0l0g0/stm32f0_irq.h
+++ b/arch/arm/include/stm32f0l0g0/stm32f0_irq.h
@@ -34,7 +34,7 @@
 #include <arch/stm32f0l0g0/chip.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f0l0g0/stm32g0_irq.h b/arch/arm/include/stm32f0l0g0/stm32g0_irq.h
index f42361d..1a496a9 100644
--- a/arch/arm/include/stm32f0l0g0/stm32g0_irq.h
+++ b/arch/arm/include/stm32f0l0g0/stm32g0_irq.h
@@ -50,7 +50,7 @@
 #include <arch/stm32f0l0g0/chip.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f0l0g0/stm32l0_irq.h b/arch/arm/include/stm32f0l0g0/stm32l0_irq.h
index fba2850..48083f1 100644
--- a/arch/arm/include/stm32f0l0g0/stm32l0_irq.h
+++ b/arch/arm/include/stm32f0l0g0/stm32l0_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32f0l0g0/stm32l0_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,31 +16,34 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through nuttx/irq.h */
+/* This file should never be included directly but, rather,
+ * only indirectly through nuttx/irq.h
+ */
 
 #ifndef __ARCH_ARM_INCLUDE_STM32F0L0G0_STM32L0_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32F0L0G0_STM32L0_IRQ_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <nuttx/irq.h>
 #include <arch/stm32f0l0g0/chip.h>
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
- * in nuttx/arch/arm/include/stm32f0l0g0/irq.h
+ * Processor Exceptions (vectors 0-15).  These common definitions
+ * can be found in nuttx/arch/arm/include/stm32f0l0g0/irq.h
  */
 
 #define STM32_IRQ_WWDG        (STM32_IRQ_EXTINT + 0)  /* 0:  Window Watchdog interrupt */
@@ -87,13 +90,13 @@
 
 #define STM32_IRQ_NEXTINT     (32)
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Types
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Data
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -104,9 +107,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/****************************************************************************************************
+/****************************************************************************
  * Public Functions Prototypes
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/stm32f7/chip.h b/arch/arm/include/stm32f7/chip.h
index a77dae3..b24e68e 100644
--- a/arch/arm/include/stm32f7/chip.h
+++ b/arch/arm/include/stm32f7/chip.h
@@ -1,4 +1,4 @@
-/********************************************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32f7/chip.h
  *
  *   Copyright (C) 2015-2017 Gregory Nutt. All rights reserved.
@@ -33,101 +33,171 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ********************************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_STM32F7_CHIP_H
 #define __ARCH_ARM_INCLUDE_STM32F7_CHIP_H
 
-/********************************************************************************************************************
+/****************************************************************************
  * Included Files
- ********************************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/********************************************************************************************************************
- * Pre-processor Definitions
- ********************************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* STM32F722xx, STM32F723xx,
- * STM32F745xx, STM32F746xx, STM32F756xx, STM32F765xx, STM32F767xx, STM32F768xx,
- * STM32F769xx, STM32F777xx and STM32F779xx  Differences between family members:
+ * STM32F745xx, STM32F746xx, STM32F756xx, STM32F765xx, STM32F767xx,
+ * STM32F768xx, STM32F769xx, STM32F777xx and STM32F779xx
+ * Differences between family members:
  *
- *   ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- ---- ----- ----- ---- ------------ ------
+ *   ----------- ---------------- ----- ---- ----- ---- ---- ---- ----
  *                                       SPI   ADC LCD
- *   PART        PACKAGE          GPIOs  I2S  CHAN TFT  MIPI JPEG CAN  ETH  DFSDM CRYPTO FPU      RAM      L1
- *   ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- ---- ----- ----- ---- ------------ ------
- *   STM32F722Rx LQFP64             50   3/3   16   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *   STM32F722Vx LQFP100            82   4/3   16   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *   STM32F722Zx LQFP144           114   5/3   24   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *   STM32F722Ix UFBGA176/LQFP176  140   5/3   24   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *
- *   STM32F723Vx WLCSP100           79   4/3   16   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *   STM32F723Zx UFBGA144/LQFP144  112   5/3   24   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *   STM32F723Ix UFBGA176/LQFP176  138   5/3   24   No   No   No   1   No    No    No   SFPU (176+16+64)  8+8
- *
- *   STM32F745Vx LQFP100            82   4/3   16   No   No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F745Zx WLCSP143/LQFP144  114   6/3   24   No   No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F745Ix UFBGA176/LQFP176  140   6/3   24   No   No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F745Bx LQFP208           168   6/3   24   No   No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F745Nx TFBGA216           68   6/3   24   No   No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *
- *   STM32F746Vx LQFP100            82   4/3   16   Yes  No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F746Zx WLCSP143/LQFP144  114   6/3   24   Yes  No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F746Ix UFBGA176/LQFP176  140   6/3   24   Yes  No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F746Bx LQFP208           168   6/3   24   Yes  No   No   2   Yes   No    No   SFPU (240+16+64)  4+4
- *   STM32F746Nx TFBGA216          168   6/3   24   Yes  No   No   2   Yes   No    No   SFPU
- *
- *   STM32F756Vx LQFP100            82   4/3   16   Yes  No   No   2   Yes   No   Yes   SFPU (240+16+64)  4+4
- *   STM32F756Zx WLCSP143/LQFP144  114   6/3   24   Yes  No   No   2   Yes   No   Yes   SFPU (240+16+64)  4+4
- *   STM32F756Ix UFBGA176/LQFP176  140   6/3   24   Yes  No   No   2   Yes   No   Yes   SFPU (240+16+64)  4+4
- *   STM32F756Bx LQFP208           168   6/3   24   Yes  No   No   2   Yes   No   Yes   SFPU (240+16+64)  4+4
- *   STM32F756Nx TFBGA216          168   6/3   24   Yes  No   No   2   Yes   No   Yes   SFPU (240+16+64)  4+4
- *
- *   STM32F765Vx LQFP100            82   4/3   16   No   No   No   3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F765Zx WLCSP143/LQFP144  114   6/3   24   No   No   No   3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F765Ix UFBGA176/LQFP176  140   6/3   24   No   No   No   3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F765Bx LQFP208           168   6/3   24   No   No   No   3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F765Nx TFBGA216          168   6/3   24   No   No   No   3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *
- *   STM32F767Vx LQFP100            82   4/3   16   Yes  No   Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F767Zx WLCSP143/LQFP144  114   6/3   24   Yes  No   Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F767Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F767Bx LQFP208           168   6/3   24   Yes  Yes  Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F767Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *
- *   STM32F768Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3   No    Yes   No   DFPU (368+16+128) 16+16
- *
- *   STM32F769Vx LQFP100            82   4/3   16   Yes  No   Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F769Zx LQFP144           114   6/3   24   Yes  No   Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F769Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F769Bx LQFP208           168   6/3   24   Yes  Yes  Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *   STM32F769Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3   Yes   Yes   No   DFPU (368+16+128) 16+16
- *
- *   STM32F769Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3   No    Yes   No   DFPU (368+16+128) 16+16
- *
- *   STM32F777Vx LQFP100            82   4/3   16   Yes  No   Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *   STM32F777Zx LQFP144           114   6/3   24   Yes  No   Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *   STM32F777Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *   STM32F777Bx LQFP208           159   6/3   24   Yes  Yes  Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *   STM32F777Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *
- *   STM32F778Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3   No    Yes   Yes  DFPU (368+16+128) 16+16
- *
- *   STM32F779Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *   STM32F779Bx LQFP208           159   6/3   24   Yes  Yes  Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
- *   STM32F779Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3   Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   PART        PACKAGE          GPIOs  I2S  CHAN TFT  MIPI JPEG CAN
+ *   ----------- ---------------- ----- ---- ----- ---- ---- ---- ----
+ *   STM32F722Rx LQFP64             50   3/3   16   No   No   No   1
+ *   STM32F722Vx LQFP100            82   4/3   16   No   No   No   1
+ *   STM32F722Zx LQFP144           114   5/3   24   No   No   No   1
+ *   STM32F722Ix UFBGA176/LQFP176  140   5/3   24   No   No   No   1
+ *
+ *   STM32F723Vx WLCSP100           79   4/3   16   No   No   No   1
+ *   STM32F723Zx UFBGA144/LQFP144  112   5/3   24   No   No   No   1
+ *   STM32F723Ix UFBGA176/LQFP176  138   5/3   24   No   No   No   1
+ *
+ *   STM32F745Vx LQFP100            82   4/3   16   No   No   No   2
+ *   STM32F745Zx WLCSP143/LQFP144  114   6/3   24   No   No   No   2
+ *   STM32F745Ix UFBGA176/LQFP176  140   6/3   24   No   No   No   2
+ *   STM32F745Bx LQFP208           168   6/3   24   No   No   No   2
+ *   STM32F745Nx TFBGA216           68   6/3   24   No   No   No   2
+ *
+ *   STM32F746Vx LQFP100            82   4/3   16   Yes  No   No   2
+ *   STM32F746Zx WLCSP143/LQFP144  114   6/3   24   Yes  No   No   2
+ *   STM32F746Ix UFBGA176/LQFP176  140   6/3   24   Yes  No   No   2
+ *   STM32F746Bx LQFP208           168   6/3   24   Yes  No   No   2
+ *   STM32F746Nx TFBGA216          168   6/3   24   Yes  No   No   2
+ *
+ *   STM32F756Vx LQFP100            82   4/3   16   Yes  No   No   2
+ *   STM32F756Zx WLCSP143/LQFP144  114   6/3   24   Yes  No   No   2
+ *   STM32F756Ix UFBGA176/LQFP176  140   6/3   24   Yes  No   No   2
+ *   STM32F756Bx LQFP208           168   6/3   24   Yes  No   No   2
+ *   STM32F756Nx TFBGA216          168   6/3   24   Yes  No   No   2
+ *
+ *   STM32F765Vx LQFP100            82   4/3   16   No   No   No   3
+ *   STM32F765Zx WLCSP143/LQFP144  114   6/3   24   No   No   No   3
+ *   STM32F765Ix UFBGA176/LQFP176  140   6/3   24   No   No   No   3
+ *   STM32F765Bx LQFP208           168   6/3   24   No   No   No   3
+ *   STM32F765Nx TFBGA216          168   6/3   24   No   No   No   3
+ *
+ *   STM32F767Vx LQFP100            82   4/3   16   Yes  No   Yes  3
+ *   STM32F767Zx WLCSP143/LQFP144  114   6/3   24   Yes  No   Yes  3
+ *   STM32F767Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3
+ *   STM32F767Bx LQFP208           168   6/3   24   Yes  Yes  Yes  3
+ *   STM32F767Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3
+ *
+ *   STM32F768Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3
+ *
+ *   STM32F769Vx LQFP100            82   4/3   16   Yes  No   Yes  3
+ *   STM32F769Zx LQFP144           114   6/3   24   Yes  No   Yes  3
+ *   STM32F769Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3
+ *   STM32F769Bx LQFP208           168   6/3   24   Yes  Yes  Yes  3
+ *   STM32F769Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3
+ *
+ *   STM32F769Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3
+ *
+ *   STM32F777Vx LQFP100            82   4/3   16   Yes  No   Yes  3
+ *   STM32F777Zx LQFP144           114   6/3   24   Yes  No   Yes  3
+ *   STM32F777Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3
+ *   STM32F777Bx LQFP208           159   6/3   24   Yes  Yes  Yes  3
+ *   STM32F777Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3
+ *
+ *   STM32F778Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3
+ *
+ *   STM32F779Ix UFBGA176/LQFP176  132   6/3   24   Yes  Yes  Yes  3
+ *   STM32F779Bx LQFP208           159   6/3   24   Yes  Yes  Yes  3
+ *   STM32F779Nx TFBGA216          159   6/3   24   Yes  Yes  Yes  3
 
- *   STM32F779Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3   No    Yes   Yes  DFPU (368+16+128) 16+16
- *   ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- ---- ----- ----- ---- ------------ ------
+ *   STM32F779Ax WLCSP180          129   6/3   24   Yes  Yes  Yes  3
+ *   ----------- ---------------- ----- ---- ----- ---- ---- ---- ----
+ *
+ *
+ *   -----------  ---- ----- ----- ---- ------------ ------
  *
+ *   PART        ETH  DFSDM CRYPTO FPU      RAM      L1
+ *   ----------- ---- ----- ----- ---- ------------ ------
+ *   STM32F722Rx No    No    No   SFPU (176+16+64)  8+8
+ *   STM32F722Vx No    No    No   SFPU (176+16+64)  8+8
+ *   STM32F722Zx No    No    No   SFPU (176+16+64)  8+8
+ *   STM32F722Ix No    No    No   SFPU (176+16+64)  8+8
+ *
+ *   STM32F723Vx No    No    No   SFPU (176+16+64)  8+8
+ *   STM32F723Zx No    No    No   SFPU (176+16+64)  8+8
+ *   STM32F723Ix No    No    No   SFPU (176+16+64)  8+8
+ *
+ *   STM32F745Vx Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F745Zx Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F745Ix Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F745Bx Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F745Nx Yes   No    No   SFPU (240+16+64)  4+4
+ *
+ *   STM32F746Vx Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F746Zx Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F746Ix Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F746Bx Yes   No    No   SFPU (240+16+64)  4+4
+ *   STM32F746Nx Yes   No    No   SFPU
+ *
+ *   STM32F756Vx Yes   No   Yes   SFPU (240+16+64)  4+4
+ *   STM32F756Zx Yes   No   Yes   SFPU (240+16+64)  4+4
+ *   STM32F756Ix Yes   No   Yes   SFPU (240+16+64)  4+4
+ *   STM32F756Bx Yes   No   Yes   SFPU (240+16+64)  4+4
+ *   STM32F756Nx Yes   No   Yes   SFPU (240+16+64)  4+4
+ *
+ *   STM32F765Vx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F765Zx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F765Ix Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F765Bx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F765Nx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *
+ *   STM32F767Vx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F767Zx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F767Ix Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F767Bx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F767Nx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *
+ *   STM32F768Ax No    Yes   No   DFPU (368+16+128) 16+16
+ *
+ *   STM32F769Vx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F769Zx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F769Ix Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F769Bx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *   STM32F769Nx Yes   Yes   No   DFPU (368+16+128) 16+16
+ *
+ *   STM32F769Ax No    Yes   No   DFPU (368+16+128) 16+16
+ *
+ *   STM32F777Vx Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   STM32F777Zx Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   STM32F777Ix Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   STM32F777Bx Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   STM32F777Nx Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *
+ *   STM32F778Ax No    Yes   Yes  DFPU (368+16+128) 16+16
+ *
+ *   STM32F779Ix Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   STM32F779Bx Yes   Yes   Yes  DFPU (368+16+128) 16+16
+ *   STM32F779Nx Yes   Yes   Yes  DFPU (368+16+128) 16+16
+
+ *   STM32F779Ax No    Yes   Yes  DFPU (368+16+128) 16+16
+ *   ----------- ---- ----- ---- ----- ------------ ------
+
  * Parts STM32F72xxC & STM32F73xxC have 256Kb of FLASH
  * Parts STM32F72xxE & STM32F73xxE have 512Kb of FLASH
  * Parts STM32F74xxE have 512Kb of FLASH
  * Parts STM32F74xxG have 1024Kb of FLASH
  * Parts STM32F74xxI have 2048Kb of FLASH
  *
- * The correct FLASH size will be set CONFIG_STM32F7_FLASH_CONFIG_x or overridden
- * with CONFIG_STM32F7_FLASH_OVERRIDE_x
+ * The correct FLASH size will be set CONFIG_STM32F7_FLASH_CONFIG_x
+ * or overridden with CONFIG_STM32F7_FLASH_OVERRIDE_x
  *
  */
 #if defined(CONFIG_ARCH_CHIP_STM32F722RC) || \
@@ -374,7 +444,7 @@
 #define STM32F7_NDFSDM                     0   /* No Digital filters */
 #endif
 
-/* NVIC priority levels *********************************************************************************************/
+/* NVIC priority levels *****************************************************/
 
 /* 16 Programmable interrupt levels */
 
diff --git a/arch/arm/include/stm32f7/irq.h b/arch/arm/include/stm32f7/irq.h
index 2147d54..0b6624b 100644
--- a/arch/arm/include/stm32f7/irq.h
+++ b/arch/arm/include/stm32f7/irq.h
@@ -48,7 +48,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h b/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h
index 4ffc3c6..611c2a2 100644
--- a/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h
+++ b/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h
@@ -52,7 +52,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h b/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h
index d481351..4502fc5 100644
--- a/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h
+++ b/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h b/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h
index e3dd548..1e9cca9 100644
--- a/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h
+++ b/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32h7/chip.h b/arch/arm/include/stm32h7/chip.h
index eed4ab8..3c16e21 100644
--- a/arch/arm/include/stm32h7/chip.h
+++ b/arch/arm/include/stm32h7/chip.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32h7/chip.h
  *
  *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
@@ -32,20 +32,20 @@
  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_STM32H7_CHIP_H
 #define __ARCH_ARM_INCLUDE_STM32H7_CHIP_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* STM32H7x3xx  Differences between family members:
  *
@@ -65,8 +65,8 @@
  *
  * Parts STM32H7xxxI have 2048Kb of FLASH
  *
- * The correct FLASH size will be set CONFIG_STM32H7_FLASH_CONFIG_x or overridden
- * with CONFIG_STM32H7_FLASH_OVERRIDE_x
+ * The correct FLASH size will be set CONFIG_STM32H7_FLASH_CONFIG_x or
+ * overridden with CONFIG_STM32H7_FLASH_OVERRIDE_x
  */
 
 #if defined (CONFIG_ARCH_CHIP_STM32H743AG) || \
@@ -211,7 +211,7 @@
 #  define STM32H7_NFMC                     0   /* No FMC memory controller */
 #endif
 
-/* NVIC priority levels *************************************************************/
+/* NVIC priority levels *****************************************************/
 
 /* 16 Programmable interrupt levels */
 
diff --git a/arch/arm/include/stm32h7/irq.h b/arch/arm/include/stm32h7/irq.h
index 894f59d..54ec535 100644
--- a/arch/arm/include/stm32h7/irq.h
+++ b/arch/arm/include/stm32h7/irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32h7/stm32h7x3xx_irq.h b/arch/arm/include/stm32h7/stm32h7x3xx_irq.h
index 88ca875..5cb5496 100644
--- a/arch/arm/include/stm32h7/stm32h7x3xx_irq.h
+++ b/arch/arm/include/stm32h7/stm32h7x3xx_irq.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32h7/stm32h7x3xx_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,27 +16,33 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directly but, rather, only indirectly through arch/irq.h */
+/* This file should never be included directly but, rather,
+ * only indirectly through arch/irq.h
+ */
 
 #ifndef __ARCH_ARM_INCLUDE_STM32H7_STM32H7X3XX_IRQ_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to bits in the
- * NVIC.  This does, however, waste several words of memory in the IRQ to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits
+ * in the NVIC.
+ * This does, however, waste several words of memory in the IRQ to handle
+ * mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found in the file
- * nuttx/arch/arm/include/stm32h7/irq.h which includes this file
+ * Processor Exceptions (vectors 0-15).  These common definitions can be
+ * found in the file nuttx/arch/arm/include/stm32h7/irq.h which includes
+ * this file
  *
  * External interrupts (vectors >= 16)
  */
diff --git a/arch/arm/include/stm32h7/stm32h7x7xx_irq.h b/arch/arm/include/stm32h7/stm32h7x7xx_irq.h
index d52fb87..eee6850 100644
--- a/arch/arm/include/stm32h7/stm32h7x7xx_irq.h
+++ b/arch/arm/include/stm32h7/stm32h7x7xx_irq.h
@@ -31,7 +31,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32l4/chip.h b/arch/arm/include/stm32l4/chip.h
index 0d74e62..4ba5cfe 100644
--- a/arch/arm/include/stm32l4/chip.h
+++ b/arch/arm/include/stm32l4/chip.h
@@ -28,7 +28,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* STM32L475, STM32L476, STM32L486, STM32L496, STM32L4A6
diff --git a/arch/arm/include/stm32l4/irq.h b/arch/arm/include/stm32l4/irq.h
index 76bc1f0..dc259c7 100644
--- a/arch/arm/include/stm32l4/irq.h
+++ b/arch/arm/include/stm32l4/irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32l4/stm32l4x3xx_irq.h b/arch/arm/include/stm32l4/stm32l4x3xx_irq.h
index 69759bb..43360ee 100644
--- a/arch/arm/include/stm32l4/stm32l4x3xx_irq.h
+++ b/arch/arm/include/stm32l4/stm32l4x3xx_irq.h
@@ -49,7 +49,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32l4/stm32l4x5xx_irq.h b/arch/arm/include/stm32l4/stm32l4x5xx_irq.h
index 55baf3f..b1e7e92 100644
--- a/arch/arm/include/stm32l4/stm32l4x5xx_irq.h
+++ b/arch/arm/include/stm32l4/stm32l4x5xx_irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32l4/stm32l4x6xx_irq.h b/arch/arm/include/stm32l4/stm32l4x6xx_irq.h
index 003d6c9..b8f628c 100644
--- a/arch/arm/include/stm32l4/stm32l4x6xx_irq.h
+++ b/arch/arm/include/stm32l4/stm32l4x6xx_irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32l4/stm32l4xrxx_irq.h b/arch/arm/include/stm32l4/stm32l4xrxx_irq.h
index 54db53f..18a8b14 100644
--- a/arch/arm/include/stm32l4/stm32l4xrxx_irq.h
+++ b/arch/arm/include/stm32l4/stm32l4xrxx_irq.h
@@ -32,7 +32,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/stm32l5/chip.h b/arch/arm/include/stm32l5/chip.h
index 9d3c892..7bb1472 100644
--- a/arch/arm/include/stm32l5/chip.h
+++ b/arch/arm/include/stm32l5/chip.h
@@ -1,4 +1,4 @@
-/*****************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32l5/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- *****************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_STM32L5_CHIP_H
 #define __ARCH_ARM_INCLUDE_STM32L5_CHIP_H
 
-/*****************************************************************************
+/****************************************************************************
  * Included Files
- *****************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/*****************************************************************************
- * Pre-processor Definitions
- *****************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 #if defined(CONFIG_STM32L5_STM32L562XX)
 #  define STM32L5_SRAM1_SIZE       (192*1024)  /* 192Kb SRAM1 on AHB bus Matrix */
@@ -69,7 +69,7 @@
 #  define STM32L5_NOPAMP                   2   /* Operational Amplifiers */
 #endif /* CONFIG_STM32L5_STM32L562XX */
 
-/* NVIC priority levels ******************************************************/
+/* NVIC priority levels *****************************************************/
 
 /* 16 Programmable interrupt levels */
 
diff --git a/arch/arm/include/stm32l5/irq.h b/arch/arm/include/stm32l5/irq.h
index 2c2a334..8e03ede 100644
--- a/arch/arm/include/stm32l5/irq.h
+++ b/arch/arm/include/stm32l5/irq.h
@@ -1,4 +1,4 @@
-/*****************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32l5/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- *****************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directed but, rather,
  * only indirectly through nuttx/irq.h
@@ -25,9 +25,9 @@
 #ifndef __ARCH_ARM_INCLUDE_STM32L5_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32L5_IRQ_H
 
-/*****************************************************************************
+/****************************************************************************
  * Included Files
- *****************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
diff --git a/arch/arm/include/stm32l5/stm32l562xx_irq.h b/arch/arm/include/stm32l5/stm32l562xx_irq.h
index 6ec2933..97bf297 100644
--- a/arch/arm/include/stm32l5/stm32l562xx_irq.h
+++ b/arch/arm/include/stm32l5/stm32l562xx_irq.h
@@ -1,4 +1,4 @@
-/*****************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32l5/stm32l562xx_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,29 +16,29 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- *****************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_STM32L5_STM32L562XX_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32L5_STM32L562XX_IRQ_H
 
-/*****************************************************************************
+/****************************************************************************
  * Included Files
- *****************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/stm32l5/stm32l5_irq.h>
 
-/*****************************************************************************
- * Pre-processor Definitions
- *****************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
  * directly to bits in the NVIC.  This does, however, waste several words of
  * memory in the IRQ to handle mapping tables.
  *
- * Processor Exceptions (vectors 0-15).  These common definitions can be found
- * in the file nuttx/arch/arm/include/stm32l5/stm32l5_irq.h, which is included
- * above.
+ * Processor Exceptions (vectors 0-15). These common definitions can be found
+ * in the file nuttx/arch/arm/include/stm32l5/stm32l5_irq.h, which is
+ * included above.
  *
  * External interrupts (vectors >= 16)
  *
diff --git a/arch/arm/include/stm32l5/stm32l5_irq.h b/arch/arm/include/stm32l5/stm32l5_irq.h
index d57ab39..be3f9fe 100644
--- a/arch/arm/include/stm32l5/stm32l5_irq.h
+++ b/arch/arm/include/stm32l5/stm32l5_irq.h
@@ -1,4 +1,4 @@
-/*****************************************************************************
+/****************************************************************************
  * arch/arm/include/stm32l5/stm32l5_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,28 +16,30 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- *****************************************************************************/
+ ****************************************************************************/
 
-/* This file should never be included directed but, rather, only indirectly by
- * the chip type specific header files (e.g. stm32l562xx_irq.h)
+/* This file should never be included directed but, rather,
+ * only indirectly by the chip type specific header files
+ * (e.g. stm32l562xx_irq.h)
  */
 
 #ifndef __ARCH_ARM_INCLUDE_STM32L5_STM32L5_IRQ_H
 #define __ARCH_ARM_INCLUDE_STM32L5_STM32L5_IRQ_H
 
-/*****************************************************************************
+/****************************************************************************
  * Included Files
- *****************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/*****************************************************************************
- * Pre-processor Definitions
- *****************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map
- * directly to bits in the NVIC.  This does, however, waste several words of
- * memory in the IRQ to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to bits
+ * in the NVIC.  This does, however, waste several words of memory in the
+ * IRQ to handle mapping tables.
  */
 
 /* Processor Exceptions (vectors 0-15) */
@@ -57,17 +59,19 @@
 #define STM32L5_IRQ_PENDSV        (14) /* Vector 14: Pendable system service request */
 #define STM32L5_IRQ_SYSTICK       (15) /* Vector 15: System tick */
 
-/* External interrupts (vectors >= 16).  These definitions are chip-specific */
+/* External interrupts (vectors >= 16).
+ * These definitions are chip-specific
+ */
 
 #define STM32L5_IRQ_FIRST         (16) /* Vector number of the first external interrupt */
 
-/*****************************************************************************
+/****************************************************************************
  * Public Types
- *****************************************************************************/
+ ****************************************************************************/
 
-/*****************************************************************************
+/****************************************************************************
  * Public Data
- *****************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -78,9 +82,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/*****************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- *****************************************************************************/
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/str71x/irq.h b/arch/arm/include/str71x/irq.h
index 998409c..3c0e9f2 100644
--- a/arch/arm/include/str71x/irq.h
+++ b/arch/arm/include/str71x/irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/str71x/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,7 +16,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 /* This file should never be included directly but, rather,
  * only indirectly through nuttx/irq.h
@@ -25,15 +25,15 @@
 #ifndef __ARCH_ARM_INCLUDE_STR71X_IRQ_H
 #define __ARCH_ARM_INCLUDE_STR71X_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* IRQ channels */
 
@@ -106,13 +106,13 @@
 #define STR71X_FIQ_WDG        (0X00000002)
 #define STR71X_FIQ_WDGT0TIMIS (0X00000003)
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -123,9 +123,9 @@ extern "C"
 #define EXTERN extern
 #endif
 
-/************************************************************************************
- * Public Functions
- ************************************************************************************/
+/****************************************************************************
+ * Public Functions Prototypes
+ ****************************************************************************/
 
 #undef EXTERN
 #ifdef __cplusplus
diff --git a/arch/arm/include/syscall.h b/arch/arm/include/syscall.h
index 7651c21..ea1ee2e 100644
--- a/arch/arm/include/syscall.h
+++ b/arch/arm/include/syscall.h
@@ -46,7 +46,7 @@
 #endif
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /****************************************************************************
diff --git a/arch/arm/include/tiva/cc13x0_irq.h b/arch/arm/include/tiva/cc13x0_irq.h
index 95ac7d6..2a1a0b2 100644
--- a/arch/arm/include/tiva/cc13x0_irq.h
+++ b/arch/arm/include/tiva/cc13x0_irq.h
@@ -28,7 +28,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/tiva/cc13x2_cc26x2_irq.h b/arch/arm/include/tiva/cc13x2_cc26x2_irq.h
index 4cecf15..1ad68e9 100644
--- a/arch/arm/include/tiva/cc13x2_cc26x2_irq.h
+++ b/arch/arm/include/tiva/cc13x2_cc26x2_irq.h
@@ -28,7 +28,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* IRQ numbers.  The IRQ number corresponds vector number and hence map
diff --git a/arch/arm/include/tiva/chip.h b/arch/arm/include/tiva/chip.h
index f0813a1..0899ac3 100644
--- a/arch/arm/include/tiva/chip.h
+++ b/arch/arm/include/tiva/chip.h
@@ -45,7 +45,7 @@
 #include <nuttx/config.h>
 
 /****************************************************************************
- * Pre-processor Definitions
+ * Pre-processor Prototypes
  ****************************************************************************/
 
 /* Get customizations for each supported chip */
diff --git a/arch/arm/include/tiva/irq.h b/arch/arm/include/tiva/irq.h
index 68727b9..b77d7f5 100644
--- a/arch/arm/include/tiva/irq.h
+++ b/arch/arm/include/tiva/irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/tiva/irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,21 +16,21 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_TIVA_IRQ_H
 #define __ARCH_ARM_INCLUDE_TIVA_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 #include <arch/tiva/chip.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* Mark GPIO interrupts as disabled for non-existent GPIO ports. */
 
@@ -109,9 +109,9 @@
 
 #define TIVA_IRQ_INTERRUPTS (16) /* Vector number of the first external interrupt */
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #if defined(CONFIG_ARCH_CHIP_LM3S)
 #  include <arch/tiva/lm3s_irq.h>
@@ -127,16 +127,16 @@
 #  error "Unsupported Stellaris IRQ file"
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************/
+ ****************************************************************************/
 
 #endif /* __ARCH_ARM_INCLUDE_TIVA_IRQ_H */
diff --git a/arch/arm/include/tiva/lm3s_irq.h b/arch/arm/include/tiva/lm3s_irq.h
index 6d39590..1cf8c11 100644
--- a/arch/arm/include/tiva/lm3s_irq.h
+++ b/arch/arm/include/tiva/lm3s_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/tiva/lm3s_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,24 +16,25 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_TIVA_LM3S_IRQ_H
 #define __ARCH_ARM_INCLUDE_TIVA_LM3S_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* External interrupts (vectors >= 16) */
@@ -503,13 +504,13 @@
 
 #define NR_GPIO_IRQS          (_NGPIOTIRQS - NR_IRQS)
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -517,9 +518,9 @@ extern "C"
 {
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 }
diff --git a/arch/arm/include/tiva/lm4f_irq.h b/arch/arm/include/tiva/lm4f_irq.h
index ba81f6d..f7a287d8 100644
--- a/arch/arm/include/tiva/lm4f_irq.h
+++ b/arch/arm/include/tiva/lm4f_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/tiva/lm4f_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,24 +16,25 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_TIVA_LM4F_IRQ_H
 #define __ARCH_ARM_INCLUDE_TIVA_LM4F_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* External interrupts (vectors >= 16) */
@@ -334,13 +335,13 @@
 
 #define NR_GPIO_IRQS          (_NGPIOTIRQS - NR_IRQS)
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -348,9 +349,9 @@ extern "C"
 {
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Function Prototypes
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 }
diff --git a/arch/arm/include/tiva/tm4c_irq.h b/arch/arm/include/tiva/tm4c_irq.h
index df02a17..500cf09 100644
--- a/arch/arm/include/tiva/tm4c_irq.h
+++ b/arch/arm/include/tiva/tm4c_irq.h
@@ -1,4 +1,4 @@
-/************************************************************************************
+/****************************************************************************
  * arch/arm/include/tiva/tm4c_irq.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_TIVA_TM4C_IRQ_H
 #define __ARCH_ARM_INCLUDE_TIVA_TM4C_IRQ_H
 
-/************************************************************************************
+/****************************************************************************
  * Included Files
- ************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/************************************************************************************
- * Pre-processor Definitions
- ************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /* All of the TM4C123* part numbers in the following list basically have the
  * same set of interrupt vectors. However, each part number varies in
@@ -59,9 +59,10 @@
  * TM4C129ENCPDT, TM4C129ENCZAD, TM4C129LNCZAD, TM4C129XKCZAD, TM4C129XNCZAD.
  */
 
-/* IRQ numbers.  The IRQ number corresponds vector number and hence map directly to
- * bits in the NVIC.  This does, however, waste several words of memory in the IRQ
- * to handle mapping tables.
+/* IRQ numbers.
+ * The IRQ number corresponds vector number and hence map directly to
+ * bits in the NVIC.  This does, however, waste several words of memory in
+ * the IRQ to handle mapping tables.
  */
 
 /* External interrupts (vectors >= 16) */
@@ -1487,13 +1488,13 @@
 
 #define NR_GPIO_IRQS          (_NGPIOQIRQS - NR_IRQS)
 
-/************************************************************************************
+/****************************************************************************
  * Public Types
- ************************************************************************************/
+ ****************************************************************************/
 
-/************************************************************************************
+/****************************************************************************
  * Public Data
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ASSEMBLY__
 #ifdef __cplusplus
@@ -1501,9 +1502,9 @@ extern "C"
 {
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Public Function Prototypess
- ************************************************************************************/
+ ****************************************************************************/
 
 #ifdef __cplusplus
 }
diff --git a/arch/arm/include/tms570/chip.h b/arch/arm/include/tms570/chip.h
index bf2edcf..cd1a334 100644
--- a/arch/arm/include/tms570/chip.h
+++ b/arch/arm/include/tms570/chip.h
@@ -1,4 +1,4 @@
-/****************************************************************************************************
+/****************************************************************************
  * arch/arm/include/tms570/chip.h
  *
  * Licensed to the Apache Software Foundation (ASF) under one or more
@@ -16,20 +16,20 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  *
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #ifndef __ARCH_ARM_INCLUDE_TMS570_CHIP_H
 #define __ARCH_ARM_INCLUDE_TMS570_CHIP_H
 
-/****************************************************************************************************
+/****************************************************************************
  * Included Files
- ****************************************************************************************************/
+ ****************************************************************************/
 
 #include <nuttx/config.h>
 
-/****************************************************************************************************
- * Pre-processor Definitions
- ****************************************************************************************************/
+/****************************************************************************
+ * Pre-processor Prototypes
+ ****************************************************************************/
 
 /*                 TMS570LS0432PZ TMS570LS0332PZ TMS570LS0232PZ
  * Package         100 QFP        100 QFP        100 QFP
@@ -167,29 +167,53 @@
 #  undef  TMS570_RTP                     /* No RAM trace port (RTP) */
 #  undef  TMS570_DMM                     /* No DMM */
 
-/*                 TMS570LS1227ZWT TMS570LS0714ZWT TMS570LS0714PGE TMS570LS0714PZ
- * Package         337 BGA         337 BGA         144 QFP         100 QFP
- * CPU             ARM Cortex-R4F  ARM Cortex-R4F  ARM Cortex-R4F  ARM Cortex-R4F
- * Frequency (MHz) 180             180             160             100
- * Flash (KB)      1280            768             768             768
- * RAM (KB)        192             128             128             128
- * Data Flash (KB) 64              64              64              64
- * EMAC            10/100          –               –               –
- * FlexRay         2-ch            –               –               –
- * CAN             3               3               3               2
- * MibADC (CH)     2 (24)          2 (24)          2 (24)          2 (16)
- * N2HET (Ch)      2 (44)          2 (44)          2 (40)          2 (21)
- * ePWM Channels   14              14              14              8
- * eCAP Channels   6               6               6               4
- * eQEP Channels   2               2               2               1
- * MibSPI (CS)     3 (6+6+4)       3 (6+6+4)       3 (5+6+4)       2 (5+1)
- * SPI (CS)        2 (2+1)         2 (2+1)         1 (1)           1 (1)
- * SCI (LIN)       2 (1)           2 (1)           2 (1)           1 (1)
- * I2C             1               1               1               –
- * GPIO (INT)      101 (16)        101 (16)        64 (10)         45 (9)
- * EMIF            16-bit data     –               –               –
- * ETM (Trace)     –               –               –               –
- * RTP/DMM         –               –               –               –
+/*                 TMS570LS1227ZWT TMS570LS0714ZWT
+ * Package         337 BGA         337 BGA
+ * CPU             ARM Cortex-R4F  ARM Cortex-R4F
+ * Frequency (MHz) 180             180
+ * Flash (KB)      1280            768
+ * RAM (KB)        192             128
+ * Data Flash (KB) 64              64
+ * EMAC            10/100          –
+ * FlexRay         2-ch            –
+ * CAN             3               3
+ * MibADC (CH)     2 (24)          2 (24)
+ * N2HET (Ch)      2 (44)          2 (44)
+ * ePWM Channels   14              14
+ * eCAP Channels   6               6
+ * eQEP Channels   2               2
+ * MibSPI (CS)     3 (6+6+4)       3 (6+6+4)
+ * SPI (CS)        2 (2+1)         2 (2+1)
+ * SCI (LIN)       2 (1)           2 (1)
+ * I2C             1               1
+ * GPIO (INT)      101 (16)        101 (16)
+ * EMIF            16-bit data     –
+ * ETM (Trace)     –               –
+ * RTP/DMM         –               –
+ *
+ *                 TMS570LS0714PGE TMS570LS0714PZ
+ * Package         144 QFP         100 QFP
+ * CPU             ARM Cortex-R4F  ARM Cortex-R4F
+ * Frequency (MHz) 160             100
+ * Flash (KB)      768             768
+ * RAM (KB)        128             128
+ * Data Flash (KB) 64              64
+ * EMAC            –               –
+ * FlexRay         –               –
+ * CAN             3               2
+ * MibADC (CH)     2 (24)          2 (16)
+ * N2HET (Ch)      2 (40)          2 (21)
+ * ePWM Channels   14              8
+ * eCAP Channels   6               4
+ * eQEP Channels   2               1
+ * MibSPI (CS)     3 (5+6+4)       2 (5+1)
+ * SPI (CS)        1 (1)           1 (1)
+ * SCI (LIN)       2 (1)           1 (1)
+ * I2C             1               –
+ * GPIO (INT)      64 (10)         45 (9)
+ * EMIF            –               –
+ * ETM (Trace)     –               –
+ * RTP/DMM         –               –
  */
 
 #elif defined(CONFIG_ARCH_CHIP_TMS570LS0714PZ)
diff --git a/arch/arm/include/tms570/irq.h b/arch/arm/include/tms570/irq.h
... 482 lines suppressed ...