future expansion for -x and -r added to docs