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 
This is nicer.  Should probably add code highlighting via back-quotes around the code pieces.  Surround code with the quote character on the tilde key.