update doc for river options