Merge branch 'Language_content' of github.com:arduino/reference-en into Language_content

Author: Your Name

Language/Functions/Advanced IO/noTone.adoc

@@ -3,7 +3,7 @@
 :ext-relative: adoc
 
 
-= Entity title()
+= noTone()
 
 
 // OVERVIEW SECTION STARTS

Language/Functions/Analog IO/analogRead.adoc

@@ -79,7 +79,7 @@ If the analog input pin is not connected to anything, the value returned by anal
 [role="language"]
 * #LANGUAGE# link:analogReference{ext-relative}[analogreference()] +
 * #LANGUAGE# link:analogReadResolution{ext-relative}[analogReadResolution()] +
-* #LANGUAGE# (http://arduino.cc/en/Tutorial/AnalogInputPins[Tutorial: Analog Input Pins])
+* #LANGUAGE# http://arduino.cc/en/Tutorial/AnalogInputPins[Tutorial: Analog Input Pins]
 
 
 --

Language/Functions/Communication/Serial/findUntil.adoc

@@ -12,11 +12,11 @@
 
 [float]
 === Description
-Serial.findUntil() reads data from the serial buffer until a target string of given length or terminator string is found.
+`Serial.findUntil()` reads data from the serial buffer until a target string of given length or terminator string is found.
 
 The function returns true if the target string is found, false if it times out.
 
-Serial.findUntil() inherits from the link:stream{ext-relative}[Stream] utility class.
+`Serial.findUntil()` inherits from the link:stream{ext-relative}[Stream] utility class.
 [%hardbreaks]
 
 

Language/Functions/Communication/Serial/print.adoc

@@ -12,21 +12,44 @@
 
 [float]
 === Description
+Prints data to the serial port as human-readable ASCII text. This command can take many forms. Numbers are printed using an ASCII character for each digit. Floats are similarly printed as ASCII digits, defaulting to two decimal places. Bytes are sent as a single character. Characters and strings are sent as is. For example-
+
+* `Serial.print(78) gives "78"` +
+* `Serial.print(1.23456) gives "1.23"` +
+* `Serial.print('N') gives "N"` +
+* `Serial.print("Hello world.") gives "Hello world." `
+
+An optional second parameter specifies the base (format) to use; permitted values are `BIN(binary, or base 2)`, `OCT(octal, or base 8)`, `DEC(decimal, or base 10)`, `HEX(hexadecimal, or base 16)`. For floating point numbers, this parameter specifies the number of decimal places to use. For example-
+
+* `Serial.print(78, BIN) gives "1001110"` +
+* `Serial.print(78, OCT) gives "116"` +
+* `Serial.print(78, DEC) gives "78"` +
+* `Serial.print(78, HEX) gives "4E"` +
+* `Serial.println(1.23456, 0) gives "1"` +
+* `Serial.println(1.23456, 2) gives "1.23"` +
+* `Serial.println(1.23456, 4) gives "1.2346"`
+
+You can pass flash-memory based strings to Serial.print() by wrapping them with F(). For example :
+
+`Serial.print(F(“Hello World”))`
+
+To send a single byte, use link:serialWrite{ext-relative}[Serial.write()].
 [%hardbreaks]
 
 
 [float]
 === Syntax
-
+`Serial.print(val)` +
+`Serial.print(val, format)`
 
 
 [float]
 === Parameters
-
+`val`: the value to print - any data type
 
 [float]
 === Returns
-Nothing
+`size_t (long)`: `print()` returns the number of bytes written, though reading that number is optional.
 
 --
 // OVERVIEW SECTION ENDS
@@ -45,12 +68,59 @@ Nothing
 
 [source,arduino]
 ----
+/*
+Uses a FOR loop for data and prints a number in various formats.
+*/
+int x = 0;    // variable
+
+void setup() {
+  Serial.begin(9600);      // open the serial port at 9600 bps:
+}
+
+void loop() {
+  // print labels
+  Serial.print("NO FORMAT");       // prints a label
+  Serial.print("\t");              // prints a tab
+
+  Serial.print("DEC");
+  Serial.print("\t");
+
+  Serial.print("HEX");
+  Serial.print("\t");
+
+  Serial.print("OCT");
+  Serial.print("\t");
+
+  Serial.print("BIN");
+  Serial.print("\t");
+
+  for(x=0; x< 64; x++){    // only part of the ASCII chart, change to suit
+
+    // print it out in many formats:
+    Serial.print(x);       // print as an ASCII-encoded decimal - same as "DEC"
+    Serial.print("\t");    // prints a tab
+
+    Serial.print(x, DEC);  // print as an ASCII-encoded decimal
+    Serial.print("\t");    // prints a tab
+
+    Serial.print(x, HEX);  // print as an ASCII-encoded hexadecimal
+    Serial.print("\t");    // prints a tab
+
+    Serial.print(x, OCT);  // print as an ASCII-encoded octal
+    Serial.print("\t");    // prints a tab
 
+    Serial.println(x, BIN);  // print as an ASCII-encoded binary
+    //                             then adds the carriage return with "println"
+    delay(200);            // delay 200 milliseconds
+  }
+  Serial.println("");      // prints another carriage return
+}
 ----
 [%hardbreaks]
 
 [float]
 === Notes and Warnings
+As of version 1.0, serial transmission is asynchronous; `Serial.print()` will return before any characters are transmitted.
 [%hardbreaks]
 
 [float]

Language/Functions/Communication/Stream/streamFindUntil.adoc

@@ -3,7 +3,7 @@
 :ext-relative: adoc
 
 
-= Entity title()
+= `findUntil()`
 
 
 // OVERVIEW SECTION STARTS