update docs
add new extra flags
expand docs