admin@glassfish.java.net

Re: Standardization on asadmin terms

From: Lloyd Chambers <Lloyd.Chambers_at_Sun.COM>
Date: Tue, 11 Aug 2009 08:51:40 -0700

I'm not grokking "utility".

Subcommand is what we've always used at ARC. I don't think we should
invent new terminology:

command subcommand options operands

Lloyd

On Aug 11, 2009, at 8:44 AM, Paul Davies wrote:

> Hi,
>
> In the discussion about --echo, I see examples of asadmin output
> that is inconsistent with the terminology in the documentation:
> asadmin Output
> Documentation
> asadmin program option
> asadmin utility option
> command
> subcommand
>
> Of course, the documentation and the software must be consistent,
> and I am willing to change the terms in the documentation if
> necessary. However, before I do, I would like to sugest that team
> consider using the terms "asadmin utility option" and "subcommand"
> in the asadmin output. I chose "utility" because, from a user's
> point of view, the utility aspect of asadmin is more important than
> the fact that it is a program. I chose "subcommand" to emphasise the
> fact that these items cannot be run in the operating system's
> command shell, but must be preceded by asadmin or run in an asadmin
> multimode session.
>
> Regards,
> --
> Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
> http://blogs.sun.com/techscribe/

Lloyd Chambers
lloyd.chambers_at_sun.com
GlassFish Team