documented usage