added some docco-style documentation