From ab9e945cb3c1855b4949bdda389be418285915f2 Mon Sep 17 00:00:00 2001
From: "David A. Mellis" <d.mellis@arduino.cc>
Date: Sun, 7 Sep 2008 12:21:07 +0000
Subject: [PATCH] Commented LCD examples.

---
 .../examples/HelloWorld/HelloWorld.pde            |  6 ++++++
 .../examples/SerialDisplay/SerialDisplay.pde      | 15 +++++++++++++++
 todo.txt                                          |  4 ++--
 3 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/hardware/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde b/hardware/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde
index f755d9ca6..438063f89 100644
--- a/hardware/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde
+++ b/hardware/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde
@@ -1,9 +1,15 @@
 #include <LiquidCrystal.h>
 
+// LiquidCrystal display with:
+// rs on pin 12
+// rw on pin 11
+// enable on pin 10
+// d0, d1, d2, d3 on pins 5, 4, 3, 2
 LiquidCrystal lcd(12, 11, 10, 5, 4, 3, 2);
 
 void setup()
 {
+  // Print a message to the LCD.
   lcd.print("hello, world!");
 }
 
diff --git a/hardware/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde b/hardware/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde
index 6e4336c9a..940439e3c 100644
--- a/hardware/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde
+++ b/hardware/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde
@@ -1,5 +1,15 @@
+/*
+ * Displays text sent over the serial port (e.g. from the Serial Monitor) on
+ * an attached LCD.
+ */
+
 #include <LiquidCrystal.h>
 
+// LiquidCrystal display with:
+// rs on pin 12
+// rw on pin 11
+// enable on pin 10
+// d0, d1, d2, d3 on pins 5, 4, 3, 2
 LiquidCrystal lcd(12, 11, 10, 5, 4, 3, 2);
 
 void setup()
@@ -9,10 +19,15 @@ void setup()
 
 void loop()
 {
+  // when characters arrive over the serial port...
   if (Serial.available()) {
+    // wait a bit for the entire message to arrive
     delay(100);
+    // clear the screen
     lcd.clear();
+    // read all the available characters
     while (Serial.available() > 0) {
+      // display each character to the LCD
       lcd.write(Serial.read());
     }
   }
diff --git a/todo.txt b/todo.txt
index eea3771e3..19b2ce641 100644
--- a/todo.txt
+++ b/todo.txt
@@ -3,9 +3,9 @@
 0012
 
 Update Windows avr-libc to 1.6 and avr-gcc to 4.3 (to match Mac).
-Comment LiquidCrystal examples.
 Add Firmata library.
-Update reference.
+[done] Comment LiquidCrystal examples.
+[done] Update reference.
 [done] Document LiquidCrystal library.
 [done] Document Servo library.
 [done] Include actual bootloader burned on the Pro and Pro Mini.