atom feed57 messages in net.java.dev.glassfish.adminRe: Final Review of create-domain man...
FromSent OnAttachments
Dixie PineOct 6, 2009 4:58 pm.pdf, .pdf, .pdf
Kedar MhaswadeOct 14, 2009 5:14 pm 
Bill ShannonOct 14, 2009 8:30 pm 
Dixie PineOct 16, 2009 5:37 pm.pdf, .pdf, .pdf
Bill ShannonOct 19, 2009 6:16 pm 
Dixie PineOct 20, 2009 10:27 am 
Bill ShannonOct 20, 2009 10:42 am 
Dixie PineOct 20, 2009 2:06 pm.pdf
Sankar NeelakandanOct 20, 2009 2:18 pm 
Bill ShannonOct 20, 2009 2:26 pm 
kedarOct 20, 2009 2:52 pm 
Dixie PineOct 21, 2009 3:52 pm.pdf
Dixie PineOct 21, 2009 3:54 pm.pdf
Sankar NeelakandanOct 21, 2009 6:38 pm 
Paul DaviesOct 21, 2009 6:58 pm 
Bill ShannonOct 21, 2009 7:33 pm 
Nandini EktareOct 21, 2009 9:13 pm 
Dixie PineOct 22, 2009 12:00 pm.pdf
Dixie PineOct 22, 2009 12:01 pm 
Dixie PineOct 22, 2009 12:38 pm 
Sankar NeelakandanOct 22, 2009 12:48 pm 
Nandini EktareOct 22, 2009 12:53 pm 
Dixie PineOct 22, 2009 2:31 pm 
Nandini EktareOct 22, 2009 2:50 pm 
Bill ShannonOct 22, 2009 2:51 pm 
Dixie PineOct 22, 2009 3:53 pm 
Dixie PineOct 22, 2009 3:57 pm 
Bill ShannonOct 22, 2009 8:53 pm 
Bill ShannonOct 22, 2009 9:00 pm 
Nandini EktareOct 22, 2009 9:48 pm 
Lloyd ChambersOct 23, 2009 10:07 am 
Lloyd ChambersOct 23, 2009 10:11 am 
Paul DaviesOct 23, 2009 1:14 pm 
Nandini EktareOct 23, 2009 1:18 pm 
Lloyd ChambersOct 23, 2009 3:13 pm 
Dixie PineOct 28, 2009 5:49 pm.pdf
Sankar NeelakandanOct 28, 2009 5:53 pm 
Bill ShannonOct 29, 2009 10:07 pm 
Dixie PineOct 30, 2009 8:37 am 
Nandini EktareOct 30, 2009 8:46 am 
Sankar NeelakandanOct 30, 2009 9:39 am 
Bill ShannonOct 30, 2009 11:28 am 
Lloyd ChambersOct 30, 2009 11:42 am 
Bill ShannonOct 30, 2009 1:07 pm 
Dixie PineOct 30, 2009 1:32 pm 
Sankar NeelakandanOct 30, 2009 2:01 pm 
Bill ShannonOct 30, 2009 2:21 pm 
Bill ShannonOct 30, 2009 2:35 pm 
Nandini EktareOct 30, 2009 2:54 pm 
Sankar NeelakandanOct 30, 2009 3:01 pm 
Dixie PineOct 30, 2009 4:15 pm 
Bill ShannonNov 2, 2009 5:01 pm 
Bill ShannonNov 2, 2009 5:03 pm 
Sankar NeelakandanNov 2, 2009 5:30 pm 
June...@Sun.COMNov 3, 2009 10:15 am 
Paul DaviesNov 3, 2009 12:33 pm 
Bill ShannonNov 3, 2009 12:51 pm 
Subject:Re: Final Review of create-domain man page
From:Bill Shannon (bill@sun.com)
Date:Oct 21, 2009 7:33:33 pm
List:net.java.dev.glassfish.admin

Dixie Pine wrote on 10/21/09 3:55 PM:

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.

The command metadata isn't rich enough to express this relationship between options, so the code that automatically generates the usage message based on the command metadata can't do any better. We could hardwire the usage message, but that makes it more fragile as the command is changed.

*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