diff --git a/examples/linearbandwidth.py b/examples/linearbandwidth.py
index 6aeb127215e642c8094f5c710fe6409473bf7dfd..424fc3ec57846d15749d91b62f295148e57e9c13 100755
--- a/examples/linearbandwidth.py
+++ b/examples/linearbandwidth.py
@@ -13,6 +13,14 @@
 Note: by default, the reference controller only supports 16
 switches, so this test WILL NOT WORK unless you have recompiled
 your controller to support 100 switches (or more.)
+
+In addition to testing the bandwidth across varying numbers
+of switches, this example demonstrates:
+
+- creating a custom topology, LinearTestTopo
+- using the ping() and iperf() tests from Mininet()
+- testing both the kernel and user switches
+
 """
 
 import sys
diff --git a/examples/udpbwtest.py b/examples/udpbwtest.py
index e9c492fce5547ddf009f454466140e2bf2f3c2bd..6baec85cc720cf0c6414f4f47a0626c1bf179843 100755
--- a/examples/udpbwtest.py
+++ b/examples/udpbwtest.py
@@ -6,6 +6,14 @@
 udp traffic. This should be something of a stress test.
 
 We should also make a tcp version. :D
+
+In addition to trying to saturate global bandwidth in
+various Mininet configurations, this example:
+
+- uses a topology, TreeTopo, from mininet.topolib
+- starts up a custom test program, udpbwtest, on each host
+- dynamically monitors the output of a set of hosts
+
 """
 
 import os
@@ -36,7 +44,7 @@ def readline( host, buffer ):
 def monitor( hosts, seconds ):
    "Monitor a set of hosts and yield their output."
    poller = select.poll()
-   Node = hosts[ 0 ] # so we can call class method
+   Node = hosts[ 0 ] # so we can call class method fdToNode
    buffers = {}
    for host in hosts:
       poller.register( host.stdout )