Added comments.

demo/microcom.py

@@ -5,18 +5,32 @@ import pcl_expect.pyserial
 import pcl_expect.user
 import pcl_expect
 
+# Open the serial port.  You could specify parity, number of bits, and
+# a lot of other things here as well.  See the pySerial
+# documentation.
+
 port = pcl_expect.pyserial.Serial(0, baudrate=9600)
+
+# We need to listen for input from the user as well.  Set the tty in
+# RAW mode so that the user can enter Ctrl-C, DEL, Backspace and other
+# special characters.
+
 user = pcl_expect.user.User(pcl_expect.user.RAW)
 
 x = pcl_expect.Controller()
 while x.loop():
     if x.re(user, "^\035"):
+        # Exit once the user hits Ctrl-].
         break
     elif x.re(user, "(?s)."):
+        # Anything else is sent to the seiral port.
         port.send(user.consumed)
-    elif x.re(port, "..*"):
+    elif x.re(port, "(?s)..*"):
+        # Anything that arrives from the serial port is sent to the
+        # user.
         user.send(port.consumed)
     elif x.timeout():
+        # Ignore timeouts.
         pass
 
 port.close()