Doc tidy up

Fixed some incorrect snippets of information, and one of the examples
which wasn't working. Also shuffled a couple of things around for
clarity.
Doc fixes
Merge branch 'master' of github.com:waveform80/picamera