updated in-file documentation