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 
Is it ok to just print out the results?  (I haven't looked much at the context surrounding this example, I don't actually know)