Gpuarray doc

This does three things:
 - fixes a lot of the warnings and errors in the documentation
 - add a --cache option to docgen.py to make it not disable the sphinx doctree cache
 - Add a section about gpuarray in the tutorial.