<html><body>
<p><font size="2" face="sans-serif">Dean, </font><br>
<br>
<font size="2" face="sans-serif">thank you for clarifying this. good to know we have some perspective of how to resolve this issue. </font><br>
<font size="2" face="sans-serif">Since Openstack community grow very fast, more and more projects and people are involved. As one big community, developers from different projects need to see an uniform hacking rules and best practice when they're moving forward so fast. If the consensus should be reached as earlier as possible, a lot of efforts of maitaining compatibility, document and fix can be saved in the future.</font><br>
<font size="2" face="sans-serif"><br>
</font><font size="1" face="serif"><b>Best Regards, </b></font><font size="1" face="serif"><br>
<br>
</font><hr width="100%" size="2" align="left">
<table border="0" cellspacing="0" cellpadding="0">
<tr valign="top"><td width="298" valign="middle">
<ul style="padding-left: 0pt"><font size="1" face="serif"><b>Edward Zhang(张华)</b></font><font size="1" face="serif"><br>
Staff Software Engineer<br>
Travel&Transportation Standards<br>
Emerging Technology Institute(ETI)<br>
IBM China Software Development Lab<br>
e-mail: zhuadl@cn.ibm.com<br>
Notes ID: Hua ZZ Zhang/China/IBM<br>
Tel: 86-10-82450483</font></ul>
</td><td width="298" valign="middle">
<ul style="padding-left: 0pt"><font size="1" face="serif">地址:北京市海淀区东北旺西路8号 中关村软件园28号楼 环宇大厦3层 邮编：100193<br>
Address: 3F Ring, Building 28 Zhongguancun Software Park, 8 Dongbeiwang West Road, Haidian District, Beijing, P.R.C.100193</font></ul>
</td></tr>
<tr valign="top"><td width="298" valign="middle">
<ul style="padding-left: 0pt"><img src="cid:1__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" width="100" height="100"></ul>
</td><td width="298" valign="middle"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""></td></tr>
<tr valign="top"><td width="298" valign="middle">
<ul style="padding-left: 0pt"><font size="1" face="serif"><br>
</font></ul>
</td><td width="298" valign="middle"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""></td></tr>
</table>
<br>
<img width="16" height="16" src="cid:3__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt="Inactive hide details for Dean Troyer ---2012-07-20 00:27:15---On Thu, Jul 19, 2012 at 4:36 AM, Hua ZZ Zhang < zhuadl@cn.ibm.co"><font size="2" color="#424282" face="sans-serif">Dean Troyer ---2012-07-20 00:27:15---On Thu, Jul 19, 2012 at 4:36 AM, Hua ZZ Zhang < zhuadl@cn.ibm.com</font><br>
<br>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr valign="top"><td style="background-image:url(cid:4__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com); background-repeat: no-repeat; " width="40%">
<ul style="padding-left: 72pt"><font size="1" face="sans-serif"><b>Dean Troyer <dtroyer@gmail.com></b></font><font size="1" face="sans-serif"> </font>
<p><font size="1" face="sans-serif">2012-07-20 00:27</font></ul>
</td><td width="60%">
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr valign="top"><td width="1%"><img width="58" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""><br>
<div align="right"><font size="1" face="sans-serif">To</font></div></td><td width="100%"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""><br>
<ul style="padding-left: 7pt"><font size="1" face="sans-serif">Hua ZZ Zhang/China/IBM@IBMCN</font></ul>
</td></tr>
<tr valign="top"><td width="1%"><img width="58" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""><br>
<div align="right"><font size="1" face="sans-serif">cc</font></div></td><td width="100%"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""><br>
<ul style="padding-left: 7pt"><font size="1" face="sans-serif">openstack@lists.launchpad.net</font></ul>
</td></tr>
<tr valign="top"><td width="1%"><img width="58" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""><br>
<div align="right"><font size="1" face="sans-serif">Subject</font></div></td><td width="100%"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""><br>
<ul style="padding-left: 7pt"><font size="1" face="sans-serif">Re: [Openstack] Command Argument Naming Style</font></ul>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="0">
<tr valign="top"><td width="58"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""></td><td width="336"><img width="1" height="1" src="cid:2__=C7BBF0D2DF98FB1B8f9e8a93df938@cn.ibm.com" border="0" alt=""></td></tr>
</table>
</td></tr>
</table>
<br>
<font size="3" face="serif">On Thu, Jul 19, 2012 at 4:36 AM, Hua ZZ Zhang <</font><a href="mailto:zhuadl@cn.ibm.com" target="_blank"><font size="3" color="#0000FF" face="serif"><u>zhuadl@cn.ibm.com</u></font></a><font size="3" face="serif">> wrote:</font>
<ul style="padding-left: 9pt"><font size="3" face="sans-serif">I found an interesting thing about the naming style of current command arguments. it is a little difference across different components.<br>
you can see nova/quantum/swift/keystone are using both dash '-' and underline '_'. Only keystone is mixed with two style: --xx_yyy_zzz --xx-yyy-zzz <br>
And glance use the --xx-yyy-zzz style which only contains dash '-'. IMO, it's better to be consisitent in naming style for all core components, including the usage text. secondly, avoid using same argument name with different meanings or different argument name for the same meaning. Thirdly, keep it simple as possible, don't use unnecessary symbols.</font></ul>
<br>
<br>
<font size="2" color="#222222" face="Arial">We strive for consistency and unfortunately we are still not there yet. The goal is to use '-' in option names everywhere but we also have backward compatibility to consider. Glance and keystone are the two that I've managed to complete so far, the others are on my list and I haven't gotten there yet.</font><br>
<br>
<font size="2" color="#222222" face="Arial">The goal is to add the options containing '-' and document those while maintaining the options containing '_' for compatibility and documenting them as deprecated, if at all, and to be removed sometime in the future (>6 months at least).</font><br>
<br>
<font size="2" color="#222222" face="Arial">FWIW, glance will never have the '_' option names because it is a new client and already breaks backward compatibility with the original glance client.</font><br>
<br>
<font size="2" color="#222222" face="Arial">dt</font><br>
<br>
<font size="3" face="serif">-- <br>
<br>
Dean Troyer</font><font size="3" color="#0000FF" face="serif"><u><br>
</u></font><a href="mailto:dtroyer@gmail.com"><font size="3" color="#0000FF" face="serif"><u>dtroyer@gmail.com</u></font></a><font size="3" face="serif"><br>
</font><br>
</body></html>