ReST directive was used. Also fixed some other ReST directives that were
not correct and removed some warnings during buildbot checks.

- Used lunix style slashes - works on most systems
- Removed all trailing whitespaces

Invalid links and refences fixed.
SpaeseMat class documentation updated.