Description of problem: The help message for "wallaby load" is not clear that if a filename is omitted, the command will read from standard input. Version-Release number of selected component (if applicable): 0.9.18 through 0.10.0 How reproducible: run "wallaby help load" with no other arguments. Actual results: Usage: wallaby load SNAPFILE Loads a wallaby snapshot from SNAPFILE.. -h, --help displays this message -a, --activate attempt to activate config after loading -q, --quiet do not provide progress on load feedback -v, --verbose provide more progress on load feedback Expected results: Usage: wallaby load [SNAPFILE] Loads a wallaby snapshot from SNAPFILE or standard input if no filename is given. -h, --help displays this message -a, --activate attempt to activate config after loading -q, --quiet do not provide progress on load feedback -v, --verbose provide more progress on load feedback Additional info:
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: C: The "wallaby load" command takes input either from a filename or from standard input. The help message for the "wallaby load" command did not indicate that it would read a snapshot file from standard input if no filename was provided on the command line. C: This may have been confusing for some users. F: The on-line help now explicitly indicates that if no filename is provided, the wallaby load command will read from standard input. R: The command's on-line help now more completely describes the command's interface, eliminating a potential source of confusion.
Tested on RHEL 5.6 x i386/x86_64 with: condor-wallaby-base-db-1.4-5.el5 wallaby-utils-0.9.18-2.el5 condor-wallaby-tools-3.6-6.el5 ruby-wallaby-0.9.18-2.el5 python-wallabyclient-3.6-6.el5 condor-wallaby-client-3.6-6.el5 wallaby-0.9.18-2.el5 and the string isn't there.
Tested on RHEL 5.6 x i386/x86_64 with: condor-wallaby-tools-3.9-2.el5 wallaby-0.10.4-2.el5 condor-wallaby-client-3.9-2.el5 wallaby-utils-0.10.4-2.el5 python-wallabyclient-3.9-2.el5 condor-wallaby-base-db-1.5-2.el5 ruby-wallaby-0.10.4-2.el5 and the string is: "Loads a wallaby snapshot from a file or from standard input." Is that right?
I think the text is acceptable. It should be clear from the brackets around SNAPFILE that the filename is optional, and it should be obvious in context that if no filename is given, that it will read from stdin.
Ok. --> VERIFIED
Technical note updated. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. Diffed Contents: @@ -1,4 +1 @@ -C: The "wallaby load" command takes input either from a filename or from standard input. The help message for the "wallaby load" command did not indicate that it would read a snapshot file from standard input if no filename was provided on the command line. +The help message for the "wallaby load" subcommand, accessed by running "wallaby help load", did not indicate that it would read a snapshot file from standard input if no file name was provided on the command line. The help message has been clarified in this update.-C: This may have been confusing for some users. -F: The on-line help now explicitly indicates that if no filename is provided, the wallaby load command will read from standard input. -R: The command's on-line help now more completely describes the command's interface, eliminating a potential source of confusion.
An advisory has been issued which should help the problem described in this bug report. This report is therefore being closed with a resolution of ERRATA. For more information on therefore solution and/or where to find the updated files, please follow the link below. You may reopen this bug report if the solution does not work for you. http://rhn.redhat.com/errata/RHBA-2011-0217.html