Extend documentation of getopts for arguments

cc @steveklabnik