add some documentation and 'usage' messages