Merge branch 'master' into fix-example-code-formatting

Author: robsoncouto

AsciiDoc_sample/AsciiDoc_Dictionary/AsciiDoc_Template-Dictionary.adoc

@@ -3,7 +3,7 @@
 
 // This is a documentation file for authors and editors of the Arduino Manutius content platform.
 // Below you can find a list of all the possible page elements with the corresponding
-// AsciiDoc syntax 
+// AsciiDoc syntax
 
 
 // GENERAL GUIDELINES
@@ -99,10 +99,10 @@ mailto:[email protected][This is an e-mail link]
 This is `code` in a sentence +
 `This is a whole line of code` +
 
-// HINT: Please note that sometimes when copy-pasting code a few spaces can be added at the beginnng of each line of code. 
+// HINT: Please note that sometimes when copy-pasting code a few spaces can be added at the beginnng of each line of code.
 // If that happens, please remove the extra spaces. Thanks!
 
-This can be a lot more code 
+This can be a lot more code
 [source,arduino]
 ----
 for (int i = 0; i <= 99; i++) {
@@ -115,7 +115,7 @@ for (int i = 0; i <= 99; i++) {
 
 // TABLES
 |===
-|Name of Column 1 |Name of Column 2 |Name of Column 3 
+|Name of Column 1 |Name of Column 2 |Name of Column 3
 
 |Cell in column 1, row 1
 |Cell in column 2, row 1
@@ -135,7 +135,7 @@ for (int i = 0; i <= 99; i++) {
 
 // IMAGES
 
-// If you need to add an image to the Asciidoc please create a folder called 'attachments' in the same directory as the Asciidoc file, 
+// If you need to add an image to the Asciidoc please create a folder called 'attachments' in the same directory as the Asciidoc file,
 // place the image there and reference it as shown below. Images can be in SVG and PNG format, max size 200KB.
 
 // To include an image on its own line (i.e., a block image), use the image:: prefix in front of the file name and square brackets after it []

AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Parent_Of_Entities.adoc

@@ -1,6 +1,6 @@
 ---
 title: Parent of Entity Title
-categories: [ "Functions" ] 
+categories: [ "Functions" ]
 subCategories: [ "Subcategory Name" ]
 ---
 // ARDUINO LANGUAGE REFERENCE TAG (above)   ►►►►► ALWAYS INCLUDE IN YOUR FILE ◄◄◄◄◄
@@ -78,7 +78,7 @@ http://arduino.cc[serialEvent()]
 
 [float]
 === See also
-// Link relevant content by category, such as other Reference terms (please add the tag #LANGUAGE#), 
+// Link relevant content by category, such as other Reference terms (please add the tag #LANGUAGE#),
 // definitions (please add the tag #DEFINITION#), and examples of Projects and Tutorials
 // (please add the tag #EXAMPLE#)  ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄
 

AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Single_Entity.adoc

@@ -106,7 +106,7 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption="
 
 [float]
 === See also
-// Link relevant content by category, such as other Reference terms (please add the tag #LANGUAGE#), 
+// Link relevant content by category, such as other Reference terms (please add the tag #LANGUAGE#),
 // definitions: (please add the tag #DEFINITION#), and examples of Projects and Tutorials
 // examples: (please add the tag #EXAMPLE#)
 
@@ -116,7 +116,7 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption="
 // use the syntax shown below. Please note that the file format is subsituted by  attribute.
 // Please note that you always need to replace spaces that you might find in folder/file names with %20
 // The entire link to Reference pages must be lower case, regardless of the case of the folders and files in this repository.
-// For language tag, items will be automatically generated for any other item of the same subcategory, 
+// For language tag, items will be automatically generated for any other item of the same subcategory,
 // no need to add links to other pages of the same subcategory
 // if you don't include this section, a minimal version with only the other pages of the same subcategory will be generated.
 * #LANGUAGE# link:../AsciiDoc_Template-Parent_Of_Entities[Parent Of Entities]

Language/Functions/Advanced IO/shiftOut.adoc

@@ -89,10 +89,10 @@ void loop() {
   for (int j = 0; j < 256; j++) {
     //coloca e mantém o pino latch em low enquanto ocorre a transmissão
     digitalWrite(latchPin, LOW);
-    
+
     //transmite o valor de j, a começar pelo bit menos significativo
     shiftOut(dataPin, clockPin, LSBFIRST, j);
-    
+
     //retorna o pino latch para high para sinalizar ao chip
     //que esse não precisa mais esperar por informação
     digitalWrite(latchPin, HIGH);

Language/Functions/Advanced IO/tone.adoc

@@ -78,7 +78,7 @@ Se você quiser tocar tons diferentes em múltiplos pinos, você precisa chamar
 
 [role="example"]
 * #EXEMPLO# http://arduino.cc/en/Tutorial/Tone[Tone^]
-* #EXEMPLO# http://arduino.cc/en/Tutorial/Tone[Pitch follower^]
+* #EXEMPLO# http://arduino.cc/en/Tutorial/tonePitchFollower[Pitch follower^]
 * #EXEMPLO# http://arduino.cc/en/Tutorial/Tone3[Simple Keyboard^]
 * #EXEMPLO# http://arduino.cc/en/Tutorial/Tone4[multiple tones^]
 * #EXEMPLO# http://arduino.cc/en/Tutorial/PWM[PWM^]

Language/Functions/Analog IO/analogRead.adoc

@@ -12,7 +12,7 @@ subCategories: [ "Entradas e Saídas Analógicas" ]
 
 [float]
 === Descrição
-Lê o valor de um pino analógico especificado. A placa Arduino possui um conversor analógico-digital 10 bts de 6 canais (8 canais nos Mini e Nano, 16 no Mega, 7 canais em placas MKR). Isso significa que este irá mapear tensões entre 0 e a tensão operacional (5V or 3.3V) para valores inteiros entre 0 e 1023. No Arduino UNO, por exemplo, isso permite uma resolução entre leituras de: 5 volts / 1024 unidades, ou .0049 volts (4.9 mV) por unidade. Veja a tabela abaixo para os pinos utilizáveis, tensão de operação e resolução máxima para algumas placas Arduino. 
+Lê o valor de um pino analógico especificado. A placa Arduino possui um conversor analógico-digital 10 bts de 6 canais (8 canais nos Mini e Nano, 16 no Mega, 7 canais em placas MKR). Isso significa que este irá mapear tensões entre 0 e a tensão operacional (5V or 3.3V) para valores inteiros entre 0 e 1023. No Arduino UNO, por exemplo, isso permite uma resolução entre leituras de: 5 volts / 1024 unidades, ou .0049 volts (4.9 mV) por unidade. Veja a tabela abaixo para os pinos utilizáveis, tensão de operação e resolução máxima para algumas placas Arduino.
 
 O intervalo de entrada pode ser mudado atrvés da função link:../analogreference[analogReference()], enquanto a resolução pode ser mudada (apenas nas placas Zero, Due e MKR) usando-se link:../../zero-due-mkr-family/analogreadresolution[analogReadResolution()].
 

Language/Functions/Analog IO/analogReference.adoc

@@ -32,7 +32,7 @@ Placas Arduino AVR (Uno, Mega, etc.)
 Placas Arduino SAMD (Zero, etc.)
 
 * AR_DEFAULT: a referência analógica padrão de 3.3V
-* AR_INTERNAL: uma referência integrada de 2.23V 
+* AR_INTERNAL: uma referência integrada de 2.23V
 * AR_INTERNAL1V0: uma referência integrada de 1.0V
 * AR_INTERNAL1V65: uma referência integrada de 1.65V
 * AR_INTERNAL2V23: uma referência integrada de 2.23V

Language/Functions/Bits and Bytes/bitWrite.adoc

@@ -28,7 +28,7 @@ Escreve em um bit especificado de um valor numérico.
 
 [float]
 === Parâmetros
-`x`: a variável numérica cujo bit se deseja escrever 
+`x`: a variável numérica cujo bit se deseja escrever
 
 `n`: qual bit do número a ser escrito, começando em 0 para o bit menos significativo (mais à direita)
 

Language/Functions/Characters/isAlpha.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se um caractere é alfabético (isto é, se é uma letra). Retorna true (verdadeiro) se thisChar contém uma letra. 
+Analisa se um caractere é alfabético (isto é, se é uma letra). Retorna true (verdadeiro) se thisChar contém uma letra.
 [%hardbreaks]
 
 

Language/Functions/Characters/isAlphaNumeric.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se um caractere é alfanumérico (isto é, uma letra ou um número). Retorna true (verdadeiro) se thisChar contém ou uma letra ou um número. 
+Analisa se um caractere é alfanumérico (isto é, uma letra ou um número). Retorna true (verdadeiro) se thisChar contém ou uma letra ou um número.
 [%hardbreaks]
 
 

Language/Functions/Characters/isAscii.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se um caractere é Ascii. Retorna true se a variável thisChar contém um caractere Ascii. 
+Analisa se um caractere é Ascii. Retorna true se a variável thisChar contém um caractere Ascii.
 [%hardbreaks]
 
 

Language/Functions/Characters/isControl.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é um caractere de controle. Retorna true (verdadeiro) se thisChar é um caractere de controle. 
+Analisa se uma caractere é um caractere de controle. Retorna true (verdadeiro) se thisChar é um caractere de controle.
 [%hardbreaks]
 
 

Language/Functions/Characters/isDigit.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é um digito (isto é, um número). Retorna true (verdadeiro) se thisChar é um número. 
+Analisa se uma caractere é um digito (isto é, um número). Retorna true (verdadeiro) se thisChar é um número.
 [%hardbreaks]
 
 

Language/Functions/Characters/isGraph.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se um caractere é imprimível com algum conteúdo (espaços são imprimíveis, mas não possuem conteúdo). Retorna true se thisChar é imprimível. 
+Analisa se um caractere é imprimível com algum conteúdo (espaços são imprimíveis, mas não possuem conteúdo). Retorna true se thisChar é imprimível.
 [%hardbreaks]
 
 

Language/Functions/Characters/isHexadecimalDigit.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é um digito hexadecimal (A-F, 0-9). Retorna true se thisChar contém um digito hexadecimal. 
+Analisa se uma caractere é um digito hexadecimal (A-F, 0-9). Retorna true se thisChar contém um digito hexadecimal.
 [%hardbreaks]
 
 

Language/Functions/Characters/isLowerCase.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é minúsculo (isto é, uma letra minúscula). Retorna true se thisChar contém uma letra minúscula. 
+Analisa se uma caractere é minúsculo (isto é, uma letra minúscula). Retorna true se thisChar contém uma letra minúscula.
 [%hardbreaks]
 
 

Language/Functions/Characters/isPrintable.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é imprimível (isto é, qualquer caractere que produz uma saída, até mesmo um espaço). Retorna true se thisChar é imprimível. Por impimível diz-se os caracteres que pode ser impressos, como letras e números. Alguns caracteres são para controle e não podem ser impressos como o new line (`'\n'`) e o tab (`'\t'`). 
+Analisa se uma caractere é imprimível (isto é, qualquer caractere que produz uma saída, até mesmo um espaço). Retorna true se thisChar é imprimível. Por impimível diz-se os caracteres que pode ser impressos, como letras e números. Alguns caracteres são para controle e não podem ser impressos como o new line (`'\n'`) e o tab (`'\t'`).
 [%hardbreaks]
 
 

Language/Functions/Characters/isPunct.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é pontuação (isto é, uma vírgula, um ponto-e-vírgula, um ponto de exlamação etc). Retorna true se thisChar é um caractere de pontuação. 
+Analisa se uma caractere é pontuação (isto é, uma vírgula, um ponto-e-vírgula, um ponto de exlamação etc). Retorna true se thisChar é um caractere de pontuação.
 [%hardbreaks]
 
 

Language/Functions/Characters/isSpace.adoc

@@ -17,7 +17,7 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se uma caractere é o caractere de espaço. Retorna true se thisChar contém um espaço. 
+Analisa se uma caractere é o caractere de espaço. Retorna true se thisChar contém um espaço.
 [%hardbreaks]
 
 

Language/Functions/Characters/isWhitespace.adoc

@@ -17,8 +17,8 @@ subCategories: [ "Caracteres" ]
 
 [float]
 === Descrição
-Analisa se um caractere é um espaço em branco, isto é o próprio caractere de espaço (' '), formfeed ('\f'), nova linha ('\n'), retorno ('\r'), tab horizontal tab ('\t') e tab vertical ('\v')). 
-Retorna true se thisChar contém um espaço em branco. 
+Analisa se um caractere é um espaço em branco, isto é o próprio caractere de espaço (' '), formfeed ('\f'), nova linha ('\n'), retorno ('\r'), tab horizontal tab ('\t') e tab vertical ('\v')).
+Retorna true se thisChar contém um espaço em branco.
 [%hardbreaks]
 
 

Language/Functions/Communication/Serial/available.adoc

@@ -11,7 +11,7 @@ title: Serial.available()
 
 [float]
 === Descrição
-Retorna o número de bytes (caracteres) disponíveis para leitura da porta serial. Esses são dados que já chegaram e foram guardados no buffer de recebimento (o qual armazena 64 bytes). 
+Retorna o número de bytes (caracteres) disponíveis para leitura da porta serial. Esses são dados que já chegaram e foram guardados no buffer de recebimento (o qual armazena 64 bytes).
 
 A função `Serial.available()` é herdada da classe link:../../stream[Stream].
 [%hardbreaks]

Language/Functions/Communication/Serial/end.adoc

@@ -22,7 +22,7 @@ Desativa a comunicação serial, permitindo os pinos RX e TX serem usados novame
 `_Serial_`: objeto porta serial. Veja a lista de portas seriais disponíveis em cada placa no link:../../serial[Serial - Página principal]
 
 [float]
-=== Retorna 
+=== Retorna
 Nada
 
 --

Language/Functions/Communication/Serial/flush.adoc

@@ -37,7 +37,7 @@ Nada
 --
 
 [float]
-=== Ver Também 
+=== Ver Também
 
 [role="language"]
 #LINGUAGEM# link:../begin[begin()] +

Language/Functions/Communication/Serial/println.adoc

@@ -48,7 +48,7 @@ O código abaixo faz a leitura de um valor analógico a cada 10 ms e imprime ess
  Tradução em 29 de Novembro de 2017
  */
 
-int analogValue = 0;    // variável para guardar a leitura analógica 
+int analogValue = 0;    // variável para guardar a leitura analógica
 
 void setup() {
   // abre a porta serial a 9600 bps:

Language/Functions/Communication/Serial/read.adoc

@@ -10,7 +10,7 @@ title: Serial.read()
 
 [float]
 === Descrição
-Lê dados recebidos na porta serial. 
+Lê dados recebidos na porta serial.
 
 A função `Serial.read()` é herdada da classe link:../../stream[Stream].
 [%hardbreaks]

Language/Functions/Communication/Serial/serialEvent.adoc

@@ -88,7 +88,7 @@ Nada
 #LINGUAGEM# link:../flush[flush()] +
 #LINGUAGEM# link:../print[print()] +
 #LINGUAGEM# link:../println[println()] +
-#LINGUAGEM# link:../write[write()] 
+#LINGUAGEM# link:../write[write()]
 
 --
 // SEE ALSO SECTION ENDS

Language/Functions/Communication/Serial/write.adoc

@@ -36,7 +36,7 @@ Escreve dados binários na porta serial. Esses dados são enviados como um byte
 
 O número de bytes escritos na porta serial - `size_t`
 
-`write()` irá retornar o número de bytes escritos, apesar de ler esse valor ser opcional 
+`write()` irá retornar o número de bytes escritos, apesar de ler esse valor ser opcional
 
 --
 // OVERVIEW SECTION ENDS
@@ -50,7 +50,7 @@ O número de bytes escritos na porta serial - `size_t`
 [float]
 === Código de Exemplo
 // Describe what the example code is all about and add relevant code   ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄
-O código abaixo usa a função Serial.write() para escrever um valor e uma string na porta serial. 
+O código abaixo usa a função Serial.write() para escrever um valor e uma string na porta serial.
 
 [source,arduino]
 ----

Language/Functions/Communication/Stream/streamParseFloat.adoc

@@ -14,7 +14,7 @@ title: Stream.parseFloat()
 
 [float]
 === Descrição
-`parseFloat()` retorna o primeiro número de ponto flutuante da posição atual. Caracteres iniciais que não são digitos (ou o sinal de menos) são ignorados. `parseFloat()` é terminada pelo primeiro caractere que não é um digito encontrado após o número. A função retorna se acabar o tempo limite (veja ../streamsettimeout[Stream.setTimeout()]). 
+`parseFloat()` retorna o primeiro número de ponto flutuante da posição atual. Caracteres iniciais que não são digitos (ou o sinal de menos) são ignorados. `parseFloat()` é terminada pelo primeiro caractere que não é um digito encontrado após o número. A função retorna se acabar o tempo limite (veja ../streamsettimeout[Stream.setTimeout()]).
 
 Essa função é parte da classe Stream, e pode ser chamada por qualquer classe que herda da mesma (Wire, Serial, etc). Veja a página principal da link:../../stream[classe Stream] para mais informações.
 [%hardbreaks]

Language/Functions/Digital IO/pinMode.adoc

@@ -31,7 +31,7 @@ Desde a versão 1.0.1, é possível ativar os resistores internos de pull-up com
 === Parâmetros
 `pino`: the número do pino o qual se quer escolher o modo
 
-`modo`: o modo do pino. Este pode ser `INPUT`, `OUTPUT` ou `INPUT_PULLUP`; que correspondem respectivamente a entrada, saída e entrada com pull-up ativado. 
+`modo`: o modo do pino. Este pode ser `INPUT`, `OUTPUT` ou `INPUT_PULLUP`; que correspondem respectivamente a entrada, saída e entrada com pull-up ativado.
 
 //Check how to add links
 

Language/Functions/Math/constrain.adoc

@@ -51,7 +51,7 @@ b: se x é maior que b
 [float]
 === Código de Exemplo
 // Describe what the example code is all about and add relevant code   ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄
-O código limita os valores de uma variável com a leitura de um sensor entre 10 e 150. 
+O código limita os valores de uma variável com a leitura de um sensor entre 10 e 150.
 
 [source,arduino]
 ----

Language/Functions/Random Numbers/random.adoc

@@ -20,7 +20,7 @@ A função `random()` gera números pseudoaleatórios.
 
 [float]
 === Sintaxe
-`random(max)` 
+`random(max)`
 `random(min, max)`
 
 

Language/Functions/USB/Keyboard.adoc

@@ -14,7 +14,7 @@ subCategories: [ "USB" ]
 
 [float]
 === Descrição
-As funções da biblioteca Keyboard permitem placas baseadas nos micros 32u4 ou SAMD funcionar como um teclado e enviar sinais de teclas pressionadas a um computador conectado através da porta micro USB nativa. 
+As funções da biblioteca Keyboard permitem placas baseadas nos micros 32u4 ou SAMD funcionar como um teclado e enviar sinais de teclas pressionadas a um computador conectado através da porta micro USB nativa.
 [%hardbreaks]
 *Nota: Nem todo caractere ASCII, particularmente os não imprimíveis, podem ser enviados com a biblioteca Keyboard.* +
 A biblioteca suporta o uso de teclas modificadoras. Teclas modificadoras mudam o comportamento de outra tecla quando pressionadas simultaneamente. link:../keyboard/keyboardmodifiers[Veja aqui] informações adicionais sobre as teclas suportadas e seu uso.
@@ -28,7 +28,7 @@ As bibliotecas core permitem as placas baseadas nos micros 32u4 e SAMD (Leonardo
 [%hardbreaks]
 *Uma nota as bibliotecas Mouse e Keyboard*: se a biblioteca Mouse ou Keyboard estiver rodando constantemente, será difícil programar a sua placa. Funções como `Mouse.move()` e `Keyboard.print()` irão mover o cursor ou enviar teclas ao computador conectado e devem ser chamadas apenas quando você estiver pronto para usá-las. É recomendado se usar um sistema de controle para ativar a funcionalidade USB, como um botão físico ou apenas responder a entradas específicas que você pode controlar.Confira os exemplos sobre as bibliotecas Mouse e Keyboard para algumas formas de fazer isso.
 [%hardbreaks]
-Quando usar as bibliotecas Mouse ou Keyboard, pode ser melhor testar sua saída primeiro utilizando link:../../communication/serial/print[Serial.print()]. Dessa forma, você pode ter certeza de quais valores estão sendo relatados. 
+Quando usar as bibliotecas Mouse ou Keyboard, pode ser melhor testar sua saída primeiro utilizando link:../../communication/serial/print[Serial.print()]. Dessa forma, você pode ter certeza de quais valores estão sendo relatados.
 [%hardbreaks]
 // FUNCTIONS SECTION STARTS
 [#functions]

Language/Functions/USB/Mouse.adoc

@@ -26,7 +26,7 @@ As bibliotecas core permitem as placas baseadas nos micros 32u4 e SAMD (Leonardo
 [%hardbreaks]
 *Uma nota as bibliotecas Mouse e Keyboard*: se a biblioteca Mouse ou Keyboard estiver rodando constantemente, será difícil programar a sua placa. Funções como `Mouse.move()` e `Keyboard.print()` irão mover o cursor ou enviar teclas ao computador conectado e devem ser chamadas apenas quando você estiver pronto para usá-las. É recomendado se usar um sistema de controle para ativar a funcionalidade USB, como um botão físico ou apenas responder a entradas específicas que você pode controlar. Confira os exemplos sobre as bibliotecas Mouse e Keyboard para algumas formas de fazer isso.
 [%hardbreaks]
-Quando usar as bibliotecas Mouse ou Keyboard, pode ser melhor testar sua saída primeiro utilizando link:../../communication/serial/print[Serial.print()]. Dessa forma, você pode ter certeza de quais valores estão sendo relatados. 
+Quando usar as bibliotecas Mouse ou Keyboard, pode ser melhor testar sua saída primeiro utilizando link:../../communication/serial/print[Serial.print()]. Dessa forma, você pode ter certeza de quais valores estão sendo relatados.
 [%hardbreaks]
 // FUNCTIONS SECTION STARTS
 [#functions]

Language/Structure/Comparison Operators/greaterThan.adoc

@@ -50,7 +50,7 @@ if (x > y) {  // testa se x é maior que y
 
 [float]
 === Notas e Advertências
-Números positivos são maiores que números negativos. 
+Números positivos são maiores que números negativos.
 [%hardbreaks]
 
 --