new documentation
add short flags to command line docs