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.

lot's of changes; nonfree & photo modules added; SIFT & SURF -> nonfree module; Inpainting -> photo; refactored features2d (ORB is still failing tests), optimized brute-force matcher and made it non-template.