From 2b88bc711901102e7093d13a05328c97f238318a Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Sat, 3 Oct 2015 07:41:15 -0600 Subject: [PATCH] Standardize the width of all comment boxes in C header files --- configs/arduino-due/src/arduino-due.h | 2 +- configs/lpc4330-xplorer/include/board.h | 2 +- configs/lpc4357-evb/include/board.h | 2 +- configs/lpc4370-link2/include/board.h | 2 +- .../olimex-stm32-h405/src/olimex-stm32-h405.h | 12 +++--- configs/olimex-stm32-p107/src/p107-internal.h | 12 +++--- .../olimex-stm32-p207/src/olimex-stm32-p207.h | 12 +++--- configs/stm32f429i-disco/src/stm32_lcd.c | 36 +++++++++--------- .../stm32f429i-disco/src/stm32f429i-disco.h | 6 +-- .../stm32vldiscovery/src/stm32vldiscovery.h | 4 +- configs/teensy-lc/src/teensy-lc.h | 38 +++++++++---------- .../src/viewtool_stm32f107.h | 38 +++++++++---------- 12 files changed, 83 insertions(+), 83 deletions(-) diff --git a/configs/arduino-due/src/arduino-due.h b/configs/arduino-due/src/arduino-due.h index b63585c3e2..68be762271 100644 --- a/configs/arduino-due/src/arduino-due.h +++ b/configs/arduino-due/src/arduino-due.h @@ -326,7 +326,7 @@ void sam_sram_initialize(void); * Description: * Initialize the SPI-based SD card. * - *****************************************************************************/ + ****************************************************************************/ #if defined(CONFIG_ARDUINO_ITHEAD_TFT) && defined(CONFIG_SPI_BITBANG) && \ defined(CONFIG_MMCSD_SPI) diff --git a/configs/lpc4330-xplorer/include/board.h b/configs/lpc4330-xplorer/include/board.h index 7afc2b1684..82f14ccecf 100644 --- a/configs/lpc4330-xplorer/include/board.h +++ b/configs/lpc4330-xplorer/include/board.h @@ -315,7 +315,7 @@ extern "C" { EXTERN void lpc43_boardinitialize(void); -/***************************************************************************** +/**************************************************************************** * Name: lpc43_ledinit, lpc43_setled, and lpc43_setleds * * Description: diff --git a/configs/lpc4357-evb/include/board.h b/configs/lpc4357-evb/include/board.h index 6747bc79db..5f418a876c 100644 --- a/configs/lpc4357-evb/include/board.h +++ b/configs/lpc4357-evb/include/board.h @@ -320,7 +320,7 @@ extern "C" { EXTERN void lpc43_boardinitialize(void); -/***************************************************************************** +/**************************************************************************** * Name: lpc43_ledinit, lpc43_setled, and lpc43_setleds * * Description: diff --git a/configs/lpc4370-link2/include/board.h b/configs/lpc4370-link2/include/board.h index 900db25684..0ba0d3f84e 100644 --- a/configs/lpc4370-link2/include/board.h +++ b/configs/lpc4370-link2/include/board.h @@ -304,7 +304,7 @@ extern "C" { EXTERN void lpc43_boardinitialize(void); -/***************************************************************************** +/**************************************************************************** * Name: lpc43_ledinit, lpc43_setled, and lpc43_setleds * * Description: diff --git a/configs/olimex-stm32-h405/src/olimex-stm32-h405.h b/configs/olimex-stm32-h405/src/olimex-stm32-h405.h index bd9c235e6b..165f124949 100644 --- a/configs/olimex-stm32-h405/src/olimex-stm32-h405.h +++ b/configs/olimex-stm32-h405/src/olimex-stm32-h405.h @@ -1,4 +1,4 @@ -/****************************************************************************** +/**************************************************************************** * configs/olimex-stm32-h405/src/olimex-stm32-h405.h * * Copyright (C) 2014 Max Holtzberg. All rights reserved. @@ -31,22 +31,22 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ******************************************************************************/ + ****************************************************************************/ #ifndef __CONFIGS_OLIMEX_STM32_H405_SRC_INTERNAL_H #define __CONFIGS_OLIMEX_STM32_H405_SRC_INTERNAL_H -/****************************************************************************** +/**************************************************************************** * Included Files - ******************************************************************************/ + ****************************************************************************/ #include #include #include -/****************************************************************************** +/**************************************************************************** * Pre-processor Definitions - ******************************************************************************/ + ****************************************************************************/ /* Olimex-STM32-P405 GPIOs ****************************************************/ /* LEDs */ diff --git a/configs/olimex-stm32-p107/src/p107-internal.h b/configs/olimex-stm32-p107/src/p107-internal.h index 02e94ebf13..ad61bb5ef8 100644 --- a/configs/olimex-stm32-p107/src/p107-internal.h +++ b/configs/olimex-stm32-p107/src/p107-internal.h @@ -1,4 +1,4 @@ -/****************************************************************************** +/**************************************************************************** * configs/olimex-stm32-p107/src/p107-internal.h * * Copyright (C) 2013 Max Holtzberg. All rights reserved. @@ -31,21 +31,21 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ******************************************************************************/ + ****************************************************************************/ #ifndef __CONFIGS_OLIMEX_STM32_P107_SRC_INTERNAL_H #define __CONFIGS_OLIMEX_STM32_P107_SRC_INTERNAL_H -/****************************************************************************** +/**************************************************************************** * Included Files - ******************************************************************************/ + ****************************************************************************/ #include #include #include -/****************************************************************************** +/**************************************************************************** * Pre-processor Definitions - ******************************************************************************/ + ****************************************************************************/ /* Olimex MOD-ENC624J600 Module * diff --git a/configs/olimex-stm32-p207/src/olimex-stm32-p207.h b/configs/olimex-stm32-p207/src/olimex-stm32-p207.h index 15ab0aeb58..543071232c 100644 --- a/configs/olimex-stm32-p207/src/olimex-stm32-p207.h +++ b/configs/olimex-stm32-p207/src/olimex-stm32-p207.h @@ -1,4 +1,4 @@ -/****************************************************************************** +/**************************************************************************** * configs/olimex-stm32-p107/src/olimex-stm32-p207.h * * Copyright (C) 2013 Max Holtzberg. All rights reserved. @@ -31,22 +31,22 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ******************************************************************************/ + ****************************************************************************/ #ifndef __CONFIGS_OLIMEX_STM32_P207_SRC_INTERNAL_H #define __CONFIGS_OLIMEX_STM32_P207_SRC_INTERNAL_H -/****************************************************************************** +/**************************************************************************** * Included Files - ******************************************************************************/ + ****************************************************************************/ #include #include #include -/****************************************************************************** +/**************************************************************************** * Pre-processor Definitions - ******************************************************************************/ + ****************************************************************************/ /* Olimex-STM32-P207 GPIOs ****************************************************/ /* LEDs */ diff --git a/configs/stm32f429i-disco/src/stm32_lcd.c b/configs/stm32f429i-disco/src/stm32_lcd.c index 07fc6fb271..884ce0e31b 100644 --- a/configs/stm32f429i-disco/src/stm32_lcd.c +++ b/configs/stm32f429i-disco/src/stm32_lcd.c @@ -279,9 +279,9 @@ #define ILI9341_YRES BOARD_LTDC_HEIGHT #endif /* CONFIG_STM32F429I_DISCO_ILI9341_FBIFACE */ -/**************************************************************************** +/************************************************************************************ * Private Data - ****************************************************************************/ + ************************************************************************************/ #ifdef CONFIG_STM32F429I_DISCO_ILI9341_LCDIFACE FAR struct lcd_dev_s *g_lcd = NULL; @@ -296,13 +296,13 @@ FAR struct ili9341_lcd_s *g_ltdc = NULL; ************************************************************************************/ #ifdef CONFIG_STM32F429I_DISCO_ILI9341_FBIFACE -/**************************************************************************** +/************************************************************************************ * Name: stm32_ili9341_initialize * * Description: * Initialize the ili9341 LCD controller to the RGB interface mode. * - ****************************************************************************/ + ************************************************************************************/ static int stm32_ili9341_initialize(void) { @@ -413,7 +413,7 @@ static int stm32_ili9341_initialize(void) ************************************************************************************/ #ifdef CONFIG_STM32F429I_DISCO_ILI9341_LCDIFACE -/**************************************************************************** +/************************************************************************************ * Name: board_lcd_uninitialize * * Description: @@ -423,7 +423,7 @@ static int stm32_ili9341_initialize(void) * * Return: * - ****************************************************************************/ + ************************************************************************************/ void board_lcd_uninitialize(void) { @@ -435,7 +435,7 @@ void board_lcd_uninitialize(void) } -/**************************************************************************** +/************************************************************************************ * Name: board_lcd_getdev * * Description: @@ -448,7 +448,7 @@ void board_lcd_uninitialize(void) * Return: * Reference to the LCD object if exist otherwise NULL * - ****************************************************************************/ + ************************************************************************************/ FAR struct lcd_dev_s *board_lcd_getdev(int lcddev) { @@ -461,7 +461,7 @@ FAR struct lcd_dev_s *board_lcd_getdev(int lcddev) } -/**************************************************************************** +/************************************************************************************ * Name: board_lcd_initialize * * Description: @@ -475,7 +475,7 @@ FAR struct lcd_dev_s *board_lcd_getdev(int lcddev) * On success - Ok * On error - Error Code * - ****************************************************************************/ + ************************************************************************************/ int board_lcd_initialize(void) { @@ -512,7 +512,7 @@ int board_lcd_initialize(void) #endif /* CONFIG_STM32F429I_DISCO_ILI9341_LCDIFACE */ #ifdef CONFIG_STM32_LTDC -/**************************************************************************** +/************************************************************************************ * Name: up_fbinitialize * * Description: @@ -521,7 +521,7 @@ int board_lcd_initialize(void) * Return: * OK - On succes * - ****************************************************************************/ + ************************************************************************************/ int up_fbinitialize(void) { @@ -546,7 +546,7 @@ int up_fbinitialize(void) #endif } -/**************************************************************************** +/************************************************************************************ * Name: up_fbgetvplane * * Description: @@ -558,27 +558,27 @@ int up_fbinitialize(void) * Return: * Reference to the fb_vtable_s on success otherwise NULL. * - ****************************************************************************/ + ************************************************************************************/ FAR struct fb_vtable_s *up_fbgetvplane(int vplane) { return stm32_ltdcgetvplane(vplane); } -/**************************************************************************** +/************************************************************************************ * Name: up_uninitialize * * Description: * The generic method to uninitialize the framebuffer device * - ****************************************************************************/ + ************************************************************************************/ void fb_uninitialize(void) { stm32_ltdcuninitialize(); } -/**************************************************************************** +/************************************************************************************ * Name: up_ltdcgetlayer * * Description: @@ -588,7 +588,7 @@ void fb_uninitialize(void) * Parameter: * lid - The specific layer identifier * - ****************************************************************************/ + ************************************************************************************/ #ifdef CONFIG_STM32_LTDC_INTERFACE FAR struct ltdc_layer_s *up_ltdcgetlayer(int lid) diff --git a/configs/stm32f429i-disco/src/stm32f429i-disco.h b/configs/stm32f429i-disco/src/stm32f429i-disco.h index 29caf9ff7a..c4c6d21c18 100644 --- a/configs/stm32f429i-disco/src/stm32f429i-disco.h +++ b/configs/stm32f429i-disco/src/stm32f429i-disco.h @@ -234,13 +234,13 @@ void stm32_pmbuttons(void); * for the specified ILI9341 LCD Single chip driver connected as 4 wire serial * (spi). NULL is returned on any failure. * - ******************************************************************************/ + ****************************************************************************/ FAR struct ili9341_lcd_s *stm32_ili93414ws_initialize(void); #endif #ifdef CONFIG_STM32_SPI5 -/****************************************************************************** +/**************************************************************************** * Name: stm32_spi5initialize * * Description: @@ -259,7 +259,7 @@ FAR struct ili9341_lcd_s *stm32_ili93414ws_initialize(void); * Returned Value: * Valid SPI device structure reference on succcess; a NULL on failure * - ******************************************************************************/ + ****************************************************************************/ FAR struct spi_dev_s *stm32_spi5initialize(void); #endif diff --git a/configs/stm32vldiscovery/src/stm32vldiscovery.h b/configs/stm32vldiscovery/src/stm32vldiscovery.h index 46f0bf685a..49b945b527 100644 --- a/configs/stm32vldiscovery/src/stm32vldiscovery.h +++ b/configs/stm32vldiscovery/src/stm32vldiscovery.h @@ -37,9 +37,9 @@ #ifndef __CONFIGS_STM32VL_DISCOVERY_SRC_STM32VLDISCOVERY_H #define __CONFIGS_STM32VL_DISCOVERY_SRC_STM32VLDISCOVERY_H -/***************************************************************************** +/**************************************************************************** * Pre-processor Definitions - *****************************************************************************/ + ****************************************************************************/ /* LED - assume it is on PC8 */ diff --git a/configs/teensy-lc/src/teensy-lc.h b/configs/teensy-lc/src/teensy-lc.h index 1df8766feb..842d5f9fe0 100644 --- a/configs/teensy-lc/src/teensy-lc.h +++ b/configs/teensy-lc/src/teensy-lc.h @@ -1,4 +1,4 @@ -/***************************************************************************** +/**************************************************************************** * configs/teensy-lc/src/teensy-lc.h * * Copyright (C) 2015 Gregory Nutt. All rights reserved. @@ -31,61 +31,61 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - *****************************************************************************/ + ****************************************************************************/ #ifndef __CONFIGS_TEENSY_LC_SRC_TEENSY_LC_H #define __CONFIGS_TEENSY_LC_SRC_TEENSY_LC_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include #include #include -/***************************************************************************** +/**************************************************************************** * Pre-processor Definitions - *****************************************************************************/ -/* Configuration *************************************************************/ + ****************************************************************************/ +/* Configuration ************************************************************/ #define GPIO_LED (GPIO_OUTPUT | GPIO_OUTPUT_ONE | PIN_PORTC | PIN5) -/* Button definitions ********************************************************/ +/* Button definitions *******************************************************/ -/* Chip selects **************************************************************/ +/* Chip selects *************************************************************/ -/***************************************************************************** +/**************************************************************************** * Public Types - *****************************************************************************/ + ****************************************************************************/ -/***************************************************************************** +/**************************************************************************** * Public data - *****************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/***************************************************************************** +/**************************************************************************** * Public Functions - *****************************************************************************/ + ****************************************************************************/ -/***************************************************************************** +/**************************************************************************** * Name: kl_spiinitialize * * Description: * Called to configure SPI chip select GPIO pins for the Freedom KL25Z board. * - *****************************************************************************/ + ****************************************************************************/ void weak_function kl_spiinitialize(void); -/***************************************************************************** +/**************************************************************************** * Name: kl_ledinit * * Description: * Initialize the on-board LED * - *****************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_ARCH_LEDS void kl_ledinit(void); diff --git a/configs/viewtool-stm32f107/src/viewtool_stm32f107.h b/configs/viewtool-stm32f107/src/viewtool_stm32f107.h index 9ee6eabdd5..294f198c7f 100644 --- a/configs/viewtool-stm32f107/src/viewtool_stm32f107.h +++ b/configs/viewtool-stm32f107/src/viewtool_stm32f107.h @@ -1,4 +1,4 @@ -/****************************************************************************** +/**************************************************************************** * configs/viewtool-stm32f107/src/viewtool_stm32f107.h * * Copyright (C) 2013-2014 Gregory Nutt. All rights reserved. @@ -31,23 +31,23 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ******************************************************************************/ + ****************************************************************************/ #ifndef __CONFIGS_VIEWTOOL_STM32F107_SRC_INTERNAL_H #define __CONFIGS_VIEWTOOL_STM32F107_SRC_INTERNAL_H -/****************************************************************************** +/**************************************************************************** * Included Files - ******************************************************************************/ + ****************************************************************************/ #include #include #include -/****************************************************************************** +/**************************************************************************** * Pre-processor Definitions - ******************************************************************************/ -/* Configuration **************************************************************/ + ****************************************************************************/ +/* Configuration ************************************************************/ /* Assume that everything is supported */ #define HAVE_USBDEV 1 @@ -91,7 +91,7 @@ #define VIEWTOOL_MMCSD_SLOTNO 0 -/* GPIO Configuration *********************************************************/ +/* GPIO Configuration *******************************************************/ /* LEDs * * There are four LEDs on the ViewTool STM32F103/F107 board that can be controlled @@ -114,7 +114,7 @@ GPIO_OUTPUT_SET | GPIO_PORTB | GPIO_PIN13) -/* Buttons **************************************************************************/ +/* Buttons ******************************************************************/ /* All pulled high and will be sensed low when depressed. * * SW2 PC11 Needs J42 closed @@ -285,19 +285,19 @@ #define GPIO_MPL115A_CS (GPIO_OUTPUT | GPIO_CNF_OUTPP | GPIO_MODE_50MHz | \ GPIO_OUTPUT_SET | GPIO_PORTB | GPIO_PIN6) -/************************************************************************************ +/**************************************************************************** * Public Functions - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/************************************************************************************ +/**************************************************************************** * Name: stm32_spiinitialize * * Description: * Called to configure SPI chip select GPIO pins for the M3 Wildfire board. * - ************************************************************************************/ + ****************************************************************************/ void weak_function stm32_spiinitialize(void); @@ -311,31 +311,31 @@ void weak_function stm32_spiinitialize(void); void stm32_ledinit(void); -/************************************************************************************ +/**************************************************************************** * Name: stm32_usbdev_initialize * * Description: * Called from stm32_usbdev_initialize very early in initialization to setup USB-related * GPIO pins for the Viewtool STM32F107 board. * - ************************************************************************************/ + ****************************************************************************/ #if defined(CONFIG_STM32_OTGFS) && defined(CONFIG_USBDEV) void weak_function stm32_usbdev_initialize(void); #endif -/************************************************************************************ +/**************************************************************************** * Name: stm32_sdinitialize * * Description: * Initialize the SPI-based SD card. Requires CONFIG_DISABLE_MOUNTPOINT=n * and CONFIG_STM32_SPI1=y * - ************************************************************************************/ + ****************************************************************************/ int stm32_sdinitialize(int minor); -/************************************************************************************ +/**************************************************************************** * Name: stm32_mpl115ainitialize * * Description: @@ -347,7 +347,7 @@ int stm32_sdinitialize(int minor); * Returned Value: * Zero (OK) on success; a negated errno value on failure. * - ************************************************************************************/ + ****************************************************************************/ #if defined(CONFIG_SPI) && defined(CONFIG_MPL115A) && defined(CONFIG_STM32_SPI3) int stm32_mpl115ainitialize(FAR const char *devpath);