"Version 1.0"

I plan to tag release version 1.0 before the end of the year (maybe work over Christmas?).

Main todos:

1) Tidy documentation
2) More examples.

Doing a tagged release so that I can work on reworking how I handle exeptions (currently, BADLY) which may change how things work and may break existing code using the library.