256 updated XML docs for new methods

fixes #256 and fixes #273