[
https://issues.jboss.org/browse/AS7-3992?page=com.atlassian.jira.plugin.s...
]
Paul Gier commented on AS7-3992:
--------------------------------
{quote}If we remove --help coverage of things we actually support, particularly ones that
people commonly use, there will almost certainly be usability JIRAs complaining about the
missing items.{quote}
Ok, in that case I agree with the suggested format for putting them on a single line, with
the space option before the equals option, just because using a space for option arguments
seems to be a more common convention in command line tools.
{noformat}
-b <value>, -b=<value> Set system property
jboss.bind.address
to the given value
{noformat}
The only combined option I see which might be longer than the current space is the
"-P <url>" option. I'm ok with either making the space a little
larger, or keeping that option on multiple lines.
{noformat}
-P <url>, -P=<url> Load system properties from the given
url
--properties=<url> Load system properties from the given
url
{noformat}
Improve formatting of command line help
---------------------------------------
Key: AS7-3992
URL:
https://issues.jboss.org/browse/AS7-3992
Project: Application Server 7
Issue Type: Enhancement
Components: Scripts
Affects Versions: 7.1.0.Final
Reporter: Paul Gier
Assignee: Joe Wertz
For command line parameters where there is both a short or a long version of the same
option, the short and long version should be comma separated. This is similar to how many
command line tools display help or in man pages.
Current output:
{noformat}
-h Display this message and exit
--help Display this message and exit
{noformat}
Suggested output:
{noformat}
-h, --help Display this message and exit
{noformat}
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see:
http://www.atlassian.com/software/jira