usage/doc fixes + remove unnecessary 'failure' text