Document bool data type

Previously only Arduino's type alias, boolean was documented.

In this case it's arguable that the benefits of a slightly more descriptive type name outweigh the disadvantages of using a non-standard type. For that reason documenting bool and recommending its use instead of boolean is desirable.

Author: per1234

Language/Variables/Data Types/bool.adoc

@@ -0,0 +1,80 @@
+---
+title: bool
+categories: [ "Variables" ]
+subCategories: [ "Data Types" ]
+---
+
+
+
+
+
+= bool
+
+
+// OVERVIEW SECTION STARTS
+[#overview]
+--
+
+[float]
+=== Description
+A `bool` holds one of two values, `true` or `false`. (Each `bool` variable occupies one byte of memory.)
+
+
+[%hardbreaks]
+
+--
+// OVERVIEW SECTION ENDS
+
+
+
+
+// HOW TO USE SECTION STARTS
+[#howtouse]
+--
+
+[float]
+=== Example Code
+// Describe what the example code is all about and add relevant code   ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄
+This code shows how to use the `bool` datatype.
+
+[source,arduino]
+----
+int LEDpin = 5;       // LED on pin 5
+int switchPin = 13;   // momentary switch on 13, other side connected to ground
+
+bool running = false;
+
+void setup()
+{
+  pinMode(LEDpin, OUTPUT);
+  pinMode(switchPin, INPUT);
+  digitalWrite(switchPin, HIGH);      // turn on pullup resistor
+}
+
+void loop()
+{
+  if (digitalRead(switchPin) == LOW)
+  {  // switch is pressed - pullup keeps pin high normally
+    delay(100);                        // delay to debounce switch
+    running = !running;                // toggle running variable
+    digitalWrite(LEDpin, running);     // indicate via LED
+  }
+}
+----
+
+--
+// HOW TO USE SECTION ENDS
+
+
+// SEE ALSO SECTION STARTS
+[#see_also]
+--
+
+[float]
+=== See also
+
+[role="language"]
+* #LANGUAGE# link:../../../variables/constants/constants[constants]
+
+--
+// SEE ALSO SECTION ENDS

Language/Variables/Data Types/boolean.adoc

@@ -11,15 +11,22 @@ subCategories: [ "Tipos de Dados" ]
 --
 
 [float]
+<<<<<<< HEAD
 === Descrição
 O tipo `boolean` pode armazenar dois valores: `true` or `false`. (Cada variável `boolean` ocupa um byte na memória.)
+=======
+=== Description
+`boolean` is a non-standard type alias for link:../../../variables/data-types/bool/[bool] defined by Arduino. It's recommended to instead use the standard type `bool`, which is identical.
+
+>>>>>>> a1ceb3b... Document bool data type
 
 [%hardbreaks]
 
 --
 // OVERVIEW SECTION ENDS
 
 
+<<<<<<< HEAD
 // HOW TO USE SECTION STARTS
 [#howtouse]
 --
@@ -56,6 +63,8 @@ void loop()
 
 --
 // HOW TO USE SECTION ENDS
+=======
+>>>>>>> a1ceb3b... Document bool data type
 
 
 // SEE ALSO SECTION STARTS
@@ -66,7 +75,11 @@ void loop()
 === Ver Também
 
 [role="language"]
+<<<<<<< HEAD
 #LINGUAGEM# link:../../../variables/constants/constants[constants] +
+=======
+* #LANGUAGE# link:../../../variables/data-types/bool/[bool]
+>>>>>>> a1ceb3b... Document bool data type
 
 --
 // SEE ALSO SECTION ENDS