add; docs for new opts