tidied up documentation on Point class
Added docs for method set, and fixed Matrix docs to stop methods spilling
into Point docs.
Merge pull request #765 from beeglebug/docs-fix

Assorted documentation fixes