ENH: Make the ndarray diagonal method return a view.

Also remove the test_diagonal_deprecation test and add test that
checks that a view is returned and that it is not writeable.

Closes #596.
Merge pull request #3645 from charris/enable-diagonal-as-view

ENH: Make the ndarray diagonal method return a view.