improve docs for extract(), add to changelog