Doc-Doctesting

Initial commit to test building on travis. Inculdes some initial fixes to the .rst files which were added while debugging the errors on my machine. 

Extension of issue #588 
What exactly is the behavior of `--doctest-glob='*.rst'`?  Does it restrict us to only .rst files?  Does it recurse into directories?