admin@glassfish.java.net

Re: Final Review of create-domain man page

From: Sankar Neelakandan <Sankar.Neelakandan_at_Sun.COM>
Date: Wed, 21 Oct 2009 18:38:59 -0700

Okay more details are missing.

option --portbase is mutually exclusive with other options --adminport
--instanceport & --domainproperties, meaning when --portbase is
specified all the other options will not be accepted. I don't know how
you can state that in the synopsis.

If --portbase is omitted --adminport defaults to 4848 --instanceport
defaults to 8080 , so it will show up in the command usage as default
values.

thanks
Sankar

Dixie Pine wrote:
> On 10/20/09 02:18 PM, Sankar Neelakandan wrote:
>> Hi Dixie,
>> --adminport and --portbase are mutually exclusive options. It
>> should be described as
>> [--adminport 4848 | --portbase portbase] [--instanceport 8080]
> I looked at the command message and I see no attempt to indicate
> mutual exclusivity. It gets very complicated, especially when
> instanceport is factored in. So I added a sentence in each port option
> description to explain the mutual exclusivity.
>
> *BUG?* 4848 and 8080 should not be in the command message, but they
> are. They should be shown as <adminport> and <instanceport>
> replaceables. I changed the man page. Can the command message be fixed?
>
> Dixie
>>
>> -Sankar
>>
>> Dixie Pine wrote:
>>> I removed --user from Synopsis and list of options, added new
>>> paragraph in description, added
>>> description for --nopassword. Please review.
>>>
>>> dixie
>>>
>>> On 10/20/09 10:42 AM, Bill Shannon wrote:
>>>> Dixie Pine wrote on 10/20/09 10:27:
>>>>> On 10/19/09 18:16, Bill Shannon wrote:
>>>>>> --user really is just an asadmin option, except with create-domain
>>>>>> we make it a *required* option. There was no other good way to
>>>>>> specify
>>>>>> that requirement in the command usage so I added it as a subcommand
>>>>>> option that is required.
>>>>>>
>>>>> okay. What description do you want for the option? The asadmin
>>>>> option version says this:
>>>>>
>>>>> --user The user name of the authorized administsrative user of
>>>>> the DAS.
>>>>
>>>> Well, since adding the --nopassword option, it's no longer true that
>>>> --user is required, so I'll update the command usage to remove --user.
>>>> It will just be an asadmin utility option, but the man page will need
>>>> to describe how it's used.
>>>>
>>>> This is another one of those "you have to specify option A or
>>>> option B"
>>>> cases. If you specify --nopassword, --user is optional.
>>>>
>>>> --user specifies the user name of the administrative user that will be
>>>> created for the new domain. If not specified, and --nopassword is
>>>> specified,
>>>> the default user name "admin" is used.
>>>>
>>>> Try this:
>>>>
>>>> The create-domain command creates a domain with a single
>>>> administrative
>>>> user specified by the --user asadmin utility option. If the
>>>> --nopassword
>>>> option is specified and the --user option is not specified, the
>>>> default
>>>> admin user "admin" is used. If the --nopassword is not
>>>> specified, a user
>>>> name is required and will be prompted for (if interactive) if not
>>>> specified
>>>> using the --user option.
>>>>
>>>>
>>> ------------------------------------------------------------------------
>>>
>>> ---------------------------------------------------------------------
>>> 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