Bug 1034771 - [ovirt-hosted-engine-setup] hosted-engine $command --help or teach --help to show all options
Summary: [ovirt-hosted-engine-setup] hosted-engine $command --help or teach --help to ...
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: ovirt-hosted-engine-setup
Version: 3.3.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: 3.3.0
Assignee: Adam Litke
QA Contact: movciari
URL:
Whiteboard: integration
: 1046019 (view as bug list)
Depends On: 1038626 1046019
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-11-26 13:35 UTC by Jiri Belka
Modified: 2014-01-21 16:55 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-01-21 16:55:36 UTC
oVirt Team: ---
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2014:0083 0 normal SHIPPED_LIVE new package: ovirt-hosted-engine-setup 2014-01-21 21:42:22 UTC
oVirt gerrit 21979 0 None None None Never
oVirt gerrit 22123 0 None None None Never

Description Jiri Belka 2013-11-26 13:35:00 UTC
Description of problem:
hosted-engine $command --help or teach --help to show all options.

# hosted-engine --deploy --help
Usage: /usr/share/ovirt-hosted-engine-setup/scripts/ovirt-hosted-engine-setup
        --config-append=file
                Load extra configuration files.
        --generate-answer=file
                Generate answer file.

is bizzare syntax. no sane command line application uses such syntax, especially comment is... how would one know it should be written like this?

* '--deploy' is an option

So either teach --help to show all possible option and inform user that it is a kind of "suboption" of another option (lol), or better change "commands" into command syntax like git does it.

* git --help commit ...or... git commit --help

thus

* hosted-engine --help ...or... hosted-engine deploy --help / hosted-engine --help deploy


Version-Release number of selected component (if applicable):
is24.2

How reproducible:
100%

Steps to Reproduce:
1. how would you know there's "config-append" option for hosted-engine (??) [no source reading please!]
2.
3.

Actual results:
--help hides all options and/or --help usage/hosted-engine's options are syntactically bizzare

Expected results:
sane style

Additional info:

Comment 1 Adam Litke 2013-12-05 14:55:28 UTC
patch merged on master branch: 02c0cf0961076d1416829dcb1ef600a72a90192b

Comment 2 Sandro Bonazzola 2013-12-06 12:35:34 UTC
patch merged also on 1.0 branch.
proposing as blocker for inclusion in 3.3.0.

Comment 3 Adam Litke 2013-12-06 13:10:48 UTC
Merged upstream as 02c0cf0961076d1416829dcb1ef600a72a90192b

Comment 5 Sandro Bonazzola 2013-12-23 08:39:42 UTC
*** Bug 1046019 has been marked as a duplicate of this bug. ***

Comment 6 errata-xmlrpc 2014-01-21 16:55:36 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2014-0083.html


Note You need to log in before you can comment on or make changes to this bug.