Dixie Pine wrote:
> On 10/21/09 09:14 PM, Nandini Ektare wrote:
>>
>>>> *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?
>>>>
>>>
>>> It's a feature. :-)
>>>
>>> Seriously, people asked for the usage message to indicate the default
>>> values of the options, where they're known, so that's what the code does.
>>> If there's consensus that that should be removed, that's easy to do.
>>>
>>> Let's see what people think. I created a poll...
>>>
>>> http://sun.doodle.com/6t38vi48u5uyvpg4
>>>
>> I like the feature because
>> 1. It's like example and usage merged together (thought it may not be
>> a widely used practice, I feel it 's convenient)
>> 2. More important: In v3 we can't see defaults in the usual place --
>> domain.xml. So this feature helps to that end.
> If we are choosing to do this (include defaults for replaceables) you
> need to do it everywhere, which you don't.
Hmm..I see defaults in the commands I was working on recently (I have
not checked other commands):
Usage: asadmin [asadmin-utility-options] create-ssl --certname
<certname> --type <type> [--ssl2enabled=true] [--ssl2ciphers
<ssl2ciphers>] [--ssl3enabled=true] [--ssl3tlsciphers <ssl3tlsciphers>]
[--tlsenabled=true] [--tlsrollbackenabled=true]
[--clientauthenabled=true] [--target <target>] [-?|--help=false]
[listener_id]
Usage: asadmin [asadmin-utility-options] create-network-listener
[--address <address>] --listenerport <listenerport> [--threadpool
http-thread-pool] --protocol <protocol> [--transport tcp]
[--enabled=true] [--jkenabled=false] [-?|--help=false] name
Nandini
> This is why users get confused and think they should type
> 4848---because they don't see this often in a command message.
>
> Do you all really want to redo all the messages to include default
> values? And how would you describe this is the message?
>
> The defaults are listed in the man pages with the descriptions of the
> options in the Options section, in a much more complete way than they
> can be shown in Synopsis or in a command message.
>
> While we're discussing this, the true|false presentation would be
> better if the actual boolean were shown. First listed would be the
> default. Users could get used to that and not think they should type true.
>
>
>>
>>