DOC: NpyIter documentation improvements

Fixes a few of the problems highlighted in #5295. Example code now actually compiles (it still segfaults when I try it; I've yet to find out why).