bring back the intershinx goodness

This ensures that links to external objects are 'magically' generated.
This feature was disable in commit 288072c, but it was likely not
used at the time.
use a more approriate Sphinx directive
spaces are preferred to tabs
Merge pull request #857 from tshepang/diff

bring back intersphinx
thank you