improve documentation of usage