Convert docstring examples to doctests and fix

any errors that were found.  Add a usage note
to compare_networks() showing how to do the
ordering with modern python.