#256 updated XML docs for new methods