Numerous formatting fixes for InteractionMachine.interact docstring.
A couple of fixes for utils docstrings (note that use of  was removed because formatting appears to not work inside it).
Remove reference to examples.rst (which does not exist). Examples live on the front page for now.