Use consistent line wrapping in built-in example comments

Author: per1234

examples/01.Basics/Blink/Blink.ino

@@ -6,8 +6,9 @@
   Most Arduinos have an on-board LED you can control. On the UNO, MEGA and ZERO
   it is attached to digital pin 13, on MKR1000 on pin 6. LED_BUILTIN is set to
   the correct LED pin independent of which board is used.
-  If you want to know what pin the on-board LED is connected to on your Arduino model, check
-  the Technical Specs of your board at https://www.arduino.cc/en/Main/Products
+  If you want to know what pin the on-board LED is connected to on your Arduino
+  model, check the Technical Specs of your board at:
+  https://www.arduino.cc/en/Main/Products
 
   modified 8 May 2014
   by Scott Fitzgerald

examples/01.Basics/Fade/Fade.ino

@@ -1,14 +1,12 @@
 /*
   Fade
 
-  This example shows how to fade an LED on pin 9
-  using the analogWrite() function.
-
-  The analogWrite() function uses PWM, so if
-  you want to change the pin you're using, be
-  sure to use another PWM capable pin. On most
-  Arduino, the PWM pins are identified with
-  a "~" sign, like ~3, ~5, ~6, ~9, ~10 and ~11.
+  This example shows how to fade an LED on pin 9 using the analogWrite()
+  function.
+
+  The analogWrite() function uses PWM, so if you want to change the pin you're
+  using, be sure to use another PWM capable pin. On most Arduino, the PWM pins
+  are identified with a "~" sign, like ~3, ~5, ~6, ~9, ~10 and ~11.
 
   This example code is in the public domain.
 

examples/02.Digital/BlinkWithoutDelay/BlinkWithoutDelay.ino

@@ -1,17 +1,18 @@
 /*
   Blink without Delay
 
-  Turns on and off a light emitting diode (LED) connected to a digital
-  pin, without using the delay() function. This means that other code
-  can run at the same time without being interrupted by the LED code.
+  Turns on and off a light emitting diode (LED) connected to a digital pin,
+  without using the delay() function. This means that other code can run at the
+  same time without being interrupted by the LED code.
 
   The circuit:
   - Use the onboard LED.
-  - Note: Most Arduinos have an on-board LED you can control. On the UNO, MEGA and ZERO
-    it is attached to digital pin 13, on MKR1000 on pin 6. LED_BUILTIN is set to
-    the correct LED pin independent of which board is used.
-    If you want to know what pin the on-board LED is connected to on your Arduino model, check
-    the Technical Specs of your board at https://www.arduino.cc/en/Main/Products
+  - Note: Most Arduinos have an on-board LED you can control. On the UNO, MEGA
+    and ZERO it is attached to digital pin 13, on MKR1000 on pin 6. LED_BUILTIN
+    is set to the correct LED pin independent of which board is used.
+    If you want to know what pin the on-board LED is connected to on your
+    Arduino model, check the Technical Specs of your board at:
+    https://www.arduino.cc/en/Main/Products
 
   created 2005
   by David A. Mellis
@@ -48,10 +49,9 @@ void setup() {
 void loop() {
   // here is where you'd put code that needs to be running all the time.
 
-  // check to see if it's time to blink the LED; that is, if the
-  // difference between the current time and last time you blinked
-  // the LED is bigger than the interval at which you want to
-  // blink the LED.
+  // check to see if it's time to blink the LED; that is, if the difference
+  // between the current time and last time you blinked the LED is bigger than
+  // the interval at which you want to blink the LED.
   unsigned long currentMillis = millis();
 
   if (currentMillis - previousMillis >= interval) {

examples/02.Digital/Button/Button.ino

@@ -1,8 +1,8 @@
 /*
   Button
 
-  Turns on and off a light emitting diode(LED) connected to digital
-  pin 13, when pressing a pushbutton attached to pin 2.
+  Turns on and off a light emitting diode(LED) connected to digital pin 13,
+  when pressing a pushbutton attached to pin 2.
 
   The circuit:
   - LED attached from pin 13 to ground
@@ -22,8 +22,7 @@
   http://www.arduino.cc/en/Tutorial/Button
 */
 
-// constants won't change. They're used here to
-// set pin numbers:
+// constants won't change. They're used here to set pin numbers:
 const int buttonPin = 2;     // the number of the pushbutton pin
 const int ledPin =  13;      // the number of the LED pin
 
@@ -41,8 +40,7 @@ void loop() {
   // read the state of the pushbutton value:
   buttonState = digitalRead(buttonPin);
 
-  // check if the pushbutton is pressed.
-  // if it is, the buttonState is HIGH:
+  // check if the pushbutton is pressed. If it is, the buttonState is HIGH:
   if (buttonState == HIGH) {
     // turn LED on:
     digitalWrite(ledPin, HIGH);

examples/02.Digital/Debounce/Debounce.ino

@@ -2,17 +2,16 @@
   Debounce
 
   Each time the input pin goes from LOW to HIGH (e.g. because of a push-button
-  press), the output pin is toggled from LOW to HIGH or HIGH to LOW. There's
-  a minimum delay between toggles to debounce the circuit (i.e. to ignore
-  noise).
+  press), the output pin is toggled from LOW to HIGH or HIGH to LOW. There's a
+  minimum delay between toggles to debounce the circuit (i.e. to ignore noise).
 
   The circuit:
   - LED attached from pin 13 to ground
   - pushbutton attached from pin 2 to +5V
   - 10 kilohm resistor attached from pin 2 to ground
 
-  - Note: On most Arduino boards, there is already an LED on the board
-    connected to pin 13, so you don't need any extra components for this example.
+  - Note: On most Arduino boards, there is already an LED on the board connected
+    to pin 13, so you don't need any extra components for this example.
 
   created 21 Nov 2006
   by David A. Mellis
@@ -28,8 +27,7 @@
   http://www.arduino.cc/en/Tutorial/Debounce
 */
 
-// constants won't change. They're used here to
-// set pin numbers:
+// constants won't change. They're used here to set pin numbers:
 const int buttonPin = 2;    // the number of the pushbutton pin
 const int ledPin = 13;      // the number of the LED pin
 
@@ -38,8 +36,8 @@ int ledState = HIGH;         // the current state of the output pin
 int buttonState;             // the current reading from the input pin
 int lastButtonState = LOW;   // the previous reading from the input pin
 
-// the following variables are unsigned longs because the time, measured in milliseconds,
-// will quickly become a bigger number than can be stored in an int.
+// the following variables are unsigned longs because the time, measured in
+// milliseconds, will quickly become a bigger number than can be stored in an int.
 unsigned long lastDebounceTime = 0;  // the last time the output pin was toggled
 unsigned long debounceDelay = 50;    // the debounce time; increase if the output flickers
 
@@ -56,8 +54,8 @@ void loop() {
   int reading = digitalRead(buttonPin);
 
   // check to see if you just pressed the button
-  // (i.e. the input went from LOW to HIGH), and you've waited
-  // long enough since the last press to ignore any noise:
+  // (i.e. the input went from LOW to HIGH), and you've waited long enough
+  // since the last press to ignore any noise:
 
   // If the switch changed, due to noise or pressing:
   if (reading != lastButtonState) {
@@ -66,8 +64,8 @@ void loop() {
   }
 
   if ((millis() - lastDebounceTime) > debounceDelay) {
-    // whatever the reading is at, it's been there for longer
-    // than the debounce delay, so take it as the actual current state:
+    // whatever the reading is at, it's been there for longer than the debounce
+    // delay, so take it as the actual current state:
 
     // if the button state has changed:
     if (reading != buttonState) {
@@ -83,7 +81,6 @@ void loop() {
   // set the LED:
   digitalWrite(ledPin, ledState);
 
-  // save the reading. Next time through the loop,
-  // it'll be the lastButtonState:
+  // save the reading. Next time through the loop, it'll be the lastButtonState:
   lastButtonState = reading;
 }

examples/02.Digital/DigitalInputPullup/DigitalInputPullup.ino

@@ -1,16 +1,16 @@
 /*
   Input Pull-up Serial
 
-  This example demonstrates the use of pinMode(INPUT_PULLUP). It reads a
-  digital input on pin 2 and prints the results to the Serial Monitor.
+  This example demonstrates the use of pinMode(INPUT_PULLUP). It reads a digital
+  input on pin 2 and prints the results to the Serial Monitor.
 
   The circuit:
   - momentary switch attached from pin 2 to ground
   - built-in LED on pin 13
 
   Unlike pinMode(INPUT), there is no pull-down resistor necessary. An internal
-  20K-ohm resistor is pulled to 5V. This configuration causes the input to
-  read HIGH when the switch is open, and LOW when it is closed.
+  20K-ohm resistor is pulled to 5V. This configuration causes the input to read
+  HIGH when the switch is open, and LOW when it is closed.
 
   created 14 Mar 2012
   by Scott Fitzgerald
@@ -35,9 +35,8 @@ void loop() {
   //print out the value of the pushbutton
   Serial.println(sensorVal);
 
-  // Keep in mind the pull-up means the pushbutton's
-  // logic is inverted. It goes HIGH when it's open,
-  // and LOW when it's pressed. Turn on pin 13 when the
+  // Keep in mind the pull-up means the pushbutton's logic is inverted. It goes
+  // HIGH when it's open, and LOW when it's pressed. Turn on pin 13 when the
   // button's pressed, and off when it's not:
   if (sensorVal == HIGH) {
     digitalWrite(13, LOW);

examples/02.Digital/StateChangeDetection/StateChangeDetection.ino

@@ -1,8 +1,8 @@
 /*
   State change detection (edge detection)
 
-  Often, you don't need to know the state of a digital input all the time,
-  but you just need to know when the input changes from one state to another.
+  Often, you don't need to know the state of a digital input all the time, but
+  you just need to know when the input changes from one state to another.
   For example, you want to know when a button goes from OFF to ON. This is called
   state change detection, or edge detection.
 
@@ -12,8 +12,8 @@
   The circuit:
   - pushbutton attached to pin 2 from +5V
   - 10 kilohm resistor attached to pin 2 from ground
-  - LED attached from pin 13 to ground (or use the built-in LED on
-    most Arduino boards)
+  - LED attached from pin 13 to ground (or use the built-in LED on most
+    Arduino boards)
 
   created  27 Sep 2005
   modified 30 Aug 2011
@@ -51,29 +51,25 @@ void loop() {
   if (buttonState != lastButtonState) {
     // if the state has changed, increment the counter
     if (buttonState == HIGH) {
-      // if the current state is HIGH then the button
-      // went from off to on:
+      // if the current state is HIGH then the button went from off to on:
       buttonPushCounter++;
       Serial.println("on");
       Serial.print("number of button pushes: ");
       Serial.println(buttonPushCounter);
     } else {
-      // if the current state is LOW then the button
-      // went from on to off:
+      // if the current state is LOW then the button went from on to off:
       Serial.println("off");
     }
     // Delay a little bit to avoid bouncing
     delay(50);
   }
-  // save the current state as the last state,
-  // for next time through the loop
+  // save the current state as the last state, for next time through the loop
   lastButtonState = buttonState;
 
 
-  // turns on the LED every four button pushes by
-  // checking the modulo of the button push counter.
-  // the modulo function gives you the remainder of
-  // the division of two numbers:
+  // turns on the LED every four button pushes by checking the modulo of the
+  // button push counter. the modulo function gives you the remainder of the
+  // division of two numbers:
   if (buttonPushCounter % 4 == 0) {
     digitalWrite(ledPin, HIGH);
   } else {

examples/02.Digital/toneMelody/toneMelody.ino

@@ -31,8 +31,7 @@ void setup() {
   // iterate over the notes of the melody:
   for (int thisNote = 0; thisNote < 8; thisNote++) {
 
-    // to calculate the note duration, take one second
-    // divided by the note type.
+    // to calculate the note duration, take one second divided by the note type.
     //e.g. quarter note = 1000 / 4, eighth note = 1000/8, etc.
     int noteDuration = 1000 / noteDurations[thisNote];
     tone(8, melody[thisNote], noteDuration);

examples/02.Digital/tonePitchFollower/tonePitchFollower.ino

@@ -29,8 +29,8 @@ void loop() {
   Serial.println(sensorReading);
   // map the analog input range (in this case, 400 - 1000 from the photoresistor)
   // to the output pitch range (120 - 1500Hz)
-  // change the minimum and maximum input numbers below
-  // depending on the range your sensor's giving:
+  // change the minimum and maximum input numbers below depending on the range
+  // your sensor's giving:
   int thisPitch = map(sensorReading, 400, 1000, 120, 1500);
 
   // play the pitch:

examples/03.Analog/AnalogInOutSerial/AnalogInOutSerial.ino

@@ -1,8 +1,8 @@
 /*
   Analog input, analog output, serial output
 
-  Reads an analog input pin, maps the result to a range from 0 to 255
-  and uses the result to set the pulse width modulation (PWM) of an output pin.
+  Reads an analog input pin, maps the result to a range from 0 to 255 and uses
+  the result to set the pulse width modulation (PWM) of an output pin.
   Also prints the results to the Serial Monitor.
 
   The circuit:
@@ -20,8 +20,7 @@
   http://www.arduino.cc/en/Tutorial/AnalogInOutSerial
 */
 
-// These constants won't change. They're used to give names
-// to the pins used:
+// These constants won't change. They're used to give names to the pins used:
 const int analogInPin = A0;  // Analog input pin that the potentiometer is attached to
 const int analogOutPin = 9; // Analog output pin that the LED is attached to
 
@@ -47,8 +46,7 @@ void loop() {
   Serial.print("\t output = ");
   Serial.println(outputValue);
 
-  // wait 2 milliseconds before the next loop
-  // for the analog-to-digital converter to settle
-  // after the last reading:
+  // wait 2 milliseconds before the next loop for the analog-to-digital
+  // converter to settle after the last reading:
   delay(2);
 }

examples/03.Analog/AnalogInput/AnalogInput.ino

@@ -3,8 +3,8 @@
 
   Demonstrates analog input by reading an analog sensor on analog pin 0 and
   turning on and off a light emitting diode(LED) connected to digital pin 13.
-  The amount of time the LED will be on and off depends on
-  the value obtained by analogRead().
+  The amount of time the LED will be on and off depends on the value obtained
+  by analogRead().
 
   The circuit:
   - potentiometer
@@ -15,8 +15,8 @@
     anode (long leg) attached to digital output 13
     cathode (short leg) attached to ground
 
-  - Note: because most Arduinos have a built-in LED attached
-    to pin 13 on the board, the LED is optional.
+  - Note: because most Arduinos have a built-in LED attached to pin 13 on the
+    board, the LED is optional.
 
   created by David Cuartielles
   modified 30 Aug 2011

examples/03.Analog/AnalogWriteMega/AnalogWriteMega.ino

@@ -15,8 +15,7 @@
   http://www.arduino.cc/en/Tutorial/AnalogWriteMega
 */
 
-// These constants won't change. They're used to give names
-// to the pins used:
+// These constants won't change. They're used to give names to the pins used:
 const int lowestPin = 2;
 const int highestPin = 13;
 

examples/03.Analog/Calibration/Calibration.ino

@@ -1,15 +1,14 @@
 /*
   Calibration
 
-  Demonstrates one technique for calibrating sensor input. The
-  sensor readings during the first five seconds of the sketch
-  execution define the minimum and maximum of expected values
-  attached to the sensor pin.
-
-  The sensor minimum and maximum initial values may seem backwards.
-  Initially, you set the minimum high and listen for anything
-  lower, saving it as the new minimum. Likewise, you set the
-  maximum low and listen for anything higher as the new maximum.
+  Demonstrates one technique for calibrating sensor input. The sensor readings
+  during the first five seconds of the sketch execution define the minimum and
+  maximum of expected values attached to the sensor pin.
+
+  The sensor minimum and maximum initial values may seem backwards. Initially,
+  you set the minimum high and listen for anything lower, saving it as the new
+  minimum. Likewise, you set the maximum low and listen for anything higher as
+  the new maximum.
 
   The circuit:
   - analog sensor (potentiometer will do) attached to analog input 0