BUG: gh-2687 make multiarray dot method accept out array and keyword args

Fixes #2687 and makes the docs for ndarray.dot be correct.