TAMAYA-8: added/improved Javadocs.