This commit adds descriptive comments for 9f6c6ae.

Author: Chris--A

hardware/arduino/avr/cores/arduino/Stream.h

@@ -35,10 +35,13 @@
 readBytesBetween( pre_string, terminator, buffer, length)
 */
 
+// This enumeration provides the lookahead options for parseInt(), parseFloat()
+// The rules set out here are used until either the first valid character is found
+// or a time out occurs due to lack of input.
 enum StreamParseOpt{
-    SKIP_ALL,
-    SKIP_NONE,
-    SKIP_WHITESPACE
+    SKIP_ALL,       // All invalid characters are ignored.
+    SKIP_NONE,      // Nothing is skipped, and the stream is not touched unless the first waiting character is valid.
+    SKIP_WHITESPACE // Only tabs, spaces, line feeds & carriage returns are skipped.
 };
 
 class Stream : public Print

hardware/arduino/sam/cores/arduino/Stream.h

@@ -35,10 +35,13 @@
 readBytesBetween( pre_string, terminator, buffer, length)
 */
 
+// This enumeration provides the lookahead options for parseInt(), parseFloat()
+// The rules set out here are used until either the first valid character is found
+// or a time out occurs due to lack of input.
 enum StreamParseOpt{
-    SKIP_ALL,
-    SKIP_NONE,
-    SKIP_WHITESPACE
+    SKIP_ALL,       // All invalid characters are ignored.
+    SKIP_NONE,      // Nothing is skipped, and the stream is not touched unless the first waiting character is valid.
+    SKIP_WHITESPACE // Only tabs, spaces, line feeds & carriage returns are skipped.
 };
 
 class Stream : public Print