Update - adjust /pins comments

Author: classicrocker883

Marlin/src/pins/pins.h

@@ -22,9 +22,7 @@
 #pragma once
 
 /**
- * File: pins/pins.h
- *
- * Include pins definitions
+ * pins.h - Include pins definitions
  *
  * Pins numbering schemes:
  *

Marlin/src/pins/pinsDebug.h

@@ -27,14 +27,14 @@
                                // "-" left justify, "39" minimum width of name, pad with blanks
 
 /**
- *  This routine minimizes RAM usage by creating a FLASH resident array to
- *  store the pin names, pin numbers and analog/digital flag.
+ * This routine minimizes RAM usage by creating a FLASH resident array to
+ * store the pin names, pin numbers and analog/digital flag.
  *
- *  Creating the array in FLASH is a two pass process.  The first pass puts the
- *  name strings into FLASH.  The second pass actually creates the array.
+ * Creating the array in FLASH is a two pass process.  The first pass puts the
+ * name strings into FLASH.  The second pass actually creates the array.
  *
- *  Both passes use the same pin list.  The list contains two macro names. The
- *  actual macro definitions are changed depending on which pass is being done.
+ * Both passes use the same pin list.  The list contains two macro names. The
+ * actual macro definitions are changed depending on which pass is being done.
  */
 
 // first pass - put the name strings into FLASH
@@ -90,12 +90,12 @@ typedef struct {
 const PinInfo pin_array[] PROGMEM = {
 
   /**
-   *  [pin name]  [pin number]  [is digital or analog]  1 = digital, 0 = analog
-   *  Each entry takes up 6 bytes in FLASH:
-   *     2 byte pointer to location of the name string
-   *     2 bytes containing the pin number
-   *         analog pin numbers were converted to digital when the array was created
-   *     2 bytes containing the digital/analog bool flag
+   * [pin name]  [pin number]  [is digital or analog]  1 = digital, 0 = analog
+   * Each entry takes up 6 bytes in FLASH:
+   *    2 byte pointer to location of the name string
+   *    2 bytes containing the pin number
+   *        analog pin numbers were converted to digital when the array was created
+   *    2 bytes containing the digital/analog bool flag
    */
 
   #if SERIAL_IN_USE(0)

Marlin/src/pins/pinsDebug_list.h

@@ -20,10 +20,12 @@
  *
  */
 
-// Please update this list when adding new pins to Marlin.
-// The order doesn't matter.
-// Following this pattern is a must.
-// If the new pin name is over 28 characters long then pinsDebug.h will need to be modified.
+/**
+ * Please update this list when adding new pins to Marlin.
+ * The order doesn't matter.
+ * Following this pattern is a must.
+ * If the new pin name is over 28 characters long then pinsDebug.h will need to be modified.
+ */
 
 #if TARGET_LPC1768
   #define ANALOG_OK(PN) (WITHIN(PN, P0_02, P0_03) || WITHIN(PN, P0_23, P0_26) || WITHIN(PN, P1_30, P1_31))
@@ -38,7 +40,6 @@
 //
 // Analog Pin Assignments
 //
-
 #define _EXISTS(PN,V...) (defined(PN##V) && PN##V >= 0)
 
 #if _EXISTS(EXT_AUX_A0)
@@ -177,7 +178,6 @@
 //
 // Digital Pin Assignments
 //
-
 #if _EXISTS(__FD)
   REPORT_NAME_DIGITAL(__LINE__, __FD)
 #endif

Marlin/src/pins/pins_postprocess.h

@@ -21,12 +21,13 @@
  */
 #pragma once
 
-//
-// File: pins/pins_postprocess.h
-// Post-process pins according to configured settings
-//
+/**
+ * pins_postprocess.h - Post-process pins according to configured settings
+ */
 
+//
 // Define certain undefined pins
+//
 #ifndef X_MS1_PIN
   #define X_MS1_PIN -1
 #endif
@@ -627,7 +628,6 @@
 //
 // Assign endstop pins, with handling for boards that have only 3 connectors
 //
-
 #if HAS_X_AXIS
   #if PIN_EXISTS(X_STOP)
     #if X_HOME_TO_MIN

Marlin/src/pins/sensitive_pins.h

@@ -23,12 +23,13 @@
 
 #include <stdint.h>
 
-//
-// Define unsorted and arrays of pins which may have duplicstes,
-// but don't allocate any runtime memory for these arrays.
-// We'll use constexpr functions to get the Nth distinct value,
-// and return -1 if we go past the end of the array.
-//
+/**
+ * Define unsorted and arrays of pins which may have duplicstes,
+ * but don't allocate any runtime memory for these arrays.
+ * We'll use constexpr functions to get the Nth distinct value,
+ * and return -1 if we go past the end of the array.
+ */
+
 constexpr pin_t sensitive_dio[] PROGMEM = {
 
   #if HAS_X_AXIS
@@ -558,12 +559,12 @@ constexpr pin_t sensitive_dio[] PROGMEM = {
   #endif
 
   #if TEMP_SENSOR_COOLER && PIN_EXISTS(TEMP_COOLER)
-    #if PIN_EXISTS(COOLER_AUTO_FAN)
-      COOLER_AUTO_FAN_PIN,
-    #endif
     #if PIN_EXISTS(COOLER)
       COOLER_PIN,
     #endif
+    #if PIN_EXISTS(COOLER_AUTO_FAN)
+      COOLER_AUTO_FAN_PIN,
+    #endif
   #endif
 
   #ifdef HAL_SENSITIVE_PINS