Thanks for the replies. I totally agree that we should deprecate it. We forgot to mark --request-format as deprecated. The way we should go is to deprecate --request-format.
Akihiro 2015-12-07 21:24 GMT+09:00 Neil Jerram <[email protected]>: > On 07/12/15 12:01, Akihiro Motoki wrote: >> Hi, >> >> neutronclient is now dropping XML support and as a result >> "--request-format" option is no longer needed as JSON is the only format now. >> >> What is the recommended way for options no longer needed? >> Does bumping major version of CLI allow us to drop an option without >> deprecation? >> >> - Deprecate such option. >> The option still exists with only one available choiceuntil the >> option is deleted. >> >> - Drop it without deprecation. >> This breaks users who uses "--requiest-format json", but 'json' is the >> default >> value and most users do not specify the option. > > I'd say it depends on how the deprecation of '--request-format xml' was > announced. If it said > > "XML format is deprecated and will be removed in a future release. The > only supported format will then be JSON, and so the --request-format > option will also be removed" > > then the option can clearly be removed now. > > How was it announced? If I look at > http://docs.openstack.org/cli-reference/content/neutronclient_commands.html, > I see many occurrences of > > *--request-format {json,xml}* > > The XML or JSON request format. > > ** > > without anything to say that XML is deprecated. And I see many other > things in the same page that _are_ marked as "DEPRECATED!" So, if I was > reading this documentation, I would not know that XML format is deprecated. > > Regards, > Neil > > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: [email protected]?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
