Documentation, .gitignore, plus tidying

- Sphinx documentation added. run 'make html' in the docs folder to produce a html documentation file that can be browsed interactively. run 'make latex' to create a latex file that can be converted to pdf.
- .gitignore file added to speed up commits
- generally tidied and improved readability of cosmology, powspec and void_distribution files