Add documentation about the 'namespace' option

Have not done ReST in a while so I hope this is correct. Also fixed line 584 to be under 80 characters.