Red Hat Bugzilla – Bug 109018
Rename '--parameters' command line arg on MasterTool to ''--define"
Last modified: 2014-12-01 18:13:19 EST
Description of problem:
The names of the args --parameters & --file to MasterTool do not give
a clear indication of their purposes. Yes, the --help option will give
detail on each argument name, but args should be named such that if
all you can remmber is the name, then you can make a reasonable
assumption as to its purpose. For instance, although I had previously
read the help, I mistakenly thought the --parameters arg would load
properties from a file, when in fact it should have been --file.
Thus, these two options should be renamed.
* For setting of key, value pairs, a common pattern is to use
'--define' as the name of the command line arg. cf RPM.
* I'd also suggest changing '--file' to '--rcfile' or similar. This
will avoid potential for confusion if we add additional command line
args that operate on files. ie, a '--bundle' option to read the list
of packages from a file instead of listing them individually on the
Version-Release number of selected component (if applicable):
Steps to Reproduce:
--usage is another very badly named parameter; --help is the industry
Per discussion, here's the final resolution:
1. --help will be aliased to --usage.
2. --file will be renamed to --parameter-file.