improve documentation of --pick options