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