Tidied up some of the documentation.
Updated some of the examples.
Actions by @NelleV.
Further enhancements and simplifications.
Merge pull request #1918 from pelson/updated_v1p3docs

Tidied up some of the documentation.