adding documentation for command.parse_response event

Event is in the source code but had been missing from docs.
adding code examples of event listener/subscriber

code examples to aid in plugin creation.
updating command options

based on source code, marking deprecated options in documentation.
adding in new parameters, especially the very useful command.request_options.
Merge pull request #471 from kosmik-koi/master

documentation updates