update documentation and fix usage