57 messages in net.java.dev.glassfish.adminRe: Final Review of create-domain man...| From | Sent On | Attachments |
|---|---|---|
| Dixie Pine | Oct 6, 2009 4:58 pm |  .pdf, .pdf, .pdf |
| Kedar Mhaswade | Oct 14, 2009 5:14 pm | |
| Bill Shannon | Oct 14, 2009 8:30 pm | |
| Dixie Pine | Oct 16, 2009 5:37 pm | .pdf, .pdf, .pdf |
| Bill Shannon | Oct 19, 2009 6:16 pm | |
| Dixie Pine | Oct 20, 2009 10:27 am | |
| Bill Shannon | Oct 20, 2009 10:42 am | |
| Dixie Pine | Oct 20, 2009 2:06 pm | .pdf |
| Sankar Neelakandan | Oct 20, 2009 2:18 pm | |
| Bill Shannon | Oct 20, 2009 2:26 pm | |
| kedar | Oct 20, 2009 2:52 pm | |
| Dixie Pine | Oct 21, 2009 3:52 pm | .pdf |
| Dixie Pine | Oct 21, 2009 3:54 pm | .pdf |
| Sankar Neelakandan | Oct 21, 2009 6:38 pm | |
| Paul Davies | Oct 21, 2009 6:58 pm | |
| Bill Shannon | Oct 21, 2009 7:33 pm | |
| Nandini Ektare | Oct 21, 2009 9:13 pm | |
| Dixie Pine | Oct 22, 2009 12:00 pm | .pdf |
| Dixie Pine | Oct 22, 2009 12:01 pm | |
| Dixie Pine | Oct 22, 2009 12:38 pm | |
| Sankar Neelakandan | Oct 22, 2009 12:48 pm | |
| Nandini Ektare | Oct 22, 2009 12:53 pm | |
| Dixie Pine | Oct 22, 2009 2:31 pm | |
| Nandini Ektare | Oct 22, 2009 2:50 pm | |
| Bill Shannon | Oct 22, 2009 2:51 pm | |
| Dixie Pine | Oct 22, 2009 3:53 pm | |
| Dixie Pine | Oct 22, 2009 3:57 pm | |
| Bill Shannon | Oct 22, 2009 8:53 pm | |
| Bill Shannon | Oct 22, 2009 9:00 pm | |
| Nandini Ektare | Oct 22, 2009 9:48 pm | |
| Lloyd Chambers | Oct 23, 2009 10:07 am | |
| Lloyd Chambers | Oct 23, 2009 10:11 am | |
| Paul Davies | Oct 23, 2009 1:14 pm | |
| Nandini Ektare | Oct 23, 2009 1:18 pm | |
| Lloyd Chambers | Oct 23, 2009 3:13 pm | |
| Dixie Pine | Oct 28, 2009 5:49 pm | .pdf |
| Sankar Neelakandan | Oct 28, 2009 5:53 pm | |
| Bill Shannon | Oct 29, 2009 10:07 pm | |
| Dixie Pine | Oct 30, 2009 8:37 am | |
| Nandini Ektare | Oct 30, 2009 8:46 am | |
| Sankar Neelakandan | Oct 30, 2009 9:39 am | |
| Bill Shannon | Oct 30, 2009 11:28 am | |
| Lloyd Chambers | Oct 30, 2009 11:42 am | |
| Bill Shannon | Oct 30, 2009 1:07 pm | |
| Dixie Pine | Oct 30, 2009 1:32 pm | |
| Sankar Neelakandan | Oct 30, 2009 2:01 pm | |
| Bill Shannon | Oct 30, 2009 2:21 pm | |
| Bill Shannon | Oct 30, 2009 2:35 pm | |
| Nandini Ektare | Oct 30, 2009 2:54 pm | |
| Sankar Neelakandan | Oct 30, 2009 3:01 pm | |
| Dixie Pine | Oct 30, 2009 4:15 pm | |
| Bill Shannon | Nov 2, 2009 5:01 pm | |
| Bill Shannon | Nov 2, 2009 5:03 pm | |
| Sankar Neelakandan | Nov 2, 2009 5:30 pm | |
| June...@Sun.COM | Nov 3, 2009 10:15 am | |
| Paul Davies | Nov 3, 2009 12:33 pm | |
| Bill Shannon | Nov 3, 2009 12:51 pm |
| Subject: | Re: Final Review of create-domain man page | |
|---|---|---|
| From: | Bill Shannon (bill...@sun.com) | |
| Date: | Oct 22, 2009 2:51:09 pm | |
| List: | net.java.dev.glassfish.admin | |
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...
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. 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 default values are supplied automatically, assuming the command implementation has specified the correct metadata.
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.
I'm fine with having the man page describe this differently than the usage message. The man page can include much more text, including text to describe the default value. The usage message is trying to be very concise.
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.
I'm not sure what you're referring to. The usage message generally includes only one of "true" or "false", depending on what the default value is.