updating command options

based on source code, marking deprecated options in documentation.
adding in new parameters, especially the very useful command.request_options.