Added some additional explanatory comments.

examples/linearbandwidth.py

@@ -13,6 +13,14 @@ h1 <-> sN+1 <-> sN+2 .. sN+N-1
 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

examples/udpbwtest.py

@@ -6,6 +6,14 @@ saturate global bandwidth by sending constant all-to-all
 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 )