Update README file; add comments to undocumented Session class methods