Sankar Neelakandan wrote:
>
>
> Kedar Mhaswade wrote:
>> I think --help or -h is more likely for general asadmin help, e.g.
>>
>> $ asadmin -h
>> $ asadmin --help
>>
>> which is what I do with any other program. So, that's my expectation with
>> asadmin as well.
>>
>> For a subcommand help, I think we should have both:
>> $ asadmin foo-cmd -h/--help, and
>> $ asadmin --help/-h foo-cmd
>>
>> So, yes, I agree with you, first of the above two is far commoner, IME.
>>
>> I think that's what V2 does as well. Can you check?
> Yes V2 supports -h|--help after the command name(asadmin & subcommand).
Thanks. In addition to this, there is also a subcommand named "help" which
serves the purpose as well.
> -Sankar
>>
>> Sankar Neelakandan wrote:
>>> Hi Paul,
>>> The plan of changes looks good, except the --help option. I feel
>>> that intuitively users will try asadmin <subcommand> --help instead
>>> of asadmin --help <subcommand>.
>>> What do others think ?.
>>>
>>> thanks
>>> Sankar
>>>
>>> Paul Davies wrote:
>>>> Hi,
>>>>
>>>> Please review the GlassFish v3 Administration CLI Documentation Plan
>>>> <http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishV3AdminCLIDocPlan>.
>>>> This plan specifies all the required documentation changes that
>>>> arise from the changes to the Administration CLI for GlassFish v3,
>>>> specifically the separation of metaoptions from subcommand options
>>>> in the asadmin utility.
>>>>
>>>> Attached to the plan is a sample changed man page (PDF)
>>>> <http://wiki.glassfish.java.net/attach/GlassFishV3AdminCLIDocPlan/create-javamail-resource.1.pdf>.
>>>> This sample illustrates how the man pages will appear after the
>>>> changes to man pages described in the plan are implemented. Please
>>>> review this sample in conjunction with the plan.
>>>>
>>>> Mandatory reviewers are as follows:
>>>>
>>>> * Kedar Mhaswade
>>>> * Bill Shannon
>>>> * Sankar Neelakandan
>>>>
>>>> Please give me your feedback on the plan and the sample by the end
>>>> of the day this *Friday, 17 July , 2009*. If you need more time,
>>>> please let me know. If I do not hear back from you by then, I will
>>>> assume that the plan and the sample are acceptable and that work can
>>>> proceed on making the changes in the documentation.
>>>>
>>>> Thank you.
>>>> --
>>>> Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
>>>> http://blogs.sun.com/techscribe/
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>