Added example runs in docstring comment.

examples/simple_annotate_date.py

@@ -1,15 +1,23 @@
 """
-Simply call "ls -a", no special stuff.
+Annotate each line coming in with the current date.
+
+Example runs:
+python simple_annotate_date.py find .
+python simple_annotate_date.py cat      (and start typing in stdin)
+python simple_annotate_date.py grep 'foobar' *
 """
 import sys
 import datetime
 import drainers
 
 def annotate(line, is_err):
-    sys.stdout.write('[%s] ' % datetime.datetime.now())
     if is_err:
-        sys.stdout.write('ERROR: ')
-    sys.stdout.write(line)
+        stream = sys.stderr
+    else:
+        stream = sys.stdout
+    stream.write('[%s] ' % datetime.datetime.now())
+    stream.write('ERROR: ')
+    stream.write(line)
 
 d = drainers.Drainer(sys.argv[1:], read_event_cb=annotate)
 d.start()

examples/simple_find.py

@@ -1,6 +1,12 @@
 """
-Simple finder. Search for a file called "foobar" for a maximum of 10
-seconds, then abort.  Present results of found files and errors.
+Simple finder. Search for the file given in sys.argv[1] for a maximum of
+10 seconds, then abort.  Present results of found files and errors.
+
+For the best demonstration effect, make the find run long (for example,
+run the script from /).
+
+Example runs:
+python simple_find.py <somefile>
 """
 import sys
 import drainers