Merge PR #520 "Document the limits of serial transmission asyncronicity " from per1234

Document the limits of serial transmission asyncronicity

Author: robsoncouto

Language/Functions/Communication/Serial/print.adoc

@@ -121,7 +121,7 @@ void loop() {
 
 [float]
 === Notes and Warnings
-As of version 1.0, serial transmission is asynchronous; `Serial.print()` will return before any characters are transmitted.
+For information on the asyncronicity of `Serial.print()`, see the Notes and Warnings section of the link:../write#howtouse[Serial.write() reference page].
 
 --
 // HOW TO USE SECTION ENDS

Language/Functions/Communication/Serial/println.adoc

@@ -80,6 +80,11 @@ void loop() {
   delay(10);
 }
 ----
+[%hardbreaks]
+
+[float]
+=== Notes and Warnings
+For information on the asyncronicity of `Serial.println()`, see the Notes and Warnings section of the link:../write#howtouse[Serial.write() reference page].
 
 --
 // HOW TO USE SECTION ENDS

Language/Functions/Communication/Serial/write.adoc

@@ -66,6 +66,11 @@ void loop(){
    int bytesSent = Serial.write(“hello”); //send the string “hello” and return the length of the string.
 }
 ----
+[%hardbreaks]
+
+[float]
+=== Notes and Warnings
+As of Arduino IDE 1.0, serial transmission is asynchronous. If there is enough empty space in the transmit buffer, `Serial.write()` will return before any characters are transmitted over serial. If the transmit buffer is full then `Serial.write()` will block until there is enough space in the buffer. To avoid blocking calls to `Serial.write()`, you can first check the amount of free space in the transmit buffer using link:../availableforwrite[availableForWrite()].
 
 --
 // HOW TO USE SECTION ENDS