Follow-up to Glacier pull request reviews

* updating Javadocs
* minor style changes