RST formating and typo fixes

PhilIJC requested to merge github/fork/PhilLAL/patch-3 into phillal-typos-formatting-improvements Oct 12, 2018