<div class="gmail_quote">On Thu, Jul 19, 2012 at 4:36 AM, Hua ZZ Zhang <span dir="ltr"><<a href="mailto:zhuadl@cn.ibm.com" target="_blank">zhuadl@cn.ibm.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div>
<p><font face="sans-serif">I found an interesting thing about the naming style of current command arguments. it is a little difference across different components.</font><br>
<font face="sans-serif">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 </font><br>
<font face="sans-serif">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><br>
</p></div></blockquote></div><div><br></div><div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)">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.</div>
<div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)"><br></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)">
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).</div>
<div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)"><br></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)">
FWIW, glance will never have the '_' option names because it is a new client and already breaks backward compatibility with the original glance client.</div></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)">
<br></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)">dt</div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:13px;background-color:rgb(255,255,255)">
<br></div>-- <br><br>Dean Troyer<br><a href="mailto:dtroyer@gmail.com">dtroyer@gmail.com</a><br><br>