<html><body>
<p><font size="2" face="sans-serif">hi,</font><br>
<br>
<font size="2" 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 size="2" 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 size="2" 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>
<br>
<font size="2" face="sans-serif">----------------------------------------------</font><br>
<font size="2" face="sans-serif">project\style --xx_yyy_zzz --xx-yyy-zzz</font><br>
<font size="2" face="sans-serif">----------------------------------------------</font><br>
<font size="2" face="sans-serif">nova Yes No</font><br>
<font size="2" face="sans-serif">quantum Yes No</font><br>
<font size="2" face="sans-serif">swift Yes No</font><br>
<font size="2" face="sans-serif">keystone Yes Yes</font><br>
<font size="2" face="sans-serif">glance No Yes</font><br>
<font size="2" face="sans-serif">----------------------------------------------</font><br>
<br>
<br>
<font size="1" face="sans-serif">usage: </font><font size="1" face="sans-serif"><b>nova </b></font><font size="1" face="sans-serif">[--debug] [--no_cache] [--timings] [--os_username OS_USERNAME]</font><br>
<font size="1" face="sans-serif"> [--os_password OS_PASSWORD] [--os_tenant_name OS_TENANT_NAME]</font><br>
<font size="1" face="sans-serif"> [--os_auth_url OS_AUTH_URL] [--os_region_name OS_REGION_NAME]</font><br>
<font size="1" face="sans-serif"> [--service_type SERVICE_TYPE] [--service_name SERVICE_NAME]</font><br>
<font size="1" face="sans-serif"> [--volume_service_name VOLUME_SERVICE_NAME]</font><br>
<font size="1" face="sans-serif"> [--endpoint_type ENDPOINT_TYPE]</font><br>
<font size="1" face="sans-serif"> [--os_compute_api_version OS_COMPUTE_API_VERSION]</font><br>
<font size="1" face="sans-serif"> [--username USERNAME] [--region_name REGION_NAME]</font><br>
<font size="1" face="sans-serif"> [--apikey APIKEY] [--projectid PROJECTID] [--url URL]</font><br>
<font size="1" face="sans-serif"> [--bypass_url BYPASS_URL]</font><br>
<font size="1" face="sans-serif"> <subcommand> ...</font><br>
<br>
<font size="1" face="sans-serif">usage: </font><font size="1" face="sans-serif"><b>quantum </b></font><font size="1" face="sans-serif">[--version] [-v] [-q] [-h] [--debug]</font><br>
<font size="1" face="sans-serif"> [--os_auth_strategy <auth_strategy>] [--os_auth_url <auth_url>]</font><br>
<font size="1" face="sans-serif"> [--os_tenant_name <auth_tenant_name>]</font><br>
<font size="1" face="sans-serif"> [--os_username <auth_username>] [--os_password <auth_password>]</font><br>
<font size="1" face="sans-serif"> [--os_region_name <auth_region_name>] [--os_token <token>]</font><br>
<font size="1" face="sans-serif"> [--os_url <url>]</font><br>
<font size="2" face="sans-serif"><b>swift</b></font><br>
<font size="2" face="sans-serif">Options:</font><br>
<font size="2" face="sans-serif"> --version show program's version number and exit</font><br>
<font size="2" face="sans-serif"> -h, --help show this help message and exit</font><br>
<font size="2" face="sans-serif"> -s, --snet Use SERVICENET internal network</font><br>
<font size="2" face="sans-serif"> -v, --verbose Print more info</font><br>
<font size="2" face="sans-serif"> -q, --quiet Suppress status output</font><br>
<font size="2" face="sans-serif"> -A AUTH, --auth=AUTH URL for obtaining an auth token</font><br>
<font size="2" face="sans-serif"> -V AUTH_VERSION, --auth-version=AUTH_VERSION</font><br>
<font size="2" face="sans-serif"> Specify a version for authentication(default: 1.0)</font><br>
<font size="2" face="sans-serif"> -U USER, --user=USER User name for obtaining an auth token</font><br>
<font size="2" face="sans-serif"> -K KEY, --key=KEY Key for obtaining an auth token</font><br>
<font size="2" face="sans-serif"> --os_auth_url=OS_AUTH_URL</font><br>
<font size="2" face="sans-serif"> Openstack auth URL. Defaults to env[OS_AUTH_URL].</font><br>
<font size="2" face="sans-serif"> --os_username=OS_USERNAME</font><br>
<font size="2" face="sans-serif"> Openstack username. Defaults to env[OS_USERNAME].</font><br>
<font size="2" face="sans-serif"> --os_tenant_name=OS_TENANT_NAME</font><br>
<font size="2" face="sans-serif"> Openstack tenant name.Defaults to env[OS_TENANT_NAME].</font><br>
<font size="2" face="sans-serif"> --os_password=OS_PASSWORD</font><br>
<font size="2" face="sans-serif"> Openstack password. Defaults to env[OS_PASSWORD].</font><br>
<br>
<font size="1" face="sans-serif">usage: </font><font size="1" face="sans-serif"><b>keystone </b></font><font size="1" face="sans-serif">[--os-username <auth-user-name>]</font><br>
<font size="1" face="sans-serif"> [--os-password <auth-password>]</font><br>
<font size="1" face="sans-serif"> [--os-tenant-name <auth-tenant-name>]</font><br>
<font size="1" face="sans-serif"> [--os-tenant-id <tenant-id>] [--os-auth-url <auth-url>]</font><br>
<font size="1" face="sans-serif"> [--os-region-name <region-name>]</font><br>
<font size="1" face="sans-serif"> [--os-identity-api-version <identity-api-version>]</font><br>
<font size="1" face="sans-serif"> [--token <service-token>] [--endpoint <service-endpoint>]</font><br>
<font size="1" face="sans-serif"> [--os_cacert <ca-certificate>] [--os_cert <certificate>]</font><br>
<font size="1" face="sans-serif"> [--os_key <key>] [--username <auth-user-name>]</font><br>
<font size="1" face="sans-serif"> [--password <auth-password>] [--tenant_name <tenant-name>]</font><br>
<font size="1" face="sans-serif"> [--auth_url <auth-url>] [--region_name <region-name>]</font><br>
<font size="1" face="sans-serif"> <subcommand> ...</font><br>
<br>
<font size="1" face="sans-serif">usage: </font><font size="1" face="sans-serif"><b>glance </b></font><font size="1" face="sans-serif">[--os-username OS_USERNAME] [--os-password OS_PASSWORD]</font><br>
<font size="1" face="sans-serif"> [--os-tenant-id OS_TENANT_ID] [--os-tenant-name OS_TENANT_NAME]</font><br>
<font size="1" face="sans-serif"> [--os-auth-url OS_AUTH_URL] [--os-region-name OS_REGION_NAME]</font><br>
<font size="1" face="sans-serif"> [--os-auth-token OS_AUTH_TOKEN] [--os-image-url OS_IMAGE_URL]</font><br>
<font size="1" face="sans-serif"> [--os-image-api-version OS_IMAGE_API_VERSION]</font><br>
<font size="1" face="sans-serif"> [--os-service-type OS_SERVICE_TYPE]</font><br>
<font size="1" face="sans-serif"> <subcommand> ...</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__=C7BBF0D3DFBC34AF8f9e8a93df938@cn.ibm.com" width="100" height="100"></ul>
</td><td width="298" valign="middle"><img width="1" height="1" src="cid:2__=C7BBF0D3DFBC34AF8f9e8a93df938@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__=C7BBF0D3DFBC34AF8f9e8a93df938@cn.ibm.com" border="0" alt=""></td></tr>
</table>
</body></html>