added docs to SelectionRecord, made appropriate methods const
marked legacy methods deprecated, updated docs
corrected method names, fix bug FS#69
Merge pull request #1 from AndySomogyi/develop

Pull request from andys develop to my develop?