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).
-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
>