cosmetics: added some documentation.