put in the comment doc what you expect in `opts`