MISC: documentation and cosmits

Address comments by @jnothman
BUG: work aroundd Cython bug to build with clang

This commit should work around a Cython bug that makes the previous
iteration code in fast_dict.pyx impossible to compile under clang. See
https://mail.python.org/pipermail/cython-devel/2013-April/003566.html