Updated docs.
Nearly done, permit is still failing a test it shouldn't.
Tidied up docs.
Merge branch 'permit_object' of github.com:ned14/thread into permit_object

Conflicts:
	doc/permits.qbk