admin@glassfish.java.net

Standardization on asadmin terms

From: Paul Davies <Paul-Martin.Davies_at_Sun.COM>
Date: Tue, 11 Aug 2009 08:44:28 -0700

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/