<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Exchange Server">
<!-- converted from text --><style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style>
</head>
<body>
<meta content="text/html; charset=UTF-8">
<style type="text/css" style="">
<!--
p
{margin-top:0;
margin-bottom:0}
-->
</style>
<div dir="ltr">
<div id="x_divtagdefaultwrapper" style="font-size:12pt; color:#000000; font-family:Calibri,Arial,Helvetica,sans-serif">
<p>We added this patch to the cinderclient:</p>
<p><span>b76f5944130e29ee1bf3095c966a393c489c05e6</span></p>
<p><br>
</p>
<p>Which basically only shows help for the features available at the requested API version. It is by design.<br>
</p>
</div>
<hr tabindex="-1" style="display:inline-block; width:98%">
<div id="x_divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" color="#000000" style="font-size:11pt"><b>From:</b> Sean McGinnis <sean.mcginnis@gmx.com><br>
<b>Sent:</b> Wednesday, October 12, 2016 7:03:28 AM<br>
<b>To:</b> openstack-dev@lists.openstack.org<br>
<b>Subject:</b> [openstack-dev] [Doc] Inclusion of microversion API support in CLI reference</font>
<div> </div>
</div>
</div>
<font size="2"><span style="font-size:10pt;">
<div class="PlainText">Just getting this out there to either get educated or to start a<br>
conversation...<br>
<br>
While going through some of the DocImpact generated bugs for<br>
python-cinderclient I noticed a few that added new parameters to<br>
existing CLI commands. As Cinder has now moved to using microversions<br>
for all API changes, these new parameters are only available at a<br>
certain microversion level.<br>
<br>
A specific case is here:<br>
<br>
<a href="https://github.com/openstack/python-cinderclient/blob/master/cinderclient/v3/shell.py#L1485">https://github.com/openstack/python-cinderclient/blob/master/cinderclient/v3/shell.py#L1485</a><br>
<br>
We have two parameters that are marked "start_version='3.1'" that do not<br>
show up in the generated CLI reference.<br>
<br>
This appears to be due to (or related to) the fact that the command line<br>
help does not output anything for these. Now before I dig into why that<br>
is, I know there are others that are already much more knowledgable<br>
about this area than I am. So my question is, is this by design? Or is<br>
something missing here that is needed to recognize these params with the<br>
start_version value so they get printed?<br>
<br>
My expectation as an end user would be that the help information would<br>
be printed, with something like "(Requires API 3.1 or later)" appended<br>
to the help text.<br>
<br>
Anyone have any insight on this?<br>
<br>
Thanks!<br>
<br>
Sean (smcginnis)<br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe<br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div>
</span></font>
</body>
</html>