DOC: Docstring of np.diagonal to reflect edits of PR #5358

I should have included these edits to the docstring of `np.diagonal` with PR #5358.  My bad!